diff --git a/.github/comment.yml b/.github/comment.yml
index d52fd9f8c403..1b7f5ae5aaaf 100644
--- a/.github/comment.yml
+++ b/.github/comment.yml
@@ -1,12 +1,4 @@
 ---
-- rule:
-    type: checkbox
-    keywords:
-      - "Removing API(s)"
-      - "Updating API in stable version"
-    onCheckedLabels:
-      - breakingChange
-
 - rule:
     type: checkbox
     keywords:
@@ -25,7 +17,7 @@
 - rule:
     type: label
     label: BreakingChangeReviewRequired
-    onLabeledComments: "Hi @${PRAuthor}, one or multiple breaking change(s) is detected in your PR. Pls follow [breaking change policy](https://aka.ms/AzBreakingChangesPolicy) to request breaking change review and approval before proceeding swagger PR review. "
+    onLabeledComments: "Hi @${PRAuthor}, one or multiple breaking change(s) is detected in your PR. Please check out the breaking change(s), and provide business justification in the PR comment and @ PR assignee why you must have these change(s), and how external customer impact can be mitigated. Please ensure to follow [breaking change policy](https://aka.ms/AzBreakingChangesPolicy) to request breaking change review and approval before proceeding swagger PR review. </br> If you think it is false positive breaking change, please provide the reasons in the PR comment, report to Swagger Tooling Team via https://aka.ma/swaggerfeedback. "
 
 - rule:
     type: label
diff --git a/.github/pull_request_assignment.yml b/.github/pull_request_assignment.yml
index c014dedd9e78..2668fe4455e5 100644
--- a/.github/pull_request_assignment.yml
+++ b/.github/pull_request_assignment.yml
@@ -28,7 +28,7 @@
     paths:
       - "specification/@(applicationinsights|operationalinsights)/**"
     reviewers:
-      - MyronFanQiu
+      - kairu-ms
 
 - rule:
     paths: "specification/@(resources|powerplatform)/**"
diff --git a/CODEOWNERS b/CODEOWNERS
index 85d25e6344a8..c191c63fa8eb 100644
--- a/CODEOWNERS
+++ b/CODEOWNERS
@@ -1,7 +1,7 @@
 /specification/analysisservices/ @taiwu
 /specification/alertsmanagement/ @ofirmanor @olalavi @erangon @orieldar @ilaizi @shakednai1 @khaboasb @orenhor
 /specification/apimanagement/ @promoisha @solankisamir
-/specification/applicationinsights/ @alexeldeib @reyang @TimothyMothra @ramthi @rajkumar-rangaraj @markwolff @trask @hectorhdzg @lzchen
+/specification/applicationinsights/ @alexeldeib @ramthi @markwolff @trask @hectorhdzg @lzchen
 /specification/asazure/ @athipp
 /specification/authorization/ @darshanhs90 @stankovski
 /specification/automation/ @vrdmr
@@ -58,7 +58,7 @@
 /specification/recoveryservicessiterecovery/ @avneeshrai
 /specification/redis/ @siddharthchatrolams @timlovellsmith
 /specification/relay/ @sethmanheim @v-ajnava
-/specification/resources/ @Tiano2017 @rajshah11 @vivsriaus
+/specification/resources/ @Azure/arm-template-deployments @rajshah11 @vivsriaus
 /specification/scheduler/ @pinwang81
 /specification/search/data-plane/ @brjohnstmsft @arv100kri @bleroy @heaths @AlexGhiondea
 /specification/search/resource-manager/ @abhi1509 @miwelsh @tjacobhi
diff --git a/custom-words.txt b/custom-words.txt
index b073225beb55..ae42b648994a 100644
--- a/custom-words.txt
+++ b/custom-words.txt
@@ -454,6 +454,7 @@ deleteconsumergroup
 deletedcertificates
 deletedkeys
 deletedsecrets
+deletedservices
 deletedstorage
 deletefailed
 deleteissuers
@@ -609,6 +610,7 @@ fileuploadout
 fileurl
 findsimilars
 findsquare
+firmwares
 fluentd
 forestsummary
 formrecognizer
@@ -675,6 +677,7 @@ Gloo
 gluster
 glusterfs
 GOARCH
+GPUP
 GPUs
 Grammarly
 GRANTACE
@@ -1818,6 +1821,7 @@ visualsearch
 visualstudio
 vlan
 vlanid
+vlans
 Vldb
 VM's
 vmextension
diff --git a/documentation/sdkautomation/sdk_customization.md b/documentation/sdkautomation/sdk_customization.md
index de083379fcf2..620ed6edfe57 100644
--- a/documentation/sdkautomation/sdk_customization.md
+++ b/documentation/sdkautomation/sdk_customization.md
@@ -777,7 +777,7 @@ Output of install instruction script.
 }
 ```
 
-#### InstallInstructionScriptInput Schema
+#### InstallInstructionScriptOutput Schema
 
 ```jsonc
 {
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/apimanagement.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/apimanagement.json
new file mode 100644
index 000000000000..dbe76ee7c35b
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/apimanagement.json
@@ -0,0 +1,765 @@
+{
+  "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": "2020-06-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": {},
+  "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"
+    },
+    "AppTypeParameter": {
+      "name": "appType",
+      "in": "query",
+      "required": false,
+      "type": "string",
+      "description": "Determines the type of application which send the create user request. Default is legacy publisher portal.",
+      "enum": [
+        "portal",
+        "developerPortal"
+      ],
+      "x-ms-enum": {
+        "name": "AppType",
+        "modelAsString": true,
+        "values": [
+          {
+            "value": "portal",
+            "description": "User create request was sent by legacy developer portal."
+          },
+          {
+            "value": "developerPortal",
+            "description": "User create request was sent by new developer portal."
+          }
+        ]
+      },
+      "default": "portal",
+      "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"
+    },
+    "ContentTypeIdParameter": {
+      "name": "contentTypeId",
+      "in": "path",
+      "required": true,
+      "type": "string",
+      "description": "Content type identifier.",
+      "minLength": 1,
+      "maxLength": 80,
+      "x-ms-parameter-location": "method"
+    },
+    "ContentItemIdParameter": {
+      "name": "contentItemId",
+      "in": "path",
+      "required": true,
+      "type": "string",
+      "description": "Content item identifier.",
+      "minLength": 1,
+      "maxLength": 80,
+      "x-ms-parameter-location": "method"
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/apimapis.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/apimapis.json
new file mode 100644
index 000000000000..4db90a55a476
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/apimapis.json
@@ -0,0 +1,4515 @@
+{
+  "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": "2020-06-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.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>| isCurrent | filter | eq, ne |  |</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": {
+          "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"
+            }
+          }
+        }
+      },
+      "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": {
+          "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"
+            }
+          }
+        }
+      },
+      "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": {
+          "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"
+            }
+          }
+        }
+      },
+      "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 was accepted."
+          },
+          "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": {
+          "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"
+            }
+          }
+        }
+      },
+      "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": {
+          "200": {
+            "description": "Api issue updated successfully.",
+            "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"
+            }
+          }
+        }
+      },
+      "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/preview/2020-06-01-preview/apimapisByTags.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/apimapisByTags.json
new file mode 100644
index 000000000000..218a30574d1b
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/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": "2020-06-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.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     |     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>| 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>| isCurrent | filter | eq |     |</br>"
+          },
+          {
+            "$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/preview/2020-06-01-preview/apimapiversionsets.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/apimapiversionsets.json
new file mode 100644
index 000000000000..83bd0afd7008
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/apimapiversionsets.json
@@ -0,0 +1,376 @@
+{
+  "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": "2020-06-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.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": {
+          "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"
+            }
+          }
+        }
+      },
+      "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/preview/2020-06-01-preview/apimauthorizationservers.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/apimauthorizationservers.json
new file mode 100644
index 000000000000..32e766c4c6c2
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/apimauthorizationservers.json
@@ -0,0 +1,427 @@
+{
+  "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": "2020-06-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.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. No secrets included.",
+            "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": {
+          "200": {
+            "description": "The authorization server settings 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/AuthorizationServerContract"
+            }
+          },
+          "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": {
+          "ApiManagementAuthorizationServerListSecrets": {
+            "$ref": "./examples/ApiManagementAuthorizationServerListSecrets.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 secrets of the specified authorization server.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/AuthorizationServerSecretsContract"
+            },
+            "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/preview/2020-06-01-preview/apimbackends.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/apimbackends.json
new file mode 100644
index 000000000000..dbcf80837dc1
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/apimbackends.json
@@ -0,0 +1,430 @@
+{
+  "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": "2020-06-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.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": {
+          "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"
+            }
+          }
+        }
+      },
+      "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/preview/2020-06-01-preview/apimcaches.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/apimcaches.json
new file mode 100644
index 000000000000..af87ef928dd6
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/apimcaches.json
@@ -0,0 +1,372 @@
+{
+  "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": "2020-06-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.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": {
+          "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"
+            }
+          }
+        }
+      },
+      "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/preview/2020-06-01-preview/apimcertificates.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/apimcertificates.json
new file mode 100644
index 000000000000..44928451f319
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/apimcertificates.json
@@ -0,0 +1,325 @@
+{
+  "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": "2020-06-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.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"
+          },
+          "ApiManagementGetCertificateWithKeyVault": {
+            "$ref": "./examples/ApiManagementGetCertificateWithKeyVault.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"
+          },
+          "ApiManagementCreateCertificateWithKeyVault": {
+            "$ref": "./examples/ApiManagementCreateCertificateWithKeyVault.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/preview/2020-06-01-preview/apimcontenttypes.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/apimcontenttypes.json
new file mode 100644
index 000000000000..f7807d846737
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/apimcontenttypes.json
@@ -0,0 +1,513 @@
+{
+  "swagger": "2.0",
+  "info": {
+    "title": "ApiManagementClient",
+    "description": "Use these REST APIs for performing operations in Azure API Management deployment.",
+    "version": "2020-06-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.ApiManagement/service/{serviceName}/contentTypes": {
+      "get": {
+        "tags": [
+          "ContentType"
+        ],
+        "operationId": "ContentType_ListByService",
+        "description": "Returns list of content types",
+        "x-ms-examples": {
+          "ApiManagementListContentTypes": {
+            "$ref": "./examples/ApiManagementListContentTypes.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 content type entities.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/ContentTypeCollection"
+            }
+          },
+          "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}/contentTypes/{contentTypeId}": {
+      "get": {
+        "tags": [
+          "ContentType"
+        ],
+        "operationId": "ContentType_Get",
+        "description": "Gets API Management content type details.",
+        "x-ms-examples": {
+          "ApiManagementGetContentType": {
+            "$ref": "./examples/ApiManagementGetContentType.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ContentTypeIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Get the details of the content type.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/ContentTypeContract"
+            },
+            "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": [
+          "ContentType"
+        ],
+        "operationId": "ContentType_CreateOrUpdate",
+        "description": "Creates or updates an Content Type.",
+        "x-ms-examples": {
+          "ApiManagementCreateContentType": {
+            "$ref": "./examples/ApiManagementCreateContentType.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ContentTypeIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/IfMatchOptionalParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "201": {
+            "description": "Content type 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/ContentTypeContract"
+            }
+          },
+          "200": {
+            "description": "The existing content type 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/ContentTypeContract"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "delete": {
+        "tags": [
+          "ContentType"
+        ],
+        "operationId": "ContentType_Delete",
+        "description": "Removes specified content type.",
+        "x-ms-examples": {
+          "ApiManagementDeleteContentType": {
+            "$ref": "./examples/ApiManagementDeleteContentType.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ContentTypeIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/IfMatchRequiredParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The content type was successfully deleted."
+          },
+          "204": {
+            "description": "The content type 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}/contentTypes/{contentTypeId}/contentItems": {
+      "get": {
+        "tags": [
+          "ContentTypeContentItem"
+        ],
+        "operationId": "ContentTypeContentItem_ListByService",
+        "description": "Returns list of content items",
+        "x-ms-examples": {
+          "ApiManagementListContentTypeContentItems": {
+            "$ref": "./examples/ApiManagementListContentTypeContentItems.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ContentTypeIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Lists a collection of Content Type entities.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/ContentItemCollection"
+            }
+          },
+          "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}/contentTypes/{contentTypeId}/contentItems/{contentItemId}": {
+      "head": {
+        "tags": [
+          "ContentTypeContentItem"
+        ],
+        "operationId": "ContentTypeContentItem_GetEntityTag",
+        "description": "Returns content item metadata",
+        "x-ms-examples": {
+          "ApiManagementHeadContentTypeContentItem": {
+            "$ref": "./examples/ApiManagementHeadContentTypeContentItem.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ContentTypeIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ContentItemIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Specified content item 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": [
+          "ContentTypeContentItem"
+        ],
+        "operationId": "ContentTypeContentItem_Get",
+        "description": "Returns content item details",
+        "x-ms-examples": {
+          "ApiManagementGetContentTypeContentItem": {
+            "$ref": "./examples/ApiManagementGetContentTypeContentItem.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ContentTypeIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ContentItemIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Get the details of the content item.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/ContentItemContract"
+            },
+            "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": [
+          "ContentTypeContentItem"
+        ],
+        "operationId": "ContentTypeContentItem_CreateOrUpdate",
+        "description": "Creates new content item",
+        "x-ms-examples": {
+          "ApiManagementCreateContentTypeContentItem": {
+            "$ref": "./examples/ApiManagementCreateContentTypeContentItem.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ContentTypeIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ContentItemIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/IfMatchOptionalParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "201": {
+            "description": "Content item 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/ContentItemContract"
+            }
+          },
+          "200": {
+            "description": "The existing content item 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/ContentItemContract"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "delete": {
+        "tags": [
+          "ContentTypeContentItem"
+        ],
+        "operationId": "ContentTypeContentItem_Delete",
+        "description": "Removes specified content item.",
+        "x-ms-examples": {
+          "ApiManagementDeleteContentTypeContentItem": {
+            "$ref": "./examples/ApiManagementDeleteContentTypeContentItem.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ContentTypeIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ContentItemIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/IfMatchRequiredParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The content item was successfully deleted."
+          },
+          "204": {
+            "description": "The content item 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/preview/2020-06-01-preview/apimdeletedservices.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/apimdeletedservices.json
new file mode 100644
index 000000000000..4a9f7b9f3a3f
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/apimdeletedservices.json
@@ -0,0 +1,175 @@
+{
+  "swagger": "2.0",
+  "info": {
+    "title": "ApiManagementClient",
+    "description": "Use these REST APIs for performing operations in Azure API Management deployment.",
+    "version": "2020-06-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.ApiManagement/deletedservices": {
+      "get": {
+        "tags": [
+          "DeletedService"
+        ],
+        "operationId": "DeletedServices_ListBySubscription",
+        "description": "Lists all soft-deleted services available for undelete for the given subscription.",
+        "x-ms-examples": {
+          "ApiManagementListRegions": {
+            "$ref": "./examples/ApiManagementDeletedServicesListBySubscription.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "List of all soft-deleted services available for undelete for the given subscription.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/DeletedServicesCollection"
+            }
+          },
+          "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/locations/{location}/deletedservices/{serviceName}": {
+      "get": {
+        "tags": [
+          "DeletedService"
+        ],
+        "operationId": "DeletedServices_GetByName",
+        "description": "Get soft-deleted Api Management Service by name.",
+        "x-ms-examples": {
+          "ApiManagementListRegions": {
+            "$ref": "./examples/ApiManagementGetDeletedServiceByName.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "name": "location",
+            "in": "path",
+            "required": true,
+            "type": "string",
+            "description": "The location of the deleted API Management service."
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Soft-deleted Api Management Service.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/DeletedServiceContract"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "delete": {
+        "tags": [
+          "DeletedService"
+        ],
+        "operationId": "DeletedServices_Purge",
+        "description": "Purges Api Management Service (deletes it with no option to undelete).",
+        "x-ms-examples": {
+          "ApiManagementListRegions": {
+            "$ref": "./examples/ApiManagementDeletedServicesPurge.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "name": "location",
+            "in": "path",
+            "required": true,
+            "type": "string",
+            "description": "The location of the deleted API Management service."
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Api Service was successfully purged."
+          },
+          "202": {
+            "description": "Api Service purge started.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/DeletedServiceContract"
+            }
+          },
+          "204": {
+            "description": "The service 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/preview/2020-06-01-preview/apimdeployment.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/apimdeployment.json
new file mode 100644
index 000000000000..48547abde3df
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/apimdeployment.json
@@ -0,0 +1,1593 @@
+{
+  "swagger": "2.0",
+  "info": {
+    "title": "ApiManagementClient",
+    "description": "Use these REST APIs to manage Azure API Management deployment.",
+    "version": "2020-06-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": {
+    "/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"
+          },
+          "ApiManagementCreateServiceInZones": {
+            "$ref": "./examples/ApiManagementCreateServiceInZones.json"
+          },
+          "ApiManagementUndelete": {
+            "$ref": "./examples/ApiManagementUndelete.json"
+          },
+          "ApiManagementCreateServiceWithCustomHostnameKeyVault": {
+            "$ref": "./examples/ApiManagementCreateServiceWithCustomHostnameKeyVault.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",
+            "Isolated"
+          ],
+          "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."
+              },
+              {
+                "value": "Isolated",
+                "description": "Isolated 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*"
+        },
+        "identityClientId": {
+          "type": "string",
+          "description": "System or User Assigned Managed identity clientId as generated by Azure AD, which has GET access to the keyVault containing the SSL certificate."
+        },
+        "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."
+        },
+        "zones": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "A list of availability zones denoting where the resource needs to come from."
+        },
+        "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, Premium and Isolated 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, Premium and Isolated 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, Premium and Isolated 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, Premium and Isolated 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."
+        },
+        "restore": {
+          "type": "boolean",
+          "description": "Undelete Api Management Service if it was previously soft-deleted. If this flag is specified and set to True all other properties will be ignored.",
+          "default": false
+        }
+      },
+      "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",
+            "Isolated"
+          ],
+          "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."
+              },
+              {
+                "value": "Isolated",
+                "description": "Isolated 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
+        },
+        "zones": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "A list of availability zones denoting where the resource needs to come from."
+        }
+      },
+      "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/preview/2020-06-01-preview/apimdiagnostics.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/apimdiagnostics.json
new file mode 100644
index 000000000000..a6bfde56707c
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/apimdiagnostics.json
@@ -0,0 +1,376 @@
+{
+  "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": "2020-06-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.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": {
+          "200": {
+            "description": "Diagnostic 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"
+            }
+          }
+        }
+      },
+      "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/preview/2020-06-01-preview/apimemailtemplates.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/apimemailtemplates.json
new file mode 100644
index 000000000000..c643ef434679
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/apimemailtemplates.json
@@ -0,0 +1,363 @@
+{
+  "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": "2020-06-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.ApiManagement/service/{serviceName}/templates": {
+      "get": {
+        "tags": [
+          "EmailTemplate"
+        ],
+        "operationId": "EmailTemplate_ListByService",
+        "description": "Gets all email templates",
+        "x-ms-examples": {
+          "ApiManagementListTemplates": {
+            "$ref": "./examples/ApiManagementListTemplates.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": {
+          "ApiManagementGetTemplate": {
+            "$ref": "./examples/ApiManagementGetTemplate.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": {
+          "ApiManagementCreateTemplate": {
+            "$ref": "./examples/ApiManagementCreateTemplate.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 API Management email template",
+        "x-ms-examples": {
+          "ApiManagementUpdateTemplate": {
+            "$ref": "./examples/ApiManagementUpdateTemplate.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/TemplateNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/IfMatchRequiredParameter"
+          },
+          {
+            "name": "parameters",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "./definitions.json#/definitions/EmailTemplateUpdateParameters"
+            },
+            "description": "Update parameters."
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "email template 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/EmailTemplateContract"
+            }
+          },
+          "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": {
+          "ApiManagementDeleteTemplate": {
+            "$ref": "./examples/ApiManagementDeleteTemplate.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/preview/2020-06-01-preview/apimgateways.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/apimgateways.json
new file mode 100644
index 000000000000..fcb04a5de2ef
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/apimgateways.json
@@ -0,0 +1,1036 @@
+{
+  "swagger": "2.0",
+  "info": {
+    "title": "ApiManagementClient",
+    "description": "Use these REST APIs for performing operations on Gateway entity in Azure API Management deployment.",
+    "version": "2020-06-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.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"
+          },
+          {
+            "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>| region | 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 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"
+        },
+        "x-ms-odata": "./definitions.json#/definitions/GatewayContract"
+      }
+    },
+    "/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": {
+          "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"
+            }
+          }
+        }
+      },
+      "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": {
+          "ApiManagementGatewayListKeys": {
+            "$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": {
+          "ApiManagementGatewayRegenerateKey": {
+            "$ref": "./examples/ApiManagementGatewayRegenerateKey.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/GatewayKeyRegenerationRequestContract"
+            }
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "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": {
+          "ApiManagementGatewayGenerateToken": {
+            "$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"
+          },
+          {
+            "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>| hostname | 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": "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"
+        },
+        "x-ms-odata": "./definitions.json#/definitions/GatewayHostnameConfigurationContract"
+      }
+    },
+    "/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": "Get details of a hostname configuration",
+        "x-ms-examples": {
+          "ApiManagementGetGatewayHostnameConfiguration": {
+            "$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/IfMatchOptionalParameter"
+          },
+          {
+            "name": "parameters",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "./definitions.json#/definitions/GatewayHostnameConfigurationContract"
+            }
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "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/IfMatchRequiredParameter"
+          },
+          {
+            "$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"
+          },
+          {
+            "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": "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"
+        },
+        "x-ms-odata": "./definitions.json#/definitions/ApiContract"
+      }
+    },
+    "/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/preview/2020-06-01-preview/apimgroups.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/apimgroups.json
new file mode 100644
index 000000000000..91cd3c56c573
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/apimgroups.json
@@ -0,0 +1,590 @@
+{
+  "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": "2020-06-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.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>| externalId | 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": {
+          "200": {
+            "description": "The group details were successfully updated.",
+            "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"
+            }
+          }
+        }
+      },
+      "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/preview/2020-06-01-preview/apimidentityprovider.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/apimidentityprovider.json
new file mode 100644
index 000000000000..3f4e1575f017
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/apimidentityprovider.json
@@ -0,0 +1,416 @@
+{
+  "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": "2020-06-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.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": {
+          "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"
+            }
+          }
+        }
+      },
+      "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": {
+          "ApiManagementIdentityProviderListSecrets": {
+            "$ref": "./examples/ApiManagementIdentityProviderListSecrets.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"
+            },
+            "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/preview/2020-06-01-preview/apimissues.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/apimissues.json
new file mode 100644
index 000000000000..fd1c939cc300
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/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": "2020-06-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.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/preview/2020-06-01-preview/apimloggers.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/apimloggers.json
new file mode 100644
index 000000000000..a12f9b4e8a01
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/apimloggers.json
@@ -0,0 +1,382 @@
+{
+  "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": "2020-06-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.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": {
+          "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"
+            }
+          }
+        }
+      },
+      "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"
+          },
+          {
+            "$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/preview/2020-06-01-preview/apimnamedvalues.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/apimnamedvalues.json
new file mode 100644
index 000000000000..f2963834eab4
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/apimnamedvalues.json
@@ -0,0 +1,450 @@
+{
+  "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": "2020-06-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.ApiManagement/service/{serviceName}/namedValues": {
+      "get": {
+        "tags": [
+          "NamedValue"
+        ],
+        "operationId": "NamedValue_ListByService",
+        "description": "Lists a collection of named values 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 named value 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 named value 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 named value 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 named value specified by its identifier.",
+        "x-ms-examples": {
+          "ApiManagementGetNamedValue": {
+            "$ref": "./examples/ApiManagementGetNamedValue.json"
+          },
+          "ApiManagementGetNamedValueWithKeyVault": {
+            "$ref": "./examples/ApiManagementGetNamedValueWithKeyVault.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 named value entity. No secrets included",
+            "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 named value.",
+        "x-ms-examples": {
+          "ApiManagementCreateNamedValue": {
+            "$ref": "./examples/ApiManagementCreateNamedValue.json"
+          },
+          "ApiManagementCreateNamedValueWithKeyVault": {
+            "$ref": "./examples/ApiManagementCreateNamedValueWithKeyVault.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 named value was accepted."
+          },
+          "201": {
+            "description": "Named value 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": "Named value 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 named value.",
+        "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 create or update named value was accepted."
+          },
+          "200": {
+            "description": "Named value 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 named value 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": "Named value was successfully deleted."
+          },
+          "204": {
+            "description": "Named value 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 of the named value specified by its identifier.",
+        "x-ms-examples": {
+          "ApiManagementNamedValueListValue": {
+            "$ref": "./examples/ApiManagementNamedValueListValue.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 named value secret.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/NamedValueSecretContract"
+            },
+            "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/preview/2020-06-01-preview/apimnetworkstatus.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/apimnetworkstatus.json
new file mode 100644
index 000000000000..564fe2ae3006
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/apimnetworkstatus.json
@@ -0,0 +1,222 @@
+{
+  "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": "2020-06-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.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"
+        },
+        "resourceType": {
+          "type": "string",
+          "description": "Resource Type."
+        },
+        "isOptional": {
+          "type": "boolean",
+          "description": "Whether this is optional."
+        }
+      },
+      "required": [
+        "name",
+        "status",
+        "lastUpdated",
+        "lastStatusChange",
+        "resourceType",
+        "isOptional"
+      ],
+      "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/preview/2020-06-01-preview/apimnotifications.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/apimnotifications.json
new file mode 100644
index 000000000000..fc5b13c4987a
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/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": "2020-06-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.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/preview/2020-06-01-preview/apimopenidconnectproviders.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/apimopenidconnectproviders.json
new file mode 100644
index 000000000000..aabb08d6082c
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/apimopenidconnectproviders.json
@@ -0,0 +1,427 @@
+{
+  "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": "2020-06-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.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 without secrets.",
+        "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 without secrets.",
+            "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": {
+          "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"
+            }
+          }
+        }
+      },
+      "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": {
+          "ApiManagementOpenidConnectProviderListSecrets": {
+            "$ref": "./examples/ApiManagementOpenidConnectProviderListSecrets.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 secrets.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/ClientSecretContract"
+            },
+            "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/preview/2020-06-01-preview/apimpolicies.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/apimpolicies.json
new file mode 100644
index 000000000000..003e1d0c1dfc
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/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": "2020-06-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.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/preview/2020-06-01-preview/apimpolicydescriptions.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/apimpolicydescriptions.json
new file mode 100644
index 000000000000..f785606df60c
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/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": "2020-06-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.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/preview/2020-06-01-preview/apimportalsettings.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/apimportalsettings.json
new file mode 100644
index 000000000000..39535195bb23
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/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": "2020-06-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.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/preview/2020-06-01-preview/apimproducts.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/apimproducts.json
new file mode 100644
index 000000000000..52d37b190db9
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/apimproducts.json
@@ -0,0 +1,1408 @@
+{
+  "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": "2020-06-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.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": {
+          "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"
+            }
+          }
+        }
+      },
+      "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/preview/2020-06-01-preview/apimproductsByTags.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/apimproductsByTags.json
new file mode 100644
index 000000000000..1a78d2509c88
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/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": "2020-06-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.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/preview/2020-06-01-preview/apimquotas.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/apimquotas.json
new file mode 100644
index 000000000000..8844236eb58f
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/apimquotas.json
@@ -0,0 +1,248 @@
+{
+  "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": "2020-06-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.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/QuotaCounterValueUpdateContract"
+            },
+            "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": {
+          "200": {
+            "description": "Updated Quota Counter Values.",
+            "schema": {
+              "$ref": "./definitions.json#/definitions/QuotaCounterCollection"
+            }
+          },
+          "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/QuotaCounterValueUpdateContract"
+            },
+            "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": {
+          "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"
+            }
+          }
+        }
+      }
+    }
+  },
+  "definitions": {},
+  "parameters": {}
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/apimregions.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/apimregions.json
new file mode 100644
index 000000000000..bb56f128de08
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/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": "2020-06-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.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/preview/2020-06-01-preview/apimreports.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/apimreports.json
new file mode 100644
index 000000000000..b354bcfddf3c
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/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": "2020-06-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.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/preview/2020-06-01-preview/apimsubscriptions.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/apimsubscriptions.json
new file mode 100644
index 000000000000..977d3c9f4b3a
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/apimsubscriptions.json
@@ -0,0 +1,523 @@
+{
+  "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": "2020-06-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.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"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/AppTypeParameter"
+          }
+        ],
+        "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"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/AppTypeParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The subscription 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/SubscriptionContract"
+            }
+          },
+          "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 specified Subscription keys.",
+        "x-ms-examples": {
+          "ApiManagementSubscriptionListSecrets": {
+            "$ref": "./examples/ApiManagementSubscriptionListSecrets.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"
+            },
+            "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/preview/2020-06-01-preview/apimtagresources.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/apimtagresources.json
new file mode 100644
index 000000000000..af73144bc8fc
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/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": "2020-06-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.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/preview/2020-06-01-preview/apimtags.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/apimtags.json
new file mode 100644
index 000000000000..d40b87031061
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/apimtags.json
@@ -0,0 +1,383 @@
+{
+  "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": "2020-06-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.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": {
+          "200": {
+            "description": "The tag 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/TagContract"
+            }
+          },
+          "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/preview/2020-06-01-preview/apimtenant.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/apimtenant.json
new file mode 100644
index 000000000000..9450224bdf04
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/apimtenant.json
@@ -0,0 +1,749 @@
+{
+  "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": "2020-06-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.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": {
+          "200": {
+            "description": "Tenant Access information was updated successfully.",
+            "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}/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/preview/2020-06-01-preview/apimusers.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/apimusers.json
new file mode 100644
index 000000000000..e3898d921ce7
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/apimusers.json
@@ -0,0 +1,724 @@
+{
+  "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": "2020-06-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.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."
+          },
+          {
+            "name": "notify",
+            "in": "query",
+            "required": false,
+            "type": "boolean",
+            "description": "Send an Email notification to the User."
+          },
+          {
+            "$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": {
+          "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"
+            }
+          }
+        }
+      },
+      "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"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/AppTypeParameter"
+          }
+        ],
+        "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"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/AppTypeParameter"
+          }
+        ],
+        "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/preview/2020-06-01-preview/definitions.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/definitions.json
new file mode 100644
index 000000000000..5e8dd300c1d9
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/definitions.json
@@ -0,0 +1,5907 @@
+{
+  "swagger": "2.0",
+  "info": {
+    "version": "2020-06-01-preview",
+    "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."
+    },
+    "AuthorizationServerSecretsContract": {
+      "properties": {
+        "clientSecret": {
+          "type": "string",
+          "description": "oAuth Authorization Server Secrets."
+        },
+        "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": "OAuth Server Secrets 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
+        },
+        "useFromLocation": {
+          "type": "string",
+          "description": "Location identifier to use cache from (should be either 'default' or valid Azure region identifier)",
+          "maxLength": 256
+        },
+        "resourceId": {
+          "type": "string",
+          "description": "Original uri of entity in external system cache points to",
+          "maxLength": 2000
+        }
+      },
+      "required": [
+        "connectionString",
+        "useFromLocation"
+      ],
+      "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
+        },
+        "useFromLocation": {
+          "type": "string",
+          "description": "Location identifier to use cache from (should be either 'default' or valid Azure region identifier)",
+          "maxLength": 256
+        },
+        "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"
+        },
+        "keyVault": {
+          "$ref": "#/definitions/KeyVaultContractProperties",
+          "description": "KeyVault location details of the certificate."
+        }
+      },
+      "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"
+        },
+        "keyVault": {
+          "$ref": "#/definitions/KeyVaultContractCreateProperties",
+          "description": "KeyVault location details of the certificate."
+        }
+      },
+      "description": "Parameters supplied to the CreateOrUpdate certificate operation."
+    },
+    "DataMasking": {
+      "properties": {
+        "queryParams": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/DataMaskingEntity"
+          },
+          "description": "Masking settings for Url query parameters"
+        },
+        "headers": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/DataMaskingEntity"
+          },
+          "description": "Masking settings for headers"
+        }
+      }
+    },
+    "DataMaskingEntity": {
+      "properties": {
+        "value": {
+          "type": "string",
+          "description": "The name of an entity to mask (e.g. a name of a header or a query parameter)."
+        },
+        "mode": {
+          "type": "string",
+          "enum": [
+            "Mask",
+            "Hide"
+          ],
+          "x-ms-enum": {
+            "name": "DataMaskingMode",
+            "modelAsString": true,
+            "values": [
+              {
+                "value": "Mask",
+                "description": "Mask the value of an entity."
+              },
+              {
+                "value": "Hide",
+                "description": "Hide the presence of an entity."
+              }
+            ]
+          },
+          "description": "Data masking mode."
+        }
+      }
+    },
+    "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."
+        },
+        "operationNameFormat": {
+          "type": "string",
+          "enum": [
+            "Name",
+            "Url"
+          ],
+          "x-ms-enum": {
+            "name": "OperationNameFormat",
+            "modelAsString": true,
+            "values": [
+              {
+                "value": "Name",
+                "description": "API_NAME;rev=API_REVISION - OPERATION_NAME"
+              },
+              {
+                "value": "Url",
+                "description": "HTTP_VERB URL"
+              }
+            ]
+          },
+          "description": "The format of the Operation Name for Application Insights telemetries. Default is Name."
+        }
+      },
+      "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."
+        },
+        "dataMasking": {
+          "$ref": "#/definitions/DataMasking",
+          "description": "Data masking 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."
+    },
+    "KeyVaultContractCreateProperties": {
+      "properties": {
+        "secretIdentifier": {
+          "type": "string",
+          "description": "Key vault secret identifier for fetching secret."
+        },
+        "identityClientId": {
+          "type": "string",
+          "description": "SystemAssignedIdentity or UserAssignedIdentity Client Id which will be used to access key vault secret."
+        }
+      },
+      "description": "Create keyVault contract details."
+    },
+    "KeyVaultContractProperties": {
+      "properties": {
+        "lastStatus": {
+          "$ref": "#/definitions/KeyVaultLastAccessStatusContractProperties",
+          "description": "Last time sync and refresh status of secret from key vault."
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "#/definitions/KeyVaultContractCreateProperties"
+        }
+      ],
+      "description": "KeyVault contract details."
+    },
+    "KeyVaultLastAccessStatusContractProperties": {
+      "properties": {
+        "code": {
+          "type": "string",
+          "description": "Last status code for sync and refresh of secret from key vault."
+        },
+        "message": {
+          "type": "string",
+          "description": "Details of the error else empty."
+        },
+        "timeStampUtc": {
+          "type": "string",
+          "format": "date-time",
+          "description": "Last time secret was accessed. The date conforms to the following format: `yyyy-MM-ddTHH:mm:ssZ` as specified by the ISO 8601 standard.\n"
+        }
+      },
+      "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",
+            "azureMonitor"
+          ],
+          "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."
+              },
+              {
+                "value": "azureMonitor",
+                "description": "Azure Monitor"
+              }
+            ]
+          }
+        },
+        "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"
+      ],
+      "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",
+            "azureMonitor"
+          ],
+          "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."
+              },
+              {
+                "value": "azureMonitor",
+                "description": "Azure Monitor"
+              }
+            ]
+          }
+        },
+        "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.",
+          "maxLength": 4096
+        },
+        "keyVault": {
+          "$ref": "#/definitions/KeyVaultContractCreateProperties",
+          "description": "KeyVault location details of the namedValue."
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "#/definitions/NamedValueEntityBaseParameters"
+        }
+      ],
+      "required": [
+        "displayName"
+      ],
+      "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.",
+          "maxLength": 4096
+        },
+        "keyVault": {
+          "$ref": "#/definitions/KeyVaultContractProperties",
+          "description": "KeyVault location details of the namedValue."
+        }
+      },
+      "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
+        },
+        "keyVault": {
+          "$ref": "#/definitions/KeyVaultContractCreateProperties",
+          "description": "KeyVault location details of the namedValue."
+        }
+      },
+      "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."
+    },
+    "QuotaCounterValueUpdateContract": {
+      "properties": {
+        "properties": {
+          "x-ms-client-flatten": true,
+          "$ref": "#/definitions/QuotaCounterValueContractProperties",
+          "description": "Quota counter value details."
+        }
+      },
+      "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 when the state is changed to the 'rejected'."
+        },
+        "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 when the state is changed to the 'rejected'."
+        },
+        "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 legacy portal.",
+          "enum": [
+            "portal",
+            "developerPortal"
+          ],
+          "x-ms-enum": {
+            "name": "AppType",
+            "modelAsString": true,
+            "values": [
+              {
+                "value": "portal",
+                "description": "User create request was sent by legacy developer portal."
+              },
+              {
+                "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."
+    },
+    "NamedValueSecretContract": {
+      "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"
+        },
+        "tls10Enabled": {
+          "type": "boolean",
+          "description": "Specifies if TLS 1.0 is supported"
+        },
+        "tls11Enabled": {
+          "type": "boolean",
+          "description": "Specifies if TLS 1.1 is supported"
+        },
+        "http2Enabled": {
+          "type": "boolean",
+          "description": "Specifies if HTTP/2.0 is supported"
+        }
+      },
+      "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."
+    },
+    "ContentTypeCollection": {
+      "properties": {
+        "value": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/ContentTypeContract"
+          },
+          "description": "Collection of content types.",
+          "readOnly": true
+        },
+        "nextLink": {
+          "type": "string",
+          "description": "Next page link, if any.",
+          "readOnly": true
+        }
+      },
+      "description": "Paged list of content types."
+    },
+    "ContentTypeContract": {
+      "properties": {
+        "properties": {
+          "x-ms-client-flatten": true,
+          "$ref": "#/definitions/ContentTypeContractProperties",
+          "description": "Properties of the content type."
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "./apimanagement.json#/definitions/Resource"
+        }
+      ],
+      "description": "Content type contract details."
+    },
+    "ContentTypeContractProperties": {
+      "properties": {
+        "id": {
+          "type": "string",
+          "description": "Content type identifier"
+        },
+        "name": {
+          "type": "string",
+          "description": "Content type name. Must be 1 to 250 characters long."
+        },
+        "description": {
+          "type": "string",
+          "description": "Content type description."
+        },
+        "schema": {
+          "type": "object",
+          "description": "Content type schema."
+        },
+        "version": {
+          "type": "string",
+          "description": "Content type version."
+        }
+      }
+    },
+    "ContentItemCollection": {
+      "properties": {
+        "value": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/ContentItemContract"
+          },
+          "description": "Collection of content items.",
+          "readOnly": true
+        },
+        "nextLink": {
+          "type": "string",
+          "description": "Next page link, if any.",
+          "readOnly": true
+        }
+      },
+      "description": "Paged list of content items."
+    },
+    "ContentItemContract": {
+      "properties": {
+        "properties": {
+          "x-ms-client-flatten": true,
+          "$ref": "#/definitions/ContentItemContractProperties",
+          "description": "Properties of the content item."
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "./apimanagement.json#/definitions/Resource"
+        }
+      ],
+      "description": "Content type contract details."
+    },
+    "ContentItemContractProperties": {
+      "properties": {},
+      "additionalProperties": true
+    },
+    "DeletedServicesCollection": {
+      "properties": {
+        "value": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/DeletedServiceContract"
+          },
+          "description": "Page values.",
+          "readOnly": true
+        },
+        "nextLink": {
+          "type": "string",
+          "description": "Next page link if any.",
+          "readOnly": true
+        }
+      },
+      "description": "Paged deleted Api Management Services List Representation."
+    },
+    "DeletedServiceContract": {
+      "properties": {
+        "properties": {
+          "x-ms-client-flatten": true,
+          "$ref": "#/definitions/DeletedServiceContractProperties",
+          "description": "Deleted Api Management Service details."
+        },
+        "location": {
+          "readOnly": true,
+          "type": "string",
+          "description": "Api Management Service Master Location."
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "./apimanagement.json#/definitions/Resource"
+        }
+      ],
+      "description": "Deleted Api Management Service information."
+    },
+    "DeletedServiceContractProperties": {
+      "properties": {
+        "serviceId": {
+          "type": "string",
+          "description": "Fully-qualified API Management Service Resource ID"
+        },
+        "scheduledPurgeDate": {
+          "type": "string",
+          "format": "date-time",
+          "description": "UTC Date and Time when the service will be automatically purged. The date conforms to the following format: yyyy-MM-ddTHH:mm:ssZ as specified by the ISO 8601 standard."
+        },
+        "deletionDate": {
+          "type": "string",
+          "format": "date-time",
+          "description": "UTC Timestamp when the service was soft-deleted. The date conforms to the following format: yyyy-MM-ddTHH:mm:ssZ as specified by the ISO 8601 standard."
+        }
+      }
+    }
+  },
+  "parameters": {}
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementApplyNetworkConfigurationUpdates.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementApplyNetworkConfigurationUpdates.json
new file mode 100644
index 000000000000..bcb094562c01
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementApplyNetworkConfigurationUpdates.json
@@ -0,0 +1,53 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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=2020-06-01-preview"
+      }
+    },
+    "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/preview/2020-06-01-preview/examples/ApiManagementAuthorizationServerListSecrets.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementAuthorizationServerListSecrets.json
new file mode 100644
index 000000000000..41d62225bcbb
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementAuthorizationServerListSecrets.json
@@ -0,0 +1,18 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "subscriptionId": "subid",
+    "authsid": "newauthServer2"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "clientSecret": "2",
+        "resourceOwnerUsername": "un",
+        "resourceOwnerPassword": "pwd"
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementBackendReconnect.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementBackendReconnect.json
new file mode 100644
index 000000000000..d731afb7bdea
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementBackendReconnect.json
@@ -0,0 +1,17 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "subscriptionId": "subid",
+    "backendId": "proxybackend",
+    "parameters": {
+      "properties": {
+        "after": "PT3S"
+      }
+    }
+  },
+  "responses": {
+    "202": {}
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementCreateAILogger.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementCreateAILogger.json
new file mode 100644
index 000000000000..8cf894468d7b
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementCreateAILogger.json
@@ -0,0 +1,51 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementCreateApi.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementCreateApi.json
new file mode 100644
index 000000000000..619b795d5b9c
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementCreateApi.json
@@ -0,0 +1,98 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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=2020-06-01-preview&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/preview/2020-06-01-preview/examples/ApiManagementCreateApiClone.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementCreateApiClone.json
new file mode 100644
index 000000000000..0d8e6c534d20
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementCreateApiClone.json
@@ -0,0 +1,79 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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=2020-06-01-preview&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/preview/2020-06-01-preview/examples/ApiManagementCreateApiDiagnostic.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementCreateApiDiagnostic.json
new file mode 100644
index 000000000000..ae3bdad89557
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementCreateApiDiagnostic.json
@@ -0,0 +1,160 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementCreateApiIssue.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementCreateApiIssue.json
new file mode 100644
index 000000000000..63725f8591b4
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementCreateApiIssue.json
@@ -0,0 +1,49 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementCreateApiIssueAttachment.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementCreateApiIssueAttachment.json
new file mode 100644
index 000000000000..0a18648f2fe7
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementCreateApiIssueAttachment.json
@@ -0,0 +1,44 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementCreateApiIssueComment.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementCreateApiIssueComment.json
new file mode 100644
index 000000000000..69548de02f8c
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementCreateApiIssueComment.json
@@ -0,0 +1,44 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementCreateApiNewVersionUsingExistingApi.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementCreateApiNewVersionUsingExistingApi.json
new file mode 100644
index 000000000000..033315e00ef2
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementCreateApiNewVersionUsingExistingApi.json
@@ -0,0 +1,95 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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=2020-06-01-preview&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/preview/2020-06-01-preview/examples/ApiManagementCreateApiOperation.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementCreateApiOperation.json
new file mode 100644
index 000000000000..76573a3df7c0
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementCreateApiOperation.json
@@ -0,0 +1,130 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementCreateApiOperationPolicy.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementCreateApiOperationPolicy.json
new file mode 100644
index 000000000000..54b38e94686e
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementCreateApiOperationPolicy.json
@@ -0,0 +1,40 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementCreateApiOperationTag.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementCreateApiOperationTag.json
new file mode 100644
index 000000000000..ae4f356cad94
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementCreateApiOperationTag.json
@@ -0,0 +1,33 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementCreateApiPolicy.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementCreateApiPolicy.json
new file mode 100644
index 000000000000..b9e309d08fe8
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementCreateApiPolicy.json
@@ -0,0 +1,39 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementCreateApiPolicyNonXmlEncoded.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementCreateApiPolicyNonXmlEncoded.json
new file mode 100644
index 000000000000..34d68490eeb9
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementCreateApiPolicyNonXmlEncoded.json
@@ -0,0 +1,39 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementCreateApiRelease.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementCreateApiRelease.json
new file mode 100644
index 000000000000..8a43aa5e8f81
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementCreateApiRelease.json
@@ -0,0 +1,44 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementCreateApiRevisionFromExistingApi.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementCreateApiRevisionFromExistingApi.json
new file mode 100644
index 000000000000..5eb9fc470247
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementCreateApiRevisionFromExistingApi.json
@@ -0,0 +1,68 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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=2020-06-01-preview&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/preview/2020-06-01-preview/examples/ApiManagementCreateApiSchema.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementCreateApiSchema.json
new file mode 100644
index 000000000000..1039cf587a0e
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementCreateApiSchema.json
@@ -0,0 +1,51 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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=2020-06-01-preview&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/preview/2020-06-01-preview/examples/ApiManagementCreateApiTag.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementCreateApiTag.json
new file mode 100644
index 000000000000..d99c49cd302e
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementCreateApiTag.json
@@ -0,0 +1,32 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementCreateApiTagDescription.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementCreateApiTagDescription.json
new file mode 100644
index 000000000000..50bce3a5eea9
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementCreateApiTagDescription.json
@@ -0,0 +1,47 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementCreateApiUsingImportOverrideServiceUrl.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementCreateApiUsingImportOverrideServiceUrl.json
new file mode 100644
index 000000000000..a26417815f8a
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementCreateApiUsingImportOverrideServiceUrl.json
@@ -0,0 +1,68 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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=2020-06-01-preview&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/preview/2020-06-01-preview/examples/ApiManagementCreateApiUsingOai3Import.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementCreateApiUsingOai3Import.json
new file mode 100644
index 000000000000..0af2e9e68fc1
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementCreateApiUsingOai3Import.json
@@ -0,0 +1,65 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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=2020-06-01-preview&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/preview/2020-06-01-preview/examples/ApiManagementCreateApiUsingSwaggerImport.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementCreateApiUsingSwaggerImport.json
new file mode 100644
index 000000000000..d6849bba079d
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementCreateApiUsingSwaggerImport.json
@@ -0,0 +1,67 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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=2020-06-01-preview&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/preview/2020-06-01-preview/examples/ApiManagementCreateApiUsingWadlImport.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementCreateApiUsingWadlImport.json
new file mode 100644
index 000000000000..ef9260d07344
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementCreateApiUsingWadlImport.json
@@ -0,0 +1,67 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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=2020-06-01-preview&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/preview/2020-06-01-preview/examples/ApiManagementCreateApiVersionSet.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementCreateApiVersionSet.json
new file mode 100644
index 000000000000..d4f40bf72928
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementCreateApiVersionSet.json
@@ -0,0 +1,42 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementCreateApiWithOpenIdConnect.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementCreateApiWithOpenIdConnect.json
new file mode 100644
index 000000000000..fad87e295026
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementCreateApiWithOpenIdConnect.json
@@ -0,0 +1,99 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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=2020-06-01-preview&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/preview/2020-06-01-preview/examples/ApiManagementCreateAuthorizationServer.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementCreateAuthorizationServer.json
new file mode 100644
index 000000000000..3333eb5e0051
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementCreateAuthorizationServer.json
@@ -0,0 +1,94 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementCreateBackendProxyBackend.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementCreateBackendProxyBackend.json
new file mode 100644
index 000000000000..9c110306f328
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementCreateBackendProxyBackend.json
@@ -0,0 +1,126 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementCreateBackendServiceFabric.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementCreateBackendServiceFabric.json
new file mode 100644
index 000000000000..d15296dc92df
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementCreateBackendServiceFabric.json
@@ -0,0 +1,87 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementCreateBackup.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementCreateBackup.json
new file mode 100644
index 000000000000..c2ba80f1eb19
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementCreateBackup.json
@@ -0,0 +1,126 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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=2020-06-01-preview"
+      }
+    },
+    "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/preview/2020-06-01-preview/examples/ApiManagementCreateCache.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementCreateCache.json
new file mode 100644
index 000000000000..ec7994160ed9
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementCreateCache.json
@@ -0,0 +1,45 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "subscriptionId": "subid",
+    "cacheId": "c1",
+    "parameters": {
+      "properties": {
+        "connectionString": "apim.redis.cache.windows.net:6380,password=xc,ssl=True,abortConnect=False",
+        "description": "Redis cache instances in West India",
+        "useFromLocation": "default",
+        "resourceId": "https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Cache/redis/apimservice1"
+      }
+    }
+  },
+  "responses": {
+    "201": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/caches/c1",
+        "type": "Microsoft.ApiManagement/service/caches",
+        "name": "c1",
+        "properties": {
+          "useFromLocation": "default",
+          "description": "Redis cache instances in West India",
+          "connectionString": "{{5f7fbca77a891a2200f3db38}}",
+          "resourceId": "https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Cache/redis/apimservice1"
+        }
+      }
+    },
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/caches/c1",
+        "type": "Microsoft.ApiManagement/service/caches",
+        "name": "c1",
+        "properties": {
+          "useFromLocation": "default",
+          "description": "Redis cache instances in West India",
+          "connectionString": "{{5f7fbca77a891a2200f3db38}}",
+          "resourceId": "https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Cache/redis/apimservice1"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementCreateCertificate.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementCreateCertificate.json
new file mode 100644
index 000000000000..1640c103bea6
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementCreateCertificate.json
@@ -0,0 +1,41 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementCreateCertificateWithKeyVault.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementCreateCertificateWithKeyVault.json
new file mode 100644
index 000000000000..c2945ea48098
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementCreateCertificateWithKeyVault.json
@@ -0,0 +1,59 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "subscriptionId": "subid",
+    "certificateId": "templateCertkv",
+    "parameters": {
+      "properties": {
+        "keyVault": {
+          "identityClientId": "ceaa6b06-c00f-43ef-99ac-f53d1fe876a0",
+          "secretIdentifier": "https://rpbvtkeyvaultintegration.vault-int.azure-int.net/secrets/msitestingCert"
+        }
+      }
+    }
+  },
+  "responses": {
+    "201": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/certificates/templateCertkv",
+        "type": "Microsoft.ApiManagement/service/certificates",
+        "name": "templateCertkv",
+        "properties": {
+          "subject": "CN=*.msitesting.net",
+          "thumbprint": "EA**********************9AD690",
+          "expirationDate": "2037-01-01T07:00:00Z",
+          "keyVault": {
+            "secretIdentifier": "https://rpbvtkeyvaultintegration.vault-int.azure-int.net/secrets/msitestingCert",
+            "identityClientId": "ceaa6b06-c00f-43ef-99ac-f53d1fe876a0",
+            "lastStatus": {
+              "code": "Success",
+              "timeStampUtc": "2020-09-22T00:24:53.3191468Z"
+            }
+          }
+        }
+      }
+    },
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/certificates/templateCertkv",
+        "type": "Microsoft.ApiManagement/service/certificates",
+        "name": "templateCertkv",
+        "properties": {
+          "subject": "CN=*.msitesting.net",
+          "thumbprint": "EA**********************9AD690",
+          "expirationDate": "2037-01-01T07:00:00Z",
+          "keyVault": {
+            "secretIdentifier": "https://rpbvtkeyvaultintegration.vault-int.azure-int.net/secrets/msitestingCert",
+            "identityClientId": "ceaa6b06-c00f-43ef-99ac-f53d1fe876a0",
+            "lastStatus": {
+              "code": "Success",
+              "timeStampUtc": "2020-09-22T00:24:53.3191468Z"
+            }
+          }
+        }
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementCreateContentType.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementCreateContentType.json
new file mode 100644
index 000000000000..8834d81790cb
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementCreateContentType.json
@@ -0,0 +1,177 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "subscriptionId": "subid",
+    "contentTypeId": "page",
+    "parameters": {
+      "properties": {
+        "name": "Page",
+        "description": "A regular page",
+        "schema": {
+          "properties": {
+            "en_us": {
+              "type": "object",
+              "properties": {
+                "title": {
+                  "title": "Title",
+                  "description": "Page title. This property gets included in SEO attributes.",
+                  "type": "string",
+                  "indexed": true
+                },
+                "description": {
+                  "title": "Description",
+                  "description": "Page description. This property gets included in SEO attributes.",
+                  "type": "string",
+                  "indexed": true
+                },
+                "keywords": {
+                  "title": "Keywords",
+                  "description": "Page keywords. This property gets included in SEO attributes.",
+                  "type": "string",
+                  "indexed": true
+                },
+                "permalink": {
+                  "title": "Permalink",
+                  "description": "Page permalink, e.g. '/about'.",
+                  "type": "string",
+                  "indexed": true
+                },
+                "documentId": {
+                  "title": "Document ID",
+                  "description": "Reference to page content document.",
+                  "type": "string"
+                }
+              },
+              "additionalProperties": false,
+              "required": [
+                "title",
+                "permalink",
+                "documentId"
+              ]
+            }
+          },
+          "additionalProperties": false
+        },
+        "version": "1.0.0"
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/contentTypes/page",
+        "type": "Microsoft.ApiManagement/service/contentTypes",
+        "name": "page",
+        "properties": {
+          "name": "Page",
+          "description": "A regular page",
+          "schema": {
+            "properties": {
+              "en_us": {
+                "type": "object",
+                "properties": {
+                  "title": {
+                    "title": "Title",
+                    "description": "Page title. This property gets included in SEO attributes.",
+                    "type": "string",
+                    "indexed": true
+                  },
+                  "description": {
+                    "title": "Description",
+                    "description": "Page description. This property gets included in SEO attributes.",
+                    "type": "string",
+                    "indexed": true
+                  },
+                  "keywords": {
+                    "title": "Keywords",
+                    "description": "Page keywords. This property gets included in SEO attributes.",
+                    "type": "string",
+                    "indexed": true
+                  },
+                  "permalink": {
+                    "title": "Permalink",
+                    "description": "Page permalink, e.g. '/about'.",
+                    "type": "string",
+                    "indexed": true
+                  },
+                  "documentId": {
+                    "title": "Document ID",
+                    "description": "Reference to page content document.",
+                    "type": "string"
+                  }
+                },
+                "additionalProperties": false,
+                "required": [
+                  "title",
+                  "permalink",
+                  "documentId"
+                ]
+              }
+            },
+            "additionalProperties": false
+          },
+          "version": "1.0.0"
+        }
+      }
+    },
+    "201": {
+      "body": {
+        "id": "/contentTypes/page",
+        "type": "Microsoft.ApiManagement/service/contentTypes",
+        "name": "page",
+        "properties": {
+          "name": "Page",
+          "description": "A regular page",
+          "schema": {
+            "properties": {
+              "en_us": {
+                "type": "object",
+                "properties": {
+                  "title": {
+                    "title": "Title",
+                    "description": "Page title. This property gets included in SEO attributes.",
+                    "type": "string",
+                    "indexed": true
+                  },
+                  "description": {
+                    "title": "Description",
+                    "description": "Page description. This property gets included in SEO attributes.",
+                    "type": "string",
+                    "indexed": true
+                  },
+                  "keywords": {
+                    "title": "Keywords",
+                    "description": "Page keywords. This property gets included in SEO attributes.",
+                    "type": "string",
+                    "indexed": true
+                  },
+                  "permalink": {
+                    "title": "Permalink",
+                    "description": "Page permalink, e.g. '/about'.",
+                    "type": "string",
+                    "indexed": true
+                  },
+                  "documentId": {
+                    "title": "Document ID",
+                    "description": "Reference to page content document.",
+                    "type": "string"
+                  }
+                },
+                "additionalProperties": false,
+                "required": [
+                  "title",
+                  "permalink",
+                  "documentId"
+                ]
+              }
+            },
+            "additionalProperties": false
+          },
+          "version": "1.0.0"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementCreateContentTypeContentItem.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementCreateContentTypeContentItem.json
new file mode 100644
index 000000000000..e5068f70e9c0
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementCreateContentTypeContentItem.json
@@ -0,0 +1,55 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "subscriptionId": "subid",
+    "contentTypeId": "page",
+    "contentItemId": "4e3cf6a5-574a-ba08-1f23-2e7a38faa6d8",
+    "parameters": {
+      "properties": {
+        "en_us": {
+          "title": "About",
+          "description": "Short story about the company.",
+          "keywords": "company, about",
+          "documentId": "contentTypes/document/contentItems/4e3cf6a5-574a-ba08-1f23-2e7a38faa6d8",
+          "permalink": "/about"
+        }
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/contentTypes/page/contentItems/4e3cf6a5-574a-ba08-1f23-2e7a38faa6d8",
+        "type": "Microsoft.ApiManagement/service/contentTypes/contentItems",
+        "name": "4e3cf6a5-574a-ba08-1f23-2e7a38faa6d8",
+        "properties": {
+          "en_us": {
+            "title": "About",
+            "description": "Short story about the company.",
+            "keywords": "company, about",
+            "documentId": "contentTypes/document/contentItems/4e3cf6a5-574a-ba08-1f23-2e7a38faa6d8",
+            "permalink": "/about"
+          }
+        }
+      }
+    },
+    "201": {
+      "body": {
+        "id": "/contentTypes/page/contentItems/4e3cf6a5-574a-ba08-1f23-2e7a38faa6d8",
+        "type": "Microsoft.ApiManagement/service/contentTypes/contentItems",
+        "name": "4e3cf6a5-574a-ba08-1f23-2e7a38faa6d8",
+        "properties": {
+          "en_us": {
+            "title": "About",
+            "description": "Short story about the company.",
+            "keywords": "company, about",
+            "documentId": "contentTypes/document/contentItems/4e3cf6a5-574a-ba08-1f23-2e7a38faa6d8",
+            "permalink": "/about"
+          }
+        }
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementCreateDiagnostic.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementCreateDiagnostic.json
new file mode 100644
index 000000000000..5d6be89af0ba
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementCreateDiagnostic.json
@@ -0,0 +1,159 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementCreateEHLogger.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementCreateEHLogger.json
new file mode 100644
index 000000000000..54029d45fd00
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementCreateEHLogger.json
@@ -0,0 +1,51 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "subscriptionId": "subid",
+    "loggerId": "eh1",
+    "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/eh1",
+        "type": "Microsoft.ApiManagement/service/loggers",
+        "name": "eh1",
+        "properties": {
+          "loggerType": "azureEventHub",
+          "description": "adding a new logger",
+          "credentials": {
+            "connectionString": "{{Logger-Credentials-5f28745bbebeeb13cc3f7301}}"
+          },
+          "isBuffered": true
+        }
+      }
+    },
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/loggers/eh1",
+        "type": "Microsoft.ApiManagement/service/loggers",
+        "name": "eh1",
+        "properties": {
+          "loggerType": "azureEventHub",
+          "description": "adding a new logger",
+          "credentials": {
+            "connectionString": "{{Logger-Credentials-5f28745bbebeeb13cc3f7301}}"
+          },
+          "isBuffered": true
+        }
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementCreateGateway.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementCreateGateway.json
new file mode 100644
index 000000000000..803c1cb3d0d7
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementCreateGateway.json
@@ -0,0 +1,45 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementCreateGatewayApi.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementCreateGatewayApi.json
new file mode 100644
index 000000000000..5df088b7b8f0
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementCreateGatewayApi.json
@@ -0,0 +1,61 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementCreateGatewayHostnameConfiguration.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementCreateGatewayHostnameConfiguration.json
new file mode 100644
index 000000000000..ead2d68bca64
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementCreateGatewayHostnameConfiguration.json
@@ -0,0 +1,52 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "subscriptionId": "subid",
+    "gatewayId": "gw1",
+    "hcId": "default",
+    "parameters": {
+      "properties": {
+        "hostname": "*",
+        "certificateId": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/certificates/cert1",
+        "negotiateClientCertificate": false,
+        "tls10Enabled": false,
+        "tls11Enabled": false,
+        "http2Enabled": true
+      }
+    }
+  },
+  "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,
+          "tls10Enabled": false,
+          "tls11Enabled": false,
+          "http2Enabled": true
+        }
+      }
+    },
+    "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,
+          "tls10Enabled": false,
+          "tls11Enabled": false,
+          "http2Enabled": true
+        }
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementCreateGroup.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementCreateGroup.json
new file mode 100644
index 000000000000..64865c2913f3
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementCreateGroup.json
@@ -0,0 +1,38 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementCreateGroupExternal.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementCreateGroupExternal.json
new file mode 100644
index 000000000000..7f8787a1d353
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementCreateGroupExternal.json
@@ -0,0 +1,45 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementCreateGroupUser.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementCreateGroupUser.json
new file mode 100644
index 000000000000..f53b3cac13ca
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementCreateGroupUser.json
@@ -0,0 +1,44 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementCreateIdentityProvider.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementCreateIdentityProvider.json
new file mode 100644
index 000000000000..6347ea5556b2
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementCreateIdentityProvider.json
@@ -0,0 +1,39 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementCreateMultiRegionServiceWithCustomHostname.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementCreateMultiRegionServiceWithCustomHostname.json
new file mode 100644
index 000000000000..b73a7cb5ad10
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementCreateMultiRegionServiceWithCustomHostname.json
@@ -0,0 +1,256 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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=2020-06-01-preview"
+      },
+      "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=2020-06-01-preview"
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementCreateNamedValue.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementCreateNamedValue.json
new file mode 100644
index 000000000000..760528dc73e7
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementCreateNamedValue.json
@@ -0,0 +1,59 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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=2020-06-01-preview&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/preview/2020-06-01-preview/examples/ApiManagementCreateNamedValueWithKeyVault.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementCreateNamedValueWithKeyVault.json
new file mode 100644
index 000000000000..c02c34c81364
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementCreateNamedValueWithKeyVault.json
@@ -0,0 +1,76 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "subscriptionId": "subid",
+    "namedValueId": "testprop6",
+    "parameters": {
+      "properties": {
+        "displayName": "prop6namekv",
+        "keyVault": {
+          "identityClientId": "ceaa6b06-c00f-43ef-99ac-f53d1fe876a0",
+          "secretIdentifier": "https://rpbvtkeyvaultintegration.vault-int.azure-int.net/secrets/msitestingCert"
+        },
+        "tags": [
+          "foo",
+          "bar"
+        ],
+        "secret": true
+      }
+    }
+  },
+  "responses": {
+    "202": {
+      "headers": {
+        "location": "https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/namedValues/testprop6?api-version=2020-06-01-preview&asyncId=5c730e343244df1b9cb56e85&asyncCode=201"
+      }
+    },
+    "201": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/namedValues/testprop6",
+        "type": "Microsoft.ApiManagement/service/namedValues",
+        "name": "testprop6",
+        "properties": {
+          "displayName": "prop6namekv",
+          "keyVault": {
+            "secretIdentifier": "https://rpbvtkeyvaultintegration.vault-int.azure-int.net/secrets/msitestingCert",
+            "identityClientId": "ceaa6b06-c00f-43ef-99ac-f53d1fe876a0",
+            "lastStatus": {
+              "code": "Success",
+              "timeStampUtc": "2020-09-11T00:54:31.8024882Z"
+            }
+          },
+          "tags": [
+            "foo",
+            "bar"
+          ],
+          "secret": true
+        }
+      }
+    },
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/namedValues/testprop6",
+        "type": "Microsoft.ApiManagement/service/namedValues",
+        "name": "testprop6",
+        "properties": {
+          "displayName": "prop6namekv",
+          "keyVault": {
+            "secretIdentifier": "https://rpbvtkeyvaultintegration.vault-int.azure-int.net/secrets/msitestingCert",
+            "identityClientId": "ceaa6b06-c00f-43ef-99ac-f53d1fe876a0",
+            "lastStatus": {
+              "code": "Success",
+              "timeStampUtc": "2020-09-11T00:54:31.8024882Z"
+            }
+          },
+          "tags": [
+            "foo",
+            "bar"
+          ],
+          "secret": true
+        }
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementCreateNotification.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementCreateNotification.json
new file mode 100644
index 000000000000..6b7d0297a34a
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementCreateNotification.json
@@ -0,0 +1,32 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementCreateNotificationRecipientEmail.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementCreateNotificationRecipientEmail.json
new file mode 100644
index 000000000000..f86dfd5e4b3f
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementCreateNotificationRecipientEmail.json
@@ -0,0 +1,32 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementCreateNotificationRecipientUser.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementCreateNotificationRecipientUser.json
new file mode 100644
index 000000000000..43c07a0097cf
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementCreateNotificationRecipientUser.json
@@ -0,0 +1,32 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementCreateOpenIdConnectProvider.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementCreateOpenIdConnectProvider.json
new file mode 100644
index 000000000000..7a4906b4933c
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementCreateOpenIdConnectProvider.json
@@ -0,0 +1,43 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementCreatePolicy.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementCreatePolicy.json
new file mode 100644
index 000000000000..76e8e5189275
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementCreatePolicy.json
@@ -0,0 +1,37 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementCreateProduct.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementCreateProduct.json
new file mode 100644
index 000000000000..9b564cd2f705
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementCreateProduct.json
@@ -0,0 +1,42 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementCreateProductApi.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementCreateProductApi.json
new file mode 100644
index 000000000000..4c95efb90c2e
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementCreateProductApi.json
@@ -0,0 +1,56 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementCreateProductGroup.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementCreateProductGroup.json
new file mode 100644
index 000000000000..0db31fe5d33d
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementCreateProductGroup.json
@@ -0,0 +1,38 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementCreateProductPolicy.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementCreateProductPolicy.json
new file mode 100644
index 000000000000..e963a2ae3f3a
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementCreateProductPolicy.json
@@ -0,0 +1,38 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementCreateProductTag.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementCreateProductTag.json
new file mode 100644
index 000000000000..401e565450dc
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementCreateProductTag.json
@@ -0,0 +1,32 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementCreateService.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementCreateService.json
new file mode 100644
index 000000000000..e30c9685040f
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementCreateService.json
@@ -0,0 +1,124 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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=2020-06-01-preview"
+      },
+      "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=2020-06-01-preview"
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementCreateServiceHavingMsi.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementCreateServiceHavingMsi.json
new file mode 100644
index 000000000000..5b587d61a0e0
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementCreateServiceHavingMsi.json
@@ -0,0 +1,119 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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=2020-06-01-preview"
+      },
+      "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=2020-06-01-preview"
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementCreateServiceInZones.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementCreateServiceInZones.json
new file mode 100644
index 000000000000..f3b8d7dc0323
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementCreateServiceInZones.json
@@ -0,0 +1,137 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "subscriptionId": "subid",
+    "parameters": {
+      "properties": {
+        "publisherEmail": "apim@autorestsdk.com",
+        "publisherName": "autorestsdk"
+      },
+      "sku": {
+        "name": "Premium",
+        "capacity": 1
+      },
+      "zones": [
+        "1",
+        "2"
+      ],
+      "location": "North europe",
+      "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=2020-06-01-preview"
+      },
+      "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": "North Europe",
+        "etag": "AAAAAAAiXto=",
+        "properties": {
+          "publisherEmail": "apim@autorestsdk.com",
+          "publisherName": "autorestsdk",
+          "notificationSenderEmail": "apimgmt-noreply@mail.windowsazure.com",
+          "provisioningState": "Created",
+          "targetProvisioningState": "Activating",
+          "createdAtUtc": "2020-07-28T23:18:14.6562474Z",
+          "hostnameConfigurations": [
+            {
+              "type": "Proxy",
+              "hostName": "apimService1.azure-api.net",
+              "negotiateClientCertificate": false,
+              "defaultSslBinding": true
+            }
+          ],
+          "virtualNetworkType": "None",
+          "disableGateway": false
+        },
+        "sku": {
+          "name": "Premium",
+          "capacity": 1
+        },
+        "zones": [
+          "1",
+          "2"
+        ]
+      }
+    },
+    "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": "North Europe",
+        "etag": "AAAAAAAiXvE=",
+        "properties": {
+          "publisherEmail": "apim@autorestsdk.com",
+          "publisherName": "autorestsdk",
+          "notificationSenderEmail": "apimgmt-noreply@mail.windowsazure.com",
+          "provisioningState": "Succeeded",
+          "targetProvisioningState": "",
+          "createdAtUtc": "2020-07-28T23:18:14.6562474Z",
+          "gatewayUrl": "https://apimService1.azure-api.net",
+          "gatewayRegionalUrl": "https://apimService1-northeurope-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": [
+            "20.54.34.66"
+          ],
+          "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
+        },
+        "sku": {
+          "name": "Premium",
+          "capacity": 1
+        },
+        "zones": [
+          "1",
+          "2"
+        ]
+      }
+    },
+    "202": {
+      "headers": {
+        "location": "https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/operationresults/dGVjaGVkX01hbmFnZVJvbGVfNWRiNGI3Ng==?api-version=2020-06-01-preview"
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementCreateServiceWithCustomHostnameKeyVault.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementCreateServiceWithCustomHostnameKeyVault.json
new file mode 100644
index 000000000000..e137b08d207c
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementCreateServiceWithCustomHostnameKeyVault.json
@@ -0,0 +1,256 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "subscriptionId": "subid",
+    "parameters": {
+      "properties": {
+        "hostnameConfigurations": [
+          {
+            "type": "Proxy",
+            "hostName": "gateway1.msitesting.net",
+            "keyVaultId": "https://rpbvtkeyvaultintegration.vault.azure.net/secrets/msitestingCert",
+            "identityClientId": "329419bc-adec-4dce-9568-25a6d486e468",
+            "defaultSslBinding": true
+          },
+          {
+            "type": "Management",
+            "hostName": "mgmt.msitesting.net",
+            "keyVaultId": "https://rpbvtkeyvaultintegration.vault.azure.net/secrets/msitestingCert",
+            "identityClientId": "329419bc-adec-4dce-9568-25a6d486e468"
+          },
+          {
+            "type": "Portal",
+            "hostName": "portal1.msitesting.net",
+            "keyVaultId": "https://rpbvtkeyvaultintegration.vault.azure.net/secrets/msitestingCert",
+            "identityClientId": "329419bc-adec-4dce-9568-25a6d486e468"
+          }
+        ],
+        "publisherEmail": "apim@autorestsdk.com",
+        "publisherName": "autorestsdk",
+        "virtualNetworkType": "None",
+        "apiVersionConstraint": {
+          "minApiVersion": "2019-01-01"
+        }
+      },
+      "sku": {
+        "name": "Premium",
+        "capacity": 1
+      },
+      "identity": {
+        "type": "UserAssigned",
+        "userAssignedIdentities": {
+          "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ManagedIdentity/userAssignedIdentities/id1": {}
+        }
+      },
+      "location": "North Europe",
+      "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=2020-06-01-preview"
+      },
+      "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": "North Europe",
+        "etag": "AAAAAAAigi8=",
+        "properties": {
+          "publisherEmail": "apim@autorestsdk.com",
+          "publisherName": "autorestsdk",
+          "notificationSenderEmail": "apimgmt-noreply@mail.windowsazure.com",
+          "provisioningState": "Created",
+          "targetProvisioningState": "Activating",
+          "createdAtUtc": "2020-09-13T22:30:20.7759747Z",
+          "hostnameConfigurations": [
+            {
+              "type": "Proxy",
+              "hostName": "apimService1.azure-api.net",
+              "negotiateClientCertificate": false,
+              "defaultSslBinding": false
+            },
+            {
+              "type": "Proxy",
+              "hostName": "gateway1.msitesting.net",
+              "keyVaultId": "https://rpbvtkeyvaultintegration.vault.azure.net/secrets/msitestingCert",
+              "negotiateClientCertificate": false,
+              "certificate": {
+                "expiry": "2037-01-01T07:00:00+00:00",
+                "thumbprint": "EA276907917CB5XXXXXXXXXXX690",
+                "subject": "CN=*.msitesting.net"
+              },
+              "defaultSslBinding": true,
+              "identityClientId": "329419bc-adec-4dce-9568-25a6d486e468"
+            },
+            {
+              "type": "Management",
+              "hostName": "mgmt.msitesting.net",
+              "keyVaultId": "https://rpbvtkeyvaultintegration.vault.azure.net/secrets/msitestingCert",
+              "negotiateClientCertificate": false,
+              "certificate": {
+                "expiry": "2037-01-01T07:00:00+00:00",
+                "thumbprint": "EA276907917CB5XXXXXXXXXXX690",
+                "subject": "CN=*.msitesting.net"
+              },
+              "defaultSslBinding": false,
+              "identityClientId": "329419bc-adec-4dce-9568-25a6d486e468"
+            },
+            {
+              "type": "Portal",
+              "hostName": "portal1.msitesting.net",
+              "keyVaultId": "https://rpbvtkeyvaultintegration.vault.azure.net/secrets/msitestingCert",
+              "negotiateClientCertificate": false,
+              "certificate": {
+                "expiry": "2037-01-01T07:00:00+00:00",
+                "thumbprint": "EA276907917CB5XXXXXXXXXXX690",
+                "subject": "CN=*.msitesting.net"
+              },
+              "defaultSslBinding": false,
+              "identityClientId": "329419bc-adec-4dce-9568-25a6d486e468"
+            }
+          ],
+          "virtualNetworkType": "None",
+          "disableGateway": false,
+          "apiVersionConstraint": {
+            "minApiVersion": "2019-01-01"
+          }
+        },
+        "sku": {
+          "name": "Premium",
+          "capacity": 1
+        },
+        "identity": {
+          "type": "UserAssigned",
+          "userAssignedIdentities": {
+            "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ManagedIdentity/userAssignedIdentities/id1": {}
+          }
+        }
+      }
+    },
+    "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": "North Europe",
+        "etag": "AAAAAAAigjU=",
+        "properties": {
+          "publisherEmail": "apim@autorestsdk.com",
+          "publisherName": "autorestsdk",
+          "notificationSenderEmail": "apimgmt-noreply@mail.windowsazure.com",
+          "provisioningState": "Succeeded",
+          "targetProvisioningState": "",
+          "createdAtUtc": "2020-09-13T22:30:20.7759747Z",
+          "gatewayUrl": "https://apimService1.azure-api.net",
+          "gatewayRegionalUrl": "https://apimService1-northeurope-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",
+              "keyVaultId": "https://rpbvtkeyvaultintegration.vault.azure.net/secrets/msitestingCert",
+              "negotiateClientCertificate": false,
+              "certificate": {
+                "expiry": "2037-01-01T07:00:00+00:00",
+                "thumbprint": "EA276907917CB5XXXXXXXXXXX690",
+                "subject": "CN=*.msitesting.net"
+              },
+              "defaultSslBinding": true,
+              "identityClientId": "329419bc-adec-4dce-9568-25a6d486e468"
+            },
+            {
+              "type": "Management",
+              "hostName": "mgmt.msitesting.net",
+              "keyVaultId": "https://rpbvtkeyvaultintegration.vault.azure.net/secrets/msitestingCert",
+              "negotiateClientCertificate": false,
+              "certificate": {
+                "expiry": "2037-01-01T07:00:00+00:00",
+                "thumbprint": "EA276907917CB5XXXXXXXXXXX690",
+                "subject": "CN=*.msitesting.net"
+              },
+              "defaultSslBinding": false,
+              "identityClientId": "329419bc-adec-4dce-9568-25a6d486e468"
+            },
+            {
+              "type": "Portal",
+              "hostName": "portal1.msitesting.net",
+              "keyVaultId": "https://rpbvtkeyvaultintegration.vault.azure.net/secrets/msitestingCert",
+              "negotiateClientCertificate": false,
+              "certificate": {
+                "expiry": "2037-01-01T07:00:00+00:00",
+                "thumbprint": "EA276907917CB5XXXXXXXXXXX690",
+                "subject": "CN=*.msitesting.net"
+              },
+              "defaultSslBinding": false,
+              "identityClientId": "329419bc-adec-4dce-9568-25a6d486e468"
+            }
+          ],
+          "publicIPAddresses": [
+            "40.112.74.192"
+          ],
+          "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
+        },
+        "identity": {
+          "type": "UserAssigned",
+          "tenantId": "f686d426-8d16-xxxx-xxxx-ab578e110ccd",
+          "userAssignedIdentities": {
+            "/subscriptions/subid/resourcegroups/rg1/providers/Microsoft.ManagedIdentity/userAssignedIdentities/id1": {
+              "principalId": "15e769b2-xxxx-xxxx-xxxx-3fd9a923ac3a",
+              "clientId": "329419bc-adec-4dce-9568-25a6d486e468"
+            }
+          }
+        }
+      }
+    },
+    "202": {
+      "headers": {
+        "location": "https://management.azure.com/subscriptions/subid/resourcegroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/operationresults/bXVsdGlob3N0bmFtZW11bHRpcmVnaW9uc2VydmljZV9BY3RfZjFiOTZhMjc=?api-version=2020-06-01-preview"
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementCreateServiceWithSystemCertificates.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementCreateServiceWithSystemCertificates.json
new file mode 100644
index 000000000000..04947bd314e9
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementCreateServiceWithSystemCertificates.json
@@ -0,0 +1,154 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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=2020-06-01-preview"
+      },
+      "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=2020-06-01-preview"
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementCreateServiceWithUserAssignedIdentity.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementCreateServiceWithUserAssignedIdentity.json
new file mode 100644
index 000000000000..17411e554208
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementCreateServiceWithUserAssignedIdentity.json
@@ -0,0 +1,136 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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=2020-06-01-preview"
+      },
+      "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=2020-06-01-preview"
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementCreateSoapPassThroughApiUsingWsdlImport.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementCreateSoapPassThroughApiUsingWsdlImport.json
new file mode 100644
index 000000000000..2f35ab4cac6b
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementCreateSoapPassThroughApiUsingWsdlImport.json
@@ -0,0 +1,72 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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=2020-06-01-preview&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/preview/2020-06-01-preview/examples/ApiManagementCreateSoapToRestApiUsingWsdlImport.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementCreateSoapToRestApiUsingWsdlImport.json
new file mode 100644
index 000000000000..7d3551631296
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementCreateSoapToRestApiUsingWsdlImport.json
@@ -0,0 +1,69 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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=2020-06-01-preview&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/preview/2020-06-01-preview/examples/ApiManagementCreateSubscription.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementCreateSubscription.json
new file mode 100644
index 000000000000..b89203c4f074
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementCreateSubscription.json
@@ -0,0 +1,46 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementCreateTag.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementCreateTag.json
new file mode 100644
index 000000000000..d2fac0799daf
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementCreateTag.json
@@ -0,0 +1,36 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementCreateTemplate.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementCreateTemplate.json
new file mode 100644
index 000000000000..a891904a89e5
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementCreateTemplate.json
@@ -0,0 +1,96 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementCreateUser.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementCreateUser.json
new file mode 100644
index 000000000000..9e65f5e1cc66
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementCreateUser.json
@@ -0,0 +1,61 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementDeleteApi.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementDeleteApi.json
new file mode 100644
index 000000000000..2456ef0d3f14
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementDeleteApi.json
@@ -0,0 +1,14 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "subscriptionId": "subid",
+    "apiId": "echo-api",
+    "If-Match": "*"
+  },
+  "responses": {
+    "200": {},
+    "204": {}
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementDeleteApiDiagnostic.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementDeleteApiDiagnostic.json
new file mode 100644
index 000000000000..ed91eddca0a5
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementDeleteApiDiagnostic.json
@@ -0,0 +1,15 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "subscriptionId": "subid",
+    "diagnosticId": "applicationinsights",
+    "apiId": "57d1f7558aa04f15146d9d8a",
+    "If-Match": "*"
+  },
+  "responses": {
+    "204": {},
+    "200": {}
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementDeleteApiIssue.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementDeleteApiIssue.json
new file mode 100644
index 000000000000..e5ac041d2e01
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementDeleteApiIssue.json
@@ -0,0 +1,15 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "subscriptionId": "subid",
+    "issueId": "57d2ef278aa04f0ad01d6cdc",
+    "apiId": "57d1f7558aa04f15146d9d8a",
+    "If-Match": "*"
+  },
+  "responses": {
+    "200": {},
+    "204": {}
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementDeleteApiIssueAttachment.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementDeleteApiIssueAttachment.json
new file mode 100644
index 000000000000..6260dcee32b6
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementDeleteApiIssueAttachment.json
@@ -0,0 +1,16 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "subscriptionId": "subid",
+    "issueId": "57d2ef278aa04f0ad01d6cdc",
+    "apiId": "57d1f7558aa04f15146d9d8a",
+    "attachmentId": "57d2ef278aa04f0888cba3f3",
+    "If-Match": "*"
+  },
+  "responses": {
+    "200": {},
+    "204": {}
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementDeleteApiIssueComment.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementDeleteApiIssueComment.json
new file mode 100644
index 000000000000..971bb981ed06
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementDeleteApiIssueComment.json
@@ -0,0 +1,16 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "subscriptionId": "subid",
+    "issueId": "57d2ef278aa04f0ad01d6cdc",
+    "apiId": "57d1f7558aa04f15146d9d8a",
+    "commentId": "599e29ab193c3c0bd0b3e2fb",
+    "If-Match": "*"
+  },
+  "responses": {
+    "200": {},
+    "204": {}
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementDeleteApiOperation.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementDeleteApiOperation.json
new file mode 100644
index 000000000000..a27085304ec3
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementDeleteApiOperation.json
@@ -0,0 +1,15 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "subscriptionId": "subid",
+    "apiId": "57d2ef278aa04f0888cba3f3",
+    "operationId": "57d2ef278aa04f0ad01d6cdc",
+    "If-Match": "*"
+  },
+  "responses": {
+    "200": {},
+    "204": {}
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementDeleteApiOperationPolicy.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementDeleteApiOperationPolicy.json
new file mode 100644
index 000000000000..6f8084f32a3b
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementDeleteApiOperationPolicy.json
@@ -0,0 +1,16 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "subscriptionId": "subid",
+    "apiId": "testapi",
+    "operationId": "testoperation",
+    "policyId": "policy",
+    "If-Match": "*"
+  },
+  "responses": {
+    "200": {},
+    "204": {}
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementDeleteApiOperationTag.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementDeleteApiOperationTag.json
new file mode 100644
index 000000000000..db7f26f86550
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementDeleteApiOperationTag.json
@@ -0,0 +1,16 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "subscriptionId": "subid",
+    "apiId": "59d5b28d1f7fab116c282650",
+    "operationId": "59d5b28d1f7fab116c282651",
+    "tagId": "59d5b28e1f7fab116402044e",
+    "If-Match": "*"
+  },
+  "responses": {
+    "200": {},
+    "204": {}
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementDeleteApiPolicy.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementDeleteApiPolicy.json
new file mode 100644
index 000000000000..77fb0e8801d9
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementDeleteApiPolicy.json
@@ -0,0 +1,15 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "subscriptionId": "subid",
+    "apiId": "loggerId",
+    "policyId": "policy",
+    "If-Match": "*"
+  },
+  "responses": {
+    "200": {},
+    "204": {}
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementDeleteApiRelease.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementDeleteApiRelease.json
new file mode 100644
index 000000000000..d122be6ed2b0
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementDeleteApiRelease.json
@@ -0,0 +1,15 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "subscriptionId": "subid",
+    "apiId": "5a5fcc09124a7fa9b89f2f1d",
+    "releaseId": "testrev",
+    "If-Match": "*"
+  },
+  "responses": {
+    "200": {},
+    "204": {}
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementDeleteApiSchema.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementDeleteApiSchema.json
new file mode 100644
index 000000000000..cb80dae93a18
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementDeleteApiSchema.json
@@ -0,0 +1,15 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "subscriptionId": "subid",
+    "apiId": "59d5b28d1f7fab116c282650",
+    "schemaId": "59d5b28e1f7fab116402044e",
+    "If-Match": "*"
+  },
+  "responses": {
+    "200": {},
+    "204": {}
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementDeleteApiTag.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementDeleteApiTag.json
new file mode 100644
index 000000000000..d63703e6e10b
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementDeleteApiTag.json
@@ -0,0 +1,15 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "subscriptionId": "subid",
+    "apiId": "59d5b28d1f7fab116c282650",
+    "tagId": "59d5b28e1f7fab116402044e",
+    "If-Match": "*"
+  },
+  "responses": {
+    "200": {},
+    "204": {}
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementDeleteApiTagDescription.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementDeleteApiTagDescription.json
new file mode 100644
index 000000000000..268d87f4419a
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementDeleteApiTagDescription.json
@@ -0,0 +1,15 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "subscriptionId": "subid",
+    "apiId": "59d5b28d1f7fab116c282650",
+    "tagDescriptionId": "59d5b28e1f7fab116402044e",
+    "If-Match": "*"
+  },
+  "responses": {
+    "200": {},
+    "204": {}
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementDeleteApiVersionSet.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementDeleteApiVersionSet.json
new file mode 100644
index 000000000000..61e2061e0723
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementDeleteApiVersionSet.json
@@ -0,0 +1,14 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "subscriptionId": "subid",
+    "versionSetId": "a1",
+    "If-Match": "*"
+  },
+  "responses": {
+    "204": {},
+    "200": {}
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementDeleteAuthorizationServer.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementDeleteAuthorizationServer.json
new file mode 100644
index 000000000000..7f0fcda1b0cd
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementDeleteAuthorizationServer.json
@@ -0,0 +1,14 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "subscriptionId": "subid",
+    "authsid": "newauthServer2",
+    "If-Match": "*"
+  },
+  "responses": {
+    "200": {},
+    "204": {}
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementDeleteBackend.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementDeleteBackend.json
new file mode 100644
index 000000000000..a821e9eaae13
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementDeleteBackend.json
@@ -0,0 +1,14 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "subscriptionId": "subid",
+    "backendId": "sfbackend",
+    "If-Match": "*"
+  },
+  "responses": {
+    "200": {},
+    "204": {}
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementDeleteCache.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementDeleteCache.json
new file mode 100644
index 000000000000..d6ced53735f2
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementDeleteCache.json
@@ -0,0 +1,14 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "subscriptionId": "subid",
+    "cacheId": "southindia",
+    "If-Match": "*"
+  },
+  "responses": {
+    "200": {},
+    "204": {}
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementDeleteCertificate.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementDeleteCertificate.json
new file mode 100644
index 000000000000..9a1043a366ca
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementDeleteCertificate.json
@@ -0,0 +1,14 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "subscriptionId": "subid",
+    "certificateId": "tempcert",
+    "If-Match": "*"
+  },
+  "responses": {
+    "200": {},
+    "204": {}
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementDeleteContentType.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementDeleteContentType.json
new file mode 100644
index 000000000000..43402d3c8e31
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementDeleteContentType.json
@@ -0,0 +1,14 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "subscriptionId": "subid",
+    "contentTypeId": "page",
+    "If-Match": "*"
+  },
+  "responses": {
+    "200": {},
+    "204": {}
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementDeleteContentTypeContentItem.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementDeleteContentTypeContentItem.json
new file mode 100644
index 000000000000..1bfdb49f901d
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementDeleteContentTypeContentItem.json
@@ -0,0 +1,15 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "subscriptionId": "subid",
+    "contentTypeId": "page",
+    "contentItemId": "4e3cf6a5-574a-ba08-1f23-2e7a38faa6d8",
+    "If-Match": "*"
+  },
+  "responses": {
+    "200": {},
+    "204": {}
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementDeleteDiagnostic.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementDeleteDiagnostic.json
new file mode 100644
index 000000000000..f2d7803ad4c3
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementDeleteDiagnostic.json
@@ -0,0 +1,14 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "subscriptionId": "subid",
+    "diagnosticId": "applicationinsights",
+    "If-Match": "*"
+  },
+  "responses": {
+    "200": {},
+    "204": {}
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementDeleteGateway.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementDeleteGateway.json
new file mode 100644
index 000000000000..f35a52f5db12
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementDeleteGateway.json
@@ -0,0 +1,14 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "subscriptionId": "subid",
+    "gatewayId": "gw1",
+    "If-Match": "*"
+  },
+  "responses": {
+    "200": {},
+    "204": {}
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementDeleteGatewayApi.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementDeleteGatewayApi.json
new file mode 100644
index 000000000000..ff9efa996b37
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementDeleteGatewayApi.json
@@ -0,0 +1,15 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "subscriptionId": "subid",
+    "gatewayId": "gw1",
+    "apiId": "echo-api",
+    "If-Match": "*"
+  },
+  "responses": {
+    "200": {},
+    "204": {}
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementDeleteGatewayHostnameConfiguration.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementDeleteGatewayHostnameConfiguration.json
new file mode 100644
index 000000000000..ada98bb25604
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementDeleteGatewayHostnameConfiguration.json
@@ -0,0 +1,15 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "subscriptionId": "subid",
+    "gatewayId": "gw1",
+    "hcId": "default",
+    "If-Match": "*"
+  },
+  "responses": {
+    "200": {},
+    "204": {}
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementDeleteGroup.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementDeleteGroup.json
new file mode 100644
index 000000000000..f1dd14a19465
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementDeleteGroup.json
@@ -0,0 +1,14 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "subscriptionId": "subid",
+    "groupId": "aadGroup",
+    "If-Match": "*"
+  },
+  "responses": {
+    "200": {},
+    "204": {}
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementDeleteGroupUser.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementDeleteGroupUser.json
new file mode 100644
index 000000000000..c510b3d8e152
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementDeleteGroupUser.json
@@ -0,0 +1,15 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "subscriptionId": "subid",
+    "groupId": "templategroup",
+    "userId": "59307d350af58404d8a26300",
+    "If-Match": "*"
+  },
+  "responses": {
+    "200": {},
+    "204": {}
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementDeleteIdentityProvider.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementDeleteIdentityProvider.json
new file mode 100644
index 000000000000..f94a8e439dbd
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementDeleteIdentityProvider.json
@@ -0,0 +1,14 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "subscriptionId": "subid",
+    "identityProviderName": "aad",
+    "If-Match": "*"
+  },
+  "responses": {
+    "200": {},
+    "204": {}
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementDeleteLogger.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementDeleteLogger.json
new file mode 100644
index 000000000000..c21bc0467cc9
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementDeleteLogger.json
@@ -0,0 +1,14 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "subscriptionId": "subid",
+    "loggerId": "loggerId",
+    "If-Match": "*"
+  },
+  "responses": {
+    "200": {},
+    "204": {}
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementDeleteNamedValue.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementDeleteNamedValue.json
new file mode 100644
index 000000000000..a7d49f4b2dca
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementDeleteNamedValue.json
@@ -0,0 +1,14 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "subscriptionId": "subid",
+    "namedValueId": "testprop2",
+    "If-Match": "*"
+  },
+  "responses": {
+    "200": {},
+    "204": {}
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementDeleteNotificationRecipientEmail.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementDeleteNotificationRecipientEmail.json
new file mode 100644
index 000000000000..39a8adf115e3
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementDeleteNotificationRecipientEmail.json
@@ -0,0 +1,14 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "subscriptionId": "subid",
+    "notificationName": "RequestPublisherNotificationMessage",
+    "email": "contoso@live.com"
+  },
+  "responses": {
+    "200": {},
+    "204": {}
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementDeleteNotificationRecipientUser.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementDeleteNotificationRecipientUser.json
new file mode 100644
index 000000000000..48d5d5a1a559
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementDeleteNotificationRecipientUser.json
@@ -0,0 +1,14 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "subscriptionId": "subid",
+    "notificationName": "RequestPublisherNotificationMessage",
+    "userId": "576823d0a40f7e74ec07d642"
+  },
+  "responses": {
+    "200": {},
+    "204": {}
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementDeleteOpenIdConnectProvider.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementDeleteOpenIdConnectProvider.json
new file mode 100644
index 000000000000..7fef910da865
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementDeleteOpenIdConnectProvider.json
@@ -0,0 +1,14 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "subscriptionId": "subid",
+    "opid": "templateOpenIdConnect3",
+    "If-Match": "*"
+  },
+  "responses": {
+    "200": {},
+    "204": {}
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementDeletePolicy.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementDeletePolicy.json
new file mode 100644
index 000000000000..1ab1440b69d6
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementDeletePolicy.json
@@ -0,0 +1,14 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "subscriptionId": "subid",
+    "policyId": "policy",
+    "If-Match": "*"
+  },
+  "responses": {
+    "200": {},
+    "204": {}
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementDeleteProduct.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementDeleteProduct.json
new file mode 100644
index 000000000000..8eddb2b6708c
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementDeleteProduct.json
@@ -0,0 +1,15 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "subscriptionId": "subid",
+    "productId": "testproduct",
+    "deleteSubscriptions": true,
+    "If-Match": "*"
+  },
+  "responses": {
+    "200": {},
+    "204": {}
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementDeleteProductApi.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementDeleteProductApi.json
new file mode 100644
index 000000000000..1ccaa6e85a42
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementDeleteProductApi.json
@@ -0,0 +1,15 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "subscriptionId": "subid",
+    "productId": "testproduct",
+    "apiId": "echo-api",
+    "If-Match": "*"
+  },
+  "responses": {
+    "200": {},
+    "204": {}
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementDeleteProductGroup.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementDeleteProductGroup.json
new file mode 100644
index 000000000000..f936f38fdf10
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementDeleteProductGroup.json
@@ -0,0 +1,15 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "subscriptionId": "subid",
+    "productId": "testproduct",
+    "groupId": "templateGroup",
+    "If-Match": "*"
+  },
+  "responses": {
+    "200": {},
+    "204": {}
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementDeleteProductPolicy.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementDeleteProductPolicy.json
new file mode 100644
index 000000000000..2bc395f622ba
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementDeleteProductPolicy.json
@@ -0,0 +1,15 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "subscriptionId": "subid",
+    "productId": "testproduct",
+    "policyId": "policy",
+    "If-Match": "*"
+  },
+  "responses": {
+    "200": {},
+    "204": {}
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementDeleteProductTag.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementDeleteProductTag.json
new file mode 100644
index 000000000000..f2071cdfa8d1
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementDeleteProductTag.json
@@ -0,0 +1,15 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "subscriptionId": "subid",
+    "productId": "59d5b28d1f7fab116c282650",
+    "tagId": "59d5b28e1f7fab116402044e",
+    "If-Match": "*"
+  },
+  "responses": {
+    "200": {},
+    "204": {}
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementDeleteSubscription.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementDeleteSubscription.json
new file mode 100644
index 000000000000..681081be8601
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementDeleteSubscription.json
@@ -0,0 +1,14 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "subscriptionId": "subid",
+    "sid": "testsub",
+    "If-Match": "*"
+  },
+  "responses": {
+    "200": {},
+    "204": {}
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementDeleteTag.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementDeleteTag.json
new file mode 100644
index 000000000000..4372de639b9d
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementDeleteTag.json
@@ -0,0 +1,14 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "subscriptionId": "subid",
+    "tagId": "tagId1",
+    "If-Match": "*"
+  },
+  "responses": {
+    "200": {},
+    "204": {}
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementDeleteTemplate.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementDeleteTemplate.json
new file mode 100644
index 000000000000..f120cb3ef528
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementDeleteTemplate.json
@@ -0,0 +1,14 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "subscriptionId": "subid",
+    "templateName": "newIssueNotificationMessage",
+    "If-Match": "*"
+  },
+  "responses": {
+    "200": {},
+    "204": {}
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementDeleteUser.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementDeleteUser.json
new file mode 100644
index 000000000000..68ccd33e4f53
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementDeleteUser.json
@@ -0,0 +1,14 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "subscriptionId": "subid",
+    "userId": "5931a75ae4bbd512288c680b",
+    "If-Match": "*"
+  },
+  "responses": {
+    "200": {},
+    "204": {}
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementDeletedServicesListBySubscription.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementDeletedServicesListBySubscription.json
new file mode 100644
index 000000000000..30c68daf5e51
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementDeletedServicesListBySubscription.json
@@ -0,0 +1,36 @@
+{
+  "parameters": {
+    "api-version": "2020-06-01-preview",
+    "subscriptionId": "subid"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "id": "/subscriptions/subid/providers/Microsoft.ApiManagement/locations/westus/deletedservices/apimService3",
+            "name": "apimService3",
+            "type": "Microsoft.ApiManagement/deletedservices",
+            "location": "West US",
+            "properties": {
+              "serviceId": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService3",
+              "scheduledPurgeDate": "2017-05-27T15:33:55.5426123Z",
+              "deletionDate": "2017-05-27T15:33:55.5426123Z"
+            }
+          },
+          {
+            "id": "/subscriptions/subid/providers/Microsoft.ApiManagement/locations/westus2/deletedservices/apimService",
+            "name": "apimService",
+            "type": "Microsoft.ApiManagement/deletedservices",
+            "location": "West US 2",
+            "properties": {
+              "serviceId": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService",
+              "scheduledPurgeDate": "2017-05-27T15:33:55.5426123Z",
+              "deletionDate": "2017-05-27T15:33:55.5426123Z"
+            }
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementDeletedServicesPurge.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementDeletedServicesPurge.json
new file mode 100644
index 000000000000..1f165c604d8a
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementDeletedServicesPurge.json
@@ -0,0 +1,28 @@
+{
+  "parameters": {
+    "serviceName": "apimService3",
+    "api-version": "2020-06-01-preview",
+    "subscriptionId": "subid",
+    "location": "westus"
+  },
+  "responses": {
+    "202": {
+      "headers": {
+        "location": "https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/locations/westus/deletedservices/apimService3/operationresults/TGV2eTExMDZtMDJfVGVybV9jMmZlY2QwMA==?api-version=2020-06-01-preview"
+      },
+      "body": {
+        "id": "/subscriptions/subid/providers/Microsoft.ApiManagement/locations/westus/deletedservices/apimService3",
+        "name": "apimService3",
+        "type": "Microsoft.ApiManagement/deletedservices",
+        "location": "West US",
+        "properties": {
+          "serviceId": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService3",
+          "scheduledPurgeDate": "2017-05-27T15:33:55.5426123Z",
+          "deletionDate": "2017-05-27T15:33:55.5426123Z"
+        }
+      }
+    },
+    "200": {},
+    "204": {}
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementGatewayGenerateToken.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementGatewayGenerateToken.json
new file mode 100644
index 000000000000..f0d339686d28
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementGatewayGenerateToken.json
@@ -0,0 +1,20 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementGatewayListKeys.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementGatewayListKeys.json
new file mode 100644
index 000000000000..b819136e3414
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementGatewayListKeys.json
@@ -0,0 +1,17 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "subscriptionId": "subid",
+    "gatewayId": "gw1"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "primary": "primary_key_value",
+        "secondary": "secondary_key_value"
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementGatewayRegenerateKey.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementGatewayRegenerateKey.json
new file mode 100644
index 000000000000..b0ef6fc56e46
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementGatewayRegenerateKey.json
@@ -0,0 +1,15 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "subscriptionId": "subid",
+    "gatewayId": "gwId",
+    "parameters": {
+      "keyType": "primary"
+    }
+  },
+  "responses": {
+    "204": {}
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementGetApiContract.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementGetApiContract.json
new file mode 100644
index 000000000000..fef873810558
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementGetApiContract.json
@@ -0,0 +1,34 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementGetApiDiagnostic.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementGetApiDiagnostic.json
new file mode 100644
index 000000000000..3f93b055ffee
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementGetApiDiagnostic.json
@@ -0,0 +1,57 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementGetApiExportInOpenApi2dot0.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementGetApiExportInOpenApi2dot0.json
new file mode 100644
index 000000000000..f512843cdd74
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementGetApiExportInOpenApi2dot0.json
@@ -0,0 +1,22 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementGetApiExportInOpenApi3dot0.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementGetApiExportInOpenApi3dot0.json
new file mode 100644
index 000000000000..f14fb80ee5c2
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementGetApiExportInOpenApi3dot0.json
@@ -0,0 +1,22 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementGetApiIssue.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementGetApiIssue.json
new file mode 100644
index 000000000000..7c4985a8e7c2
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementGetApiIssue.json
@@ -0,0 +1,27 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementGetApiIssueAttachment.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementGetApiIssueAttachment.json
new file mode 100644
index 000000000000..c3ce2e32b603
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementGetApiIssueAttachment.json
@@ -0,0 +1,25 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementGetApiIssueComment.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementGetApiIssueComment.json
new file mode 100644
index 000000000000..fcfb4193289c
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementGetApiIssueComment.json
@@ -0,0 +1,25 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementGetApiOperation.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementGetApiOperation.json
new file mode 100644
index 000000000000..248732ab7ebc
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementGetApiOperation.json
@@ -0,0 +1,53 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementGetApiOperationPetStore.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementGetApiOperationPetStore.json
new file mode 100644
index 000000000000..19332e3f6817
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementGetApiOperationPetStore.json
@@ -0,0 +1,91 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementGetApiOperationPolicy.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementGetApiOperationPolicy.json
new file mode 100644
index 000000000000..e059fe77279f
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementGetApiOperationPolicy.json
@@ -0,0 +1,23 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementGetApiOperationTag.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementGetApiOperationTag.json
new file mode 100644
index 000000000000..5cb9098006fd
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementGetApiOperationTag.json
@@ -0,0 +1,23 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementGetApiPolicy.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementGetApiPolicy.json
new file mode 100644
index 000000000000..202b43c3069d
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementGetApiPolicy.json
@@ -0,0 +1,22 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementGetApiRelease.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementGetApiRelease.json
new file mode 100644
index 000000000000..a43f08677b5b
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementGetApiRelease.json
@@ -0,0 +1,25 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementGetApiRevision.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementGetApiRevision.json
new file mode 100644
index 000000000000..0fc7f51db655
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementGetApiRevision.json
@@ -0,0 +1,32 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementGetApiSchema.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementGetApiSchema.json
new file mode 100644
index 000000000000..ec36f1b34797
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementGetApiSchema.json
@@ -0,0 +1,25 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementGetApiTag.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementGetApiTag.json
new file mode 100644
index 000000000000..720ba5cb103c
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementGetApiTag.json
@@ -0,0 +1,22 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementGetApiTagDescription.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementGetApiTagDescription.json
new file mode 100644
index 000000000000..9c89f046ddcc
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementGetApiTagDescription.json
@@ -0,0 +1,26 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementGetApiVersionSet.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementGetApiVersionSet.json
new file mode 100644
index 000000000000..5cd3a2fc3daf
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementGetApiVersionSet.json
@@ -0,0 +1,23 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementGetAuthorizationServer.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementGetAuthorizationServer.json
new file mode 100644
index 000000000000..68360d49e9c0
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementGetAuthorizationServer.json
@@ -0,0 +1,43 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementGetBackend.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementGetBackend.json
new file mode 100644
index 000000000000..1c91275b8805
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementGetBackend.json
@@ -0,0 +1,38 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementGetCache.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementGetCache.json
new file mode 100644
index 000000000000..4726f660414b
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementGetCache.json
@@ -0,0 +1,24 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "subscriptionId": "subid",
+    "cacheId": "c1"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/caches/c1",
+        "type": "Microsoft.ApiManagement/service/caches",
+        "name": "c1",
+        "properties": {
+          "useFromLocation": "default",
+          "description": "Redis cache instances in West India",
+          "connectionString": "{{5f7fbca77a891a2200f3db38}}",
+          "resourceId": "https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Cache/redis/apimservice1"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementGetCertificate.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementGetCertificate.json
new file mode 100644
index 000000000000..33526b16bf63
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementGetCertificate.json
@@ -0,0 +1,23 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementGetCertificateWithKeyVault.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementGetCertificateWithKeyVault.json
new file mode 100644
index 000000000000..9ec311ff43e4
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementGetCertificateWithKeyVault.json
@@ -0,0 +1,31 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "subscriptionId": "subid",
+    "certificateId": "templateCertkv"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/certificates/templateCertkv",
+        "type": "Microsoft.ApiManagement/service/certificates",
+        "name": "templateCertkv",
+        "properties": {
+          "subject": "CN=*.msitesting.net",
+          "thumbprint": "EA**********************9AD690",
+          "expirationDate": "2037-01-01T07:00:00Z",
+          "keyVault": {
+            "secretIdentifier": "https://rpbvtkeyvaultintegration.vault-int.azure-int.net/secrets/msitestingCert",
+            "identityClientId": "ceaa6b06-c00f-43ef-99ac-f53d1fe876a0",
+            "lastStatus": {
+              "code": "Success",
+              "timeStampUtc": "2020-09-22T00:24:53.3191468Z"
+            }
+          }
+        }
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementGetContentType.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementGetContentType.json
new file mode 100644
index 000000000000..3cbf82f676cb
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementGetContentType.json
@@ -0,0 +1,68 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "subscriptionId": "subid",
+    "contentTypeId": "page"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourcegroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/contentTypes/page",
+        "type": "Microsoft.ApiManagement/service/contentTypes",
+        "name": "page",
+        "properties": {
+          "name": "Page",
+          "description": "A regular page",
+          "schema": {
+            "properties": {
+              "en_us": {
+                "type": "object",
+                "properties": {
+                  "title": {
+                    "title": "Title",
+                    "description": "Page title. This property gets included in SEO attributes.",
+                    "type": "string",
+                    "indexed": true
+                  },
+                  "description": {
+                    "title": "Description",
+                    "description": "Page description. This property gets included in SEO attributes.",
+                    "type": "string",
+                    "indexed": true
+                  },
+                  "keywords": {
+                    "title": "Keywords",
+                    "description": "Page keywords. This property gets included in SEO attributes.",
+                    "type": "string",
+                    "indexed": true
+                  },
+                  "permalink": {
+                    "title": "Permalink",
+                    "description": "Page permalink, e.g. '/about'.",
+                    "type": "string",
+                    "indexed": true
+                  },
+                  "documentId": {
+                    "title": "Document ID",
+                    "description": "Reference to page content document.",
+                    "type": "string"
+                  }
+                },
+                "additionalProperties": false,
+                "required": [
+                  "title",
+                  "permalink",
+                  "documentId"
+                ]
+              }
+            },
+            "additionalProperties": false
+          },
+          "version": "1.0.0"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementGetContentTypeContentItem.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementGetContentTypeContentItem.json
new file mode 100644
index 000000000000..3992d40ee51e
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementGetContentTypeContentItem.json
@@ -0,0 +1,28 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "subscriptionId": "subid",
+    "contentTypeId": "page",
+    "contentItemId": "4e3cf6a5-574a-ba08-1f23-2e7a38faa6d8"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/contentTypes/page/contentItems/4e3cf6a5-574a-ba08-1f23-2e7a38faa6d8",
+        "type": "Microsoft.ApiManagement/service/contentTypes/contentItems",
+        "name": "4e3cf6a5-574a-ba08-1f23-2e7a38faa6d8",
+        "properties": {
+          "en_us": {
+            "title": "About",
+            "description": "Short story about the company.",
+            "keywords": "company, about",
+            "documentId": "contentTypes/document/contentItems/4e3cf6a5-574a-ba08-1f23-2e7a38faa6d8",
+            "permalink": "/about"
+          }
+        }
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementGetDeletedServiceByName.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementGetDeletedServiceByName.json
new file mode 100644
index 000000000000..6d85bea5a4b7
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementGetDeletedServiceByName.json
@@ -0,0 +1,23 @@
+{
+  "parameters": {
+    "serviceName": "apimService3",
+    "api-version": "2020-06-01-preview",
+    "subscriptionId": "subid",
+    "location": "westus"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/providers/Microsoft.ApiManagement/locations/westus/deletedservices/apimService3",
+        "name": "apimService3",
+        "type": "Microsoft.ApiManagement/deletedservices",
+        "location": "West US",
+        "properties": {
+          "serviceId": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService3",
+          "scheduledPurgeDate": "2017-05-27T15:33:55.5426123Z",
+          "deletionDate": "2017-05-27T15:33:55.5426123Z"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementGetDiagnostic.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementGetDiagnostic.json
new file mode 100644
index 000000000000..81fa6686e651
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementGetDiagnostic.json
@@ -0,0 +1,56 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementGetGateway.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementGetGateway.json
new file mode 100644
index 000000000000..81b39c802832
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementGetGateway.json
@@ -0,0 +1,24 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementGetGatewayHostnameConfiguration.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementGetGatewayHostnameConfiguration.json
new file mode 100644
index 000000000000..338c448706f0
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementGetGatewayHostnameConfiguration.json
@@ -0,0 +1,24 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementGetGroup.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementGetGroup.json
new file mode 100644
index 000000000000..833feaa62b7b
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementGetGroup.json
@@ -0,0 +1,25 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementGetIdentityProvider.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementGetIdentityProvider.json
new file mode 100644
index 000000000000..97b9e1488c7f
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementGetIdentityProvider.json
@@ -0,0 +1,30 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementGetIssue.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementGetIssue.json
new file mode 100644
index 000000000000..2239666930c1
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementGetIssue.json
@@ -0,0 +1,26 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementGetLogger.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementGetLogger.json
new file mode 100644
index 000000000000..e841df62dd1c
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementGetLogger.json
@@ -0,0 +1,28 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementGetNamedValue.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementGetNamedValue.json
new file mode 100644
index 000000000000..0f985ed9146a
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementGetNamedValue.json
@@ -0,0 +1,27 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementGetNamedValueWithKeyVault.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementGetNamedValueWithKeyVault.json
new file mode 100644
index 000000000000..57d4b52e8cb8
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementGetNamedValueWithKeyVault.json
@@ -0,0 +1,34 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "subscriptionId": "subid",
+    "namedValueId": "testprop6"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/namedValues/testprop6",
+        "type": "Microsoft.ApiManagement/service/namedValues",
+        "name": "testprop6",
+        "properties": {
+          "displayName": "prop6namekv",
+          "keyVault": {
+            "secretIdentifier": "https://rpbvtkeyvaultintegration.vault-int.azure-int.net/secrets/msitestingCert",
+            "identityClientId": "2d2df842-44d8-4885-8dec-77cc1a984a31",
+            "lastStatus": {
+              "code": "Success",
+              "timeStampUtc": "2020-09-11T00:54:31.8024882Z"
+            }
+          },
+          "tags": [
+            "foo",
+            "bar"
+          ],
+          "secret": true
+        }
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementGetNotification.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementGetNotification.json
new file mode 100644
index 000000000000..6b7d0297a34a
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementGetNotification.json
@@ -0,0 +1,32 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementGetOpenIdConnectProvider.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementGetOpenIdConnectProvider.json
new file mode 100644
index 000000000000..0530deb1d21a
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementGetOpenIdConnectProvider.json
@@ -0,0 +1,24 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementGetPolicy.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementGetPolicy.json
new file mode 100644
index 000000000000..6077b92eafd6
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementGetPolicy.json
@@ -0,0 +1,21 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementGetPolicyFormat.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementGetPolicyFormat.json
new file mode 100644
index 000000000000..48e37da34fe4
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementGetPolicyFormat.json
@@ -0,0 +1,23 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementGetProduct.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementGetProduct.json
new file mode 100644
index 000000000000..ca26615588fb
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementGetProduct.json
@@ -0,0 +1,26 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementGetProductPolicy.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementGetProductPolicy.json
new file mode 100644
index 000000000000..ff2e08733ea8
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementGetProductPolicy.json
@@ -0,0 +1,22 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementGetProductTag.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementGetProductTag.json
new file mode 100644
index 000000000000..61abf1257c81
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementGetProductTag.json
@@ -0,0 +1,22 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementGetQuotaCounterKeys.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementGetQuotaCounterKeys.json
new file mode 100644
index 000000000000..c620808ea72a
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementGetQuotaCounterKeys.json
@@ -0,0 +1,28 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementGetQuotaCounterKeysByQuotaPeriod.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementGetQuotaCounterKeysByQuotaPeriod.json
new file mode 100644
index 000000000000..9f2657010d1d
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementGetQuotaCounterKeysByQuotaPeriod.json
@@ -0,0 +1,24 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementGetReportsByApi.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementGetReportsByApi.json
new file mode 100644
index 000000000000..7fb71bd87239
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementGetReportsByApi.json
@@ -0,0 +1,55 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementGetReportsByGeo.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementGetReportsByGeo.json
new file mode 100644
index 000000000000..61123d73fbf6
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementGetReportsByGeo.json
@@ -0,0 +1,37 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementGetReportsByOperation.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementGetReportsByOperation.json
new file mode 100644
index 000000000000..044b3fac4edb
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementGetReportsByOperation.json
@@ -0,0 +1,76 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementGetReportsByProduct.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementGetReportsByProduct.json
new file mode 100644
index 000000000000..21670a33a873
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementGetReportsByProduct.json
@@ -0,0 +1,55 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementGetReportsByRequest.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementGetReportsByRequest.json
new file mode 100644
index 000000000000..229a04f6fb86
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementGetReportsByRequest.json
@@ -0,0 +1,56 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementGetReportsBySubscription.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementGetReportsBySubscription.json
new file mode 100644
index 000000000000..d5fe01338505
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementGetReportsBySubscription.json
@@ -0,0 +1,79 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementGetReportsByTime.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementGetReportsByTime.json
new file mode 100644
index 000000000000..92b4b0b48e3d
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementGetReportsByTime.json
@@ -0,0 +1,56 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementGetReportsByUser.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementGetReportsByUser.json
new file mode 100644
index 000000000000..a75bc98c2a2f
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementGetReportsByUser.json
@@ -0,0 +1,73 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementGetSubscription.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementGetSubscription.json
new file mode 100644
index 000000000000..b676ce95f821
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementGetSubscription.json
@@ -0,0 +1,25 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementGetTag.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementGetTag.json
new file mode 100644
index 000000000000..6731fe050098
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementGetTag.json
@@ -0,0 +1,21 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementGetTemplate.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementGetTemplate.json
new file mode 100644
index 000000000000..8cf2b0190cf2
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementGetTemplate.json
@@ -0,0 +1,51 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementGetTenantAccess.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementGetTenantAccess.json
new file mode 100644
index 000000000000..93932543df7f
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementGetTenantAccess.json
@@ -0,0 +1,17 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "subscriptionId": "subid",
+    "accessName": "access"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "5600b59375ff190048030003",
+        "enabled": true
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementGetUser.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementGetUser.json
new file mode 100644
index 000000000000..6bbdf2e206d4
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementGetUser.json
@@ -0,0 +1,31 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementHeadApi.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementHeadApi.json
new file mode 100644
index 000000000000..50b325e1b598
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementHeadApi.json
@@ -0,0 +1,16 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "subscriptionId": "subid",
+    "apiId": "57d1f7558aa04f15146d9d8a"
+  },
+  "responses": {
+    "200": {
+      "headers": {
+        "etag": "AAAAAAAAAAa="
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementHeadApiDiagnostic.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementHeadApiDiagnostic.json
new file mode 100644
index 000000000000..2ce252ee87b4
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementHeadApiDiagnostic.json
@@ -0,0 +1,17 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "subscriptionId": "subid",
+    "diagnosticId": "applicationinsights",
+    "apiId": "57d1f7558aa04f15146d9d8a"
+  },
+  "responses": {
+    "200": {
+      "headers": {
+        "etag": "AAAAAAAAAAa="
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementHeadApiIssue.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementHeadApiIssue.json
new file mode 100644
index 000000000000..fe58ac88b529
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementHeadApiIssue.json
@@ -0,0 +1,17 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "subscriptionId": "subid",
+    "apiId": "57d2ef278aa04f0888cba3f3",
+    "issueId": "57d2ef278aa04f0ad01d6cdc"
+  },
+  "responses": {
+    "200": {
+      "headers": {
+        "etag": "AAAAAAAAAAa="
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementHeadApiIssueAttachment.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementHeadApiIssueAttachment.json
new file mode 100644
index 000000000000..a4ea190a4bb9
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementHeadApiIssueAttachment.json
@@ -0,0 +1,18 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "subscriptionId": "subid",
+    "apiId": "57d2ef278aa04f0888cba3f3",
+    "issueId": "57d2ef278aa04f0ad01d6cdc",
+    "attachmentId": "57d2ef278aa04f0888cba3f3"
+  },
+  "responses": {
+    "200": {
+      "headers": {
+        "etag": "AAAAAAAAAAa="
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementHeadApiIssueComment.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementHeadApiIssueComment.json
new file mode 100644
index 000000000000..e6d4a6e777d6
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementHeadApiIssueComment.json
@@ -0,0 +1,18 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "subscriptionId": "subid",
+    "apiId": "57d2ef278aa04f0888cba3f3",
+    "issueId": "57d2ef278aa04f0ad01d6cdc",
+    "commentId": "599e29ab193c3c0bd0b3e2fb"
+  },
+  "responses": {
+    "200": {
+      "headers": {
+        "etag": "AAAAAAAAAAa="
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementHeadApiOperation.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementHeadApiOperation.json
new file mode 100644
index 000000000000..eded86f7d3f9
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementHeadApiOperation.json
@@ -0,0 +1,17 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "subscriptionId": "subid",
+    "apiId": "57d2ef278aa04f0888cba3f3",
+    "operationId": "57d2ef278aa04f0ad01d6cdc"
+  },
+  "responses": {
+    "200": {
+      "headers": {
+        "etag": "AAAAAAAAAAa="
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementHeadApiOperationPolicy.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementHeadApiOperationPolicy.json
new file mode 100644
index 000000000000..4e5592c7ed4a
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementHeadApiOperationPolicy.json
@@ -0,0 +1,18 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "subscriptionId": "subid",
+    "apiId": "5600b539c53f5b0062040001",
+    "operationId": "5600b53ac53f5b0062080006",
+    "policyId": "policy"
+  },
+  "responses": {
+    "200": {
+      "headers": {
+        "etag": "AAAAAAAAAAa="
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementHeadApiOperationTag.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementHeadApiOperationTag.json
new file mode 100644
index 000000000000..be8c80e887c4
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementHeadApiOperationTag.json
@@ -0,0 +1,18 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "subscriptionId": "subid",
+    "apiId": "59d6bb8f1f7fab13dc67ec9b",
+    "operationId": "59d6bb8f1f7fab13dc67ec9a",
+    "tagId": "59306a29e4bbd510dc24e5f9"
+  },
+  "responses": {
+    "200": {
+      "headers": {
+        "Etag": "AAAAAAAACCI="
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementHeadApiPolicy.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementHeadApiPolicy.json
new file mode 100644
index 000000000000..06fe21531066
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementHeadApiPolicy.json
@@ -0,0 +1,17 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "subscriptionId": "subid",
+    "apiId": "57d1f7558aa04f15146d9d8a",
+    "policyId": "policy"
+  },
+  "responses": {
+    "200": {
+      "headers": {
+        "etag": "AAAAAAAAAAa="
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementHeadApiRelease.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementHeadApiRelease.json
new file mode 100644
index 000000000000..1daa119850fb
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementHeadApiRelease.json
@@ -0,0 +1,17 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "subscriptionId": "subid",
+    "apiId": "a1",
+    "releaseId": "5a7cb545298324c53224a799"
+  },
+  "responses": {
+    "200": {
+      "headers": {
+        "etag": "AAAAAAAAAAa="
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementHeadApiSchema.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementHeadApiSchema.json
new file mode 100644
index 000000000000..53ada6295bbc
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementHeadApiSchema.json
@@ -0,0 +1,17 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "subscriptionId": "subid",
+    "apiId": "57d1f7558aa04f15146d9d8a",
+    "schemaId": "ec12520d-9d48-4e7b-8f39-698ca2ac63f1"
+  },
+  "responses": {
+    "200": {
+      "headers": {
+        "etag": "AAAAAAAAAAa="
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementHeadApiTag.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementHeadApiTag.json
new file mode 100644
index 000000000000..3af1593849f4
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementHeadApiTag.json
@@ -0,0 +1,17 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "subscriptionId": "subid",
+    "apiId": "59d6bb8f1f7fab13dc67ec9b",
+    "tagId": "59306a29e4bbd510dc24e5f9"
+  },
+  "responses": {
+    "200": {
+      "headers": {
+        "Etag": "AAAAAAAACCI="
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementHeadApiTagDescription.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementHeadApiTagDescription.json
new file mode 100644
index 000000000000..10013cf30dd9
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementHeadApiTagDescription.json
@@ -0,0 +1,17 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "subscriptionId": "subid",
+    "apiId": "59d6bb8f1f7fab13dc67ec9b",
+    "tagDescriptionId": "59306a29e4bbd510dc24e5f9"
+  },
+  "responses": {
+    "200": {
+      "headers": {
+        "Etag": "AAAAAAAACCI="
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementHeadApiVersionSet.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementHeadApiVersionSet.json
new file mode 100644
index 000000000000..19d74745c2a2
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementHeadApiVersionSet.json
@@ -0,0 +1,16 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "subscriptionId": "subid",
+    "versionSetId": "vs1"
+  },
+  "responses": {
+    "200": {
+      "headers": {
+        "etag": "AAAAAAAAAAa="
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementHeadAuthorizationServer.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementHeadAuthorizationServer.json
new file mode 100644
index 000000000000..b0cc21645f2d
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementHeadAuthorizationServer.json
@@ -0,0 +1,16 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "subscriptionId": "subid",
+    "authsid": "newauthServer2"
+  },
+  "responses": {
+    "200": {
+      "headers": {
+        "etag": "AAAAAAAAAAa="
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementHeadBackend.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementHeadBackend.json
new file mode 100644
index 000000000000..42880d255b50
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementHeadBackend.json
@@ -0,0 +1,16 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "subscriptionId": "subid",
+    "backendId": "sfbackend"
+  },
+  "responses": {
+    "200": {
+      "headers": {
+        "etag": "AAAAAAAAAAa="
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementHeadCache.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementHeadCache.json
new file mode 100644
index 000000000000..b8c234443954
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementHeadCache.json
@@ -0,0 +1,16 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "subscriptionId": "subid",
+    "cacheId": "default"
+  },
+  "responses": {
+    "200": {
+      "headers": {
+        "etag": "AAAAAAAAAAa="
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementHeadCertificate.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementHeadCertificate.json
new file mode 100644
index 000000000000..23cefcb4ef40
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementHeadCertificate.json
@@ -0,0 +1,16 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "subscriptionId": "subid",
+    "certificateId": "templateCert1"
+  },
+  "responses": {
+    "200": {
+      "headers": {
+        "etag": "AAAAAAAAAAa="
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementHeadContentTypeContentItem.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementHeadContentTypeContentItem.json
new file mode 100644
index 000000000000..06ed7f8ace4a
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementHeadContentTypeContentItem.json
@@ -0,0 +1,17 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "subscriptionId": "subid",
+    "contentTypeId": "page",
+    "contentItemId": "4e3cf6a5-574a-ba08-1f23-2e7a38faa6d8"
+  },
+  "responses": {
+    "200": {
+      "headers": {
+        "etag": "AAAAAAAAAAa="
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementHeadDelegationSettings.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementHeadDelegationSettings.json
new file mode 100644
index 000000000000..c47b61600d79
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementHeadDelegationSettings.json
@@ -0,0 +1,15 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "subscriptionId": "subid"
+  },
+  "responses": {
+    "200": {
+      "headers": {
+        "etag": "AAAAAAAAAAa="
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementHeadDiagnostic.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementHeadDiagnostic.json
new file mode 100644
index 000000000000..ec83014b9f40
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementHeadDiagnostic.json
@@ -0,0 +1,16 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "subscriptionId": "subid",
+    "diagnosticId": "applicationinsights"
+  },
+  "responses": {
+    "200": {
+      "headers": {
+        "etag": "AAAAAAAAAAa="
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementHeadEmailTemplate.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementHeadEmailTemplate.json
new file mode 100644
index 000000000000..1f8c05912c21
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementHeadEmailTemplate.json
@@ -0,0 +1,16 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "subscriptionId": "subid",
+    "templateName": "newIssueNotificationMessage"
+  },
+  "responses": {
+    "200": {
+      "headers": {
+        "etag": "AAAAAAAAAAa="
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementHeadGateway.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementHeadGateway.json
new file mode 100644
index 000000000000..79f8cc1a83f4
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementHeadGateway.json
@@ -0,0 +1,16 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "subscriptionId": "subid",
+    "gatewayId": "mygateway"
+  },
+  "responses": {
+    "200": {
+      "headers": {
+        "etag": "AAAAAAAAAAa="
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementHeadGatewayApi.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementHeadGatewayApi.json
new file mode 100644
index 000000000000..9fa9626c4ad5
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementHeadGatewayApi.json
@@ -0,0 +1,17 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "subscriptionId": "subid",
+    "gatewayId": "gw1",
+    "apiId": "api1"
+  },
+  "responses": {
+    "200": {
+      "headers": {
+        "Etag": "AAAAAAAACCI="
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementHeadGatewayHostnameConfiguration.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementHeadGatewayHostnameConfiguration.json
new file mode 100644
index 000000000000..e980097253ec
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementHeadGatewayHostnameConfiguration.json
@@ -0,0 +1,17 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "subscriptionId": "subid",
+    "gatewayId": "gw1",
+    "hcId": "default"
+  },
+  "responses": {
+    "200": {
+      "headers": {
+        "etag": "AAAAAAAAAAa="
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementHeadGroup.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementHeadGroup.json
new file mode 100644
index 000000000000..63649c50827d
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementHeadGroup.json
@@ -0,0 +1,16 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "subscriptionId": "subid",
+    "groupId": "59306a29e4bbd510dc24e5f9"
+  },
+  "responses": {
+    "200": {
+      "headers": {
+        "etag": "AAAAAAAAAAa="
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementHeadGroupUser.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementHeadGroupUser.json
new file mode 100644
index 000000000000..10171b29af03
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementHeadGroupUser.json
@@ -0,0 +1,14 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "subscriptionId": "subid",
+    "groupId": "59306a29e4bbd510dc24e5f9",
+    "userId": "5931a75ae4bbd512a88c680b"
+  },
+  "responses": {
+    "204": {},
+    "404": {}
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementHeadIdentityProvider.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementHeadIdentityProvider.json
new file mode 100644
index 000000000000..339a8b120b51
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementHeadIdentityProvider.json
@@ -0,0 +1,16 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "subscriptionId": "subid",
+    "identityProviderName": "aadB2C"
+  },
+  "responses": {
+    "200": {
+      "headers": {
+        "etag": "AAAAAAAAAAa="
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementHeadLogger.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementHeadLogger.json
new file mode 100644
index 000000000000..18a864d57e83
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementHeadLogger.json
@@ -0,0 +1,16 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "subscriptionId": "subid",
+    "loggerId": "templateLogger"
+  },
+  "responses": {
+    "200": {
+      "headers": {
+        "etag": "AAAAAAAAAAa="
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementHeadNamedValue.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementHeadNamedValue.json
new file mode 100644
index 000000000000..f783fa01c78b
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementHeadNamedValue.json
@@ -0,0 +1,16 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "subscriptionId": "subid",
+    "namedValueId": "testarmTemplateproperties2"
+  },
+  "responses": {
+    "200": {
+      "headers": {
+        "etag": "AAAAAAAAAAa="
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementHeadNotificationRecipientEmail.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementHeadNotificationRecipientEmail.json
new file mode 100644
index 000000000000..893611c4148a
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementHeadNotificationRecipientEmail.json
@@ -0,0 +1,14 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "subscriptionId": "subid",
+    "notificationName": "RequestPublisherNotificationMessage",
+    "email": "contoso@live.com"
+  },
+  "responses": {
+    "204": {},
+    "404": {}
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementHeadNotificationRecipientUser.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementHeadNotificationRecipientUser.json
new file mode 100644
index 000000000000..bcd278b46da6
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementHeadNotificationRecipientUser.json
@@ -0,0 +1,14 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "subscriptionId": "subid",
+    "notificationName": "RequestPublisherNotificationMessage",
+    "userId": "576823d0a40f7e74ec07d642"
+  },
+  "responses": {
+    "204": {},
+    "404": {}
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementHeadOpenIdConnectProvider.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementHeadOpenIdConnectProvider.json
new file mode 100644
index 000000000000..e48999ceb3b4
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementHeadOpenIdConnectProvider.json
@@ -0,0 +1,16 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "subscriptionId": "subid",
+    "opid": "templateOpenIdConnect2"
+  },
+  "responses": {
+    "200": {
+      "headers": {
+        "etag": "AAAAAAAAAAa="
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementHeadPolicy.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementHeadPolicy.json
new file mode 100644
index 000000000000..d2b2be6dba18
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementHeadPolicy.json
@@ -0,0 +1,16 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "subscriptionId": "subid",
+    "policyId": "policy"
+  },
+  "responses": {
+    "200": {
+      "headers": {
+        "etag": "AAAAAAAAAAa="
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementHeadProduct.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementHeadProduct.json
new file mode 100644
index 000000000000..bd71bdc6cd4f
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementHeadProduct.json
@@ -0,0 +1,16 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "subscriptionId": "subid",
+    "productId": "unlimited"
+  },
+  "responses": {
+    "200": {
+      "headers": {
+        "etag": "AAAAAAAAAAa="
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementHeadProductApi.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementHeadProductApi.json
new file mode 100644
index 000000000000..1b974f3b83f4
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementHeadProductApi.json
@@ -0,0 +1,13 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "subscriptionId": "subid",
+    "productId": "5931a75ae4bbd512a88c680b",
+    "apiId": "59306a29e4bbd510dc24e5f9"
+  },
+  "responses": {
+    "204": {}
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementHeadProductGroup.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementHeadProductGroup.json
new file mode 100644
index 000000000000..39852b18ff8f
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementHeadProductGroup.json
@@ -0,0 +1,13 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "subscriptionId": "subid",
+    "productId": "5931a75ae4bbd512a88c680b",
+    "groupId": "59306a29e4bbd510dc24e5f9"
+  },
+  "responses": {
+    "204": {}
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementHeadProductPolicy.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementHeadProductPolicy.json
new file mode 100644
index 000000000000..be455d591168
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementHeadProductPolicy.json
@@ -0,0 +1,17 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "subscriptionId": "subid",
+    "productId": "unlimited",
+    "policyId": "policy"
+  },
+  "responses": {
+    "200": {
+      "headers": {
+        "etag": "AAAAAAAAAAa="
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementHeadProductTag.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementHeadProductTag.json
new file mode 100644
index 000000000000..9833d5de0a83
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementHeadProductTag.json
@@ -0,0 +1,17 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "subscriptionId": "subid",
+    "productId": "59306a29e4bbd510dc24e5f8",
+    "tagId": "59306a29e4bbd510dc24e5f9"
+  },
+  "responses": {
+    "200": {
+      "headers": {
+        "Etag": "AAAAAAAACCI="
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementHeadSignInSettings.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementHeadSignInSettings.json
new file mode 100644
index 000000000000..c47b61600d79
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementHeadSignInSettings.json
@@ -0,0 +1,15 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "subscriptionId": "subid"
+  },
+  "responses": {
+    "200": {
+      "headers": {
+        "etag": "AAAAAAAAAAa="
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementHeadSignUpSettings.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementHeadSignUpSettings.json
new file mode 100644
index 000000000000..c47b61600d79
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementHeadSignUpSettings.json
@@ -0,0 +1,15 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "subscriptionId": "subid"
+  },
+  "responses": {
+    "200": {
+      "headers": {
+        "etag": "AAAAAAAAAAa="
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementHeadSubscription.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementHeadSubscription.json
new file mode 100644
index 000000000000..51def46e143d
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementHeadSubscription.json
@@ -0,0 +1,16 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "subscriptionId": "subid",
+    "sid": "5931a769d8d14f0ad8ce13b8"
+  },
+  "responses": {
+    "200": {
+      "headers": {
+        "etag": "AAAAAAAAAAa="
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementHeadTag.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementHeadTag.json
new file mode 100644
index 000000000000..8391eeef7436
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementHeadTag.json
@@ -0,0 +1,16 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "subscriptionId": "subid",
+    "tagId": "59306a29e4bbd510dc24e5f9"
+  },
+  "responses": {
+    "200": {
+      "headers": {
+        "Etag": "AAAAAAAACCI="
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementHeadTenantAccess.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementHeadTenantAccess.json
new file mode 100644
index 000000000000..7e52ca73be60
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementHeadTenantAccess.json
@@ -0,0 +1,12 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "subscriptionId": "subid",
+    "accessName": "access"
+  },
+  "responses": {
+    "200": {}
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementHeadUser.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementHeadUser.json
new file mode 100644
index 000000000000..4a74e419b4f8
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementHeadUser.json
@@ -0,0 +1,16 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "subscriptionId": "subid",
+    "userId": "5931a75ae4bbd512a88c680b"
+  },
+  "responses": {
+    "200": {
+      "headers": {
+        "etag": "AAAAAAAAAAa="
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementIdentityProviderListSecrets.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementIdentityProviderListSecrets.json
new file mode 100644
index 000000000000..6273dc91c38b
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementIdentityProviderListSecrets.json
@@ -0,0 +1,16 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "subscriptionId": "subid",
+    "identityProviderName": "aadB2C"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "clientSecret": "XXXXXXX"
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementListApiDiagnostics.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementListApiDiagnostics.json
new file mode 100644
index 000000000000..2c32c74665a7
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementListApiDiagnostics.json
@@ -0,0 +1,60 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementListApiIssueAttachments.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementListApiIssueAttachments.json
new file mode 100644
index 000000000000..efda0253ddde
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementListApiIssueAttachments.json
@@ -0,0 +1,29 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementListApiIssueComments.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementListApiIssueComments.json
new file mode 100644
index 000000000000..996a15abe6cb
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementListApiIssueComments.json
@@ -0,0 +1,29 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementListApiIssues.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementListApiIssues.json
new file mode 100644
index 000000000000..64b2cc085949
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementListApiIssues.json
@@ -0,0 +1,31 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementListApiOperationPolicies.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementListApiOperationPolicies.json
new file mode 100644
index 000000000000..eac6a7c3ded4
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementListApiOperationPolicies.json
@@ -0,0 +1,27 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementListApiOperationTags.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementListApiOperationTags.json
new file mode 100644
index 000000000000..54b576745bd3
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementListApiOperationTags.json
@@ -0,0 +1,27 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementListApiOperations.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementListApiOperations.json
new file mode 100644
index 000000000000..b6c0a2b7676e
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementListApiOperations.json
@@ -0,0 +1,69 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementListApiOperationsByTags.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementListApiOperationsByTags.json
new file mode 100644
index 000000000000..a4ace8f70931
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementListApiOperationsByTags.json
@@ -0,0 +1,32 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementListApiPolicies.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementListApiPolicies.json
new file mode 100644
index 000000000000..ce589c840a9c
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementListApiPolicies.json
@@ -0,0 +1,26 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementListApiProducts.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementListApiProducts.json
new file mode 100644
index 000000000000..e626dfce85e0
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementListApiProducts.json
@@ -0,0 +1,31 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementListApiReleases.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementListApiReleases.json
new file mode 100644
index 000000000000..dfe7fd84b39e
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementListApiReleases.json
@@ -0,0 +1,28 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementListApiRevisions.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementListApiRevisions.json
new file mode 100644
index 000000000000..8b6b42328b0e
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementListApiRevisions.json
@@ -0,0 +1,26 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementListApiSchemas.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementListApiSchemas.json
new file mode 100644
index 000000000000..538964ee2e23
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementListApiSchemas.json
@@ -0,0 +1,26 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementListApiTagDescriptions.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementListApiTagDescriptions.json
new file mode 100644
index 000000000000..4d84c70df645
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementListApiTagDescriptions.json
@@ -0,0 +1,29 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementListApiTags.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementListApiTags.json
new file mode 100644
index 000000000000..147c621553a0
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementListApiTags.json
@@ -0,0 +1,26 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementListApiVersionSets.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementListApiVersionSets.json
new file mode 100644
index 000000000000..f329e40a10ec
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementListApiVersionSets.json
@@ -0,0 +1,37 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementListApis.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementListApis.json
new file mode 100644
index 000000000000..db0d0849f41a
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementListApis.json
@@ -0,0 +1,81 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementListApisByTags.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementListApisByTags.json
new file mode 100644
index 000000000000..b396de8237e6
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementListApisByTags.json
@@ -0,0 +1,30 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementListAuthorizationServers.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementListAuthorizationServers.json
new file mode 100644
index 000000000000..e0df828f7b16
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementListAuthorizationServers.json
@@ -0,0 +1,74 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementListBackends.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementListBackends.json
new file mode 100644
index 000000000000..524eca3e55cc
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementListBackends.json
@@ -0,0 +1,80 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementListCaches.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementListCaches.json
new file mode 100644
index 000000000000..8e1e5ca24b5e
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementListCaches.json
@@ -0,0 +1,27 @@
+{
+  "parameters": {
+    "resourceGroupName": "rg1",
+    "serviceName": "apimService1",
+    "api-version": "2020-06-01-preview",
+    "subscriptionId": "subid"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/caches/c1",
+            "type": "Microsoft.ApiManagement/service/caches",
+            "name": "c1",
+            "properties": {
+              "useFromLocation": "default",
+              "description": "Redis cache instances in West India",
+              "connectionString": "{{5f7fbca77a891a2200f3db38}}",
+              "resourceId": "https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Cache/redis/apimservice1"
+            }
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementListCertificates.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementListCertificates.json
new file mode 100644
index 000000000000..4dd72b49e187
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementListCertificates.json
@@ -0,0 +1,45 @@
+{
+  "parameters": {
+    "resourceGroupName": "rg1",
+    "serviceName": "apimService1",
+    "api-version": "2020-06-01-preview",
+    "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"
+            }
+          },
+          {
+            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/certificates/templateCertkv",
+            "type": "Microsoft.ApiManagement/service/certificates",
+            "name": "templateCertkv",
+            "properties": {
+              "subject": "CN=*.msitesting.net",
+              "thumbprint": "EA**********************9AD690",
+              "expirationDate": "2037-01-01T07:00:00Z",
+              "keyVault": {
+                "secretIdentifier": "https://rpbvtkeyvaultintegration.vault-int.azure-int.net/secrets/msitestingCert",
+                "identityClientId": "ceaa6b06-c00f-43ef-99ac-f53d1fe876a0",
+                "lastStatus": {
+                  "code": "Success",
+                  "timeStampUtc": "2020-09-22T00:24:53.3191468Z"
+                }
+              }
+            }
+          }
+        ],
+        "nextLink": ""
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementListContentTypeContentItems.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementListContentTypeContentItems.json
new file mode 100644
index 000000000000..ff2a4e716b5f
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementListContentTypeContentItems.json
@@ -0,0 +1,31 @@
+{
+  "parameters": {
+    "resourceGroupName": "rg1",
+    "serviceName": "apimService1",
+    "api-version": "2020-06-01-preview",
+    "subscriptionId": "subid",
+    "contentTypeId": "page"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "id": "/contentTypes/page/contentItems/4e3cf6a5-574a-ba08-1f23-2e7a38faa6d8",
+            "type": "Microsoft.ApiManagement/service/contentTypes/contentItems",
+            "name": "4e3cf6a5-574a-ba08-1f23-2e7a38faa6d8",
+            "properties": {
+              "en_us": {
+                "title": "About",
+                "description": "Short story about the company.",
+                "keywords": "company, about",
+                "documentId": "contentTypes/document/contentItems/4e3cf6a5-574a-ba08-1f23-2e7a38faa6d8",
+                "permalink": "/about"
+              }
+            }
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementListContentTypes.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementListContentTypes.json
new file mode 100644
index 000000000000..077412fcfbd1
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementListContentTypes.json
@@ -0,0 +1,71 @@
+{
+  "parameters": {
+    "resourceGroupName": "rg1",
+    "serviceName": "apimService1",
+    "api-version": "2020-06-01-preview",
+    "subscriptionId": "subid"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "id": "/contentTypes/page",
+            "type": "Microsoft.ApiManagement/service/contentTypes",
+            "name": "page",
+            "properties": {
+              "name": "Page",
+              "description": "A regular page",
+              "schema": {
+                "properties": {
+                  "en_us": {
+                    "type": "object",
+                    "properties": {
+                      "title": {
+                        "title": "Title",
+                        "description": "Page title. This property gets included in SEO attributes.",
+                        "type": "string",
+                        "indexed": true
+                      },
+                      "description": {
+                        "title": "Description",
+                        "description": "Page description. This property gets included in SEO attributes.",
+                        "type": "string",
+                        "indexed": true
+                      },
+                      "keywords": {
+                        "title": "Keywords",
+                        "description": "Page keywords. This property gets included in SEO attributes.",
+                        "type": "string",
+                        "indexed": true
+                      },
+                      "permalink": {
+                        "title": "Permalink",
+                        "description": "Page permalink, e.g. '/about'.",
+                        "type": "string",
+                        "indexed": true
+                      },
+                      "documentId": {
+                        "title": "Document ID",
+                        "description": "Reference to page content document.",
+                        "type": "string"
+                      }
+                    },
+                    "additionalProperties": false,
+                    "required": [
+                      "title",
+                      "permalink",
+                      "documentId"
+                    ]
+                  }
+                },
+                "additionalProperties": false
+              },
+              "version": "1.0.0"
+            }
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementListDiagnostics.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementListDiagnostics.json
new file mode 100644
index 000000000000..b0a623a0bc7f
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementListDiagnostics.json
@@ -0,0 +1,73 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementListGatewayApis.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementListGatewayApis.json
new file mode 100644
index 000000000000..e94db2a0ea4d
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementListGatewayApis.json
@@ -0,0 +1,34 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementListGatewayHostnameConfigurations.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementListGatewayHostnameConfigurations.json
new file mode 100644
index 000000000000..0ffb5cc2a202
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementListGatewayHostnameConfigurations.json
@@ -0,0 +1,38 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementListGateways.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementListGateways.json
new file mode 100644
index 000000000000..94ab4066e519
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementListGateways.json
@@ -0,0 +1,39 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementListGroupUsers.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementListGroupUsers.json
new file mode 100644
index 000000000000..16d826ee40ff
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementListGroupUsers.json
@@ -0,0 +1,37 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementListGroups.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementListGroups.json
new file mode 100644
index 000000000000..72a61f4553b1
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementListGroups.json
@@ -0,0 +1,62 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementListIdentityProviders.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementListIdentityProviders.json
new file mode 100644
index 000000000000..c29bb8a0081e
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementListIdentityProviders.json
@@ -0,0 +1,52 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementListIssues.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementListIssues.json
new file mode 100644
index 000000000000..77f71015014f
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementListIssues.json
@@ -0,0 +1,30 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementListLoggers.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementListLoggers.json
new file mode 100644
index 000000000000..a729ca673b72
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementListLoggers.json
@@ -0,0 +1,51 @@
+{
+  "parameters": {
+    "resourceGroupName": "rg1",
+    "serviceName": "apimService1",
+    "api-version": "2020-06-01-preview",
+    "subscriptionId": "subid"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/loggers/azuremonitor",
+            "type": "Microsoft.ApiManagement/service/loggers",
+            "name": "azuremonitor",
+            "properties": {
+              "loggerType": "azureMonitor",
+              "isBuffered": true
+            }
+          },
+          {
+            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/loggers/vvktest",
+            "type": "Microsoft.ApiManagement/service/loggers",
+            "name": "vvktest",
+            "properties": {
+              "loggerType": "applicationInsights",
+              "credentials": {
+                "instrumentationKey": "{{Logger-Credentials-5b1a17ef2b3f91153004b10d}}"
+              },
+              "isBuffered": true
+            }
+          },
+          {
+            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/loggers/applicationinsights",
+            "type": "Microsoft.ApiManagement/service/loggers",
+            "name": "applicationinsights",
+            "properties": {
+              "loggerType": "applicationInsights",
+              "description": "miaoappinsight",
+              "credentials": {
+                "instrumentationKey": "{{Logger-Credentials-5b2056062b3f911ae84a3069}}"
+              },
+              "isBuffered": true
+            }
+          }
+        ],
+        "nextLink": ""
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementListNamedValues.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementListNamedValues.json
new file mode 100644
index 000000000000..eb5c84ef99f0
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementListNamedValues.json
@@ -0,0 +1,48 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/testprop6",
+            "type": "Microsoft.ApiManagement/service/namedValues",
+            "name": "testprop6",
+            "properties": {
+              "displayName": "prop6namekv",
+              "keyVault": {
+                "secretIdentifier": "https://rpbvtkeyvaultintegration.vault-int.azure-int.net/secrets/msitestingCert",
+                "identityClientId": "2d2df842-44d8-4885-8dec-77cc1a984a31",
+                "lastStatus": {
+                  "code": "Success",
+                  "timeStampUtc": "2020-09-11T00:54:31.8024882Z"
+                }
+              },
+              "tags": [
+                "foo",
+                "bar"
+              ],
+              "secret": true
+            }
+          }
+        ],
+        "nextLink": ""
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementListNotificationRecipientEmails.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementListNotificationRecipientEmails.json
new file mode 100644
index 000000000000..25bb6a21d20f
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementListNotificationRecipientEmails.json
@@ -0,0 +1,42 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementListNotificationRecipientUsers.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementListNotificationRecipientUsers.json
new file mode 100644
index 000000000000..77906dafa840
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementListNotificationRecipientUsers.json
@@ -0,0 +1,26 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementListNotifications.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementListNotifications.json
new file mode 100644
index 000000000000..45f47aa91f26
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementListNotifications.json
@@ -0,0 +1,126 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementListOpenIdConnectProviders.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementListOpenIdConnectProviders.json
new file mode 100644
index 000000000000..dd49e8285555
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementListOpenIdConnectProviders.json
@@ -0,0 +1,28 @@
+{
+  "parameters": {
+    "resourceGroupName": "rg1",
+    "serviceName": "apimService1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementListOperations.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementListOperations.json
new file mode 100644
index 000000000000..626e102fde6f
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementListOperations.json
@@ -0,0 +1,59 @@
+{
+  "parameters": {
+    "api-version": "2020-06-01-preview"
+  },
+  "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/preview/2020-06-01-preview/examples/ApiManagementListPolicies.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementListPolicies.json
new file mode 100644
index 000000000000..57512a308209
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementListPolicies.json
@@ -0,0 +1,25 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementListPolicyDescriptions.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementListPolicyDescriptions.json
new file mode 100644
index 000000000000..d4023ee28171
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementListPolicyDescriptions.json
@@ -0,0 +1,36 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementListProductApis.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementListProductApis.json
new file mode 100644
index 000000000000..b08a8253d794
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementListProductApis.json
@@ -0,0 +1,34 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementListProductGroups.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementListProductGroups.json
new file mode 100644
index 000000000000..2cd39b327237
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementListProductGroups.json
@@ -0,0 +1,51 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementListProductPolicies.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementListProductPolicies.json
new file mode 100644
index 000000000000..91d5451d3f77
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementListProductPolicies.json
@@ -0,0 +1,26 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementListProductSubscriptions.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementListProductSubscriptions.json
new file mode 100644
index 000000000000..75609168a95c
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementListProductSubscriptions.json
@@ -0,0 +1,29 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementListProductTags.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementListProductTags.json
new file mode 100644
index 000000000000..6858019dfc09
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementListProductTags.json
@@ -0,0 +1,26 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementListProducts.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementListProducts.json
new file mode 100644
index 000000000000..5e4609befdc1
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementListProducts.json
@@ -0,0 +1,55 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementListProductsByTags.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementListProductsByTags.json
new file mode 100644
index 000000000000..37d1513c8655
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementListProductsByTags.json
@@ -0,0 +1,32 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementListRegions.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementListRegions.json
new file mode 100644
index 000000000000..5b853c1ded22
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementListRegions.json
@@ -0,0 +1,23 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementListSKUs-Consumption.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementListSKUs-Consumption.json
new file mode 100644
index 000000000000..c69f25a2e01c
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementListSKUs-Consumption.json
@@ -0,0 +1,24 @@
+{
+  "parameters": {
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementListSKUs-Dedicated.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementListSKUs-Dedicated.json
new file mode 100644
index 000000000000..87b62d9a1beb
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementListSKUs-Dedicated.json
@@ -0,0 +1,77 @@
+{
+  "parameters": {
+    "api-version": "2020-06-01-preview",
+    "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"
+            }
+          },
+          {
+            "resourceType": "Microsoft.ApiManagement/service",
+            "sku": {
+              "name": "Isolated"
+            },
+            "capacity": {
+              "minimum": 1,
+              "maximum": 1,
+              "default": 1,
+              "scaleType": "automatic"
+            }
+          }
+        ],
+        "nextLink": null
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementListSecretsPortalSettingsValidationKey.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementListSecretsPortalSettingsValidationKey.json
new file mode 100644
index 000000000000..b7a67c34de9b
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementListSecretsPortalSettingsValidationKey.json
@@ -0,0 +1,15 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "subscriptionId": "subid"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "validationKey": "nVF7aKIvr9mV/RM5lOD0sYoi8ThXTRHQP7o66hvUmjCDkPKR3qxPu/otJcNciz2aQdqPuzJH3ECG4TU2yZjQ7Q=="
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementListSecretsTenantAccess.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementListSecretsTenantAccess.json
new file mode 100644
index 000000000000..0d36f2e5bf5d
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementListSecretsTenantAccess.json
@@ -0,0 +1,19 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementListServiceBySubscription.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementListServiceBySubscription.json
new file mode 100644
index 000000000000..4cdfc7cc390b
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementListServiceBySubscription.json
@@ -0,0 +1,164 @@
+{
+  "parameters": {
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementListServiceBySubscriptionAndResourceGroup.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementListServiceBySubscriptionAndResourceGroup.json
new file mode 100644
index 000000000000..c23bcd843757
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementListServiceBySubscriptionAndResourceGroup.json
@@ -0,0 +1,121 @@
+{
+  "parameters": {
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementListSubscriptions.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementListSubscriptions.json
new file mode 100644
index 000000000000..a56f8b34e014
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementListSubscriptions.json
@@ -0,0 +1,55 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementListTagResources.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementListTagResources.json
new file mode 100644
index 000000000000..d690c5a922c2
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementListTagResources.json
@@ -0,0 +1,61 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementListTags.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementListTags.json
new file mode 100644
index 000000000000..19333c4aea58
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementListTags.json
@@ -0,0 +1,33 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementListTemplates.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementListTemplates.json
new file mode 100644
index 000000000000..138810fa541d
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementListTemplates.json
@@ -0,0 +1,55 @@
+{
+  "parameters": {
+    "resourceGroupName": "rg1",
+    "serviceName": "apimService1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementListUserGroups.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementListUserGroups.json
new file mode 100644
index 000000000000..26014aa0203d
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementListUserGroups.json
@@ -0,0 +1,29 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementListUserIdentities.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementListUserIdentities.json
new file mode 100644
index 000000000000..7f3ee6429a8d
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementListUserIdentities.json
@@ -0,0 +1,22 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "subscriptionId": "subid",
+    "userId": "57f2af53bb17172280f44057"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "provider": "Microsoft",
+            "id": "086cf9********55ab"
+          }
+        ],
+        "nextLink": ""
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementListUserSubscriptions.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementListUserSubscriptions.json
new file mode 100644
index 000000000000..d8f0f7486dd2
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementListUserSubscriptions.json
@@ -0,0 +1,44 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementListUsers.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementListUsers.json
new file mode 100644
index 000000000000..f888f4e0996d
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementListUsers.json
@@ -0,0 +1,71 @@
+{
+  "parameters": {
+    "resourceGroupName": "rg1",
+    "serviceName": "apimService1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementNamedValueListValue.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementNamedValueListValue.json
new file mode 100644
index 000000000000..b215e1cdbaca
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementNamedValueListValue.json
@@ -0,0 +1,16 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "subscriptionId": "subid",
+    "namedValueId": "testarmTemplateproperties2"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": "propValue"
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementOpenidConnectProviderListSecrets.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementOpenidConnectProviderListSecrets.json
new file mode 100644
index 000000000000..1ad7560c42bf
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementOpenidConnectProviderListSecrets.json
@@ -0,0 +1,16 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "subscriptionId": "subid",
+    "opid": "templateOpenIdConnect2"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "clientSecret": "oidsecretproviderTemplate2"
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementPortalSettingsGetDelegation.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementPortalSettingsGetDelegation.json
new file mode 100644
index 000000000000..8dadd7eb8b4e
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementPortalSettingsGetDelegation.json
@@ -0,0 +1,26 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementPortalSettingsGetSignIn.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementPortalSettingsGetSignIn.json
new file mode 100644
index 000000000000..9ec33b58b927
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementPortalSettingsGetSignIn.json
@@ -0,0 +1,20 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementPortalSettingsGetSignUp.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementPortalSettingsGetSignUp.json
new file mode 100644
index 000000000000..38ef5dff521f
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementPortalSettingsGetSignUp.json
@@ -0,0 +1,25 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementPortalSettingsPutDelegation.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementPortalSettingsPutDelegation.json
new file mode 100644
index 000000000000..8bb69e9d27db
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementPortalSettingsPutDelegation.json
@@ -0,0 +1,40 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementPortalSettingsPutSignIn.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementPortalSettingsPutSignIn.json
new file mode 100644
index 000000000000..c01a06d9baf8
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementPortalSettingsPutSignIn.json
@@ -0,0 +1,27 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementPortalSettingsPutSignUp.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementPortalSettingsPutSignUp.json
new file mode 100644
index 000000000000..32e37f3b7559
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementPortalSettingsPutSignUp.json
@@ -0,0 +1,37 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementPortalSettingsUpdateDelegation.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementPortalSettingsUpdateDelegation.json
new file mode 100644
index 000000000000..0d101b20a8f2
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementPortalSettingsUpdateDelegation.json
@@ -0,0 +1,25 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementPortalSettingsUpdateSignIn.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementPortalSettingsUpdateSignIn.json
new file mode 100644
index 000000000000..a93c220bcf7f
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementPortalSettingsUpdateSignIn.json
@@ -0,0 +1,18 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "subscriptionId": "subid",
+    "userId": "5931a75ae4bbd512288c680b",
+    "If-Match": "*",
+    "parameters": {
+      "properties": {
+        "enabled": true
+      }
+    }
+  },
+  "responses": {
+    "204": {}
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementPortalSettingsUpdateSignUp.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementPortalSettingsUpdateSignUp.json
new file mode 100644
index 000000000000..c7a607e1c8cd
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementPortalSettingsUpdateSignUp.json
@@ -0,0 +1,23 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementRestoreService.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementRestoreService.json
new file mode 100644
index 000000000000..c2ba80f1eb19
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementRestoreService.json
@@ -0,0 +1,126 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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=2020-06-01-preview"
+      }
+    },
+    "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/preview/2020-06-01-preview/examples/ApiManagementServiceCheckNameAvailability.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementServiceCheckNameAvailability.json
new file mode 100644
index 000000000000..c65b77e59dc8
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementServiceCheckNameAvailability.json
@@ -0,0 +1,19 @@
+{
+  "parameters": {
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "subscriptionId": "subid",
+    "parameters": {
+      "name": "apimService1"
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "nameAvailable": true,
+        "reason": "Valid",
+        "message": ""
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementServiceDeleteService.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementServiceDeleteService.json
new file mode 100644
index 000000000000..e295d6734724
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementServiceDeleteService.json
@@ -0,0 +1,60 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "subscriptionId": "subid"
+  },
+  "responses": {
+    "202": {
+      "headers": {
+        "location": "https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/operationresults/TGV2eTExMDZtMDJfVGVybV9jMmZlY2QwMA==?api-version=2020-06-01-preview"
+      },
+      "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/preview/2020-06-01-preview/examples/ApiManagementServiceGetMultiRegionInternalVnet.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementServiceGetMultiRegionInternalVnet.json
new file mode 100644
index 000000000000..ad944244f2de
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementServiceGetMultiRegionInternalVnet.json
@@ -0,0 +1,98 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementServiceGetNetworkStatus.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementServiceGetNetworkStatus.json
new file mode 100644
index 000000000000..af76a259d10e
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementServiceGetNetworkStatus.json
@@ -0,0 +1,123 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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",
+                "resourceType": "BlobStorage",
+                "isOptional": false
+              },
+              {
+                "name": "apimgmtsttgzqxxxxxcrsc.file.core.windows.net",
+                "status": "success",
+                "error": "",
+                "lastUpdated": "2019-12-18T12:04:44.0439771Z",
+                "lastStatusChange": "2019-05-02T21:22:50.6835366Z",
+                "resourceType": "FileStorage",
+                "isOptional": true
+              },
+              {
+                "name": "apimgmtsttgzqxxxxxcrsc.queue.core.windows.net",
+                "status": "success",
+                "error": "",
+                "lastUpdated": "2019-12-18T12:04:44.8564232Z",
+                "lastStatusChange": "2019-05-02T20:53:26.6260794Z",
+                "resourceType": "Queue",
+                "isOptional": true
+              },
+              {
+                "name": "apimgmtsttgzqxxxxxcrsc.table.core.windows.net",
+                "status": "success",
+                "error": "",
+                "lastUpdated": "2019-12-18T12:04:44.0439771Z",
+                "lastStatusChange": "2019-05-02T20:53:21.6729263Z",
+                "resourceType": "TableStorage",
+                "isOptional": true
+              },
+              {
+                "name": "ftmrcxxx.database.windows.net",
+                "status": "success",
+                "error": "",
+                "lastUpdated": "2019-12-18T12:04:44.1845483Z",
+                "lastStatusChange": "2019-05-02T21:02:00.9466899Z",
+                "resourceType": "SQLDatabase",
+                "isOptional": false
+              },
+              {
+                "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",
+                "resourceType": "Metrics",
+                "isOptional": false
+              },
+              {
+                "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",
+                "resourceType": "Monitoring",
+                "isOptional": true
+              },
+              {
+                "name": "LocalGatewayRedis",
+                "status": "success",
+                "error": "",
+                "lastUpdated": "2019-12-18T12:04:50.6376685Z",
+                "lastStatusChange": "2019-12-18T11:14:44.4966742Z",
+                "resourceType": "InternalCache",
+                "isOptional": false
+              },
+              {
+                "name": "prod.warmpath.msftcloudes.com",
+                "status": "success",
+                "error": "",
+                "lastUpdated": "2019-12-18T12:04:44.4345454Z",
+                "lastStatusChange": "2019-05-08T00:09:58.031766Z",
+                "resourceType": "Monitoring",
+                "isOptional": true
+              },
+              {
+                "name": "Scm",
+                "status": "success",
+                "error": "",
+                "lastUpdated": "2019-12-18T12:04:58.4815899Z",
+                "lastStatusChange": "2019-12-18T11:24:48.4795085Z",
+                "resourceType": "SourceControl",
+                "isOptional": true
+              },
+              {
+                "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",
+                "resourceType": "Email",
+                "isOptional": true
+              }
+            ]
+          }
+        }
+      ]
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementServiceGetNetworkStatusByLocation.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementServiceGetNetworkStatusByLocation.json
new file mode 100644
index 000000000000..ef8f5ba53087
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementServiceGetNetworkStatusByLocation.json
@@ -0,0 +1,74 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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",
+            "resourceType": "BlobStorage",
+            "isOptional": false
+          },
+          {
+            "name": "apimgmtst6mtxxxxxxxx.file.core.windows.net",
+            "status": "success",
+            "error": "",
+            "lastUpdated": "2018-06-13T22:41:08.6657305Z",
+            "lastStatusChange": "2018-06-13T20:31:06.8934611Z",
+            "resourceType": "FileStorage",
+            "isOptional": true
+          },
+          {
+            "name": "apimgmtst6mtxxxxxxxx.table.core.windows.net",
+            "status": "success",
+            "error": "",
+            "lastUpdated": "2018-06-13T22:41:08.7594708Z",
+            "lastStatusChange": "2018-06-13T20:31:06.7529128Z",
+            "resourceType": "TableStorage",
+            "isOptional": true
+          },
+          {
+            "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",
+            "resourceType": "Metrics",
+            "isOptional": false
+          },
+          {
+            "name": "n20fxxx.database.windows.net",
+            "status": "success",
+            "error": "",
+            "lastUpdated": "2018-06-13T22:41:09.5094848Z",
+            "lastStatusChange": "2018-06-13T20:31:07.0968711Z",
+            "resourceType": "SQLDatabase",
+            "isOptional": false
+          },
+          {
+            "name": "Scm",
+            "status": "success",
+            "error": "",
+            "lastUpdated": "2018-06-13T22:41:29.4358865Z",
+            "lastStatusChange": "2018-06-13T20:41:09.8627827Z",
+            "resourceType": "SourceControl",
+            "isOptional": true
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementServiceGetService.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementServiceGetService.json
new file mode 100644
index 000000000000..e1aa7fe649ed
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementServiceGetService.json
@@ -0,0 +1,115 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementServiceGetServiceHavingMsi.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementServiceGetServiceHavingMsi.json
new file mode 100644
index 000000000000..9438ae63ef41
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementServiceGetServiceHavingMsi.json
@@ -0,0 +1,87 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementServiceGetSsoToken.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementServiceGetSsoToken.json
new file mode 100644
index 000000000000..1e05df222ce8
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementServiceGetSsoToken.json
@@ -0,0 +1,15 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementSubscriptionListSecrets.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementSubscriptionListSecrets.json
new file mode 100644
index 000000000000..7dbc11ad3cce
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementSubscriptionListSecrets.json
@@ -0,0 +1,17 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "subscriptionId": "subid",
+    "sid": "5931a769d8d14f0ad8ce13b8"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "primaryKey": "6de0a3b2da204e459148d2f6785873f0",
+        "secondaryKey": "c6de00b451f64ea780db1eb8dcf30b62"
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementSubscriptionRegeneratePrimaryKey.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementSubscriptionRegeneratePrimaryKey.json
new file mode 100644
index 000000000000..617d9ea77148
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementSubscriptionRegeneratePrimaryKey.json
@@ -0,0 +1,12 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "subscriptionId": "subid",
+    "sid": "testsub"
+  },
+  "responses": {
+    "204": {}
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementSubscriptionRegenerateSecondaryKey.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementSubscriptionRegenerateSecondaryKey.json
new file mode 100644
index 000000000000..617d9ea77148
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementSubscriptionRegenerateSecondaryKey.json
@@ -0,0 +1,12 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "subscriptionId": "subid",
+    "sid": "testsub"
+  },
+  "responses": {
+    "204": {}
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementTenantAccessRegenerateKey.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementTenantAccessRegenerateKey.json
new file mode 100644
index 000000000000..f57fc39bd0de
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementTenantAccessRegenerateKey.json
@@ -0,0 +1,12 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "subscriptionId": "subid",
+    "accessName": "access"
+  },
+  "responses": {
+    "204": {}
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementTenantAccessSyncState.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementTenantAccessSyncState.json
new file mode 100644
index 000000000000..665c90ef358f
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementTenantAccessSyncState.json
@@ -0,0 +1,22 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementTenantConfigurationDeploy.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementTenantConfigurationDeploy.json
new file mode 100644
index 000000000000..00f2537b8768
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementTenantConfigurationDeploy.json
@@ -0,0 +1,33 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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=2020-06-01-preview"
+      }
+    },
+    "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/preview/2020-06-01-preview/examples/ApiManagementTenantConfigurationSave.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementTenantConfigurationSave.json
new file mode 100644
index 000000000000..38b2292e3272
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementTenantConfigurationSave.json
@@ -0,0 +1,32 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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=2020-06-01-preview"
+      }
+    },
+    "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/preview/2020-06-01-preview/examples/ApiManagementTenantConfigurationValidate.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementTenantConfigurationValidate.json
new file mode 100644
index 000000000000..bfd57da0c36c
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementTenantConfigurationValidate.json
@@ -0,0 +1,172 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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=2020-06-01-preview"
+      }
+    },
+    "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/preview/2020-06-01-preview/examples/ApiManagementUndelete.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementUndelete.json
new file mode 100644
index 000000000000..be7ec949239a
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementUndelete.json
@@ -0,0 +1,113 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "subscriptionId": "subid",
+    "parameters": {
+      "properties": {
+        "publisherEmail": "foo@contoso.com",
+        "publisherName": "foo",
+        "restore": true
+      },
+      "sku": {
+        "name": "Developer",
+        "capacity": 1
+      },
+      "location": "South Central US"
+    }
+  },
+  "responses": {
+    "201": {
+      "headers": {
+        "location": "https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/operationresults/dGVjaGVkX01hbmFnZVJvbGVfNWRiNGI3Ng==?api-version=2020-06-01-preview"
+      },
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1",
+        "name": "apimService1",
+        "type": "Microsoft.ApiManagement/service",
+        "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",
+        "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=2020-06-01-preview"
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementUpdateApi.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementUpdateApi.json
new file mode 100644
index 000000000000..bab1e87ab463
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementUpdateApi.json
@@ -0,0 +1,41 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "subscriptionId": "subid",
+    "apiId": "echo-api",
+    "If-Match": "*",
+    "parameters": {
+      "properties": {
+        "displayName": "Echo API New",
+        "serviceUrl": "http://echoapi.cloudapp.net/api2",
+        "path": "newecho"
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "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 New",
+          "apiRevision": "1",
+          "serviceUrl": "http://echoapi.cloudapp.net/api2",
+          "path": "newecho",
+          "protocols": [
+            "https"
+          ],
+          "subscriptionKeyParameterNames": {
+            "header": "Ocp-Apim-Subscription-Key",
+            "query": "subscription-key"
+          },
+          "isCurrent": true,
+          "isOnline": true
+        }
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementUpdateApiDiagnostic.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementUpdateApiDiagnostic.json
new file mode 100644
index 000000000000..03a72af628b2
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementUpdateApiDiagnostic.json
@@ -0,0 +1,104 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "subscriptionId": "subid",
+    "diagnosticId": "applicationinsights",
+    "apiId": "echo-api",
+    "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": {
+    "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/preview/2020-06-01-preview/examples/ApiManagementUpdateApiIssue.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementUpdateApiIssue.json
new file mode 100644
index 000000000000..d912b69765b4
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementUpdateApiIssue.json
@@ -0,0 +1,33 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "subscriptionId": "subid",
+    "issueId": "57d2ef278aa04f0ad01d6cdc",
+    "apiId": "57d1f7558aa04f15146d9d8a",
+    "If-Match": "*",
+    "parameters": {
+      "properties": {
+        "state": "closed"
+      }
+    }
+  },
+  "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/preview/2020-06-01-preview/examples/ApiManagementUpdateApiOperation.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementUpdateApiOperation.json
new file mode 100644
index 000000000000..a1fa1d1d6621
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementUpdateApiOperation.json
@@ -0,0 +1,90 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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": {
+    "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/preview/2020-06-01-preview/examples/ApiManagementUpdateApiRelease.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementUpdateApiRelease.json
new file mode 100644
index 000000000000..0e335402cf6d
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementUpdateApiRelease.json
@@ -0,0 +1,32 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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": {
+    "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:38:29.173Z",
+          "updatedDateTime": "2018-02-08T20:38:29.173Z",
+          "notes": "yahoo"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementUpdateApiVersionSet.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementUpdateApiVersionSet.json
new file mode 100644
index 000000000000..06fce04d05c4
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementUpdateApiVersionSet.json
@@ -0,0 +1,31 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "subscriptionId": "subid",
+    "versionSetId": "vs1",
+    "If-Match": "*",
+    "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/vs1",
+        "type": "Microsoft.ApiManagement/service/api-version-sets",
+        "name": "vs1",
+        "properties": {
+          "displayName": "api set 1",
+          "versioningScheme": "Segment",
+          "description": "Version configuration"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementUpdateAuthorizationServer.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementUpdateAuthorizationServer.json
new file mode 100644
index 000000000000..6903baf6406a
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementUpdateAuthorizationServer.json
@@ -0,0 +1,50 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "subscriptionId": "subid",
+    "authsid": "newauthServer",
+    "If-Match": "*",
+    "parameters": {
+      "properties": {
+        "clientId": "update",
+        "clientSecret": "updated"
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/authorizationServers/newauthServer",
+        "type": "Microsoft.ApiManagement/service/authorizationServers",
+        "name": "newauthServer",
+        "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": "updated",
+          "resourceOwnerUsername": "un",
+          "resourceOwnerPassword": "pwd"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementUpdateBackend.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementUpdateBackend.json
new file mode 100644
index 000000000000..ecb94af38949
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementUpdateBackend.json
@@ -0,0 +1,61 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "subscriptionId": "subid",
+    "backendId": "proxybackend",
+    "If-Match": "*",
+    "parameters": {
+      "properties": {
+        "description": "description5308",
+        "tls": {
+          "validateCertificateChain": false,
+          "validateCertificateName": true
+        }
+      }
+    }
+  },
+  "responses": {
+    "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": true
+          }
+        }
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementUpdateCache.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementUpdateCache.json
new file mode 100644
index 000000000000..40d8440bb57c
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementUpdateCache.json
@@ -0,0 +1,30 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "subscriptionId": "subid",
+    "cacheId": "c1",
+    "If-Match": "*",
+    "parameters": {
+      "properties": {
+        "useFromLocation": "westindia"
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/caches/c1",
+        "type": "Microsoft.ApiManagement/service/caches",
+        "name": "c1",
+        "properties": {
+          "useFromLocation": "westindia",
+          "description": "Redis cache instances in West India",
+          "connectionString": "{{5f7fbca77a891a2200f3db38}}",
+          "resourceId": "https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Cache/redis/apimservice1"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementUpdateDiagnostic.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementUpdateDiagnostic.json
new file mode 100644
index 000000000000..f4a4569cf51f
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementUpdateDiagnostic.json
@@ -0,0 +1,111 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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": {
+    "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": 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/preview/2020-06-01-preview/examples/ApiManagementUpdateGateway.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementUpdateGateway.json
new file mode 100644
index 000000000000..82e231c8e2bc
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementUpdateGateway.json
@@ -0,0 +1,33 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "subscriptionId": "subid",
+    "gatewayId": "gw1",
+    "If-Match": "*",
+    "parameters": {
+      "properties": {
+        "description": "my gateway 1",
+        "locationData": {
+          "name": "my location"
+        }
+      }
+    }
+  },
+  "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/preview/2020-06-01-preview/examples/ApiManagementUpdateGroup.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementUpdateGroup.json
new file mode 100644
index 000000000000..5e4fe1fd7249
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementUpdateGroup.json
@@ -0,0 +1,31 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "subscriptionId": "subid",
+    "groupId": "tempgroup",
+    "If-Match": "*",
+    "parameters": {
+      "properties": {
+        "displayName": "temp group"
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/groups/tempgroup",
+        "type": "Microsoft.ApiManagement/service/groups",
+        "name": "tempgroup",
+        "properties": {
+          "displayName": "tempgroup",
+          "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/preview/2020-06-01-preview/examples/ApiManagementUpdateIdentityProvider.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementUpdateIdentityProvider.json
new file mode 100644
index 000000000000..fca16f78b7fe
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementUpdateIdentityProvider.json
@@ -0,0 +1,37 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "subscriptionId": "subid",
+    "identityProviderName": "facebook",
+    "If-Match": "*",
+    "parameters": {
+      "properties": {
+        "clientId": "updatedfacebookid",
+        "clientSecret": "updatedfacebooksecret"
+      }
+    }
+  },
+  "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/preview/2020-06-01-preview/examples/ApiManagementUpdateLogger.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementUpdateLogger.json
new file mode 100644
index 000000000000..80194d98a0f4
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementUpdateLogger.json
@@ -0,0 +1,33 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "subscriptionId": "subid",
+    "loggerId": "eh1",
+    "If-Match": "*",
+    "parameters": {
+      "properties": {
+        "loggerType": "azureEventHub",
+        "description": "updating description"
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/loggers/eh1",
+        "type": "Microsoft.ApiManagement/service/loggers",
+        "name": "eh1",
+        "properties": {
+          "loggerType": "azureEventHub",
+          "description": "updating description",
+          "credentials": {
+            "connectionString": "{{Logger-Credentials-5f28745bbebeeb13cc3f7301}}"
+          },
+          "isBuffered": true
+        }
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementUpdateNamedValue.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementUpdateNamedValue.json
new file mode 100644
index 000000000000..9fc3b7df72a4
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementUpdateNamedValue.json
@@ -0,0 +1,43 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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=2020-06-01-preview&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
+        }
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementUpdateOpenIdConnectProvider.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementUpdateOpenIdConnectProvider.json
new file mode 100644
index 000000000000..a6318c8c4c89
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementUpdateOpenIdConnectProvider.json
@@ -0,0 +1,30 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "subscriptionId": "subid",
+    "opid": "templateOpenIdConnect2",
+    "If-Match": "*",
+    "parameters": {
+      "properties": {
+        "clientSecret": "updatedsecret"
+      }
+    }
+  },
+  "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/preview/2020-06-01-preview/examples/ApiManagementUpdateProduct.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementUpdateProduct.json
new file mode 100644
index 000000000000..a46b1b0f03ce
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementUpdateProduct.json
@@ -0,0 +1,32 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "subscriptionId": "subid",
+    "productId": "testproduct",
+    "If-Match": "*",
+    "parameters": {
+      "properties": {
+        "displayName": "Test Template ProductName 4"
+      }
+    }
+  },
+  "responses": {
+    "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",
+          "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/preview/2020-06-01-preview/examples/ApiManagementUpdateQuotaCounterKey.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementUpdateQuotaCounterKey.json
new file mode 100644
index 000000000000..ac84c9b3432a
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementUpdateQuotaCounterKey.json
@@ -0,0 +1,34 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "subscriptionId": "subid",
+    "quotaCounterKey": "ba",
+    "parameters": {
+      "properties": {
+        "callsCount": 0,
+        "kbTransferred": 2.5630078125
+      }
+    }
+  },
+  "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/preview/2020-06-01-preview/examples/ApiManagementUpdateQuotaCounterKeyByQuotaPeriod.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementUpdateQuotaCounterKeyByQuotaPeriod.json
new file mode 100644
index 000000000000..a21c5e5bbe6b
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementUpdateQuotaCounterKeyByQuotaPeriod.json
@@ -0,0 +1,30 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "subscriptionId": "subid",
+    "quotaCounterKey": "ba",
+    "quotaPeriodKey": "0_P3Y6M4DT12H30M5S",
+    "parameters": {
+      "properties": {
+        "callsCount": 0,
+        "kbTransferred": 0
+      }
+    }
+  },
+  "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/preview/2020-06-01-preview/examples/ApiManagementUpdateServiceDisableTls10.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementUpdateServiceDisableTls10.json
new file mode 100644
index 000000000000..19ff7d253b17
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementUpdateServiceDisableTls10.json
@@ -0,0 +1,92 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementUpdateServicePublisherDetails.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementUpdateServicePublisherDetails.json
new file mode 100644
index 000000000000..c499a5d2e168
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementUpdateServicePublisherDetails.json
@@ -0,0 +1,91 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementUpdateSubscription.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementUpdateSubscription.json
new file mode 100644
index 000000000000..b8d6e6d2cc35
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementUpdateSubscription.json
@@ -0,0 +1,31 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "subscriptionId": "subid",
+    "sid": "testsub",
+    "If-Match": "*",
+    "parameters": {
+      "properties": {
+        "displayName": "testsub"
+      }
+    }
+  },
+  "responses": {
+    "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/5931a75ae4bbd512a88c680b",
+          "scope": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/products/5600b59475ff190048060002",
+          "displayName": "testsub",
+          "state": "submitted",
+          "createdDate": "2017-06-02T17:59:06.223Z"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementUpdateTag.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementUpdateTag.json
new file mode 100644
index 000000000000..052a7d86f32d
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementUpdateTag.json
@@ -0,0 +1,27 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "subscriptionId": "subid",
+    "tagId": "temptag",
+    "If-Match": "*",
+    "parameters": {
+      "properties": {
+        "displayName": "temp tag"
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/tags/temptag",
+        "type": "Microsoft.ApiManagement/service/tags",
+        "name": "temptag",
+        "properties": {
+          "displayName": "tag1"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementUpdateTemplate.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementUpdateTemplate.json
new file mode 100644
index 000000000000..73720dea26d6
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementUpdateTemplate.json
@@ -0,0 +1,58 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "subscriptionId": "subid",
+    "templateName": "newIssueNotificationMessage",
+    "If-Match": "*",
+    "parameters": {
+      "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'\">\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": {
+    "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/preview/2020-06-01-preview/examples/ApiManagementUpdateTenantAccess.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementUpdateTenantAccess.json
new file mode 100644
index 000000000000..9649d5b2d0bb
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementUpdateTenantAccess.json
@@ -0,0 +1,23 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "subscriptionId": "subid",
+    "If-Match": "*",
+    "accessName": "access",
+    "parameters": {
+      "properties": {
+        "enabled": true
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "5600b59375ff190048030003",
+        "enabled": true
+      }
+    }
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementUpdateUser.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementUpdateUser.json
new file mode 100644
index 000000000000..509719245cb0
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementUpdateUser.json
@@ -0,0 +1,39 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "subscriptionId": "subid",
+    "userId": "5931a75ae4bbd512a88c680b",
+    "If-Match": "*",
+    "parameters": {
+      "properties": {
+        "firstName": "foo",
+        "lastName": "bar",
+        "email": "foobar@outlook.com"
+      }
+    }
+  },
+  "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/preview/2020-06-01-preview/examples/ApiManagementUserConfirmationPasswordSend.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementUserConfirmationPasswordSend.json
new file mode 100644
index 000000000000..f8a24bd75354
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementUserConfirmationPasswordSend.json
@@ -0,0 +1,12 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "subscriptionId": "subid",
+    "userId": "57127d485157a511ace86ae7"
+  },
+  "responses": {
+    "204": {}
+  }
+}
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementUserGenerateSsoUrl.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementUserGenerateSsoUrl.json
new file mode 100644
index 000000000000..3b97a599accb
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementUserGenerateSsoUrl.json
@@ -0,0 +1,16 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/preview/2020-06-01-preview/examples/ApiManagementUserToken.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementUserToken.json
new file mode 100644
index 000000000000..6213f36318c1
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2020-06-01-preview/examples/ApiManagementUserToken.json
@@ -0,0 +1,22 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-06-01-preview",
+    "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/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateContentType.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateContentType.json
index 1ef1cbc9f30f..8ff951e395bc 100644
--- a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateContentType.json
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementCreateContentType.json
@@ -12,12 +12,6 @@
         "schema": {
           "properties": {
             "en_us": {
-              "$ref": "#/definitions/metadata"
-            }
-          },
-          "additionalProperties": false,
-          "definitions": {
-            "metadata": {
               "type": "object",
               "properties": {
                 "title": {
@@ -57,7 +51,8 @@
                 "documentId"
               ]
             }
-          }
+          },
+          "additionalProperties": false
         },
         "version": "1.0.0"
       }
@@ -75,12 +70,6 @@
           "schema": {
             "properties": {
               "en_us": {
-                "$ref": "#/definitions/metadata"
-              }
-            },
-            "additionalProperties": false,
-            "definitions": {
-              "metadata": {
                 "type": "object",
                 "properties": {
                   "title": {
@@ -120,7 +109,8 @@
                   "documentId"
                 ]
               }
-            }
+            },
+            "additionalProperties": false
           },
           "version": "1.0.0"
         }
@@ -137,12 +127,6 @@
           "schema": {
             "properties": {
               "en_us": {
-                "$ref": "#/definitions/metadata"
-              }
-            },
-            "additionalProperties": false,
-            "definitions": {
-              "metadata": {
                 "type": "object",
                 "properties": {
                   "title": {
@@ -182,7 +166,8 @@
                   "documentId"
                 ]
               }
-            }
+            },
+            "additionalProperties": false
           },
           "version": "1.0.0"
         }
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListContentTypes.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListContentTypes.json
index 4a008fed1b45..fe7ccc552877 100644
--- a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListContentTypes.json
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2019-12-01/examples/ApiManagementListContentTypes.json
@@ -19,12 +19,6 @@
               "schema": {
                 "properties": {
                   "en_us": {
-                    "$ref": "#/definitions/metadata"
-                  }
-                },
-                "additionalProperties": false,
-                "definitions": {
-                  "metadata": {
                     "type": "object",
                     "properties": {
                       "title": {
@@ -64,7 +58,8 @@
                       "documentId"
                     ]
                   }
-                }
+                },
+                "additionalProperties": false
               },
               "version": "1.0.0"
             }
diff --git a/specification/apimanagement/resource-manager/readme.azureresourceschema.md b/specification/apimanagement/resource-manager/readme.azureresourceschema.md
index 7afd9c95a116..99e3ce1ce490 100644
--- a/specification/apimanagement/resource-manager/readme.azureresourceschema.md
+++ b/specification/apimanagement/resource-manager/readme.azureresourceschema.md
@@ -6,6 +6,7 @@ These settings apply only when `--azureresourceschema` is specified on the comma
 
 ``` yaml $(azureresourceschema) && $(multiapi)
 batch:
+  - tag: schema-apimanagement-2020-06-01-preview
   - tag: schema-apimanagement-2019-12-01-preview
   - tag: schema-apimanagement-2019-12-01
   - tag: schema-apimanagement-2019-01-01
@@ -19,6 +20,52 @@ batch:
 
 Please also specify `--azureresourceschema-folder=<path to the root directory of your azure-resource-manager-schemas clone>`.
 
+### Tag: schema-apimanagement-2020-06-01-preview and azureresourceschema
+
+``` yaml $(tag) == 'schema-apimanagement-2020-06-01-preview' && $(azureresourceschema)
+output-folder: $(azureresourceschema-folder)/schemas
+
+# all the input files in this apiVersion
+input-file:
+  - Microsoft.ApiManagement/preview/2020-06-01-preview/apimanagement.json
+  - Microsoft.ApiManagement/preview/2020-06-01-preview/apimapis.json
+  - Microsoft.ApiManagement/preview/2020-06-01-preview/apimapisByTags.json
+  - Microsoft.ApiManagement/preview/2020-06-01-preview/apimapiversionsets.json
+  - Microsoft.ApiManagement/preview/2020-06-01-preview/apimauthorizationservers.json
+  - Microsoft.ApiManagement/preview/2020-06-01-preview/apimbackends.json
+  - Microsoft.ApiManagement/preview/2020-06-01-preview/apimcaches.json
+  - Microsoft.ApiManagement/preview/2020-06-01-preview/apimcertificates.json
+  - Microsoft.ApiManagement/preview/2020-06-01-preview/apimcontenttypes.json
+  - Microsoft.ApiManagement/preview/2020-06-01-preview/apimdeletedservices.json
+  - Microsoft.ApiManagement/preview/2020-06-01-preview/apimdeployment.json
+  - Microsoft.ApiManagement/preview/2020-06-01-preview/apimdiagnostics.json
+  - Microsoft.ApiManagement/preview/2020-06-01-preview/apimemailtemplates.json
+  - Microsoft.ApiManagement/preview/2020-06-01-preview/apimgateways.json
+  - Microsoft.ApiManagement/preview/2020-06-01-preview/apimgroups.json
+  - Microsoft.ApiManagement/preview/2020-06-01-preview/apimidentityprovider.json
+  - Microsoft.ApiManagement/preview/2020-06-01-preview/apimissues.json
+  - Microsoft.ApiManagement/preview/2020-06-01-preview/apimloggers.json
+  - Microsoft.ApiManagement/preview/2020-06-01-preview/apimnamedvalues.json
+  - Microsoft.ApiManagement/preview/2020-06-01-preview/apimnetworkstatus.json
+  - Microsoft.ApiManagement/preview/2020-06-01-preview/apimnotifications.json
+  - Microsoft.ApiManagement/preview/2020-06-01-preview/apimopenidconnectproviders.json
+  - Microsoft.ApiManagement/preview/2020-06-01-preview/apimpolicies.json
+  - Microsoft.ApiManagement/preview/2020-06-01-preview/apimpolicydescriptions.json
+  - Microsoft.ApiManagement/preview/2020-06-01-preview/apimportalsettings.json
+  - Microsoft.ApiManagement/preview/2020-06-01-preview/apimproducts.json
+  - Microsoft.ApiManagement/preview/2020-06-01-preview/apimproductsByTags.json
+  - Microsoft.ApiManagement/preview/2020-06-01-preview/apimquotas.json
+  - Microsoft.ApiManagement/preview/2020-06-01-preview/apimregions.json
+  - Microsoft.ApiManagement/preview/2020-06-01-preview/apimreports.json
+  - Microsoft.ApiManagement/preview/2020-06-01-preview/apimsubscriptions.json
+  - Microsoft.ApiManagement/preview/2020-06-01-preview/apimtagresources.json
+  - Microsoft.ApiManagement/preview/2020-06-01-preview/apimtags.json
+  - Microsoft.ApiManagement/preview/2020-06-01-preview/apimtenant.json
+  - Microsoft.ApiManagement/preview/2020-06-01-preview/apimusers.json
+  - Microsoft.ApiManagement/preview/2020-06-01-preview/definitions.json
+
+```
+
 ### Tag: schema-apimanagement-2019-12-01-preview and azureresourceschema
 
 ``` yaml $(tag) == 'schema-apimanagement-2019-12-01-preview' && $(azureresourceschema)
diff --git a/specification/apimanagement/resource-manager/readme.md b/specification/apimanagement/resource-manager/readme.md
index 623baea81b75..38edc5918a9e 100644
--- a/specification/apimanagement/resource-manager/readme.md
+++ b/specification/apimanagement/resource-manager/readme.md
@@ -28,10 +28,53 @@ These are the global settings for the ApiManagement API.
 title: ApiManagementClient
 description: ApiManagement Client
 openapi-type: arm
-tag: package-2019-12
+tag: package-preview-2020-06
 ```
 
 
+### Tag: package-preview-2020-06
+
+These settings apply only when `--tag=package-preview-2020-06` is specified on the command line.
+
+```yaml $(tag) == 'package-preview-2020-06'
+input-file:
+  - Microsoft.ApiManagement/preview/2020-06-01-preview/apimanagement.json
+  - Microsoft.ApiManagement/preview/2020-06-01-preview/apimapis.json
+  - Microsoft.ApiManagement/preview/2020-06-01-preview/apimapisByTags.json
+  - Microsoft.ApiManagement/preview/2020-06-01-preview/apimapiversionsets.json
+  - Microsoft.ApiManagement/preview/2020-06-01-preview/apimauthorizationservers.json
+  - Microsoft.ApiManagement/preview/2020-06-01-preview/apimbackends.json
+  - Microsoft.ApiManagement/preview/2020-06-01-preview/apimcaches.json
+  - Microsoft.ApiManagement/preview/2020-06-01-preview/apimcertificates.json
+  - Microsoft.ApiManagement/preview/2020-06-01-preview/apimcontenttypes.json
+  - Microsoft.ApiManagement/preview/2020-06-01-preview/apimdeletedservices.json
+  - Microsoft.ApiManagement/preview/2020-06-01-preview/apimdeployment.json
+  - Microsoft.ApiManagement/preview/2020-06-01-preview/apimdiagnostics.json
+  - Microsoft.ApiManagement/preview/2020-06-01-preview/apimemailtemplates.json
+  - Microsoft.ApiManagement/preview/2020-06-01-preview/apimgateways.json
+  - Microsoft.ApiManagement/preview/2020-06-01-preview/apimgroups.json
+  - Microsoft.ApiManagement/preview/2020-06-01-preview/apimidentityprovider.json
+  - Microsoft.ApiManagement/preview/2020-06-01-preview/apimissues.json
+  - Microsoft.ApiManagement/preview/2020-06-01-preview/apimloggers.json
+  - Microsoft.ApiManagement/preview/2020-06-01-preview/apimnamedvalues.json
+  - Microsoft.ApiManagement/preview/2020-06-01-preview/apimnetworkstatus.json
+  - Microsoft.ApiManagement/preview/2020-06-01-preview/apimnotifications.json
+  - Microsoft.ApiManagement/preview/2020-06-01-preview/apimopenidconnectproviders.json
+  - Microsoft.ApiManagement/preview/2020-06-01-preview/apimpolicies.json
+  - Microsoft.ApiManagement/preview/2020-06-01-preview/apimpolicydescriptions.json
+  - Microsoft.ApiManagement/preview/2020-06-01-preview/apimportalsettings.json
+  - Microsoft.ApiManagement/preview/2020-06-01-preview/apimproducts.json
+  - Microsoft.ApiManagement/preview/2020-06-01-preview/apimproductsByTags.json
+  - Microsoft.ApiManagement/preview/2020-06-01-preview/apimquotas.json
+  - Microsoft.ApiManagement/preview/2020-06-01-preview/apimregions.json
+  - Microsoft.ApiManagement/preview/2020-06-01-preview/apimreports.json
+  - Microsoft.ApiManagement/preview/2020-06-01-preview/apimsubscriptions.json
+  - Microsoft.ApiManagement/preview/2020-06-01-preview/apimtagresources.json
+  - Microsoft.ApiManagement/preview/2020-06-01-preview/apimtags.json
+  - Microsoft.ApiManagement/preview/2020-06-01-preview/apimtenant.json
+  - Microsoft.ApiManagement/preview/2020-06-01-preview/apimusers.json
+  - Microsoft.ApiManagement/preview/2020-06-01-preview/definitions.json
+```
 ### Tag: package-2019-12
 
 These settings apply only when `--tag=package-2019-12` is specified on the command line.
@@ -74,6 +117,7 @@ input-file:
   - 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.
diff --git a/specification/appconfiguration/resource-manager/Microsoft.AppConfiguration/preview/2020-07-01-preview/appconfiguration.json b/specification/appconfiguration/resource-manager/Microsoft.AppConfiguration/preview/2020-07-01-preview/appconfiguration.json
new file mode 100644
index 000000000000..e8822e146841
--- /dev/null
+++ b/specification/appconfiguration/resource-manager/Microsoft.AppConfiguration/preview/2020-07-01-preview/appconfiguration.json
@@ -0,0 +1,1960 @@
+{
+  "swagger": "2.0",
+  "info": {
+    "version": "2020-07-01-preview",
+    "title": "AppConfigurationManagementClient"
+  },
+  "host": "management.azure.com",
+  "schemes": [
+    "https"
+  ],
+  "consumes": [
+    "application/json"
+  ],
+  "produces": [
+    "application/json"
+  ],
+  "paths": {
+    "/subscriptions/{subscriptionId}/providers/Microsoft.AppConfiguration/configurationStores": {
+      "get": {
+        "tags": [
+          "ConfigurationStores"
+        ],
+        "description": "Lists the configuration stores for a given subscription.",
+        "operationId": "ConfigurationStores_List",
+        "parameters": [
+          {
+            "$ref": "#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/ApiVersionParameter"
+          },
+          {
+            "name": "$skipToken",
+            "in": "query",
+            "description": "A skip token is used to continue retrieving items after an operation returns a partial result. If a previous response contains a nextLink element, the value of the nextLink element will include a skipToken parameter that specifies a starting point to use for subsequent calls.",
+            "required": false,
+            "type": "string"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The request was successful; the request was well-formed and received properly.",
+            "schema": {
+              "$ref": "#/definitions/ConfigurationStoreListResult"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-examples": {
+          "ConfigurationStores_List": {
+            "$ref": "./examples/ConfigurationStoresList.json"
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppConfiguration/configurationStores": {
+      "get": {
+        "tags": [
+          "ConfigurationStores"
+        ],
+        "description": "Lists the configuration stores for a given resource group.",
+        "operationId": "ConfigurationStores_ListByResourceGroup",
+        "parameters": [
+          {
+            "$ref": "#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/ApiVersionParameter"
+          },
+          {
+            "name": "$skipToken",
+            "in": "query",
+            "description": "A skip token is used to continue retrieving items after an operation returns a partial result. If a previous response contains a nextLink element, the value of the nextLink element will include a skipToken parameter that specifies a starting point to use for subsequent calls.",
+            "required": false,
+            "type": "string"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The request was successful; the request was well-formed and received properly.",
+            "schema": {
+              "$ref": "#/definitions/ConfigurationStoreListResult"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-examples": {
+          "ConfigurationStores_ListByResourceGroup": {
+            "$ref": "./examples/ConfigurationStoresListByResourceGroup.json"
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppConfiguration/configurationStores/{configStoreName}": {
+      "get": {
+        "tags": [
+          "ConfigurationStores"
+        ],
+        "description": "Gets the properties of the specified configuration store.",
+        "operationId": "ConfigurationStores_Get",
+        "parameters": [
+          {
+            "$ref": "#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/ConfigStoreNameParameter"
+          },
+          {
+            "$ref": "#/parameters/ApiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The request was successful; the request was well-formed and received properly.",
+            "schema": {
+              "$ref": "#/definitions/ConfigurationStore"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-examples": {
+          "ConfigurationStores_Get": {
+            "$ref": "./examples/ConfigurationStoresGet.json"
+          }
+        }
+      },
+      "put": {
+        "tags": [
+          "ConfigurationStores"
+        ],
+        "description": "Creates a configuration store with the specified parameters.",
+        "operationId": "ConfigurationStores_Create",
+        "parameters": [
+          {
+            "$ref": "#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/ConfigStoreNameParameter"
+          },
+          {
+            "$ref": "#/parameters/ApiVersionParameter"
+          },
+          {
+            "name": "configStoreCreationParameters",
+            "in": "body",
+            "description": "The parameters for creating a configuration store.",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/ConfigurationStore"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The request was successful; the request was well-formed and received properly.",
+            "schema": {
+              "$ref": "#/definitions/ConfigurationStore"
+            }
+          },
+          "201": {
+            "description": "The request was successfully accepted; the operation will complete asynchronously. The provisioning state of the resource should indicate the current state of the resource.",
+            "schema": {
+              "$ref": "#/definitions/ConfigurationStore"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-examples": {
+          "ConfigurationStores_Create": {
+            "$ref": "./examples/ConfigurationStoresCreate.json"
+          },
+          "ConfigurationStores_Create_WithIdentity": {
+            "$ref": "./examples/ConfigurationStoresCreateWithIdentity.json"
+          }
+        },
+        "x-ms-long-running-operation": true
+      },
+      "delete": {
+        "tags": [
+          "ConfigurationStores"
+        ],
+        "description": "Deletes a configuration store.",
+        "operationId": "ConfigurationStores_Delete",
+        "parameters": [
+          {
+            "$ref": "#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/ConfigStoreNameParameter"
+          },
+          {
+            "$ref": "#/parameters/ApiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The request was successful; the request was well-formed and received properly."
+          },
+          "202": {
+            "description": "The request was successful; the operation will complete asynchronously."
+          },
+          "204": {
+            "description": "No Content - the specified resource was not found."
+          },
+          "default": {
+            "description": "Error response describing why the operation failed",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-examples": {
+          "ConfigurationStores_Delete": {
+            "$ref": "./examples/ConfigurationStoresDelete.json"
+          }
+        },
+        "x-ms-long-running-operation": true
+      },
+      "patch": {
+        "tags": [
+          "ConfigurationStores"
+        ],
+        "description": "Updates a configuration store with the specified parameters.",
+        "operationId": "ConfigurationStores_Update",
+        "parameters": [
+          {
+            "$ref": "#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/ConfigStoreNameParameter"
+          },
+          {
+            "$ref": "#/parameters/ApiVersionParameter"
+          },
+          {
+            "name": "configStoreUpdateParameters",
+            "in": "body",
+            "description": "The parameters for updating a configuration store.",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/ConfigurationStoreUpdateParameters"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The request was successful; the request was well-formed and received properly.",
+            "schema": {
+              "$ref": "#/definitions/ConfigurationStore"
+            }
+          },
+          "201": {
+            "description": "The request was successfully accepted; the operation will complete asynchronously. The provisioning state of the resource should indicate the current state of the resource.",
+            "schema": {
+              "$ref": "#/definitions/ConfigurationStore"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-examples": {
+          "ConfigurationStores_Update": {
+            "$ref": "./examples/ConfigurationStoresUpdate.json"
+          },
+          "ConfigurationStores_Update_WithIdentity": {
+            "$ref": "./examples/ConfigurationStoresUpdateWithIdentity.json"
+          }
+        },
+        "x-ms-long-running-operation": true
+      }
+    },
+    "/subscriptions/{subscriptionId}/providers/Microsoft.AppConfiguration/checkNameAvailability": {
+      "post": {
+        "tags": [
+          "Operations"
+        ],
+        "description": "Checks whether the configuration store name is available for use.",
+        "operationId": "Operations_CheckNameAvailability",
+        "parameters": [
+          {
+            "$ref": "#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/ApiVersionParameter"
+          },
+          {
+            "name": "checkNameAvailabilityParameters",
+            "in": "body",
+            "description": "The object containing information for the availability request.",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/CheckNameAvailabilityParameters"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The request was successful; the request was well-formed and received properly.",
+            "schema": {
+              "$ref": "#/definitions/NameAvailabilityStatus"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-examples": {
+          "ConfigurationStores_CheckNameAvailable": {
+            "$ref": "./examples/CheckNameAvailable.json"
+          },
+          "ConfigurationStores_CheckNameNotAvailable": {
+            "$ref": "./examples/CheckNameNotAvailable.json"
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppConfiguration/configurationStores/{configStoreName}/listKeys": {
+      "post": {
+        "tags": [
+          "ConfigurationStores"
+        ],
+        "description": "Lists the access key for the specified configuration store.",
+        "operationId": "ConfigurationStores_ListKeys",
+        "parameters": [
+          {
+            "$ref": "#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/ConfigStoreNameParameter"
+          },
+          {
+            "$ref": "#/parameters/ApiVersionParameter"
+          },
+          {
+            "name": "$skipToken",
+            "in": "query",
+            "description": "A skip token is used to continue retrieving items after an operation returns a partial result. If a previous response contains a nextLink element, the value of the nextLink element will include a skipToken parameter that specifies a starting point to use for subsequent calls.",
+            "required": false,
+            "type": "string"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The request was successful; the request was well-formed and received properly.",
+            "schema": {
+              "$ref": "#/definitions/ApiKeyListResult"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-examples": {
+          "ConfigurationStores_ListKeys": {
+            "$ref": "./examples/ConfigurationStoresListKeys.json"
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppConfiguration/configurationStores/{configStoreName}/regenerateKey": {
+      "post": {
+        "tags": [
+          "ConfigurationStores"
+        ],
+        "description": "Regenerates an access key for the specified configuration store.",
+        "operationId": "ConfigurationStores_RegenerateKey",
+        "parameters": [
+          {
+            "$ref": "#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/ConfigStoreNameParameter"
+          },
+          {
+            "$ref": "#/parameters/ApiVersionParameter"
+          },
+          {
+            "name": "regenerateKeyParameters",
+            "in": "body",
+            "description": "The parameters for regenerating an access key.",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/RegenerateKeyParameters"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The request was successful; the request was well-formed and received properly.",
+            "schema": {
+              "$ref": "#/definitions/ApiKey"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-examples": {
+          "ConfigurationStores_RegenerateKey": {
+            "$ref": "./examples/ConfigurationStoresRegenerateKey.json"
+          }
+        }
+      }
+    },
+    "/providers/Microsoft.AppConfiguration/operations": {
+      "get": {
+        "tags": [
+          "Operations"
+        ],
+        "description": "Lists the operations available from this provider.",
+        "operationId": "Operations_List",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersionParameter"
+          },
+          {
+            "name": "$skipToken",
+            "in": "query",
+            "description": "A skip token is used to continue retrieving items after an operation returns a partial result. If a previous response contains a nextLink element, the value of the nextLink element will include a skipToken parameter that specifies a starting point to use for subsequent calls.",
+            "required": false,
+            "type": "string"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The request was successful; the request was well-formed and received properly.",
+            "schema": {
+              "$ref": "#/definitions/OperationDefinitionListResult"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-examples": {},
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppConfiguration/configurationStores/{configStoreName}/privateEndpointConnections": {
+      "get": {
+        "tags": [
+          "PrivateEndpointConnections"
+        ],
+        "operationId": "PrivateEndpointConnections_ListByConfigurationStore",
+        "description": "Lists all private endpoint connections for a configuration store.",
+        "parameters": [
+          {
+            "$ref": "#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/ConfigStoreNameParameter"
+          },
+          {
+            "$ref": "#/parameters/ApiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The request was successful; the request was well-formed and received properly.",
+            "schema": {
+              "$ref": "#/definitions/PrivateEndpointConnectionListResult"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-examples": {
+          "PrivateEndpointConnection_List": {
+            "$ref": "./examples/ConfigurationStoresListPrivateEndpointConnections.json"
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppConfiguration/configurationStores/{configStoreName}/privateEndpointConnections/{privateEndpointConnectionName}": {
+      "get": {
+        "tags": [
+          "PrivateEndpointConnections"
+        ],
+        "operationId": "PrivateEndpointConnections_Get",
+        "description": "Gets the specified private endpoint connection associated with the configuration store.",
+        "parameters": [
+          {
+            "$ref": "#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/ConfigStoreNameParameter"
+          },
+          {
+            "$ref": "#/parameters/ApiVersionParameter"
+          },
+          {
+            "name": "privateEndpointConnectionName",
+            "in": "path",
+            "description": "Private endpoint connection name",
+            "required": true,
+            "type": "string"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The request was successful; the request was well-formed and received properly.",
+            "schema": {
+              "$ref": "#/definitions/PrivateEndpointConnection"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-examples": {
+          "PrivateEndpointConnection_GetConnection": {
+            "$ref": "./examples/ConfigurationStoresGetPrivateEndpointConnection.json"
+          }
+        }
+      },
+      "put": {
+        "tags": [
+          "PrivateEndpointConnections"
+        ],
+        "operationId": "PrivateEndpointConnections_CreateOrUpdate",
+        "description": "Update the state of the specified private endpoint connection associated with the configuration store.",
+        "parameters": [
+          {
+            "$ref": "#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/ConfigStoreNameParameter"
+          },
+          {
+            "$ref": "#/parameters/ApiVersionParameter"
+          },
+          {
+            "name": "privateEndpointConnectionName",
+            "in": "path",
+            "description": "Private endpoint connection name",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "privateEndpointConnection",
+            "in": "body",
+            "description": "The private endpoint connection properties.",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/PrivateEndpointConnection"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The request was successful; the request was well-formed and received properly.",
+            "schema": {
+              "$ref": "#/definitions/PrivateEndpointConnection"
+            }
+          },
+          "201": {
+            "description": "The request was successfully accepted; the operation will complete asynchronously. The provisioning state of the resource should indicate the current state of the resource.",
+            "schema": {
+              "$ref": "#/definitions/PrivateEndpointConnection"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-examples": {
+          "PrivateEndpointConnection_CreateOrUpdate": {
+            "$ref": "./examples/ConfigurationStoresCreatePrivateEndpointConnection.json"
+          }
+        },
+        "x-ms-long-running-operation": true
+      },
+      "delete": {
+        "tags": [
+          "PrivateEndpointConnections"
+        ],
+        "description": "Deletes a private endpoint connection.",
+        "operationId": "PrivateEndpointConnections_Delete",
+        "parameters": [
+          {
+            "$ref": "#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/ConfigStoreNameParameter"
+          },
+          {
+            "$ref": "#/parameters/ApiVersionParameter"
+          },
+          {
+            "name": "privateEndpointConnectionName",
+            "in": "path",
+            "description": "Private endpoint connection name",
+            "required": true,
+            "type": "string"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The request was successful; the request was well-formed and received properly."
+          },
+          "202": {
+            "description": "The request was successful; the operation will complete asynchronously."
+          },
+          "204": {
+            "description": "No Content - the specified resource was not found."
+          },
+          "default": {
+            "description": "Error response describing why the operation failed",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-examples": {
+          "PrivateEndpointConnections_Delete": {
+            "$ref": "./examples/ConfigurationStoresDeletePrivateEndpointConnection.json"
+          }
+        },
+        "x-ms-long-running-operation": true
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppConfiguration/configurationStores/{configStoreName}/privateLinkResources": {
+      "get": {
+        "tags": [
+          "PrivateLinkResources"
+        ],
+        "operationId": "PrivateLinkResources_ListByConfigurationStore",
+        "description": "Gets the private link resources that need to be created for a configuration store.",
+        "parameters": [
+          {
+            "$ref": "#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/ConfigStoreNameParameter"
+          },
+          {
+            "$ref": "#/parameters/ApiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The request was successful; the request was well-formed and received properly.",
+            "schema": {
+              "$ref": "#/definitions/PrivateLinkResourceListResult"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-examples": {
+          "PrivateLinkResources_ListGroupIds": {
+            "$ref": "./examples/PrivateLinkResourcesListByConfigurationStore.json"
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppConfiguration/configurationStores/{configStoreName}/privateLinkResources/{groupName}": {
+      "get": {
+        "tags": [
+          "PrivateLinkResources"
+        ],
+        "operationId": "PrivateLinkResources_Get",
+        "description": "Gets a private link resource that need to be created for a configuration store.",
+        "parameters": [
+          {
+            "$ref": "#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/ConfigStoreNameParameter"
+          },
+          {
+            "$ref": "#/parameters/ApiVersionParameter"
+          },
+          {
+            "name": "groupName",
+            "in": "path",
+            "description": "The name of the private link resource group.",
+            "required": true,
+            "type": "string"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The request was successful; the request was well-formed and received properly.",
+            "schema": {
+              "$ref": "#/definitions/PrivateLinkResource"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-examples": {
+          "PrivateLinkResources_Get": {
+            "$ref": "./examples/PrivateLinkResourceGet.json"
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppConfiguration/configurationStores/{configStoreName}/keyValues": {
+      "get": {
+        "tags": [
+          "KeyValues"
+        ],
+        "description": "Lists the key-values for a given configuration store.",
+        "operationId": "KeyValues_ListByConfigurationStore",
+        "parameters": [
+          {
+            "$ref": "#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/ConfigStoreNameParameter"
+          },
+          {
+            "$ref": "#/parameters/ApiVersionParameter"
+          },
+          {
+            "name": "$skipToken",
+            "in": "query",
+            "description": "A skip token is used to continue retrieving items after an operation returns a partial result. If a previous response contains a nextLink element, the value of the nextLink element will include a skipToken parameter that specifies a starting point to use for subsequent calls.",
+            "required": false,
+            "type": "string"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The request was successful; the request was well-formed and received properly.",
+            "schema": {
+              "$ref": "#/definitions/KeyValueListResult"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-examples": {
+          "KeyValues_ListByConfigurationStore": {
+            "$ref": "./examples/ConfigurationStoresListKeyValues.json"
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppConfiguration/configurationStores/{configStoreName}/keyValues/{keyValueName}": {
+      "get": {
+        "tags": [
+          "KeyValues"
+        ],
+        "description": "Gets the properties of the specified key-value.",
+        "operationId": "KeyValues_Get",
+        "parameters": [
+          {
+            "$ref": "#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/ConfigStoreNameParameter"
+          },
+          {
+            "$ref": "#/parameters/ApiVersionParameter"
+          },
+          {
+            "name": "keyValueName",
+            "in": "path",
+            "description": "Identifier of key and label combination. Key and label are joined by $ character. Label is optional.",
+            "required": true,
+            "type": "string"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The request was successful; the request was well-formed and received properly.",
+            "schema": {
+              "$ref": "#/definitions/KeyValue"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-examples": {
+          "KeyValues_Get": {
+            "$ref": "./examples/ConfigurationStoresGetKeyValue.json"
+          }
+        }
+      },
+      "put": {
+        "tags": [
+          "KeyValues"
+        ],
+        "description": "Creates a key-value.",
+        "operationId": "KeyValues_CreateOrUpdate",
+        "parameters": [
+          {
+            "$ref": "#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/ConfigStoreNameParameter"
+          },
+          {
+            "$ref": "#/parameters/ApiVersionParameter"
+          },
+          {
+            "name": "keyValueName",
+            "in": "path",
+            "description": "Identifier of key and label combination. Key and label are joined by $ character. Label is optional.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "keyValueParameters",
+            "in": "body",
+            "description": "The parameters for creating a key-value.",
+            "required": false,
+            "schema": {
+              "$ref": "#/definitions/KeyValue"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The request was successful; the request was well-formed and received properly.",
+            "schema": {
+              "$ref": "#/definitions/KeyValue"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-examples": {
+          "KeyValues_CreateOrUpdate": {
+            "$ref": "./examples/ConfigurationStoresCreateKeyValue.json"
+          }
+        }
+      },
+      "delete": {
+        "tags": [
+          "KeyValues"
+        ],
+        "description": "Deletes a key-value.",
+        "operationId": "KeyValues_Delete",
+        "parameters": [
+          {
+            "$ref": "#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/ConfigStoreNameParameter"
+          },
+          {
+            "$ref": "#/parameters/ApiVersionParameter"
+          },
+          {
+            "name": "keyValueName",
+            "in": "path",
+            "description": "Identifier of key and label combination. Key and label are joined by $ character. Label is optional.",
+            "required": true,
+            "type": "string"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The request was successful; the request was well-formed and received properly."
+          },
+          "202": {
+            "description": "The request was successful; the operation will complete asynchronously."
+          },
+          "204": {
+            "description": "No Content - the specified resource was not found."
+          },
+          "default": {
+            "description": "Error response describing why the operation failed",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-examples": {
+          "KeyValues_Delete": {
+            "$ref": "./examples/ConfigurationStoresDeleteKeyValue.json"
+          }
+        },
+        "x-ms-long-running-operation": true
+      }
+    }
+  },
+  "definitions": {
+    "ConfigurationStoreListResult": {
+      "description": "The result of a request to list configuration stores.",
+      "type": "object",
+      "properties": {
+        "value": {
+          "description": "The collection value.",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/ConfigurationStore"
+          }
+        },
+        "nextLink": {
+          "description": "The URI that can be used to request the next set of paged results.",
+          "type": "string"
+        }
+      }
+    },
+    "ConfigurationStore": {
+      "description": "The configuration store along with all resource properties. The Configuration Store will have all information to begin utilizing it.",
+      "required": [
+        "location",
+        "sku"
+      ],
+      "type": "object",
+      "allOf": [
+        {
+          "$ref": "#/definitions/Resource"
+        }
+      ],
+      "properties": {
+        "identity": {
+          "$ref": "#/definitions/ResourceIdentity",
+          "description": "The managed identity information, if configured."
+        },
+        "properties": {
+          "$ref": "#/definitions/ConfigurationStoreProperties",
+          "description": "The properties of a configuration store.",
+          "x-ms-client-flatten": true
+        },
+        "sku": {
+          "$ref": "#/definitions/Sku",
+          "description": "The sku of the configuration store."
+        }
+      }
+    },
+    "ConfigurationStoreProperties": {
+      "description": "The properties of a configuration store.",
+      "type": "object",
+      "properties": {
+        "provisioningState": {
+          "description": "The provisioning state of the configuration store.",
+          "enum": [
+            "Creating",
+            "Updating",
+            "Deleting",
+            "Succeeded",
+            "Failed",
+            "Canceled"
+          ],
+          "type": "string",
+          "readOnly": true,
+          "x-ms-enum": {
+            "name": "ProvisioningState",
+            "modelAsString": true
+          }
+        },
+        "creationDate": {
+          "format": "date-time",
+          "description": "The creation date of configuration store.",
+          "type": "string",
+          "readOnly": true
+        },
+        "endpoint": {
+          "description": "The DNS endpoint where the configuration store API will be available.",
+          "type": "string",
+          "readOnly": true
+        },
+        "encryption": {
+          "$ref": "#/definitions/EncryptionProperties",
+          "description": "The encryption settings of the configuration store."
+        },
+        "privateEndpointConnections": {
+          "description": "The list of private endpoint connections that are set up for this resource.",
+          "type": "array",
+          "readOnly": true,
+          "items": {
+            "$ref": "#/definitions/PrivateEndpointConnectionReference"
+          }
+        },
+        "publicNetworkAccess": {
+          "description": "Control permission for data plane traffic coming from public networks while private endpoint is enabled.",
+          "enum": [
+            "Enabled",
+            "Disabled"
+          ],
+          "type": "string",
+          "x-ms-enum": {
+            "name": "PublicNetworkAccess",
+            "modelAsString": true
+          }
+        }
+      }
+    },
+    "EncryptionProperties": {
+      "type": "object",
+      "description": "The encryption settings for a configuration store.",
+      "properties": {
+        "keyVaultProperties": {
+          "$ref": "#/definitions/KeyVaultProperties",
+          "description": "Key vault properties."
+        }
+      }
+    },
+    "PrivateEndpointConnectionReference": {
+      "type": "object",
+      "description": "A reference to a related private endpoint connection.",
+      "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
+        },
+        "properties": {
+          "$ref": "#/definitions/PrivateEndpointConnectionProperties",
+          "description": "The properties of a private endpoint connection.",
+          "x-ms-client-flatten": true
+        }
+      }
+    },
+    "KeyVaultProperties": {
+      "type": "object",
+      "description": "Settings concerning key vault encryption for a configuration store.",
+      "properties": {
+        "keyIdentifier": {
+          "description": "The URI of the key vault key used to encrypt data.",
+          "type": "string"
+        },
+        "identityClientId": {
+          "description": "The client id of the identity which will be used to access key vault.",
+          "type": "string"
+        }
+      }
+    },
+    "ConfigurationStoreUpdateParameters": {
+      "description": "The parameters for updating a configuration store.",
+      "type": "object",
+      "properties": {
+        "properties": {
+          "$ref": "#/definitions/ConfigurationStorePropertiesUpdateParameters",
+          "description": "The properties for updating a configuration store.",
+          "x-ms-client-flatten": true
+        },
+        "identity": {
+          "$ref": "#/definitions/ResourceIdentity",
+          "description": "The managed identity information for the configuration store."
+        },
+        "sku": {
+          "$ref": "#/definitions/Sku",
+          "description": "The SKU of the configuration store."
+        },
+        "tags": {
+          "description": "The ARM resource tags.",
+          "type": "object",
+          "additionalProperties": {
+            "type": "string"
+          }
+        }
+      }
+    },
+    "ConfigurationStorePropertiesUpdateParameters": {
+      "description": "The properties for updating a configuration store.",
+      "type": "object",
+      "properties": {
+        "encryption": {
+          "$ref": "#/definitions/EncryptionProperties",
+          "description": "The encryption settings of the configuration store."
+        }
+      }
+    },
+    "CheckNameAvailabilityParameters": {
+      "description": "Parameters used for checking whether a resource name is available.",
+      "required": [
+        "name",
+        "type"
+      ],
+      "type": "object",
+      "properties": {
+        "name": {
+          "description": "The name to check for availability.",
+          "type": "string"
+        },
+        "type": {
+          "description": "The resource type to check for name availability.",
+          "enum": [
+            "Microsoft.AppConfiguration/configurationStores"
+          ],
+          "type": "string",
+          "x-ms-enum": {
+            "name": "ConfigurationResourceType",
+            "modelAsString": true
+          }
+        }
+      }
+    },
+    "NameAvailabilityStatus": {
+      "description": "The result of a request to check the availability of a resource name.",
+      "type": "object",
+      "properties": {
+        "nameAvailable": {
+          "description": "The value indicating whether the resource name is available.",
+          "type": "boolean",
+          "readOnly": true
+        },
+        "message": {
+          "description": "If any, the error message that provides more detail for the reason that the name is not available.",
+          "type": "string",
+          "readOnly": true
+        },
+        "reason": {
+          "description": "If any, the reason that the name is not available.",
+          "type": "string",
+          "readOnly": true
+        }
+      }
+    },
+    "ApiKeyListResult": {
+      "description": "The result of a request to list API keys.",
+      "type": "object",
+      "properties": {
+        "value": {
+          "description": "The collection value.",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/ApiKey"
+          }
+        },
+        "nextLink": {
+          "description": "The URI that can be used to request the next set of paged results.",
+          "type": "string"
+        }
+      }
+    },
+    "ApiKey": {
+      "description": "An API key used for authenticating with a configuration store endpoint.",
+      "type": "object",
+      "properties": {
+        "id": {
+          "description": "The key ID.",
+          "type": "string",
+          "readOnly": true
+        },
+        "name": {
+          "description": "A name for the key describing its usage.",
+          "type": "string",
+          "readOnly": true
+        },
+        "value": {
+          "description": "The value of the key that is used for authentication purposes.",
+          "type": "string",
+          "readOnly": true
+        },
+        "connectionString": {
+          "description": "A connection string that can be used by supporting clients for authentication.",
+          "type": "string",
+          "readOnly": true
+        },
+        "lastModified": {
+          "format": "date-time",
+          "description": "The last time any of the key's properties were modified.",
+          "type": "string",
+          "readOnly": true
+        },
+        "readOnly": {
+          "description": "Whether this key can only be used for read operations.",
+          "type": "boolean",
+          "readOnly": true
+        }
+      }
+    },
+    "RegenerateKeyParameters": {
+      "description": "The parameters used to regenerate an API key.",
+      "type": "object",
+      "properties": {
+        "id": {
+          "description": "The id of the key to regenerate.",
+          "type": "string"
+        }
+      }
+    },
+    "KeyValueListResult": {
+      "description": "The result of a request to list key-values.",
+      "type": "object",
+      "properties": {
+        "value": {
+          "description": "The collection value.",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/KeyValue"
+          }
+        },
+        "nextLink": {
+          "description": "The URI that can be used to request the next set of paged results.",
+          "type": "string"
+        }
+      }
+    },
+    "KeyValue": {
+      "description": "The key-value resource along with all resource properties.",
+      "type": "object",
+      "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
+        },
+        "properties": {
+          "$ref": "#/definitions/KeyValueProperties",
+          "description": "All key-value properties.",
+          "x-ms-client-flatten": true
+        }
+      },
+      "x-ms-azure-resource": true
+    },
+    "KeyValueProperties": {
+      "description": "All key-value properties.",
+      "type": "object",
+      "properties": {
+        "key": {
+          "description": "The primary identifier of a key-value.\r\nThe key is used in unison with the label to uniquely identify a key-value.",
+          "type": "string",
+          "readOnly": true
+        },
+        "label": {
+          "description": "A value used to group key-values.\r\nThe label is used in unison with the key to uniquely identify a key-value.",
+          "type": "string",
+          "readOnly": true
+        },
+        "value": {
+          "description": "The value of the key-value.",
+          "type": "string"
+        },
+        "contentType": {
+          "description": "The content type of the key-value's value.\r\nProviding a proper content-type can enable transformations of values when they are retrieved by applications.",
+          "type": "string"
+        },
+        "eTag": {
+          "description": "An ETag indicating the state of a key-value within a configuration store.",
+          "type": "string",
+          "readOnly": true
+        },
+        "lastModified": {
+          "format": "date-time",
+          "description": "The last time a modifying operation was performed on the given key-value.",
+          "type": "string",
+          "readOnly": true
+        },
+        "locked": {
+          "description": "A value indicating whether the key-value is locked.\r\nA locked key-value may not be modified until it is unlocked.",
+          "type": "boolean",
+          "readOnly": true
+        },
+        "tags": {
+          "description": "A dictionary of tags that can help identify what a key-value may be applicable for.",
+          "type": "object",
+          "additionalProperties": {
+            "type": "string"
+          }
+        }
+      }
+    },
+    "OperationDefinitionListResult": {
+      "description": "The result of a request to list configuration store operations.",
+      "type": "object",
+      "properties": {
+        "value": {
+          "description": "The collection value.",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/OperationDefinition"
+          }
+        },
+        "nextLink": {
+          "description": "The URI that can be used to request the next set of paged results.",
+          "type": "string"
+        }
+      }
+    },
+    "OperationDefinition": {
+      "description": "The definition of a configuration store operation.",
+      "type": "object",
+      "properties": {
+        "name": {
+          "description": "Operation name: {provider}/{resource}/{operation}.",
+          "type": "string"
+        },
+        "isDataAction": {
+          "description": "Indicates whether the operation is a data action",
+          "type": "boolean"
+        },
+        "display": {
+          "$ref": "#/definitions/OperationDefinitionDisplay",
+          "description": "The display information for the configuration store operation."
+        },
+        "origin": {
+          "description": "Origin of the operation",
+          "type": "string"
+        },
+        "properties": {
+          "$ref": "#/definitions/OperationProperties",
+          "description": "Properties of the operation"
+        }
+      }
+    },
+    "OperationDefinitionDisplay": {
+      "description": "The display information for a configuration store operation.",
+      "type": "object",
+      "properties": {
+        "provider": {
+          "description": "The resource provider name: Microsoft App Configuration.\"",
+          "type": "string",
+          "readOnly": true
+        },
+        "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"
+        }
+      }
+    },
+    "OperationProperties": {
+      "description": "Extra Operation properties",
+      "type": "object",
+      "properties": {
+        "serviceSpecification": {
+          "$ref": "#/definitions/ServiceSpecification",
+          "description": "Service specifications of the operation"
+        }
+      }
+    },
+    "ServiceSpecification": {
+      "description": "Service specification payload",
+      "type": "object",
+      "properties": {
+        "logSpecifications": {
+          "description": "Specifications of the Log for Azure Monitoring",
+          "uniqueItems": false,
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/LogSpecification"
+          }
+        },
+        "metricSpecifications": {
+          "description": "Specifications of the Metrics for Azure Monitoring",
+          "uniqueItems": false,
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/MetricSpecification"
+          }
+        }
+      }
+    },
+    "LogSpecification": {
+      "description": "Specifications of the Log for Azure Monitoring",
+      "type": "object",
+      "properties": {
+        "name": {
+          "description": "Name of the log",
+          "type": "string"
+        },
+        "displayName": {
+          "description": "Localized friendly display name of the log",
+          "type": "string"
+        },
+        "blobDuration": {
+          "description": "Blob duration of the log",
+          "type": "string"
+        }
+      }
+    },
+    "MetricSpecification": {
+      "description": "Specifications of the Metrics for Azure Monitoring",
+      "type": "object",
+      "properties": {
+        "name": {
+          "description": "Name of the metric",
+          "type": "string"
+        },
+        "displayName": {
+          "description": "Localized friendly display name of the metric",
+          "type": "string"
+        },
+        "displayDescription": {
+          "description": "Localized friendly description of the metric",
+          "type": "string"
+        },
+        "unit": {
+          "description": "Unit that makes sense for the metric",
+          "type": "string"
+        },
+        "aggregationType": {
+          "description": "Only provide one value for this field. Valid values: Average, Minimum, Maximum, Total, Count.",
+          "type": "string"
+        },
+        "internalMetricName": {
+          "description": "Internal metric name.",
+          "type": "string"
+        },
+        "dimensions": {
+          "description": "Dimensions of the metric",
+          "uniqueItems": false,
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/MetricDimension"
+          }
+        }
+      }
+    },
+    "MetricDimension": {
+      "description": "Specifications of the Dimension of metrics",
+      "type": "object",
+      "properties": {
+        "name": {
+          "description": "Name of the dimension",
+          "type": "string"
+        },
+        "displayName": {
+          "description": "Localized friendly display name of the dimension",
+          "type": "string"
+        },
+        "internalName": {
+          "description": "Internal name of the dimension.",
+          "type": "string"
+        }
+      }
+    },
+    "ResourceIdentity": {
+      "type": "object",
+      "description": "An identity that can be associated with a resource.",
+      "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 identities.",
+          "enum": [
+            "None",
+            "SystemAssigned",
+            "UserAssigned",
+            "SystemAssigned, UserAssigned"
+          ],
+          "type": "string",
+          "x-ms-enum": {
+            "name": "IdentityType",
+            "modelAsString": true
+          }
+        },
+        "userAssignedIdentities": {
+          "description": "The list of user-assigned identities associated with the resource. The user-assigned identity dictionary keys will be ARM resource ids in the form: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.",
+          "type": "object",
+          "additionalProperties": {
+            "$ref": "#/definitions/UserIdentity"
+          }
+        },
+        "principalId": {
+          "description": "The principal id of the identity. This property will only be provided for a system-assigned identity.",
+          "type": "string",
+          "readOnly": true
+        },
+        "tenantId": {
+          "description": "The tenant id associated with the resource's identity. This property will only be provided for a system-assigned identity.",
+          "type": "string",
+          "readOnly": true
+        }
+      }
+    },
+    "UserIdentity": {
+      "type": "object",
+      "description": "A resource identity that is managed by the user of the service.",
+      "properties": {
+        "principalId": {
+          "description": "The principal ID of the user-assigned identity.",
+          "type": "string",
+          "readOnly": true
+        },
+        "clientId": {
+          "description": "The client ID of the user-assigned identity.",
+          "type": "string",
+          "readOnly": true
+        }
+      }
+    },
+    "Sku": {
+      "type": "object",
+      "required": [
+        "name"
+      ],
+      "properties": {
+        "name": {
+          "description": "The SKU name of the configuration store.",
+          "type": "string"
+        }
+      },
+      "description": "Describes a configuration store SKU."
+    },
+    "ErrorDetails": {
+      "description": "The details of the error.",
+      "properties": {
+        "code": {
+          "description": "Error code.",
+          "type": "string",
+          "readOnly": true
+        },
+        "message": {
+          "description": "Error message indicating why the operation failed.",
+          "type": "string",
+          "readOnly": true
+        }
+      }
+    },
+    "ErrorResponse": {
+      "description": "Error response indicates that the service is not able to process the incoming request. The reason is provided in the error message.",
+      "type": "object",
+      "properties": {
+        "error": {
+          "description": "The details of the error.",
+          "$ref": "#/definitions/ErrorDetails"
+        }
+      }
+    },
+    "Resource": {
+      "description": "An Azure resource.",
+      "required": [
+        "location"
+      ],
+      "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
+        },
+        "location": {
+          "description": "The location of the resource. This cannot be changed after the resource is created.",
+          "type": "string",
+          "x-ms-mutability": [
+            "read",
+            "create"
+          ]
+        },
+        "tags": {
+          "description": "The tags of the resource.",
+          "type": "object",
+          "additionalProperties": {
+            "type": "string"
+          }
+        }
+      },
+      "x-ms-azure-resource": true
+    },
+    "PrivateEndpointConnectionListResult": {
+      "type": "object",
+      "description": "A list of private endpoint connections",
+      "properties": {
+        "value": {
+          "description": "The collection value.",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/PrivateEndpointConnection"
+          }
+        },
+        "nextLink": {
+          "description": "The URI that can be used to request the next set of paged results.",
+          "type": "string"
+        }
+      }
+    },
+    "PrivateEndpointConnection": {
+      "description": "A private endpoint connection",
+      "type": "object",
+      "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
+        },
+        "properties": {
+          "$ref": "#/definitions/PrivateEndpointConnectionProperties",
+          "description": "The properties of a private endpoint.",
+          "x-ms-client-flatten": true
+        }
+      },
+      "x-ms-azure-resource": true
+    },
+    "PrivateEndpointConnectionProperties": {
+      "type": "object",
+      "description": "Properties of a private endpoint connection.",
+      "properties": {
+        "provisioningState": {
+          "enum": [
+            "Creating",
+            "Updating",
+            "Deleting",
+            "Succeeded",
+            "Failed",
+            "Canceled"
+          ],
+          "type": "string",
+          "readOnly": true,
+          "description": "The provisioning status of the private endpoint connection.",
+          "x-ms-enum": {
+            "name": "ProvisioningState",
+            "modelAsString": true
+          }
+        },
+        "privateEndpoint": {
+          "$ref": "#/definitions/PrivateEndpoint",
+          "description": "The resource of private endpoint."
+        },
+        "privateLinkServiceConnectionState": {
+          "$ref": "#/definitions/PrivateLinkServiceConnectionState",
+          "description": "A collection of information about the state of the connection between service consumer and provider."
+        }
+      },
+      "required": [
+        "privateLinkServiceConnectionState"
+      ]
+    },
+    "PrivateEndpoint": {
+      "type": "object",
+      "description": "Private endpoint which a connection belongs to.",
+      "properties": {
+        "id": {
+          "description": "The resource Id for private endpoint",
+          "type": "string"
+        }
+      }
+    },
+    "PrivateLinkServiceConnectionState": {
+      "description": "The state of a private link service connection.",
+      "type": "object",
+      "properties": {
+        "status": {
+          "enum": [
+            "Pending",
+            "Approved",
+            "Rejected",
+            "Disconnected"
+          ],
+          "type": "string",
+          "description": "The private link service connection status.",
+          "x-ms-enum": {
+            "name": "ConnectionStatus",
+            "modelAsString": true
+          }
+        },
+        "description": {
+          "type": "string",
+          "description": "The private link service connection description."
+        },
+        "actionsRequired": {
+          "enum": [
+            "None",
+            "Recreate"
+          ],
+          "type": "string",
+          "readOnly": true,
+          "description": "Any action that is required beyond basic workflow (approve/ reject/ disconnect)",
+          "x-ms-enum": {
+            "name": "ActionsRequired",
+            "modelAsString": true
+          }
+        }
+      }
+    },
+    "PrivateLinkResourceListResult": {
+      "type": "object",
+      "description": "A list of private link resources.",
+      "properties": {
+        "value": {
+          "description": "The collection value.",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/PrivateLinkResource"
+          }
+        },
+        "nextLink": {
+          "description": "The URI that can be used to request the next set of paged results.",
+          "type": "string"
+        }
+      }
+    },
+    "PrivateLinkResource": {
+      "type": "object",
+      "description": "A resource that supports private link capabilities.",
+      "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
+        },
+        "properties": {
+          "$ref": "#/definitions/PrivateLinkResourceProperties",
+          "description": "Private link resource properties.",
+          "x-ms-client-flatten": true
+        }
+      }
+    },
+    "PrivateLinkResourceProperties": {
+      "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
+        },
+        "requiredZoneNames": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "readOnly": true,
+          "description": "The list of required DNS zone names of the private link resource."
+        }
+      },
+      "description": "Properties of a private link resource."
+    }
+  },
+  "parameters": {
+    "SubscriptionIdParameter": {
+      "name": "subscriptionId",
+      "in": "path",
+      "description": "The Microsoft Azure subscription ID.",
+      "required": true,
+      "type": "string"
+    },
+    "ResourceGroupNameParameter": {
+      "name": "resourceGroupName",
+      "in": "path",
+      "description": "The name of the resource group to which the container registry belongs.",
+      "required": true,
+      "type": "string",
+      "x-ms-parameter-location": "method"
+    },
+    "ConfigStoreNameParameter": {
+      "name": "configStoreName",
+      "in": "path",
+      "description": "The name of the configuration store.",
+      "required": true,
+      "type": "string",
+      "maxLength": 50,
+      "minLength": 5,
+      "pattern": "^[a-zA-Z0-9_-]*$",
+      "x-ms-parameter-location": "method"
+    },
+    "ApiVersionParameter": {
+      "name": "api-version",
+      "in": "query",
+      "description": "The client API version.",
+      "required": true,
+      "type": "string"
+    }
+  },
+  "securityDefinitions": {
+    "azure_auth": {
+      "flow": "implicit",
+      "authorizationUrl": "https://login.microsoftonline.com/common/oauth2/authorize",
+      "scopes": {
+        "user_impersonation": "impersonate your user account"
+      },
+      "type": "oauth2",
+      "description": "Azure Active Directory OAuth2 Flow"
+    }
+  },
+  "security": [
+    {
+      "azure_auth": [
+        "user_impersonation"
+      ]
+    }
+  ]
+}
diff --git a/specification/appconfiguration/resource-manager/Microsoft.AppConfiguration/preview/2020-07-01-preview/examples/CheckNameAvailable.json b/specification/appconfiguration/resource-manager/Microsoft.AppConfiguration/preview/2020-07-01-preview/examples/CheckNameAvailable.json
new file mode 100644
index 000000000000..60426fdaac53
--- /dev/null
+++ b/specification/appconfiguration/resource-manager/Microsoft.AppConfiguration/preview/2020-07-01-preview/examples/CheckNameAvailable.json
@@ -0,0 +1,19 @@
+{
+  "parameters": {
+    "subscriptionId": "c80fb759-c965-4c6a-9110-9b2b2d038882",
+    "api-version": "2020-07-01-preview",
+    "checkNameAvailabilityParameters": {
+      "name": "contoso",
+      "type": "Microsoft.AppConfiguration/configurationStores"
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "nameAvailable": true,
+        "message": "The specified name is available.",
+        "reason": null
+      }
+    }
+  }
+}
diff --git a/specification/appconfiguration/resource-manager/Microsoft.AppConfiguration/preview/2020-07-01-preview/examples/CheckNameNotAvailable.json b/specification/appconfiguration/resource-manager/Microsoft.AppConfiguration/preview/2020-07-01-preview/examples/CheckNameNotAvailable.json
new file mode 100644
index 000000000000..10e2a074401d
--- /dev/null
+++ b/specification/appconfiguration/resource-manager/Microsoft.AppConfiguration/preview/2020-07-01-preview/examples/CheckNameNotAvailable.json
@@ -0,0 +1,19 @@
+{
+  "parameters": {
+    "subscriptionId": "c80fb759-c965-4c6a-9110-9b2b2d038882",
+    "api-version": "2020-07-01-preview",
+    "checkNameAvailabilityParameters": {
+      "name": "contoso",
+      "type": "Microsoft.AppConfiguration/configurationStores"
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "nameAvailable": false,
+        "reason": "AlreadyExists",
+        "message": "The specified name is already in use."
+      }
+    }
+  }
+}
diff --git a/specification/appconfiguration/resource-manager/Microsoft.AppConfiguration/preview/2020-07-01-preview/examples/ConfigurationStoresCreate.json b/specification/appconfiguration/resource-manager/Microsoft.AppConfiguration/preview/2020-07-01-preview/examples/ConfigurationStoresCreate.json
new file mode 100644
index 000000000000..0e5185e46219
--- /dev/null
+++ b/specification/appconfiguration/resource-manager/Microsoft.AppConfiguration/preview/2020-07-01-preview/examples/ConfigurationStoresCreate.json
@@ -0,0 +1,73 @@
+{
+  "parameters": {
+    "subscriptionId": "c80fb759-c965-4c6a-9110-9b2b2d038882",
+    "resourceGroupName": "myResourceGroup",
+    "configStoreName": "contoso",
+    "api-version": "2020-07-01-preview",
+    "configStoreCreationParameters": {
+      "location": "westus",
+      "sku": {
+        "name": "Standard"
+      },
+      "tags": {
+        "myTag": "myTagValue"
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "type": "Microsoft.AppConfiguration/configurationStores",
+        "properties": {
+          "provisioningState": "Succeeded",
+          "creationDate": "2018-04-24T16:30:55+00:00",
+          "endpoint": "https://contoso.azconfig.io",
+          "encryption": {
+            "keyVaultProperties": {
+              "keyIdentifier": null,
+              "identityClientId": null
+            }
+          },
+          "privateEndpointConnections": [],
+          "publicNetworkAccess": "Disabled"
+        },
+        "sku": {
+          "name": "Standard"
+        },
+        "id": "/subscriptions/c80fb759-c965-4c6a-9110-9b2b2d038882/resourceGroups/myResourceGroup/providers/Microsoft.AppConfiguration/configurationStores/contoso",
+        "name": "contoso",
+        "location": "westus",
+        "tags": {
+          "myTag": "myTagValue"
+        }
+      }
+    },
+    "201": {
+      "body": {
+        "type": "Microsoft.AppConfiguration/configurationStores",
+        "properties": {
+          "provisioningState": "Creating",
+          "creationDate": "2018-04-24T16:30:55+00:00",
+          "endpoint": "https://contoso.azconfig.io",
+          "encryption": {
+            "keyVaultProperties": {
+              "keyIdentifier": null,
+              "identityClientId": null
+            }
+          },
+          "privateEndpointConnections": [],
+          "publicNetworkAccess": "Disabled"
+        },
+        "sku": {
+          "name": "Standard"
+        },
+        "id": "/subscriptions/c80fb759-c965-4c6a-9110-9b2b2d038882/resourceGroups/myResourceGroup/providers/Microsoft.AppConfiguration/configurationStores/contoso",
+        "name": "contoso",
+        "location": "westus",
+        "tags": {
+          "myTag": "myTagValue"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/appconfiguration/resource-manager/Microsoft.AppConfiguration/preview/2020-07-01-preview/examples/ConfigurationStoresCreateKeyValue.json b/specification/appconfiguration/resource-manager/Microsoft.AppConfiguration/preview/2020-07-01-preview/examples/ConfigurationStoresCreateKeyValue.json
new file mode 100644
index 000000000000..3fa26edbd9ed
--- /dev/null
+++ b/specification/appconfiguration/resource-manager/Microsoft.AppConfiguration/preview/2020-07-01-preview/examples/ConfigurationStoresCreateKeyValue.json
@@ -0,0 +1,40 @@
+{
+  "parameters": {
+    "subscriptionId": "c80fb759-c965-4c6a-9110-9b2b2d038882",
+    "resourceGroupName": "myResourceGroup",
+    "configStoreName": "contoso",
+    "api-version": "2020-07-01-preview",
+    "keyValueName": "myKey$myLabel",
+    "keyValueParameters": {
+      "properties": {
+        "value": "myValue",
+        "tags": {
+          "tag1": "tagValue1",
+          "tag2": "tagValue2"
+        }
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "type": "Microsoft.AppConfiguration/configurationStores/keyValues",
+        "properties": {
+          "key": "myKey",
+          "label": "myLabel",
+          "value": "myValue",
+          "contentType": "",
+          "eTag": "IhDxoa8VkXxPsYsemBlxvV0d5fp",
+          "lastModified": "2020-06-23T06:42:24+00:00",
+          "locked": false,
+          "tags": {
+            "tag1": "tagValue1",
+            "tag2": "tagValue2"
+          }
+        },
+        "id": "/subscriptions/c80fb759-c965-4c6a-9110-9b2b2d038882/resourceGroups/myResourceGroup/providers/Microsoft.AppConfiguration/configurationStores/contoso/keyValues/myKey$myLabel",
+        "name": "myKey$myLabel"
+      }
+    }
+  }
+}
diff --git a/specification/appconfiguration/resource-manager/Microsoft.AppConfiguration/preview/2020-07-01-preview/examples/ConfigurationStoresCreatePrivateEndpointConnection.json b/specification/appconfiguration/resource-manager/Microsoft.AppConfiguration/preview/2020-07-01-preview/examples/ConfigurationStoresCreatePrivateEndpointConnection.json
new file mode 100644
index 000000000000..a026b6f66db1
--- /dev/null
+++ b/specification/appconfiguration/resource-manager/Microsoft.AppConfiguration/preview/2020-07-01-preview/examples/ConfigurationStoresCreatePrivateEndpointConnection.json
@@ -0,0 +1,55 @@
+{
+  "parameters": {
+    "subscriptionId": "c80fb759-c965-4c6a-9110-9b2b2d038882",
+    "resourceGroupName": "myResourceGroup",
+    "configStoreName": "contoso",
+    "privateEndpointConnectionName": "myConnection",
+    "api-version": "2020-07-01-preview",
+    "privateEndpointConnection": {
+      "properties": {
+        "privateLinkServiceConnectionState": {
+          "status": "Approved",
+          "description": "Auto-Approved"
+        }
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/c80fb759-c965-4c6a-9110-9b2b2d038882/resourceGroups/myResourceGroup/providers/Microsoft.AppConfiguration/configurationStores/contoso/privateEndpointConnections/myConnection",
+        "name": "myConnection",
+        "type": "Microsoft.AppConfiguration/configurationStores/privateEndpointConnections",
+        "properties": {
+          "provisioningState": "Succeeded",
+          "privateEndpoint": {
+            "id": "/subscriptions/c80fb759-c965-4c6a-9110-9b2b2d038882/resourceGroups/myResourceGroup/providers/Microsoft.Network/privateEndpoints/peexample01"
+          },
+          "privateLinkServiceConnectionState": {
+            "status": "Approved",
+            "description": "Auto-Approved",
+            "actionsRequired": "None"
+          }
+        }
+      }
+    },
+    "201": {
+      "body": {
+        "id": "/subscriptions/c80fb759-c965-4c6a-9110-9b2b2d038882/resourceGroups/myResourceGroup/providers/Microsoft.AppConfiguration/configurationStores/contoso/privateEndpointConnections/myConnection",
+        "name": "myConnection",
+        "type": "Microsoft.AppConfiguration/configurationStores/privateEndpointConnections",
+        "properties": {
+          "provisioningState": "Succeeded",
+          "privateEndpoint": {
+            "id": "/subscriptions/c80fb759-c965-4c6a-9110-9b2b2d038882/resourceGroups/myResourceGroup/providers/Microsoft.Network/privateEndpoints/peexample01"
+          },
+          "privateLinkServiceConnectionState": {
+            "status": "Approved",
+            "description": "Auto-Approved",
+            "actionsRequired": "None"
+          }
+        }
+      }
+    }
+  }
+}
diff --git a/specification/appconfiguration/resource-manager/Microsoft.AppConfiguration/preview/2020-07-01-preview/examples/ConfigurationStoresCreateWithIdentity.json b/specification/appconfiguration/resource-manager/Microsoft.AppConfiguration/preview/2020-07-01-preview/examples/ConfigurationStoresCreateWithIdentity.json
new file mode 100644
index 000000000000..79d2c7e12504
--- /dev/null
+++ b/specification/appconfiguration/resource-manager/Microsoft.AppConfiguration/preview/2020-07-01-preview/examples/ConfigurationStoresCreateWithIdentity.json
@@ -0,0 +1,101 @@
+{
+  "parameters": {
+    "subscriptionId": "c80fb759-c965-4c6a-9110-9b2b2d038882",
+    "resourceGroupName": "myResourceGroup",
+    "configStoreName": "contoso",
+    "api-version": "2020-07-01-preview",
+    "configStoreCreationParameters": {
+      "location": "westus",
+      "sku": {
+        "name": "Standard"
+      },
+      "tags": {
+        "myTag": "myTagValue"
+      },
+      "identity": {
+        "type": "SystemAssigned, UserAssigned",
+        "userAssignedIdentities": {
+          "/subscriptions/c80fb759-c965-4c6a-9110-9b2b2d038882/resourcegroups/myResourceGroup1/providers/Microsoft.ManagedIdentity/userAssignedIdentities/identity2": {}
+        }
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "type": "Microsoft.AppConfiguration/configurationStores",
+        "properties": {
+          "provisioningState": "Succeeded",
+          "creationDate": "2018-04-24T16:30:55+00:00",
+          "endpoint": "https://contoso.azconfig.io",
+          "encryption": {
+            "keyVaultProperties": {
+              "keyIdentifier": null,
+              "identityClientId": null
+            }
+          },
+          "privateEndpointConnections": [],
+          "publicNetworkAccess": "Disabled"
+        },
+        "sku": {
+          "name": "Standard"
+        },
+        "identity": {
+          "principalId": "AAAAAAAA-AAAA-AAAA-AAAA-AAAAAAAAAAAA",
+          "tenantId": "BBBBBBBB-BBBB-BBBB-BBBB-BBBBBBBBBBBB",
+          "type": "SystemAssigned, UserAssigned",
+          "userAssignedIdentities": {
+            "/subscriptions/c80fb759-c965-4c6a-9110-9b2b2d038882/resourcegroups/myResourceGroup1/providers/Microsoft.ManagedIdentity/userAssignedIdentities/identity2": {
+              "clientId": "CCCCCCCC-CCCC-CCCC-CCCC-CCCCCCCCCCCC",
+              "principalId": "DDDDDDDD-DDDD-DDDD-DDDD-DDDDDDDDDDDD"
+            }
+          }
+        },
+        "id": "/subscriptions/c80fb759-c965-4c6a-9110-9b2b2d038882/resourceGroups/myResourceGroup/providers/Microsoft.AppConfiguration/configurationStores/contoso",
+        "name": "contoso",
+        "location": "westus",
+        "tags": {
+          "myTag": "myTagValue"
+        }
+      }
+    },
+    "201": {
+      "body": {
+        "type": "Microsoft.AppConfiguration/configurationStores",
+        "properties": {
+          "provisioningState": "Creating",
+          "creationDate": "2018-04-24T16:30:55+00:00",
+          "endpoint": "https://contoso.azconfig.io",
+          "encryption": {
+            "keyVaultProperties": {
+              "keyIdentifier": null,
+              "identityClientId": null
+            }
+          },
+          "privateEndpointConnections": [],
+          "publicNetworkAccess": "Disabled"
+        },
+        "sku": {
+          "name": "Standard"
+        },
+        "identity": {
+          "principalId": "AAAAAAAA-AAAA-AAAA-AAAA-AAAAAAAAAAAA",
+          "tenantId": "BBBBBBBB-BBBB-BBBB-BBBB-BBBBBBBBBBBB",
+          "type": "SystemAssigned, UserAssigned",
+          "userAssignedIdentities": {
+            "/subscriptions/c80fb759-c965-4c6a-9110-9b2b2d038882/resourcegroups/myResourceGroup1/providers/Microsoft.ManagedIdentity/userAssignedIdentities/identity2": {
+              "clientId": "CCCCCCCC-CCCC-CCCC-CCCC-CCCCCCCCCCCC",
+              "principalId": "DDDDDDDD-DDDD-DDDD-DDDD-DDDDDDDDDDDD"
+            }
+          }
+        },
+        "id": "/subscriptions/c80fb759-c965-4c6a-9110-9b2b2d038882/resourceGroups/myResourceGroup/providers/Microsoft.AppConfiguration/configurationStores/contoso",
+        "name": "contoso",
+        "location": "westus",
+        "tags": {
+          "myTag": "myTagValue"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/appconfiguration/resource-manager/Microsoft.AppConfiguration/preview/2020-07-01-preview/examples/ConfigurationStoresDelete.json b/specification/appconfiguration/resource-manager/Microsoft.AppConfiguration/preview/2020-07-01-preview/examples/ConfigurationStoresDelete.json
new file mode 100644
index 000000000000..34d501fb71f3
--- /dev/null
+++ b/specification/appconfiguration/resource-manager/Microsoft.AppConfiguration/preview/2020-07-01-preview/examples/ConfigurationStoresDelete.json
@@ -0,0 +1,13 @@
+{
+  "parameters": {
+    "subscriptionId": "c80fb759-c965-4c6a-9110-9b2b2d038882",
+    "resourceGroupName": "myResourceGroup",
+    "configStoreName": "contoso",
+    "api-version": "2020-07-01-preview"
+  },
+  "responses": {
+    "200": {},
+    "202": {},
+    "204": {}
+  }
+}
diff --git a/specification/appconfiguration/resource-manager/Microsoft.AppConfiguration/preview/2020-07-01-preview/examples/ConfigurationStoresDeleteKeyValue.json b/specification/appconfiguration/resource-manager/Microsoft.AppConfiguration/preview/2020-07-01-preview/examples/ConfigurationStoresDeleteKeyValue.json
new file mode 100644
index 000000000000..6ca474efd8aa
--- /dev/null
+++ b/specification/appconfiguration/resource-manager/Microsoft.AppConfiguration/preview/2020-07-01-preview/examples/ConfigurationStoresDeleteKeyValue.json
@@ -0,0 +1,14 @@
+{
+  "parameters": {
+    "subscriptionId": "c80fb759-c965-4c6a-9110-9b2b2d038882",
+    "resourceGroupName": "myResourceGroup",
+    "configStoreName": "contoso",
+    "api-version": "2020-07-01-preview",
+    "keyValueName": "myKey$myLabel"
+  },
+  "responses": {
+    "200": {},
+    "202": {},
+    "204": {}
+  }
+}
diff --git a/specification/appconfiguration/resource-manager/Microsoft.AppConfiguration/preview/2020-07-01-preview/examples/ConfigurationStoresDeletePrivateEndpointConnection.json b/specification/appconfiguration/resource-manager/Microsoft.AppConfiguration/preview/2020-07-01-preview/examples/ConfigurationStoresDeletePrivateEndpointConnection.json
new file mode 100644
index 000000000000..ecbb9f0539e4
--- /dev/null
+++ b/specification/appconfiguration/resource-manager/Microsoft.AppConfiguration/preview/2020-07-01-preview/examples/ConfigurationStoresDeletePrivateEndpointConnection.json
@@ -0,0 +1,14 @@
+{
+  "parameters": {
+    "subscriptionId": "c80fb759-c965-4c6a-9110-9b2b2d038882",
+    "resourceGroupName": "myResourceGroup",
+    "configStoreName": "contoso",
+    "privateEndpointConnectionName": "myConnection",
+    "api-version": "2020-07-01-preview"
+  },
+  "responses": {
+    "200": {},
+    "202": {},
+    "204": {}
+  }
+}
diff --git a/specification/appconfiguration/resource-manager/Microsoft.AppConfiguration/preview/2020-07-01-preview/examples/ConfigurationStoresGet.json b/specification/appconfiguration/resource-manager/Microsoft.AppConfiguration/preview/2020-07-01-preview/examples/ConfigurationStoresGet.json
new file mode 100644
index 000000000000..d41981042b67
--- /dev/null
+++ b/specification/appconfiguration/resource-manager/Microsoft.AppConfiguration/preview/2020-07-01-preview/examples/ConfigurationStoresGet.json
@@ -0,0 +1,40 @@
+{
+  "parameters": {
+    "subscriptionId": "c80fb759-c965-4c6a-9110-9b2b2d038882",
+    "resourceGroupName": "myResourceGroup",
+    "configStoreName": "contoso",
+    "api-version": "2020-07-01-preview"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "type": "Microsoft.AppConfiguration/configurationStores",
+        "properties": {
+          "provisioningState": "Succeeded",
+          "creationDate": "2018-04-24T16:30:55+00:00",
+          "endpoint": "https://contoso.azconfig.io",
+          "encryption": {
+            "keyVaultProperties": {
+              "keyIdentifier": null,
+              "identityClientId": null
+            }
+          },
+          "privateEndpointConnections": [],
+          "publicNetworkAccess": "Disabled"
+        },
+        "sku": {
+          "name": "Standard"
+        },
+        "identity": {
+          "principalId": "AAAAAAAA-AAAA-AAAA-AAAA-AAAAAAAAAAAA",
+          "tenantId": "BBBBBBBB-BBBB-BBBB-BBBB-BBBBBBBBBBBB",
+          "type": "SystemAssigned"
+        },
+        "id": "/subscriptions/c80fb759-c965-4c6a-9110-9b2b2d038882/resourceGroups/myResourceGroup/providers/Microsoft.AppConfiguration/configurationStores/contoso",
+        "name": "contoso",
+        "location": "westus",
+        "tags": {}
+      }
+    }
+  }
+}
diff --git a/specification/appconfiguration/resource-manager/Microsoft.AppConfiguration/preview/2020-07-01-preview/examples/ConfigurationStoresGetKeyValue.json b/specification/appconfiguration/resource-manager/Microsoft.AppConfiguration/preview/2020-07-01-preview/examples/ConfigurationStoresGetKeyValue.json
new file mode 100644
index 000000000000..356021bb1e5e
--- /dev/null
+++ b/specification/appconfiguration/resource-manager/Microsoft.AppConfiguration/preview/2020-07-01-preview/examples/ConfigurationStoresGetKeyValue.json
@@ -0,0 +1,31 @@
+{
+  "parameters": {
+    "subscriptionId": "c80fb759-c965-4c6a-9110-9b2b2d038882",
+    "resourceGroupName": "myResourceGroup",
+    "configStoreName": "contoso",
+    "api-version": "2020-07-01-preview",
+    "keyValueName": "myKey$myLabel"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "type": "Microsoft.AppConfiguration/configurationStores/keyValues",
+        "properties": {
+          "key": "myKey",
+          "label": "myLabel",
+          "value": "myValue",
+          "contentType": "",
+          "eTag": "IhDxoa8VkXxPsYsemBlxvV0d5fp",
+          "lastModified": "2020-06-23T06:42:24+00:00",
+          "locked": false,
+          "tags": {
+            "tag1": "tagValue1",
+            "tag2": "tagValue2"
+          }
+        },
+        "id": "/subscriptions/c80fb759-c965-4c6a-9110-9b2b2d038882/resourceGroups/myResourceGroup/providers/Microsoft.AppConfiguration/configurationStores/contoso/keyValues/myKey$myLabel",
+        "name": "myKey$myLabel"
+      }
+    }
+  }
+}
diff --git a/specification/appconfiguration/resource-manager/Microsoft.AppConfiguration/preview/2020-07-01-preview/examples/ConfigurationStoresGetPrivateEndpointConnection.json b/specification/appconfiguration/resource-manager/Microsoft.AppConfiguration/preview/2020-07-01-preview/examples/ConfigurationStoresGetPrivateEndpointConnection.json
new file mode 100644
index 000000000000..9ce8bf38b42b
--- /dev/null
+++ b/specification/appconfiguration/resource-manager/Microsoft.AppConfiguration/preview/2020-07-01-preview/examples/ConfigurationStoresGetPrivateEndpointConnection.json
@@ -0,0 +1,29 @@
+{
+  "parameters": {
+    "subscriptionId": "c80fb759-c965-4c6a-9110-9b2b2d038882",
+    "resourceGroupName": "myResourceGroup",
+    "configStoreName": "contoso",
+    "privateEndpointConnectionName": "myConnection",
+    "api-version": "2020-07-01-preview"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/c80fb759-c965-4c6a-9110-9b2b2d038882/resourceGroups/myResourceGroup/providers/Microsoft.AppConfiguration/configurationStores/contoso/privateEndpointConnections/myConnection",
+        "name": "myConnection",
+        "type": "Microsoft.AppConfiguration/configurationStores/privateEndpointConnections",
+        "properties": {
+          "provisioningState": "Succeeded",
+          "privateEndpoint": {
+            "id": "/subscriptions/c80fb759-c965-4c6a-9110-9b2b2d038882/resourceGroups/myResourceGroup/providers/Microsoft.Network/privateEndpoints/peexample01"
+          },
+          "privateLinkServiceConnectionState": {
+            "status": "Approved",
+            "description": "Auto-Approved",
+            "actionsRequired": "None"
+          }
+        }
+      }
+    }
+  }
+}
diff --git a/specification/appconfiguration/resource-manager/Microsoft.AppConfiguration/preview/2020-07-01-preview/examples/ConfigurationStoresList.json b/specification/appconfiguration/resource-manager/Microsoft.AppConfiguration/preview/2020-07-01-preview/examples/ConfigurationStoresList.json
new file mode 100644
index 000000000000..c1ba19057f81
--- /dev/null
+++ b/specification/appconfiguration/resource-manager/Microsoft.AppConfiguration/preview/2020-07-01-preview/examples/ConfigurationStoresList.json
@@ -0,0 +1,70 @@
+{
+  "parameters": {
+    "subscriptionId": "c80fb759-c965-4c6a-9110-9b2b2d038882",
+    "api-version": "2020-07-01-preview"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "type": "Microsoft.AppConfiguration/configurationStores",
+            "properties": {
+              "provisioningState": "Succeeded",
+              "creationDate": "2018-04-24T16:30:55+00:00",
+              "endpoint": "https://contoso.azconfig.io",
+              "encryption": {
+                "keyVaultProperties": {
+                  "keyIdentifier": null,
+                  "identityClientId": null
+                }
+              },
+              "privateEndpointConnections": [],
+              "publicNetworkAccess": "Disabled"
+            },
+            "sku": {
+              "name": "Standard"
+            },
+            "identity": {
+              "principalId": "AAAAAAAA-AAAA-AAAA-AAAA-AAAAAAAAAAAA",
+              "tenantId": "BBBBBBBB-BBBB-BBBB-BBBB-BBBBBBBBBBBB",
+              "type": "SystemAssigned"
+            },
+            "id": "/subscriptions/c80fb759-c965-4c6a-9110-9b2b2d038882/resourceGroups/myResourceGroup/providers/Microsoft.AppConfiguration/configurationStores/contoso",
+            "name": "contoso",
+            "location": "westus",
+            "tags": {}
+          },
+          {
+            "type": "Microsoft.AppConfiguration/configurationStores",
+            "properties": {
+              "provisioningState": "Succeeded",
+              "creationDate": "2018-04-24T23:06:59+00:00",
+              "endpoint": "https://contoso2.azconfig.io",
+              "encryption": {
+                "keyVaultProperties": {
+                  "keyIdentifier": null,
+                  "identityClientId": null
+                }
+              },
+              "privateEndpointConnections": [],
+              "publicNetworkAccess": "Disabled"
+            },
+            "sku": {
+              "name": "Standard"
+            },
+            "identity": {
+              "principalId": "CCCCCCCC-CCCC-CCCC-CCCC-CCCCCCCCCCCC",
+              "tenantId": "BBBBBBBB-BBBB-BBBB-BBBB-BBBBBBBBBBBB",
+              "type": "SystemAssigned"
+            },
+            "id": "/subscriptions/c80fb759-c965-4c6a-9110-9b2b2d038882/resourceGroups/myResourceGroup/providers/Microsoft.AppConfiguration/configurationStores/contoso2",
+            "name": "contoso2",
+            "location": "westus",
+            "tags": {}
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/appconfiguration/resource-manager/Microsoft.AppConfiguration/preview/2020-07-01-preview/examples/ConfigurationStoresListByResourceGroup.json b/specification/appconfiguration/resource-manager/Microsoft.AppConfiguration/preview/2020-07-01-preview/examples/ConfigurationStoresListByResourceGroup.json
new file mode 100644
index 000000000000..551d59e280a4
--- /dev/null
+++ b/specification/appconfiguration/resource-manager/Microsoft.AppConfiguration/preview/2020-07-01-preview/examples/ConfigurationStoresListByResourceGroup.json
@@ -0,0 +1,61 @@
+{
+  "parameters": {
+    "subscriptionId": "c80fb759-c965-4c6a-9110-9b2b2d038882",
+    "resourceGroupName": "myResourceGroup",
+    "api-version": "2020-07-01-preview"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "type": "Microsoft.AppConfiguration/configurationStores",
+            "properties": {
+              "provisioningState": "Succeeded",
+              "creationDate": "2018-04-24T16:30:55+00:00",
+              "endpoint": "https://contoso.azconfig.io",
+              "encryption": {
+                "keyVaultProperties": {
+                  "keyIdentifier": null,
+                  "identityClientId": null
+                }
+              },
+              "privateEndpointConnections": [],
+              "publicNetworkAccess": "Disabled"
+            },
+            "sku": {
+              "name": "Standard"
+            },
+            "id": "/subscriptions/c80fb759-c965-4c6a-9110-9b2b2d038882/resourceGroups/myResourceGroup/providers/Microsoft.AppConfiguration/configurationStores/contoso",
+            "name": "contoso",
+            "location": "westus",
+            "tags": {}
+          },
+          {
+            "type": "Microsoft.AppConfiguration/configurationStores",
+            "properties": {
+              "provisioningState": "Succeeded",
+              "creationDate": "2018-04-24T23:06:59+00:00",
+              "endpoint": "https://contoso2.azconfig.io",
+              "encryption": {
+                "keyVaultProperties": {
+                  "keyIdentifier": null,
+                  "identityClientId": null
+                }
+              },
+              "privateEndpointConnections": [],
+              "publicNetworkAccess": "Disabled"
+            },
+            "sku": {
+              "name": "Standard"
+            },
+            "id": "/subscriptions/c80fb759-c965-4c6a-9110-9b2b2d038882/resourceGroups/myResourceGroup/providers/Microsoft.AppConfiguration/configurationStores/contoso2",
+            "name": "contoso2",
+            "location": "westus",
+            "tags": {}
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/appconfiguration/resource-manager/Microsoft.AppConfiguration/preview/2020-07-01-preview/examples/ConfigurationStoresListKeyValues.json b/specification/appconfiguration/resource-manager/Microsoft.AppConfiguration/preview/2020-07-01-preview/examples/ConfigurationStoresListKeyValues.json
new file mode 100644
index 000000000000..43c85eb330f1
--- /dev/null
+++ b/specification/appconfiguration/resource-manager/Microsoft.AppConfiguration/preview/2020-07-01-preview/examples/ConfigurationStoresListKeyValues.json
@@ -0,0 +1,52 @@
+{
+  "parameters": {
+    "subscriptionId": "c80fb759-c965-4c6a-9110-9b2b2d038882",
+    "resourceGroupName": "myResourceGroup",
+    "configStoreName": "contoso",
+    "api-version": "2020-07-01-preview"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "type": "Microsoft.AppConfiguration/configurationStores/keyValues",
+            "properties": {
+              "key": "myKey",
+              "label": "myLabel",
+              "value": "myValue",
+              "contentType": "",
+              "eTag": "IhDxoa8VkXxPsYsemBlxvV0d5fp",
+              "lastModified": "2020-06-23T06:42:24+00:00",
+              "locked": false,
+              "tags": {
+                "tag1": "tagValue1",
+                "tag2": "tagValue2"
+              }
+            },
+            "id": "/subscriptions/c80fb759-c965-4c6a-9110-9b2b2d038882/resourceGroups/myResourceGroup/providers/Microsoft.AppConfiguration/configurationStores/contoso/keyValues/myKey$myLabel",
+            "name": "myKey$myLabel"
+          },
+          {
+            "type": "Microsoft.AppConfiguration/configurationStores/keyValues",
+            "properties": {
+              "key": "myKey2",
+              "label": "myLabel2",
+              "value": "myValue",
+              "contentType": "",
+              "eTag": "IfDxoa8VkXxPsYsemBlxvV0d5fp",
+              "lastModified": "2020-06-23T06:42:24+00:00",
+              "locked": false,
+              "tags": {
+                "tag1": "tagValue1",
+                "tag2": "tagValue2"
+              }
+            },
+            "id": "/subscriptions/c80fb759-c965-4c6a-9110-9b2b2d038882/resourceGroups/myResourceGroup/providers/Microsoft.AppConfiguration/configurationStores/contoso/keyValues/myKey2$myLabel2",
+            "name": "myKey2$myLabel2"
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/appconfiguration/resource-manager/Microsoft.AppConfiguration/preview/2020-07-01-preview/examples/ConfigurationStoresListKeys.json b/specification/appconfiguration/resource-manager/Microsoft.AppConfiguration/preview/2020-07-01-preview/examples/ConfigurationStoresListKeys.json
new file mode 100644
index 000000000000..f064d35f0ed6
--- /dev/null
+++ b/specification/appconfiguration/resource-manager/Microsoft.AppConfiguration/preview/2020-07-01-preview/examples/ConfigurationStoresListKeys.json
@@ -0,0 +1,48 @@
+{
+  "parameters": {
+    "subscriptionId": "c80fb759-c965-4c6a-9110-9b2b2d038882",
+    "resourceGroupName": "myResourceGroup",
+    "configStoreName": "contoso",
+    "api-version": "2020-07-01-preview"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "id": "439AD01B4BE67DB1",
+            "name": "Primary",
+            "value": "000000000000000000000000000000000000000000000000000000",
+            "connectionString": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
+            "lastModified": "2018-04-24T16:30:54+00:00",
+            "readOnly": false
+          },
+          {
+            "id": "CB45E100456857B9",
+            "name": "Secondary",
+            "value": "000000000000000000000000000000000000000000000000000000",
+            "connectionString": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
+            "lastModified": "2018-04-24T16:30:54+00:00",
+            "readOnly": false
+          },
+          {
+            "id": "B3AC55B7E71431A9",
+            "name": "Primary Read Only",
+            "value": "000000000000000000000000000000000000000000000000000000",
+            "connectionString": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
+            "lastModified": "2018-04-24T16:30:54+00:00",
+            "readOnly": true
+          },
+          {
+            "id": "E2AF6A9A89DCC177",
+            "name": "Secondary Read Only",
+            "value": "000000000000000000000000000000000000000000000000000000",
+            "connectionString": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
+            "lastModified": "2018-04-24T16:30:54+00:00",
+            "readOnly": true
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/appconfiguration/resource-manager/Microsoft.AppConfiguration/preview/2020-07-01-preview/examples/ConfigurationStoresListPrivateEndpointConnections.json b/specification/appconfiguration/resource-manager/Microsoft.AppConfiguration/preview/2020-07-01-preview/examples/ConfigurationStoresListPrivateEndpointConnections.json
new file mode 100644
index 000000000000..36721dcecc33
--- /dev/null
+++ b/specification/appconfiguration/resource-manager/Microsoft.AppConfiguration/preview/2020-07-01-preview/examples/ConfigurationStoresListPrivateEndpointConnections.json
@@ -0,0 +1,32 @@
+{
+  "parameters": {
+    "subscriptionId": "c80fb759-c965-4c6a-9110-9b2b2d038882",
+    "resourceGroupName": "myResourceGroup",
+    "configStoreName": "contoso",
+    "api-version": "2020-07-01-preview"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "id": "/subscriptions/c80fb759-c965-4c6a-9110-9b2b2d038882/resourceGroups/myResourceGroup/providers/Microsoft.AppConfiguration/configurationStores/contoso/privateEndpointConnections/myConnection",
+            "name": "myConnection",
+            "type": "Microsoft.AppConfiguration/configurationStores/privateEndpointConnections",
+            "properties": {
+              "provisioningState": "Succeeded",
+              "privateEndpoint": {
+                "id": "/subscriptions/c80fb759-c965-4c6a-9110-9b2b2d038882/resourceGroups/myResourceGroup/providers/Microsoft.Network/privateEndpoints/peexample01"
+              },
+              "privateLinkServiceConnectionState": {
+                "status": "Approved",
+                "description": "Auto-Approved",
+                "actionsRequired": "None"
+              }
+            }
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/appconfiguration/resource-manager/Microsoft.AppConfiguration/preview/2020-07-01-preview/examples/ConfigurationStoresRegenerateKey.json b/specification/appconfiguration/resource-manager/Microsoft.AppConfiguration/preview/2020-07-01-preview/examples/ConfigurationStoresRegenerateKey.json
new file mode 100644
index 000000000000..8176bceba950
--- /dev/null
+++ b/specification/appconfiguration/resource-manager/Microsoft.AppConfiguration/preview/2020-07-01-preview/examples/ConfigurationStoresRegenerateKey.json
@@ -0,0 +1,23 @@
+{
+  "parameters": {
+    "subscriptionId": "c80fb759-c965-4c6a-9110-9b2b2d038882",
+    "resourceGroupName": "myResourceGroup",
+    "configStoreName": "contoso",
+    "api-version": "2020-07-01-preview",
+    "regenerateKeyParameters": {
+      "id": "439AD01B4BE67DB1"
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "439AD01B4BE67DB1",
+        "name": "Primary",
+        "value": "000000000000000000000000000000000000000000000000000000",
+        "connectionString": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
+        "lastModified": "2018-04-26T22:59:24.2370906+00:00",
+        "readOnly": false
+      }
+    }
+  }
+}
diff --git a/specification/appconfiguration/resource-manager/Microsoft.AppConfiguration/preview/2020-07-01-preview/examples/ConfigurationStoresUpdate.json b/specification/appconfiguration/resource-manager/Microsoft.AppConfiguration/preview/2020-07-01-preview/examples/ConfigurationStoresUpdate.json
new file mode 100644
index 000000000000..72378ed10084
--- /dev/null
+++ b/specification/appconfiguration/resource-manager/Microsoft.AppConfiguration/preview/2020-07-01-preview/examples/ConfigurationStoresUpdate.json
@@ -0,0 +1,72 @@
+{
+  "parameters": {
+    "subscriptionId": "c80fb759-c965-4c6a-9110-9b2b2d038882",
+    "resourceGroupName": "myResourceGroup",
+    "configStoreName": "contoso",
+    "api-version": "2020-07-01-preview",
+    "configStoreUpdateParameters": {
+      "tags": {
+        "Category": "Marketing"
+      },
+      "sku": {
+        "name": "Standard"
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "type": "Microsoft.AppConfiguration/configurationStores",
+        "properties": {
+          "provisioningState": "Succeeded",
+          "creationDate": "2018-04-24T16:30:55+00:00",
+          "endpoint": "https://contoso.azconfig.io",
+          "encryption": {
+            "keyVaultProperties": {
+              "keyIdentifier": null,
+              "identityClientId": null
+            }
+          },
+          "privateEndpointConnections": [],
+          "publicNetworkAccess": "Disabled"
+        },
+        "sku": {
+          "name": "Standard"
+        },
+        "id": "/subscriptions/c80fb759-c965-4c6a-9110-9b2b2d038882/resourceGroups/myResourceGroup/providers/Microsoft.AppConfiguration/configurationStores/contoso",
+        "name": "contoso",
+        "location": "westus",
+        "tags": {
+          "Category": "Marketing"
+        }
+      }
+    },
+    "201": {
+      "body": {
+        "type": "Microsoft.AppConfiguration/configurationStores",
+        "properties": {
+          "provisioningState": "Updating",
+          "creationDate": "2018-04-24T16:30:55+00:00",
+          "endpoint": "https://contoso.azconfig.io",
+          "encryption": {
+            "keyVaultProperties": {
+              "keyIdentifier": null,
+              "identityClientId": null
+            }
+          },
+          "privateEndpointConnections": [],
+          "publicNetworkAccess": "Disabled"
+        },
+        "sku": {
+          "name": "Standard"
+        },
+        "id": "/subscriptions/c80fb759-c965-4c6a-9110-9b2b2d038882/resourceGroups/myResourceGroup/providers/Microsoft.AppConfiguration/configurationStores/contoso",
+        "name": "contoso",
+        "location": "westus",
+        "tags": {
+          "Category": "Marketing"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/appconfiguration/resource-manager/Microsoft.AppConfiguration/preview/2020-07-01-preview/examples/ConfigurationStoresUpdateWithIdentity.json b/specification/appconfiguration/resource-manager/Microsoft.AppConfiguration/preview/2020-07-01-preview/examples/ConfigurationStoresUpdateWithIdentity.json
new file mode 100644
index 000000000000..986fcb164e24
--- /dev/null
+++ b/specification/appconfiguration/resource-manager/Microsoft.AppConfiguration/preview/2020-07-01-preview/examples/ConfigurationStoresUpdateWithIdentity.json
@@ -0,0 +1,100 @@
+{
+  "parameters": {
+    "subscriptionId": "c80fb759-c965-4c6a-9110-9b2b2d038882",
+    "resourceGroupName": "myResourceGroup",
+    "configStoreName": "contoso",
+    "api-version": "2020-07-01-preview",
+    "configStoreUpdateParameters": {
+      "tags": {
+        "Category": "Marketing"
+      },
+      "sku": {
+        "name": "Standard"
+      },
+      "identity": {
+        "type": "SystemAssigned, UserAssigned",
+        "userAssignedIdentities": {
+          "/subscriptions/c80fb759-c965-4c6a-9110-9b2b2d038882/resourcegroups/myResourceGroup1/providers/Microsoft.ManagedIdentity/userAssignedIdentities/identity2": {}
+        }
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "type": "Microsoft.AppConfiguration/configurationStores",
+        "properties": {
+          "provisioningState": "Succeeded",
+          "creationDate": "2018-04-24T16:30:55+00:00",
+          "endpoint": "https://contoso.azconfig.io",
+          "encryption": {
+            "keyVaultProperties": {
+              "keyIdentifier": null,
+              "identityClientId": null
+            }
+          },
+          "privateEndpointConnections": [],
+          "publicNetworkAccess": "Disabled"
+        },
+        "sku": {
+          "name": "Standard"
+        },
+        "identity": {
+          "principalId": "AAAAAAAA-AAAA-AAAA-AAAA-AAAAAAAAAAAA",
+          "tenantId": "BBBBBBBB-BBBB-BBBB-BBBB-BBBBBBBBBBBB",
+          "type": "SystemAssigned, UserAssigned",
+          "userAssignedIdentities": {
+            "/subscriptions/c80fb759-c965-4c6a-9110-9b2b2d038882/resourcegroups/myResourceGroup1/providers/Microsoft.ManagedIdentity/userAssignedIdentities/identity2": {
+              "clientId": "CCCCCCCC-CCCC-CCCC-CCCC-CCCCCCCCCCCC",
+              "principalId": "DDDDDDDD-DDDD-DDDD-DDDD-DDDDDDDDDDDD"
+            }
+          }
+        },
+        "id": "/subscriptions/c80fb759-c965-4c6a-9110-9b2b2d038882/resourceGroups/myResourceGroup/providers/Microsoft.AppConfiguration/configurationStores/contoso",
+        "name": "contoso",
+        "location": "westus",
+        "tags": {
+          "Category": "Marketing"
+        }
+      }
+    },
+    "201": {
+      "body": {
+        "type": "Microsoft.AppConfiguration/configurationStores",
+        "properties": {
+          "provisioningState": "Updating",
+          "creationDate": "2018-04-24T16:30:55+00:00",
+          "endpoint": "https://contoso.azconfig.io",
+          "encryption": {
+            "keyVaultProperties": {
+              "keyIdentifier": null,
+              "identityClientId": null
+            }
+          },
+          "privateEndpointConnections": [],
+          "publicNetworkAccess": "Disabled"
+        },
+        "sku": {
+          "name": "Standard"
+        },
+        "identity": {
+          "principalId": "AAAAAAAA-AAAA-AAAA-AAAA-AAAAAAAAAAAA",
+          "tenantId": "BBBBBBBB-BBBB-BBBB-BBBB-BBBBBBBBBBBB",
+          "type": "SystemAssigned, UserAssigned",
+          "userAssignedIdentities": {
+            "/subscriptions/c80fb759-c965-4c6a-9110-9b2b2d038882/resourcegroups/myResourceGroup1/providers/Microsoft.ManagedIdentity/userAssignedIdentities/identity2": {
+              "clientId": "CCCCCCCC-CCCC-CCCC-CCCC-CCCCCCCCCCCC",
+              "principalId": "DDDDDDDD-DDDD-DDDD-DDDD-DDDDDDDDDDDD"
+            }
+          }
+        },
+        "id": "/subscriptions/c80fb759-c965-4c6a-9110-9b2b2d038882/resourceGroups/myResourceGroup/providers/Microsoft.AppConfiguration/configurationStores/contoso",
+        "name": "contoso",
+        "location": "westus",
+        "tags": {
+          "Category": "Marketing"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/appconfiguration/resource-manager/Microsoft.AppConfiguration/preview/2020-07-01-preview/examples/PrivateLinkResourceGet.json b/specification/appconfiguration/resource-manager/Microsoft.AppConfiguration/preview/2020-07-01-preview/examples/PrivateLinkResourceGet.json
new file mode 100644
index 000000000000..73499f7a781c
--- /dev/null
+++ b/specification/appconfiguration/resource-manager/Microsoft.AppConfiguration/preview/2020-07-01-preview/examples/PrivateLinkResourceGet.json
@@ -0,0 +1,27 @@
+{
+  "parameters": {
+    "subscriptionId": "c80fb759-c965-4c6a-9110-9b2b2d038882",
+    "resourceGroupName": "myResourceGroup",
+    "configStoreName": "contoso",
+    "api-version": "2020-07-01-preview",
+    "groupName": "configurationStores"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/c80fb759-c965-4c6a-9110-9b2b2d038882/resourceGroups/myResourceGroup/providers/Microsoft.AppConfiguration/configurationStores/contoso/privateLinkResources/configurationStores",
+        "name": "configurationStores",
+        "type": "Microsoft.AppConfiguraiton/configurationStores/privateLinkResources",
+        "properties": {
+          "groupId": "configurationStores",
+          "requiredMembers": [
+            "configurationStores"
+          ],
+          "requiredZoneNames": [
+            "privatelink.azconfig.io"
+          ]
+        }
+      }
+    }
+  }
+}
diff --git a/specification/appconfiguration/resource-manager/Microsoft.AppConfiguration/preview/2020-07-01-preview/examples/PrivateLinkResourcesListByConfigurationStore.json b/specification/appconfiguration/resource-manager/Microsoft.AppConfiguration/preview/2020-07-01-preview/examples/PrivateLinkResourcesListByConfigurationStore.json
new file mode 100644
index 000000000000..c1e4767ffe02
--- /dev/null
+++ b/specification/appconfiguration/resource-manager/Microsoft.AppConfiguration/preview/2020-07-01-preview/examples/PrivateLinkResourcesListByConfigurationStore.json
@@ -0,0 +1,30 @@
+{
+  "parameters": {
+    "subscriptionId": "c80fb759-c965-4c6a-9110-9b2b2d038882",
+    "resourceGroupName": "myResourceGroup",
+    "configStoreName": "contoso",
+    "api-version": "2020-07-01-preview"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "id": "/subscriptions/c80fb759-c965-4c6a-9110-9b2b2d038882/resourceGroups/myResourceGroup/providers/Microsoft.AppConfiguration/configurationStores/contoso/privateLinkResources/configurationStores",
+            "name": "configurationStores",
+            "type": "Microsoft.AppConfiguraiton/configurationStores/privateLinkResources",
+            "properties": {
+              "groupId": "configurationStores",
+              "requiredMembers": [
+                "configurationStores"
+              ],
+              "requiredZoneNames": [
+                "privatelink.azconfig.io"
+              ]
+            }
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/appconfiguration/resource-manager/readme.go.md b/specification/appconfiguration/resource-manager/readme.go.md
index 8b9ca1624935..cdcf3496c0b5 100644
--- a/specification/appconfiguration/resource-manager/readme.go.md
+++ b/specification/appconfiguration/resource-manager/readme.go.md
@@ -13,12 +13,22 @@ go:
 
 ``` yaml $(go) && $(multiapi)
 batch:
+  - tag: package-2020-07-01-preview
   - tag: package-2020-06-01
   - tag: package-2019-11-01-preview
   - tag: package-2019-10-01
   - tag: package-2019-02-01-preview
 ```
 
+### Tag: package-2020-07-01-preview and go
+
+These settings apply only when `--tag=package-2020-07-01-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-07-01-preview' && $(go)
+output-folder: $(go-sdk-folder)/services/preview/$(namespace)/mgmt/2020-07-01-preview/$(namespace)
+```
+
 ### Tag: package-2020-06-01 and go
 
 These settings apply only when `--tag=package-2020-06-01 --go` is specified on the command line.
diff --git a/specification/appconfiguration/resource-manager/readme.java.md b/specification/appconfiguration/resource-manager/readme.java.md
index f20aca80ff98..deefcca752c4 100644
--- a/specification/appconfiguration/resource-manager/readme.java.md
+++ b/specification/appconfiguration/resource-manager/readme.java.md
@@ -16,11 +16,25 @@ output-folder: $(azure-libraries-for-java-folder)/azure-mgmt-appconfiguration
 
 ``` yaml $(java) && $(multiapi)
 batch:
+  - tag: package-2020-07-01-preview
   - tag: package-2020-06-01
   - tag: package-2019-10-01
   - tag: package-2019-02-01-preview
 ```
 
+### Tag: package-2020-07-01-preview and java
+
+These settings apply only when `--tag=package-2020-07-01-preview --java` is specified on the command line.
+Please also specify `--azure-libraries-for-java-folder=<path to the root directory of your azure-sdk-for-java clone>`.
+
+``` yaml $(tag)=='package-2020-07-01-preview' && $(java) && $(multiapi)
+java:
+  namespace: com.microsoft.azure.management.appconfiguration.v2020_07_01_preview
+  output-folder: $(azure-libraries-for-java-folder)/sdk/appconfiguration/mgmt-v2020_07_01_preview
+regenerate-manager: true
+generate-interface: true
+```
+
 ### Tag: package-2020-06-01 and java
 
 These settings apply only when `--tag=package-2020-06-01 --java` is specified on the command line.
diff --git a/specification/appconfiguration/resource-manager/readme.md b/specification/appconfiguration/resource-manager/readme.md
index 8f59f70c2a43..920bdb01695d 100644
--- a/specification/appconfiguration/resource-manager/readme.md
+++ b/specification/appconfiguration/resource-manager/readme.md
@@ -26,7 +26,16 @@ These are the global settings for the AppConfiguration API.
 
 ``` yaml
 openapi-type: arm
-tag: package-2020-06-01
+tag: package-2020-07-01-preview
+```
+
+### Tag: package-2020-07-01-preview
+
+These settings apply only when `--tag=2020-07-01-preview` is specified on the command line.
+
+``` yaml $(tag) == 'package-2020-07-01-preview'
+input-file:
+- Microsoft.AppConfiguration/preview/2020-07-01-preview/appconfiguration.json
 ```
 
 ### Tag: package-2020-06-01
@@ -128,7 +137,7 @@ directive:
     reason: We did consider using an enum instead but found it to not be helpful.
   - suppress: EnumInsteadOfBoolean
     from: appconfiguration.json
-    where: $.definitions.KeyValue.properties.locked
+    where: $.definitions.KeyValueProperties.properties.locked
     reason: This is data plane level information proxied through the RP and cannot be changed.
 ```
 
diff --git a/specification/applicationinsights/data-plane/Monitor.Exporters/preview/2020-09-15_Preview/swagger.json b/specification/applicationinsights/data-plane/Monitor.Exporters/preview/2020-09-15_Preview/swagger.json
index 53f0815ec32c..3c790353ec37 100644
--- a/specification/applicationinsights/data-plane/Monitor.Exporters/preview/2020-09-15_Preview/swagger.json
+++ b/specification/applicationinsights/data-plane/Monitor.Exporters/preview/2020-09-15_Preview/swagger.json
@@ -849,6 +849,7 @@
         },
         "time": {
           "type": "string",
+          "format": "date-time",
           "description": "Event date time when telemetry item was created. This is the wall clock time on the client when the event was generated. There is no guarantee that the client's time is accurate. This field must be formatted in UTC ISO 8601 format, with a trailing 'Z' character, as described publicly on https://en.wikipedia.org/wiki/ISO_8601#UTC. Note: the number of decimal seconds digits provided are variable (and unspecified). Consumers should handle this, i.e. managed code consumers should not use format 'O' for parsing as it specifies a fixed length. Example: 2009-06-15T13:45:30.0000000Z."
         },
         "sampleRate": {
diff --git a/specification/applicationinsights/resource-manager/Microsoft.Insights/preview/2020-10-05-preview/examples/Operations_List.json b/specification/applicationinsights/resource-manager/Microsoft.Insights/preview/2020-10-05-preview/examples/Operations_List.json
new file mode 100644
index 000000000000..02bcba3635f9
--- /dev/null
+++ b/specification/applicationinsights/resource-manager/Microsoft.Insights/preview/2020-10-05-preview/examples/Operations_List.json
@@ -0,0 +1,23 @@
+{
+  "parameters": {
+    "api-version": "2020-10-05-preview"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "name": "Microsoft.insights/webtests",
+            "display": {
+              "provider": "Microsoft Container Instance",
+              "resource": "webtests",
+              "operation": "CRUD operations on webtest",
+              "description": "CRUD operations on webtest"
+            },
+            "origin": "User"
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/applicationinsights/resource-manager/Microsoft.Insights/preview/2020-10-05-preview/examples/WebTestCreate.json b/specification/applicationinsights/resource-manager/Microsoft.Insights/preview/2020-10-05-preview/examples/WebTestCreate.json
new file mode 100644
index 000000000000..d4a592e3395a
--- /dev/null
+++ b/specification/applicationinsights/resource-manager/Microsoft.Insights/preview/2020-10-05-preview/examples/WebTestCreate.json
@@ -0,0 +1,64 @@
+{
+  "parameters": {
+    "api-version": "2020-10-05-preview",
+    "subscriptionId": "subid",
+    "resourceGroupName": "my-resource-group",
+    "webTestName": "my-webtest-my-component",
+    "WebTestDefinition": {
+      "location": "South Central US",
+      "kind": "ping",
+      "properties": {
+        "Name": "my-webtest-my-component",
+        "SyntheticMonitorId": "my-webtest-my-component",
+        "Configuration": {
+          "WebTest": "<WebTest Name=\"my-webtest\" Id=\"678ddf96-1ab8-44c8-9274-123456789abc\" Enabled=\"True\" CssProjectStructure=\"\" CssIteration=\"\" Timeout=\"120\" WorkItemIds=\"\" xmlns=\"http://microsoft.com/schemas/VisualStudio/TeamTest/2010\" Description=\"\" CredentialUserName=\"\" CredentialPassword=\"\" PreAuthenticate=\"True\" Proxy=\"default\" StopOnError=\"False\" RecordedResultFile=\"\" ResultsLocale=\"\" ><Items><Request Method=\"GET\" Guid=\"a4162485-9114-fcfc-e086-123456789abc\" Version=\"1.1\" Url=\"http://my-component.azurewebsites.net\" ThinkTime=\"0\" Timeout=\"120\" ParseDependentRequests=\"True\" FollowRedirects=\"True\" RecordResult=\"True\" Cache=\"False\" ResponseTimeGoal=\"0\" Encoding=\"utf-8\" ExpectedHttpStatusCode=\"200\" ExpectedResponseUrl=\"\" ReportingName=\"\" IgnoreHttpStatusCode=\"False\" /></Items></WebTest>"
+        },
+        "Description": "Ping web test alert for mytestwebapp",
+        "Enabled": true,
+        "Frequency": 900,
+        "Timeout": 120,
+        "Kind": "ping",
+        "RetryEnabled": true,
+        "Locations": [
+          {
+            "Id": "us-fl-mia-edge"
+          }
+        ]
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/my-resource-group/providers/Microsoft.Insights/webtests/my-webtest-my-component",
+        "name": "my-webtest-my-component",
+        "type": "Microsoft.Insights/webtests",
+        "location": "southcentralus",
+        "tags": {
+          "hidden-link:/subscriptions/subid/resourceGroups/my-resource-group/providers/Microsoft.Insights/components/my-component": "Resource",
+          "hidden-link:/subscriptions/subid/resourceGroups/my-resource-group/providers/Microsoft.Web/sites/mytestwebapp": "Resource"
+        },
+        "kind": "ping",
+        "properties": {
+          "Name": "my-webtest-my-component",
+          "SyntheticMonitorId": "my-webtest-my-component",
+          "Description": "Ping web test alert for mytestwebapp",
+          "Enabled": true,
+          "Frequency": 900,
+          "Timeout": 120,
+          "Kind": "ping",
+          "RetryEnabled": true,
+          "Locations": [
+            {
+              "Id": "us-fl-mia-edge"
+            }
+          ],
+          "Configuration": {
+            "WebTest": "<WebTest Name=\"my-webtest\" Id=\"678ddf96-1ab8-44c8-9274-123456789abc\" Enabled=\"True\" CssProjectStructure=\"\" CssIteration=\"\" Timeout=\"120\" WorkItemIds=\"\" xmlns=\"http://microsoft.com/schemas/VisualStudio/TeamTest/2010\" Description=\"\" CredentialUserName=\"\" CredentialPassword=\"\" PreAuthenticate=\"True\" Proxy=\"default\" StopOnError=\"False\" RecordedResultFile=\"\" ResultsLocale=\"\" ><Items><Request Method=\"GET\" Guid=\"a4162485-9114-fcfc-e086-123456789abc\" Version=\"1.1\" Url=\"http://my-component.azurewebsites.net\" ThinkTime=\"0\" Timeout=\"120\" ParseDependentRequests=\"True\" FollowRedirects=\"True\" RecordResult=\"True\" Cache=\"False\" ResponseTimeGoal=\"0\" Encoding=\"utf-8\" ExpectedHttpStatusCode=\"200\" ExpectedResponseUrl=\"\" ReportingName=\"\" IgnoreHttpStatusCode=\"False\" /></Items></WebTest>"
+          },
+          "provisioningState": "Succeeded"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/applicationinsights/resource-manager/Microsoft.Insights/preview/2020-10-05-preview/examples/WebTestDelete.json b/specification/applicationinsights/resource-manager/Microsoft.Insights/preview/2020-10-05-preview/examples/WebTestDelete.json
new file mode 100644
index 000000000000..c1438fa108c3
--- /dev/null
+++ b/specification/applicationinsights/resource-manager/Microsoft.Insights/preview/2020-10-05-preview/examples/WebTestDelete.json
@@ -0,0 +1,12 @@
+{
+  "parameters": {
+    "api-version": "2020-10-05-preview",
+    "subscriptionId": "subid",
+    "resourceGroupName": "my-resource-group",
+    "webTestName": "my-webtest-01-mywebservice"
+  },
+  "responses": {
+    "200": {},
+    "204": {}
+  }
+}
diff --git a/specification/applicationinsights/resource-manager/Microsoft.Insights/preview/2020-10-05-preview/examples/WebTestGet.json b/specification/applicationinsights/resource-manager/Microsoft.Insights/preview/2020-10-05-preview/examples/WebTestGet.json
new file mode 100644
index 000000000000..af81591ea12f
--- /dev/null
+++ b/specification/applicationinsights/resource-manager/Microsoft.Insights/preview/2020-10-05-preview/examples/WebTestGet.json
@@ -0,0 +1,45 @@
+{
+  "parameters": {
+    "api-version": "2020-10-05-preview",
+    "subscriptionId": "subid",
+    "resourceGroupName": "my-resource-group",
+    "webTestName": "my-webtest-01-mywebservice"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/my-test-resources/providers/Microsoft.Insights/webtests/my-webtest-01-mywebservice",
+        "name": "my-webtest-01-mywebservice",
+        "type": "Microsoft.Insights/webtests",
+        "location": "southcentralus",
+        "tags": {
+          "hidden-link:/subscriptions/subid/resourceGroups/my-test-resources/providers/Microsoft.Insights/components/mytester": "Resource",
+          "hidden-link:/subscriptions/subid/resourceGroups/my-test-resources/providers/Microsoft.Web/sites/mytester": "Resource"
+        },
+        "kind": "ping",
+        "properties": {
+          "SyntheticMonitorId": "my-webtest-01-mywebservice",
+          "Name": "mytest-webtest-01",
+          "Description": "",
+          "Enabled": false,
+          "Frequency": 900,
+          "Timeout": 30,
+          "Kind": "ping",
+          "RetryEnabled": true,
+          "Locations": [
+            {
+              "Id": "us-fl-mia-edge"
+            },
+            {
+              "Id": "apac-hk-hkn-azr"
+            }
+          ],
+          "Configuration": {
+            "WebTest": "<WebTest Name=\"mytest-webtest-01\" Id=\"0317d26b-8672-4370-bd6b-123456789abc\" Enabled=\"True\" CssProjectStructure=\"\" CssIteration=\"\" Timeout=\"30\" WorkItemIds=\"\" xmlns=\"http://microsoft.com/schemas/VisualStudio/TeamTest/2010\" Description=\"\" CredentialUserName=\"\" CredentialPassword=\"\" PreAuthenticate=\"True\" Proxy=\"default\" StopOnError=\"False\" RecordedResultFile=\"\" ResultsLocale=\"\"><Items><Request Method=\"GET\" Guid=\"a55ce143-4f1e-a7e6-b69e-123456789abc\" Version=\"1.1\" Url=\"http://mytester.azurewebsites.net\" ThinkTime=\"0\" Timeout=\"30\" ParseDependentRequests=\"False\" FollowRedirects=\"True\" RecordResult=\"True\" Cache=\"False\" ResponseTimeGoal=\"0\" Encoding=\"utf-8\" ExpectedHttpStatusCode=\"200\" ExpectedResponseUrl=\"\" ReportingName=\"\" IgnoreHttpStatusCode=\"False\" /></Items></WebTest>"
+          },
+          "provisioningState": "Succeeded"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/applicationinsights/resource-manager/Microsoft.Insights/preview/2020-10-05-preview/examples/WebTestList.json b/specification/applicationinsights/resource-manager/Microsoft.Insights/preview/2020-10-05-preview/examples/WebTestList.json
new file mode 100644
index 000000000000..033c6ebec7b7
--- /dev/null
+++ b/specification/applicationinsights/resource-manager/Microsoft.Insights/preview/2020-10-05-preview/examples/WebTestList.json
@@ -0,0 +1,68 @@
+{
+  "parameters": {
+    "api-version": "2020-10-05-preview",
+    "subscriptionId": "subid",
+    "resourceGroupName": "my-resource-group"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "id": "/subscriptions/subid/resourceGroups/my-resource-group/providers/Microsoft.Insights/webtests/my-webtest-my-component",
+            "name": "my-webtest-my-component",
+            "type": "Microsoft.Insights/webtests",
+            "location": "southcentralus",
+            "tags": {
+              "hidden-link:/subscriptions/subid/resourceGroups/my-resource-group/providers/Microsoft.Insights/components/my-component": "Resource",
+              "hidden-link:/subscriptions/subid/resourceGroups/my-resource-group/providers/Microsoft.Web/sites/mytestwebapp": "Resource"
+            },
+            "kind": "ping",
+            "properties": {
+              "SyntheticMonitorId": "my-webtest-my-component",
+              "Name": "my-webtest",
+              "Description": "",
+              "Enabled": false,
+              "Frequency": 900,
+              "Timeout": 120,
+              "Kind": "ping",
+              "RetryEnabled": true,
+              "Locations": [],
+              "Configuration": {
+                "WebTest": "<WebTest Name=\"my-webtest\" Id=\"678ddf96-1ab8-44c8-9274-123456789abc\" Enabled=\"True\" CssProjectStructure=\"\" CssIteration=\"\" Timeout=\"120\" WorkItemIds=\"\" xmlns=\"http://microsoft.com/schemas/VisualStudio/TeamTest/2010\" Description=\"\" CredentialUserName=\"\" CredentialPassword=\"\" PreAuthenticate=\"True\" Proxy=\"default\" StopOnError=\"False\" RecordedResultFile=\"\" ResultsLocale=\"\"><Items><Request Method=\"GET\" Guid=\"a4162485-9114-fcfc-e086-123456789abc\" Version=\"1.1\" Url=\"http://my-component.azurewebsites.net\" ThinkTime=\"0\" Timeout=\"120\" ParseDependentRequests=\"True\" FollowRedirects=\"True\" RecordResult=\"True\" Cache=\"False\" ResponseTimeGoal=\"0\" Encoding=\"utf-8\" ExpectedHttpStatusCode=\"200\" ExpectedResponseUrl=\"\" ReportingName=\"\" IgnoreHttpStatusCode=\"False\" /></Items></WebTest>"
+              },
+              "provisioningState": "Succeeded"
+            }
+          },
+          {
+            "id": "/subscriptions/subid/resourceGroups/my-other-resource-group/providers/Microsoft.Insights/webtests/my-webtest-my-other-component",
+            "name": "my-webtest-my-other-component",
+            "type": "Microsoft.Insights/webtests",
+            "location": "southcentralus",
+            "tags": {
+              "Test": "You can delete this synthetic monitor anytime",
+              "hidden-link:/subscriptions/subid/resourceGroups/my-other-resource-group/providers/Microsoft.Insights/components/my-other-component": "Resource"
+            },
+            "kind": "ping",
+            "properties": {
+              "SyntheticMonitorId": "my-webtest-my-other-component",
+              "Name": "342bccf4-722f-496d-b064-123456789abc",
+              "Description": "",
+              "Enabled": false,
+              "Frequency": 900,
+              "Timeout": 120,
+              "Kind": "ping",
+              "RetryEnabled": false,
+              "Locations": [],
+              "Configuration": {
+                "WebTest": "<WebTest Name=\"342bccf4-722f-496d-b064-123456789abc\" Id=\"00a15cc1-c903-4f97-9af4-123456789abc\" Enabled=\"False\" CssProjectStructure=\"\" CssIteration=\"\" Timeout=\"120\" WorkItemIds=\"\" xmlns=\"http://microsoft.com/schemas/VisualStudio/TeamTest/2010\" Description=\"\" CredentialUserName=\"\" CredentialPassword=\"\" PreAuthenticate=\"True\" Proxy=\"default\" StopOnError=\"False\" RecordedResultFile=\"\" ResultsLocale=\"\"><Items><Request Method=\"GET\" Guid=\"347e1924-9899-4c6e-ad78-123456789abc\" Version=\"1.1\" Url=\"http://my-other-component.azurewebsites.net\" ThinkTime=\"0\" Timeout=\"120\" ParseDependentRequests=\"True\" FollowRedirects=\"True\" RecordResult=\"True\" Cache=\"False\" ResponseTimeGoal=\"0\" Encoding=\"utf-8\" ExpectedHttpStatusCode=\"200\" ExpectedResponseUrl=\"\" ReportingName=\"\" IgnoreHttpStatusCode=\"False\" /></Items></WebTest>"
+              },
+              "provisioningState": "Succeeded"
+            }
+          }
+        ],
+        "nextLink": null
+      }
+    }
+  }
+}
diff --git a/specification/applicationinsights/resource-manager/Microsoft.Insights/preview/2020-10-05-preview/examples/WebTestListByComponent.json b/specification/applicationinsights/resource-manager/Microsoft.Insights/preview/2020-10-05-preview/examples/WebTestListByComponent.json
new file mode 100644
index 000000000000..b8f6f6901248
--- /dev/null
+++ b/specification/applicationinsights/resource-manager/Microsoft.Insights/preview/2020-10-05-preview/examples/WebTestListByComponent.json
@@ -0,0 +1,47 @@
+{
+  "parameters": {
+    "api-version": "2020-10-05-preview",
+    "subscriptionId": "subid",
+    "resourceGroupName": "my-resource-group",
+    "componentName": "my-component"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "id": "/subscriptions/subid/resourceGroups/my-resource-group/providers/Microsoft.Insights/webtests/my-webtest-my-component",
+            "name": "my-webtest-my-component",
+            "type": "Microsoft.Insights/webtests",
+            "location": "southcentralus",
+            "tags": {
+              "hidden-link:/subscriptions/subid/resourceGroups/my-resource-group/providers/Microsoft.Insights/components/my-component": "Resource",
+              "hidden-link:/subscriptions/subid/resourceGroups/my-resource-group/providers/Microsoft.Web/sites/mytestwebapp": "Resource"
+            },
+            "kind": "ping",
+            "properties": {
+              "SyntheticMonitorId": "my-webtest-my-component",
+              "Name": "my-webtest",
+              "Description": "",
+              "Enabled": false,
+              "Frequency": 900,
+              "Timeout": 120,
+              "Kind": "ping",
+              "RetryEnabled": true,
+              "Locations": [
+                {
+                  "Id": "apac-hk-hkn-azr"
+                }
+              ],
+              "Configuration": {
+                "WebTest": "<WebTest Name=\"my-webtest\" Id=\"678ddf96-1ab8-44c8-9274-123456789abc\" Enabled=\"True\" CssProjectStructure=\"\" CssIteration=\"\" Timeout=\"120\" WorkItemIds=\"\" xmlns=\"http://microsoft.com/schemas/VisualStudio/TeamTest/2010\" Description=\"\" CredentialUserName=\"\" CredentialPassword=\"\" PreAuthenticate=\"True\" Proxy=\"default\" StopOnError=\"False\" RecordedResultFile=\"\" ResultsLocale=\"\"><Items><Request Method=\"GET\" Guid=\"a4162485-9114-fcfc-e086-123456789abc\" Version=\"1.1\" Url=\"http://my-component.azurewebsites.net\" ThinkTime=\"0\" Timeout=\"120\" ParseDependentRequests=\"True\" FollowRedirects=\"True\" RecordResult=\"True\" Cache=\"False\" ResponseTimeGoal=\"0\" Encoding=\"utf-8\" ExpectedHttpStatusCode=\"200\" ExpectedResponseUrl=\"\" ReportingName=\"\" IgnoreHttpStatusCode=\"False\" /></Items></WebTest>"
+              },
+              "provisioningState": "Succeeded"
+            }
+          }
+        ],
+        "nextLink": null
+      }
+    }
+  }
+}
diff --git a/specification/applicationinsights/resource-manager/Microsoft.Insights/preview/2020-10-05-preview/examples/WebTestListByResourceGroup.json b/specification/applicationinsights/resource-manager/Microsoft.Insights/preview/2020-10-05-preview/examples/WebTestListByResourceGroup.json
new file mode 100644
index 000000000000..06a2118a79bb
--- /dev/null
+++ b/specification/applicationinsights/resource-manager/Microsoft.Insights/preview/2020-10-05-preview/examples/WebTestListByResourceGroup.json
@@ -0,0 +1,76 @@
+{
+  "parameters": {
+    "api-version": "2020-10-05-preview",
+    "subscriptionId": "subid",
+    "resourceGroupName": "my-resource-group"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "id": "/subscriptions/subid/resourceGroups/my-resource-group/providers/Microsoft.Insights/webtests/my-webtest-my-component",
+            "name": "my-webtest-my-component",
+            "type": "Microsoft.Insights/webtests",
+            "location": "southcentralus",
+            "tags": {
+              "hidden-link:/subscriptions/subid/resourceGroups/my-resource-group/providers/Microsoft.Insights/components/my-component": "Resource",
+              "hidden-link:/subscriptions/subid/resourceGroups/my-resource-group/providers/Microsoft.Web/sites/mytestwebapp": "Resource"
+            },
+            "kind": "ping",
+            "properties": {
+              "SyntheticMonitorId": "my-webtest-my-component",
+              "Name": "my-webtest",
+              "Description": "",
+              "Enabled": false,
+              "Frequency": 900,
+              "Timeout": 120,
+              "Kind": "ping",
+              "RetryEnabled": true,
+              "Locations": [
+                {
+                  "Id": "apac-hk-hkn-azr"
+                }
+              ],
+              "Configuration": {
+                "WebTest": "<WebTest Name=\"my-webtest\" Id=\"678ddf96-1ab8-44c8-9274-123456789abc\" Enabled=\"True\" CssProjectStructure=\"\" CssIteration=\"\" Timeout=\"120\" WorkItemIds=\"\" xmlns=\"http://microsoft.com/schemas/VisualStudio/TeamTest/2010\" Description=\"\" CredentialUserName=\"\" CredentialPassword=\"\" PreAuthenticate=\"True\" Proxy=\"default\" StopOnError=\"False\" RecordedResultFile=\"\" ResultsLocale=\"\"><Items><Request Method=\"GET\" Guid=\"a4162485-9114-fcfc-e086-123456789abc\" Version=\"1.1\" Url=\"http://my-component.azurewebsites.net\" ThinkTime=\"0\" Timeout=\"120\" ParseDependentRequests=\"True\" FollowRedirects=\"True\" RecordResult=\"True\" Cache=\"False\" ResponseTimeGoal=\"0\" Encoding=\"utf-8\" ExpectedHttpStatusCode=\"200\" ExpectedResponseUrl=\"\" ReportingName=\"\" IgnoreHttpStatusCode=\"False\" /></Items></WebTest>"
+              },
+              "provisioningState": "Succeeded"
+            }
+          },
+          {
+            "id": "/subscriptions/subid/resourceGroups/my-resource-group/providers/Microsoft.Insights/webtests/my-webtest-my-other-component",
+            "name": "my-webtest-my-other-component",
+            "type": "Microsoft.Insights/webtests",
+            "location": "southcentralus",
+            "tags": {
+              "Test": "You can delete this synthetic monitor anytime",
+              "hidden-link:/subscriptions/subid/resourceGroups/my-resource-group/providers/Microsoft.Insights/components/my-other-component": "Resource"
+            },
+            "kind": "ping",
+            "properties": {
+              "SyntheticMonitorId": "my-webtest-my-other-component",
+              "Name": "342bccf4-722f-496d-b064-123456789abc",
+              "Description": "",
+              "Enabled": false,
+              "Frequency": 300,
+              "Timeout": 90,
+              "Kind": "ping",
+              "RetryEnabled": false,
+              "Locations": [
+                {
+                  "Id": "us-fl-mia-edge"
+                }
+              ],
+              "Configuration": {
+                "WebTest": "<WebTest Name=\"342bccf4-722f-496d-b064-123456789abc\" Id=\"00a15cc1-c903-4f97-9af4-123456789abc\" Enabled=\"False\" CssProjectStructure=\"\" CssIteration=\"\" Timeout=\"120\" WorkItemIds=\"\" xmlns=\"http://microsoft.com/schemas/VisualStudio/TeamTest/2010\" Description=\"\" CredentialUserName=\"\" CredentialPassword=\"\" PreAuthenticate=\"True\" Proxy=\"default\" StopOnError=\"False\" RecordedResultFile=\"\" ResultsLocale=\"\"><Items><Request Method=\"GET\" Guid=\"347e1924-9899-4c6e-ad78-123456789abc\" Version=\"1.1\" Url=\"http://my-other-component.azurewebsites.net\" ThinkTime=\"0\" Timeout=\"120\" ParseDependentRequests=\"True\" FollowRedirects=\"True\" RecordResult=\"True\" Cache=\"False\" ResponseTimeGoal=\"0\" Encoding=\"utf-8\" ExpectedHttpStatusCode=\"200\" ExpectedResponseUrl=\"\" ReportingName=\"\" IgnoreHttpStatusCode=\"False\" /></Items></WebTest>"
+              },
+              "provisioningState": "Succeeded"
+            }
+          }
+        ],
+        "nextLink": null
+      }
+    }
+  }
+}
diff --git a/specification/applicationinsights/resource-manager/Microsoft.Insights/preview/2020-10-05-preview/examples/WebTestUpdate.json b/specification/applicationinsights/resource-manager/Microsoft.Insights/preview/2020-10-05-preview/examples/WebTestUpdate.json
new file mode 100644
index 000000000000..4db95f82f2cd
--- /dev/null
+++ b/specification/applicationinsights/resource-manager/Microsoft.Insights/preview/2020-10-05-preview/examples/WebTestUpdate.json
@@ -0,0 +1,67 @@
+{
+  "parameters": {
+    "api-version": "2020-10-05-preview",
+    "subscriptionId": "subid",
+    "resourceGroupName": "my-resource-group",
+    "webTestName": "my-webtest-my-component",
+    "WebTestDefinition": {
+      "location": "South Central US",
+      "kind": "ping",
+      "properties": {
+        "Configuration": {
+          "WebTest": "<WebTest Name=\"my-webtest\" Id=\"678ddf96-1ab8-44c8-9274-123456789abc\" Enabled=\"True\" CssProjectStructure=\"\" CssIteration=\"\" Timeout=\"30\" WorkItemIds=\"\" xmlns=\"http://microsoft.com/schemas/VisualStudio/TeamTest/2010\" Description=\"\" CredentialUserName=\"\" CredentialPassword=\"\" PreAuthenticate=\"True\" Proxy=\"default\" StopOnError=\"False\" RecordedResultFile=\"\" ResultsLocale=\"\" ><Items><Request Method=\"GET\" Guid=\"a4162485-9114-fcfc-e086-123456789abc\" Version=\"1.1\" Url=\"http://my-component.azurewebsites.net\" ThinkTime=\"0\" Timeout=\"30\" ParseDependentRequests=\"True\" FollowRedirects=\"True\" RecordResult=\"True\" Cache=\"False\" ResponseTimeGoal=\"0\" Encoding=\"utf-8\" ExpectedHttpStatusCode=\"200\" ExpectedResponseUrl=\"\" ReportingName=\"\" IgnoreHttpStatusCode=\"False\" /></Items></WebTest>"
+        },
+        "Frequency": 600,
+        "Timeout": 30,
+        "Locations": [
+          {
+            "Id": "us-fl-mia-edge"
+          },
+          {
+            "Id": "apac-hk-hkn-azr"
+          }
+        ],
+        "Kind": "ping",
+        "Name": "my-webtest-my-component",
+        "SyntheticMonitorId": "my-webtest-my-component"
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/my-resource-group/providers/Microsoft.Insights/webtests/my-webtest-my-component",
+        "name": "my-webtest-my-component",
+        "type": "Microsoft.Insights/webtests",
+        "location": "southcentralus",
+        "tags": {
+          "hidden-link:/subscriptions/subid/resourceGroups/my-resource-group/providers/Microsoft.Insights/components/my-component": "Resource",
+          "hidden-link:/subscriptions/subid/resourceGroups/my-resource-group/providers/Microsoft.Web/sites/mytestwebapp": "Resource"
+        },
+        "kind": "ping",
+        "properties": {
+          "Name": "my-webtest-my-component",
+          "SyntheticMonitorId": "my-webtest-my-component",
+          "Description": "Ping web test alert for mytestwebapp",
+          "Enabled": true,
+          "Frequency": 600,
+          "Timeout": 30,
+          "Kind": "ping",
+          "RetryEnabled": true,
+          "Locations": [
+            {
+              "Id": "us-fl-mia-edge"
+            },
+            {
+              "Id": "apac-hk-hkn-azr"
+            }
+          ],
+          "Configuration": {
+            "WebTest": "<WebTest Name=\"my-webtest\" Id=\"678ddf96-1ab8-44c8-9274-123456789abc\" Enabled=\"True\" CssProjectStructure=\"\" CssIteration=\"\" Timeout=\"30\" WorkItemIds=\"\" xmlns=\"http://microsoft.com/schemas/VisualStudio/TeamTest/2010\" Description=\"\" CredentialUserName=\"\" CredentialPassword=\"\" PreAuthenticate=\"True\" Proxy=\"default\" StopOnError=\"False\" RecordedResultFile=\"\" ResultsLocale=\"\" ><Items><Request Method=\"GET\" Guid=\"a4162485-9114-fcfc-e086-123456789abc\" Version=\"1.1\" Url=\"http://my-component.azurewebsites.net\" ThinkTime=\"0\" Timeout=\"30\" ParseDependentRequests=\"True\" FollowRedirects=\"True\" RecordResult=\"True\" Cache=\"False\" ResponseTimeGoal=\"0\" Encoding=\"utf-8\" ExpectedHttpStatusCode=\"200\" ExpectedResponseUrl=\"\" ReportingName=\"\" IgnoreHttpStatusCode=\"False\" /></Items></WebTest>"
+          },
+          "provisioningState": "Succeeded"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/applicationinsights/resource-manager/Microsoft.Insights/preview/2020-10-05-preview/examples/WebTestUpdateTagsOnly.json b/specification/applicationinsights/resource-manager/Microsoft.Insights/preview/2020-10-05-preview/examples/WebTestUpdateTagsOnly.json
new file mode 100644
index 000000000000..517323cb7cfe
--- /dev/null
+++ b/specification/applicationinsights/resource-manager/Microsoft.Insights/preview/2020-10-05-preview/examples/WebTestUpdateTagsOnly.json
@@ -0,0 +1,57 @@
+{
+  "parameters": {
+    "api-version": "2020-10-05-preview",
+    "subscriptionId": "subid",
+    "resourceGroupName": "my-resource-group",
+    "webTestName": "my-webtest-my-component",
+    "WebTestTags": {
+      "tags": {
+        "hidden-link:/subscriptions/subid/resourceGroups/my-resource-group/providers/Microsoft.Insights/components/my-component": "Resource",
+        "hidden-link:/subscriptions/subid/resourceGroups/my-resource-group/providers/Microsoft.Web/sites/mytestwebapp": "Resource",
+        "CustomField-01": "This is a random value",
+        "SystemType": "A08",
+        "Color": "AzureBlue"
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/my-resource-group/providers/Microsoft.Insights/webtests/my-webtest-my-component",
+        "name": "my-webtest-my-component",
+        "type": "Microsoft.Insights/webtests",
+        "location": "southcentralus",
+        "tags": {
+          "hidden-link:/subscriptions/subid/resourceGroups/my-resource-group/providers/Microsoft.Insights/components/my-component": "Resource",
+          "hidden-link:/subscriptions/subid/resourceGroups/my-resource-group/providers/Microsoft.Web/sites/mytestwebapp": "Resource",
+          "CustomField-01": "This is a random value",
+          "SystemType": "A08",
+          "Color": "AzureBlue"
+        },
+        "kind": "ping",
+        "properties": {
+          "Name": "my-webtest-my-component",
+          "SyntheticMonitorId": "my-webtest-my-component",
+          "Description": "Ping web test alert for mytestwebapp",
+          "Enabled": true,
+          "Frequency": 600,
+          "Timeout": 30,
+          "Kind": "ping",
+          "RetryEnabled": true,
+          "Locations": [
+            {
+              "Id": "us-fl-mia-edge"
+            },
+            {
+              "Id": "apac-hk-hkn-azr"
+            }
+          ],
+          "Configuration": {
+            "WebTest": "<WebTest Name=\"my-webtest\" Id=\"678ddf96-1ab8-44c8-9274-123456789abc\" Enabled=\"True\" CssProjectStructure=\"\" CssIteration=\"\" Timeout=\"30\" WorkItemIds=\"\" xmlns=\"http://microsoft.com/schemas/VisualStudio/TeamTest/2010\" Description=\"\" CredentialUserName=\"\" CredentialPassword=\"\" PreAuthenticate=\"True\" Proxy=\"default\" StopOnError=\"False\" RecordedResultFile=\"\" ResultsLocale=\"\" ><Items><Request Method=\"GET\" Guid=\"a4162485-9114-fcfc-e086-123456789abc\" Version=\"1.1\" Url=\"http://my-component.azurewebsites.net\" ThinkTime=\"0\" Timeout=\"30\" ParseDependentRequests=\"True\" FollowRedirects=\"True\" RecordResult=\"True\" Cache=\"False\" ResponseTimeGoal=\"0\" Encoding=\"utf-8\" ExpectedHttpStatusCode=\"200\" ExpectedResponseUrl=\"\" ReportingName=\"\" IgnoreHttpStatusCode=\"False\" /></Items></WebTest>"
+          },
+          "provisioningState": "Succeeded"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/applicationinsights/resource-manager/Microsoft.Insights/preview/2020-10-05-preview/webTests_API.json b/specification/applicationinsights/resource-manager/Microsoft.Insights/preview/2020-10-05-preview/webTests_API.json
new file mode 100644
index 000000000000..cf128cdb0556
--- /dev/null
+++ b/specification/applicationinsights/resource-manager/Microsoft.Insights/preview/2020-10-05-preview/webTests_API.json
@@ -0,0 +1,678 @@
+{
+  "swagger": "2.0",
+  "info": {
+    "title": "ApplicationInsightsManagementClient",
+    "description": "Azure Application Insights client for web test based alerting.",
+    "version": "2020-10-05-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.Insights/operations": {
+      "get": {
+        "tags": [
+          "Operations"
+        ],
+        "summary": "List available operations.",
+        "description": "List the available operations supported by the Microsoft.EventGrid resource provider.",
+        "operationId": "Operations_List",
+        "consumes": [],
+        "produces": [
+          "application/json"
+        ],
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/OperationsListResult"
+            }
+          },
+          "default": {
+            "description": "*** Error Responses: ***\n\n * 400 Bad Request.\n\n * 500 Internal Server Error."
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        },
+        "x-ms-examples": {
+          "Operations_List": {
+            "$ref": "./examples/Operations_List.json"
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Insights/webtests": {
+      "get": {
+        "description": "Get all Application Insights web tests defined within a specified resource group.",
+        "operationId": "WebTests_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 web test definitions.",
+            "schema": {
+              "$ref": "#/definitions/webTestListResult"
+            }
+          }
+        },
+        "x-ms-examples": {
+          "webTestListByResourceGroup": {
+            "$ref": "./examples/WebTestListByResourceGroup.json"
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Insights/webtests/{webTestName}": {
+      "get": {
+        "description": "Get a specific Application Insights web test definition.",
+        "operationId": "WebTests_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/WebTestNameParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Ann Application Insights web test definition.",
+            "schema": {
+              "$ref": "#/definitions/WebTest"
+            }
+          }
+        },
+        "x-ms-examples": {
+          "webTestGet": {
+            "$ref": "./examples/WebTestGet.json"
+          }
+        }
+      },
+      "put": {
+        "description": "Creates or updates an Application Insights web test definition.",
+        "operationId": "WebTests_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/WebTestNameParameter"
+          },
+          {
+            "name": "WebTestDefinition",
+            "description": "Properties that need to be specified to create or update an Application Insights web test definition.",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/WebTest"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Adding the Application Insights web test was successful. Web test properties are updated and returned.",
+            "schema": {
+              "$ref": "#/definitions/WebTest"
+            }
+          }
+        },
+        "x-ms-examples": {
+          "webTestCreate": {
+            "$ref": "./examples/WebTestCreate.json"
+          },
+          "webTestUpdate": {
+            "$ref": "./examples/WebTestUpdate.json"
+          }
+        }
+      },
+      "patch": {
+        "description": "Creates or updates an Application Insights web test definition.",
+        "operationId": "WebTests_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/WebTestNameParameter"
+          },
+          {
+            "name": "WebTestTags",
+            "description": "Updated tag information to set into the web test instance.",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/TagsResource"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Updating the Application Insights web test tags was successful. Web test tags are updated and returned with the rest of the WebTest object properties.",
+            "schema": {
+              "$ref": "#/definitions/WebTest"
+            }
+          }
+        },
+        "x-ms-examples": {
+          "webTestUpdateTags": {
+            "$ref": "./examples/WebTestUpdateTagsOnly.json"
+          }
+        }
+      },
+      "delete": {
+        "description": "Deletes an Application Insights web test.",
+        "operationId": "WebTests_Delete",
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/WebTestNameParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          }
+        ],
+        "responses": {
+          "204": {
+            "description": "No content: the request was successful, but the response is empty (the request to delete failed because the specified web test does not exist)."
+          },
+          "200": {
+            "description": "Successful request to delete a web test definition."
+          }
+        },
+        "x-ms-examples": {
+          "webTestDelete": {
+            "$ref": "./examples/WebTestDelete.json"
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/providers/Microsoft.Insights/webtests": {
+      "get": {
+        "description": "Get all Application Insights web test alerts definitions within a subscription.",
+        "operationId": "WebTests_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 of 0 or more Application Insights web test definitions.",
+            "schema": {
+              "$ref": "#/definitions/webTestListResult"
+            }
+          }
+        },
+        "x-ms-examples": {
+          "webTestList": {
+            "$ref": "./examples/WebTestList.json"
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Insights/components/{componentName}/webtests": {
+      "get": {
+        "description": "Get all Application Insights web tests defined for the specified component.",
+        "operationId": "WebTests_ListByComponent",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ComponentNameParameter"
+          },
+          {
+            "$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 web test definitions.",
+            "schema": {
+              "$ref": "#/definitions/webTestListResult"
+            }
+          }
+        },
+        "x-ms-examples": {
+          "webTestListByComponent": {
+            "$ref": "./examples/WebTestListByComponent.json"
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        }
+      }
+    }
+  },
+  "definitions": {
+    "WebtestsResource": {
+      "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."
+    },
+    "webTestListResult": {
+      "description": "A list of 0 or more Application Insights WebTest definitions.",
+      "required": [
+        "value"
+      ],
+      "properties": {
+        "value": {
+          "type": "array",
+          "description": "Set of Application Insights WebTest definitions.",
+          "items": {
+            "$ref": "#/definitions/WebTest"
+          }
+        },
+        "nextLink": {
+          "type": "string",
+          "description": "The link to get the next part of the returned list of WebTest, should the return set be too large for a single request. May be null."
+        }
+      }
+    },
+    "WebTest": {
+      "description": "An Application Insights WebTest definition.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/WebtestsResource"
+        }
+      ],
+      "properties": {
+        "kind": {
+          "type": "string",
+          "description": "The kind of WebTest that this web test watches. Choices are ping and multistep.",
+          "default": "ping",
+          "enum": [
+            "ping",
+            "multistep"
+          ],
+          "x-ms-enum": {
+            "name": "WebTestKind",
+            "modelAsString": false
+          }
+        },
+        "properties": {
+          "x-ms-client-flatten": true,
+          "description": "Metadata describing a web test for an Azure resource.",
+          "$ref": "#/definitions/WebTestProperties"
+        }
+      }
+    },
+    "WebTestProperties": {
+      "description": "Metadata describing a web test for an Azure resource.",
+      "required": [
+        "Name",
+        "Kind",
+        "Locations",
+        "SyntheticMonitorId"
+      ],
+      "properties": {
+        "SyntheticMonitorId": {
+          "type": "string",
+          "description": "Unique ID of this WebTest. This is typically the same value as the Name field."
+        },
+        "Name": {
+          "x-ms-client-name": "WebTestName",
+          "type": "string",
+          "description": "User defined name if this WebTest."
+        },
+        "Description": {
+          "type": "string",
+          "description": "User defined description for this WebTest."
+        },
+        "Enabled": {
+          "type": "boolean",
+          "description": "Is the test actively being monitored."
+        },
+        "Frequency": {
+          "type": "integer",
+          "format": "int32",
+          "description": "Interval in seconds between test runs for this WebTest. Default value is 300.",
+          "default": 300
+        },
+        "Timeout": {
+          "type": "integer",
+          "format": "int32",
+          "description": "Seconds until this WebTest will timeout and fail. Default value is 30.",
+          "default": 30
+        },
+        "Kind": {
+          "x-ms-client-name": "WebTestKind",
+          "type": "string",
+          "description": "The kind of web test this is, valid choices are ping, multistep, basic, and standard.",
+          "default": "ping",
+          "enum": [
+            "ping",
+            "multistep",
+            "basic",
+            "standard"
+          ],
+          "x-ms-enum": {
+            "name": "WebTestKindEnum",
+            "modelAsString": false
+          }
+        },
+        "RetryEnabled": {
+          "type": "boolean",
+          "description": "Allow for retries should this WebTest fail."
+        },
+        "Locations": {
+          "type": "array",
+          "description": "A list of where to physically run the tests from to give global coverage for accessibility of your application.",
+          "items": {
+            "$ref": "#/definitions/WebTestGeolocation"
+          }
+        },
+        "Configuration": {
+          "type": "object",
+          "description": "An XML configuration specification for a WebTest.",
+          "properties": {
+            "WebTest": {
+              "type": "string",
+              "description": "The XML specification of a WebTest to run against an application."
+            }
+          }
+        },
+        "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
+        },
+        "Request": {
+          "type": "object",
+          "description": "The collection of request properties",
+          "properties": {
+            "RequestUrl": {
+              "type": "string",
+              "description": "Url location to test."
+            },
+            "Headers": {
+              "type": "array",
+              "description": "List of headers and their values to add to the WebTest call.",
+              "items": {
+                "$ref": "#/definitions/HeaderField"
+              }
+            },
+            "HttpVerb": {
+              "type": "string",
+              "description": "Http verb to use for this web test."
+            },
+            "RequestBody": {
+              "type": "string",
+              "description": "Base64 encoded string body to send with this web test."
+            },
+            "ParseDependentRequests": {
+              "type": "boolean",
+              "description": "Parse Dependent request for this WebTest."
+            },
+            "FollowRedirects": {
+              "type": "boolean",
+              "description": "Follow redirects for this web test."
+            }
+          }
+        },
+        "ContentValidation": {
+          "type": "object",
+          "description": "The collection of content validation properties",
+          "properties": {
+            "ContentMatch": {
+              "type": "string",
+              "description": "Content to look for in the return of the WebTest."
+            },
+            "IgnoreCase": {
+              "type": "boolean",
+              "description": "When set, this value makes the ContentMatch validation case insensitive."
+            },
+            "PassIfTextFound": {
+              "type": "boolean",
+              "description": "When true, validation will pass if there is a match for the ContentMatch string.  If false, validation will fail if there is a match"
+            }
+          }
+        },
+        "SSLCheck": {
+          "type": "boolean",
+          "description": "Checks to see if the SSL cert is still valid."
+        },
+        "SSLCertRemainingLifetimeCheck": {
+          "type": "integer",
+          "format": "int32",
+          "description": "A number of days to check still remain before the the existing SSL cert expires."
+        },
+        "ExpectedHttpStatusCode": {
+          "type": "integer",
+          "format": "int32",
+          "description": "Validate that the WebTest returns the http status code provided."
+        },
+        "IgnoreHttpsStatusCode": {
+          "type": "boolean",
+          "description": "When set, validation will ignore the status code."
+        }
+      }
+    },
+    "WebTestGeolocation": {
+      "description": "Geo-physical location to run a WebTest from. You must specify one or more locations for the test to run from.",
+      "type": "object",
+      "properties": {
+        "Id": {
+          "x-ms-client-name": "location",
+          "type": "string",
+          "description": "Location ID for the WebTest to run from."
+        }
+      }
+    },
+    "HeaderField": {
+      "description": "A header to add to the WebTest.",
+      "type": "object",
+      "properties": {
+        "key": {
+          "x-ms-client-name": "headerFieldName",
+          "type": "string",
+          "description": "The name of the header."
+        },
+        "value": {
+          "x-ms-client-name": "headerFieldValue",
+          "type": "string",
+          "description": "The value of the header."
+        }
+      }
+    },
+    "OperationsListResult": {
+      "description": "Result of the List Operations operation",
+      "type": "object",
+      "properties": {
+        "value": {
+          "description": "A collection of operations",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/Operation"
+          }
+        },
+        "nextLink": {
+          "type": "string",
+          "description": "URL to get the next set of operation list results if there are any."
+        }
+      }
+    },
+    "Operation": {
+      "description": "Represents an operation returned by the GetOperations request",
+      "type": "object",
+      "properties": {
+        "name": {
+          "description": "Name of the operation",
+          "type": "string"
+        },
+        "display": {
+          "$ref": "#/definitions/OperationInfo",
+          "description": "Display name of the operation"
+        },
+        "origin": {
+          "description": "Origin of the operation",
+          "type": "string"
+        },
+        "properties": {
+          "description": "Properties of the operation",
+          "type": "object",
+          "x-ms-client-flatten": true
+        }
+      }
+    },
+    "OperationInfo": {
+      "description": "Information about an operation",
+      "type": "object",
+      "properties": {
+        "provider": {
+          "description": "Name of the provider",
+          "type": "string"
+        },
+        "resource": {
+          "description": "Name of the resource type",
+          "type": "string"
+        },
+        "operation": {
+          "description": "Name of the operation",
+          "type": "string"
+        },
+        "description": {
+          "description": "Description of the operation",
+          "type": "string"
+        }
+      }
+    }
+  },
+  "parameters": {
+    "ComponentNameParameter": {
+      "name": "componentName",
+      "in": "path",
+      "required": true,
+      "type": "string",
+      "description": "The name of the Application Insights component resource.",
+      "x-ms-parameter-location": "method"
+    },
+    "WebTestNameParameter": {
+      "name": "webTestName",
+      "in": "path",
+      "required": true,
+      "type": "string",
+      "description": "The name of the Application Insights WebTest resource.",
+      "x-ms-parameter-location": "method"
+    }
+  }
+}
diff --git a/specification/applicationinsights/resource-manager/readme.md b/specification/applicationinsights/resource-manager/readme.md
index 5c0ad5cb963a..bd369edd1a93 100644
--- a/specification/applicationinsights/resource-manager/readme.md
+++ b/specification/applicationinsights/resource-manager/readme.md
@@ -28,7 +28,7 @@ These are the global settings for the ApplicationInsights API.
 title: ApplicationInsightsManagementClient
 description: Composite Swagger for Application Insights Management Client
 openapi-type: arm
-tag: package-preview-2020-06
+tag: package-preview-2020-10
 ```
 
 ## Suppression
@@ -105,6 +105,15 @@ directive:
     reason: 'delete API returns empty response and is already part of the previous api, cannot change it'
 ```
 
+
+### Tag: package-preview-2020-10
+
+These settings apply only when `--tag=package-preview-2020-10` is specified on the command line.
+
+```yaml $(tag) == 'package-preview-2020-10'
+input-file:
+  - Microsoft.Insights/preview/2020-10-05-preview/webTests_API.json
+```
 ### Tag: package-preview-2020-06-only
 
 These settings apply only when `--tag=package-preview-2020-06-only` is specified on the command line.
@@ -351,4 +360,3 @@ input-file:
 ## AzureResourceSchema
 
 See configuration in [readme.azureresourceschema.md](./readme.azureresourceschema.md)
-
diff --git a/specification/automanage/resource-manager/readme.md b/specification/automanage/resource-manager/readme.md
index a99434672cf5..4e54a1d44f3c 100644
--- a/specification/automanage/resource-manager/readme.md
+++ b/specification/automanage/resource-manager/readme.md
@@ -18,6 +18,8 @@ To see additional help and options, run:
 
 ---
 
+## Configuration
+
 ### Basic Information
 
 These are the global settings for the Automanage API.
diff --git a/specification/azsadmin/resource-manager/fabric/Microsoft.Fabric.Admin/preview/2020-10-01/ScaleUnit.json b/specification/azsadmin/resource-manager/fabric/Microsoft.Fabric.Admin/preview/2020-10-01/ScaleUnit.json
new file mode 100644
index 000000000000..b0cd34d29890
--- /dev/null
+++ b/specification/azsadmin/resource-manager/fabric/Microsoft.Fabric.Admin/preview/2020-10-01/ScaleUnit.json
@@ -0,0 +1,599 @@
+{
+  "swagger": "2.0",
+  "info": {
+    "description": "Scale unit operation endpoints and objects.",
+    "title": "FabricAdminClient",
+    "version": "2020-10-01"
+  },
+  "host": "management.azure.com",
+  "schemes": [
+    "https"
+  ],
+  "consumes": [
+    "application/json"
+  ],
+  "produces": [
+    "application/json"
+  ],
+  "paths": {
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Fabric.Admin/fabricLocations/{location}/scaleUnits/{scaleUnit}/scaleOut": {
+      "post": {
+        "x-ms-examples": {
+          "Scales out a scale unit.": {
+            "$ref": "./examples/ScaleUnit/ScaleOut.json"
+          }
+        },
+        "tags": [
+          "ScaleUnits"
+        ],
+        "description": "Scales out a scale unit.",
+        "operationId": "ScaleUnits_ScaleOut",
+        "parameters": [
+          {
+            "$ref": "../2016-05-01/Fabric.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../2016-05-01/Fabric.json#/parameters/ResourceGroupParameter"
+          },
+          {
+            "$ref": "../2016-05-01/Fabric.json#/parameters/LocationParameter"
+          },
+          {
+            "$ref": "#/parameters/ScaleUnitParameter"
+          },
+          {
+            "$ref": "#/parameters/ScaleOutScaleUnitParametersInBody"
+          },
+          {
+            "$ref": "#/parameters/ApiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK"
+          },
+          "202": {
+            "description": "ACCEPTED"
+          }
+        },
+        "x-ms-long-running-operation": true
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Fabric.Admin/fabricLocations/{location}/scaleUnits/{scaleUnit}/setGpuPartitionSize": {
+      "post": {
+        "x-ms-examples": {
+          "Set GPU partition size.": {
+            "$ref": "./examples/ScaleUnit/SetGpuPartitionSize.json"
+          }
+        },
+        "tags": [
+          "ScaleUnits"
+        ],
+        "description": "Set GPU partition size.",
+        "operationId": "ScaleUnits_SetGPUPartitionSize",
+        "parameters": [
+          {
+            "$ref": "../2016-05-01/Fabric.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../2016-05-01/Fabric.json#/parameters/ResourceGroupParameter"
+          },
+          {
+            "$ref": "../2016-05-01/Fabric.json#/parameters/LocationParameter"
+          },
+          {
+            "$ref": "#/parameters/ScaleUnitParameter"
+          },
+          {
+            "$ref": "#/parameters/GpuPartitionSizeParameter"
+          },
+          {
+            "$ref": "#/parameters/ApiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK"
+          },
+          "202": {
+            "description": "ACCEPTED"
+          },
+          "default": {
+            "description": "Default Response.",
+            "schema": {
+              "$ref": "#/definitions/ExtendedErrorInfo"
+            }
+          }
+        },
+        "x-ms-long-running-operation": true
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Fabric.Admin/fabricLocations/{location}/scaleUnits/{scaleUnit}/createFromJson": {
+      "post": {
+        "x-ms-examples": {
+          "Add a new scale unit.": {
+            "$ref": "./examples/ScaleUnit/CreateFromJson.json"
+          }
+        },
+        "tags": [
+          "ScaleUnits"
+        ],
+        "description": "Add a new scale unit.",
+        "operationId": "ScaleUnits_CreateFromJson",
+        "parameters": [
+          {
+            "$ref": "../2016-05-01/Fabric.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../2016-05-01/Fabric.json#/parameters/ResourceGroupParameter"
+          },
+          {
+            "$ref": "../2016-05-01/Fabric.json#/parameters/LocationParameter"
+          },
+          {
+            "$ref": "#/parameters/ScaleUnitParameter"
+          },
+          {
+            "$ref": "#/parameters/CreateFromJsonScaleUnitParametersInBody"
+          },
+          {
+            "$ref": "#/parameters/ApiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK"
+          },
+          "202": {
+            "description": "ACCEPTED"
+          }
+        },
+        "x-ms-long-running-operation": true
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Fabric.Admin/fabricLocations/{location}/scaleUnits/{scaleUnit}": {
+      "get": {
+        "x-ms-examples": {
+          "Returns the requested scale unit": {
+            "$ref": "./examples/ScaleUnit/Get.json"
+          }
+        },
+        "tags": [
+          "ScaleUnits"
+        ],
+        "description": "Returns the requested scale unit.",
+        "operationId": "ScaleUnits_Get",
+        "parameters": [
+          {
+            "$ref": "../2016-05-01/Fabric.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../2016-05-01/Fabric.json#/parameters/ResourceGroupParameter"
+          },
+          {
+            "$ref": "../2016-05-01/Fabric.json#/parameters/LocationParameter"
+          },
+          {
+            "$ref": "#/parameters/ScaleUnitParameter"
+          },
+          {
+            "$ref": "#/parameters/ApiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/ScaleUnit"
+            }
+          },
+          "404": {
+            "description": "NOT FOUND"
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Fabric.Admin/fabricLocations/{location}/scaleUnits": {
+      "get": {
+        "x-ms-examples": {
+          "Returns a list of all scale units at a location.": {
+            "$ref": "./examples/ScaleUnit/List.json"
+          }
+        },
+        "tags": [
+          "ScaleUnits"
+        ],
+        "description": "Returns a list of all scale units at a location.",
+        "operationId": "ScaleUnits_List",
+        "parameters": [
+          {
+            "$ref": "../2016-05-01/Fabric.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../2016-05-01/Fabric.json#/parameters/ResourceGroupParameter"
+          },
+          {
+            "$ref": "../2016-05-01/Fabric.json#/parameters/LocationParameter"
+          },
+          {
+            "$ref": "#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "../2016-05-01/Fabric.json#/parameters/FilterParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/ScaleUnitList"
+            }
+          },
+          "404": {
+            "description": "NOT FOUND"
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        },
+        "x-ms-odata": "#/definitions/ScaleUnit"
+      }
+    }
+  },
+  "definitions": {
+    "ScaleUnitCapacity": {
+      "description": "The capacity information for a physical machine.",
+      "type": "object",
+      "properties": {
+        "memoryGB": {
+          "description": "The memory for the physical machine.",
+          "type": "number",
+          "format": "float"
+        },
+        "cores": {
+          "description": "The number of CPU cores for the physical machine.",
+          "type": "integer",
+          "format": "int64"
+        }
+      }
+    },
+    "ScaleUnit": {
+      "description": "Represents a cluster. Generally, the cluster will be a collection of hosts backed by failover cluster manager.",
+      "type": "object",
+      "properties": {
+        "properties": {
+          "description": "Properties of a scale unit.",
+          "x-ms-client-flatten": true,
+          "$ref": "#/definitions/ScaleUnitModel"
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "../2016-05-01/Fabric.json#/definitions/Resource"
+        }
+      ]
+    },
+    "ScaleUnitModel": {
+      "description": "Properties of a scale unit.",
+      "type": "object",
+      "properties": {
+        "scaleUnitType": {
+          "description": "Type of cluster.",
+          "enum": [
+            "Unknown",
+            "ComputeOnly",
+            "StorageOnly",
+            "HyperConverged"
+          ],
+          "type": "string",
+          "x-ms-enum": {
+            "modelAsString": true,
+            "name": "ScaleUnitType"
+          }
+        },
+        "logicalFaultDomain": {
+          "description": "Fault domain name of the cluster.",
+          "type": "integer",
+          "format": "int32"
+        },
+        "nodes": {
+          "description": "List of nodes in the server.",
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "state": {
+          "description": "Current state of the cluster.",
+          "enum": [
+            "Unknown",
+            "Creating",
+            "Running",
+            "Upgrading",
+            "Deleting"
+          ],
+          "type": "string",
+          "x-ms-enum": {
+            "modelAsString": true,
+            "name": "ScaleUnitState"
+          }
+        },
+        "model": {
+          "description": "Model of the servers in the cluster.",
+          "type": "string"
+        },
+        "totalCapacity": {
+          "description": "Capacity information for the cluster.",
+          "$ref": "#/definitions/ScaleUnitCapacity"
+        },
+        "isMultiNode": {
+          "description": "Denotes if more than one node in cluster.",
+          "type": "boolean"
+        },
+        "isGpuAvailable": {
+          "description": "Denotes if GPU resource is available in the cluster.",
+          "type": "boolean"
+        },
+        "gpuPartitionSize": {
+          "description": "GPU partition size.",
+          "type": "integer",
+          "format": "int32"
+        },
+        "gpuType": {
+          "description": "Type of GPU.",
+          "enum": [
+            "GPUP",
+            "DDA",
+            "None"
+          ],
+          "type": "string",
+          "x-ms-enum": {
+            "modelAsString": true,
+            "name": "GpuType"
+          }
+        }
+      }
+    },
+    "ScaleUnitList": {
+      "description": "A pageable list of scale units.",
+      "type": "object",
+      "properties": {
+        "value": {
+          "description": "List of scale units.",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/ScaleUnit"
+          }
+        },
+        "nextLink": {
+          "description": "URI to the next page.",
+          "type": "string"
+        }
+      }
+    },
+    "SetGpuPartitionSizeParameter": {
+      "description": "Input data for setting GPU partitions.",
+      "type": "object",
+      "properties": {
+        "gpuPartitionSize": {
+          "x-ms-client-name": "GpuPartitionSize",
+          "description": "Number of GPU partitions",
+          "type": "integer",
+          "format": "int32"
+        }
+      }
+    },
+    "ScaleOutScaleUnitParameters": {
+      "description": "Input data that allows for adding a scale unit node.",
+      "type": "object",
+      "properties": {
+        "bmcIpv4Address": {
+          "x-ms-client-name": "BMCIPv4Address",
+          "description": "BMC address of the physical machine.",
+          "type": "string"
+        },
+        "computerName": {
+          "description": "Computer name of the physical machine.",
+          "type": "string"
+        }
+      }
+    },
+    "ScaleOutScaleUnitParametersList": {
+      "description": "A list of input data that allows for adding a set of scale unit nodes.",
+      "type": "object",
+      "properties": {
+        "nodeList": {
+          "description": "List of nodes in the scale unit.",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/ScaleOutScaleUnitParameters"
+          }
+        },
+        "awaitStorageConvergence": {
+          "description": "Flag indicates if the operation should wait for storage to converge before returning.",
+          "type": "boolean"
+        }
+      }
+    },
+    "NetworkDefinitionParameter": {
+      "description": "A definition of the network received from a new cluster operation.",
+      "type": "object",
+      "properties": {
+        "subnet": {
+          "description": "The subnet IP mask in the example format 10.0.0.0/25.",
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "vlanId": {
+          "description": "The Vlan ID of the subnet.",
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        }
+      }
+    },
+    "DeploymentJsonPhysicalNodeParameters": {
+      "description": "Description of a bare metal node used for scale unit scale out operations.",
+      "type": "object",
+      "properties": {
+        "bmcIpAddress": {
+          "x-ms-client-name": "BMCIPAddress",
+          "description": "BMC address of the physical machine.",
+          "type": "string"
+        },
+        "name": {
+          "description": "Computer name of the physical machine.",
+          "type": "string"
+        }
+      }
+    },
+    "CreateFromJsonScaleUnitParametersList": {
+      "description": "A list of input data that allows for creating the new scale unit.",
+      "type": "object",
+      "properties": {
+        "clusterName": {
+          "description": "Cluster name for the new scale unit.",
+          "type": "string"
+        },
+        "physicalNodes": {
+          "description": "List of nodes in the scale unit.",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/DeploymentJsonPhysicalNodeParameters"
+          }
+        },
+        "torSwitchBgpAsn": {
+          "description": "The ASN for the cluster's rack TOR.",
+          "type": "string"
+        },
+        "softwareBgpAsn": {
+          "description": "The software ASN for the cluster's rack.",
+          "type": "string"
+        },
+        "torSwitchBgpPeerIp": {
+          "description": "The list of IP addresses used for TOR communication.",
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "infrastructureNetwork": {
+          "description": "The information associated with the infrastructure network that will be subdivided into subnets.",
+          "$ref": "#/definitions/NetworkDefinitionParameter"
+        },
+        "storageNetwork": {
+          "description": "The information associated with the storage network that will be subdivided into subnets.",
+          "$ref": "#/definitions/NetworkDefinitionParameter"
+        },
+        "netQosPriority": {
+          "description": "The network QOS priority setting.",
+          "type": "integer",
+          "format": "int32"
+        }
+      }
+    },
+    "ExtendedErrorInfo": {
+      "type": "object",
+      "description": "Error response.",
+      "properties": {
+        "error": {
+          "$ref": "#/definitions/ErrorDefinition",
+          "description": "The error details."
+        }
+      }
+    },
+    "ErrorDefinition": {
+      "type": "object",
+      "description": "Error definition.",
+      "properties": {
+        "code": {
+          "description": "Service specific error code which serves as the substatus for the HTTP error code.",
+          "type": "string",
+          "readOnly": true
+        },
+        "message": {
+          "description": "Description of the error.",
+          "type": "string",
+          "readOnly": true
+        },
+        "details": {
+          "description": "Internal error details.",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/ErrorDefinition"
+          },
+          "readOnly": true
+        }
+      }
+    }
+  },
+  "parameters": {
+    "ApiVersionParameter": {
+      "name": "api-version",
+      "in": "query",
+      "description": "Client API Version.",
+      "required": true,
+      "type": "string",
+      "default": "2020-10-01"
+    },
+    "ScaleUnitParameter": {
+      "name": "scaleUnit",
+      "description": "Name of the scale units.",
+      "in": "path",
+      "required": true,
+      "type": "string",
+      "x-ms-parameter-location": "method"
+    },
+    "GpuPartitionSizeParameter": {
+      "name": "gpuPartitionSizeParameters",
+      "description": "Number of GPU partitions.",
+      "in": "body",
+      "required": true,
+      "schema": {
+        "$ref": "#/definitions/SetGpuPartitionSizeParameter"
+      },
+      "x-ms-parameter-location": "method"
+    },
+    "ScaleOutScaleUnitParametersInBody": {
+      "name": "scaleUnitNodeParameters",
+      "description": "A list of input data that allows for adding a set of scale unit nodes.",
+      "in": "body",
+      "required": true,
+      "schema": {
+        "$ref": "#/definitions/ScaleOutScaleUnitParametersList"
+      },
+      "x-ms-parameter-location": "method"
+    },
+    "CreateFromJsonScaleUnitParametersInBody": {
+      "name": "creationData",
+      "description": "A list of input data that allows for creating the new scale unit.",
+      "in": "body",
+      "required": true,
+      "schema": {
+        "$ref": "#/definitions/CreateFromJsonScaleUnitParametersList"
+      },
+      "x-ms-parameter-location": "method"
+    }
+  },
+  "securityDefinitions": {
+    "azure_auth": {
+      "type": "oauth2",
+      "authorizationUrl": "https://login.microsoftonline.com/common/oauth2/authorize",
+      "flow": "implicit",
+      "description": "Authorization uses an Azure Active Directory OAuth2 flow.",
+      "scopes": {
+        "user_impersonation": "impersonate your user account"
+      }
+    }
+  },
+  "security": [
+    {
+      "azure_auth": [
+        "user_impersonation"
+      ]
+    }
+  ]
+}
diff --git a/specification/azsadmin/resource-manager/fabric/Microsoft.Fabric.Admin/preview/2020-10-01/ScaleUnitNode.json b/specification/azsadmin/resource-manager/fabric/Microsoft.Fabric.Admin/preview/2020-10-01/ScaleUnitNode.json
new file mode 100644
index 000000000000..3c8918b40b98
--- /dev/null
+++ b/specification/azsadmin/resource-manager/fabric/Microsoft.Fabric.Admin/preview/2020-10-01/ScaleUnitNode.json
@@ -0,0 +1,588 @@
+{
+  "swagger": "2.0",
+  "info": {
+    "description": "Scale unit node operation endpoints and objects.",
+    "title": "FabricAdminClient",
+    "version": "2020-10-01"
+  },
+  "host": "management.azure.com",
+  "schemes": [
+    "https"
+  ],
+  "consumes": [
+    "application/json"
+  ],
+  "produces": [
+    "application/json"
+  ],
+  "paths": {
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Fabric.Admin/fabricLocations/{location}/scaleUnitNodes/{scaleUnitNode}/Shutdown": {
+      "post": {
+        "x-ms-examples": {
+          "Shutdown a scale unit node.": {
+            "$ref": "./examples/ScaleUnitNode/Shutdown.json"
+          }
+        },
+        "tags": [
+          "ScaleUnitNodes"
+        ],
+        "description": "Shutdown a scale unit node.",
+        "operationId": "ScaleUnitNodes_Shutdown",
+        "parameters": [
+          {
+            "$ref": "../2016-05-01/Fabric.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../2016-05-01/Fabric.json#/parameters/ResourceGroupParameter"
+          },
+          {
+            "$ref": "../2016-05-01/Fabric.json#/parameters/LocationParameter"
+          },
+          {
+            "$ref": "#/parameters/ScaleUnitNodeParameter"
+          },
+          {
+            "$ref": "#/parameters/ApiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK"
+          },
+          "202": {
+            "description": "ACCEPTED"
+          }
+        },
+        "x-ms-long-running-operation": true
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Fabric.Admin/fabricLocations/{location}/scaleUnitNodes/{scaleUnitNode}/PowerOff": {
+      "post": {
+        "x-ms-examples": {
+          "Power off a scale unit node.": {
+            "$ref": "./examples/ScaleUnitNode/PowerOff.json"
+          }
+        },
+        "tags": [
+          "ScaleUnitNodes"
+        ],
+        "description": "Power off a scale unit node.",
+        "operationId": "ScaleUnitNodes_PowerOff",
+        "parameters": [
+          {
+            "$ref": "../2016-05-01/Fabric.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../2016-05-01/Fabric.json#/parameters/ResourceGroupParameter"
+          },
+          {
+            "$ref": "../2016-05-01/Fabric.json#/parameters/LocationParameter"
+          },
+          {
+            "$ref": "#/parameters/ScaleUnitNodeParameter"
+          },
+          {
+            "$ref": "#/parameters/ApiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK"
+          },
+          "202": {
+            "description": "ACCEPTED"
+          }
+        },
+        "x-ms-long-running-operation": true
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Fabric.Admin/fabricLocations/{location}/scaleUnitNodes/{scaleUnitNode}/PowerOn": {
+      "post": {
+        "x-ms-examples": {
+          "Power on a scale unit node.": {
+            "$ref": "./examples/ScaleUnitNode/PowerOn.json"
+          }
+        },
+        "tags": [
+          "ScaleUnitNodes"
+        ],
+        "description": "Power on a scale unit node.",
+        "operationId": "ScaleUnitNodes_PowerOn",
+        "parameters": [
+          {
+            "$ref": "../2016-05-01/Fabric.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../2016-05-01/Fabric.json#/parameters/ResourceGroupParameter"
+          },
+          {
+            "$ref": "../2016-05-01/Fabric.json#/parameters/LocationParameter"
+          },
+          {
+            "$ref": "#/parameters/ScaleUnitNodeParameter"
+          },
+          {
+            "$ref": "#/parameters/ApiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK"
+          },
+          "202": {
+            "description": "ACCEPTED"
+          }
+        },
+        "x-ms-long-running-operation": true
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Fabric.Admin/fabricLocations/{location}/scaleUnitNodes/{scaleUnitNode}/StartMaintenanceMode": {
+      "post": {
+        "x-ms-examples": {
+          "Start maintenance mode on a scale unit node.": {
+            "$ref": "./examples/ScaleUnitNode/StartMaintenanceMode.json"
+          }
+        },
+        "tags": [
+          "ScaleUnitNodes"
+        ],
+        "description": "Start maintenance mode for a scale unit node.",
+        "operationId": "ScaleUnitNodes_StartMaintenanceMode",
+        "parameters": [
+          {
+            "$ref": "../2016-05-01/Fabric.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../2016-05-01/Fabric.json#/parameters/ResourceGroupParameter"
+          },
+          {
+            "$ref": "../2016-05-01/Fabric.json#/parameters/LocationParameter"
+          },
+          {
+            "$ref": "#/parameters/ScaleUnitNodeParameter"
+          },
+          {
+            "$ref": "#/parameters/ApiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK"
+          },
+          "202": {
+            "description": "ACCEPTED"
+          }
+        },
+        "x-ms-long-running-operation": true
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Fabric.Admin/fabricLocations/{location}/scaleUnitNodes/{scaleUnitNode}/StopMaintenanceMode": {
+      "post": {
+        "x-ms-examples": {
+          "Stop maintenance mode on a scale unit node.": {
+            "$ref": "./examples/ScaleUnitNode/StopMaintenanceMode.json"
+          }
+        },
+        "tags": [
+          "ScaleUnitNodes"
+        ],
+        "description": "Stop maintenance mode for a scale unit node.",
+        "operationId": "ScaleUnitNodes_StopMaintenanceMode",
+        "parameters": [
+          {
+            "$ref": "../2016-05-01/Fabric.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../2016-05-01/Fabric.json#/parameters/ResourceGroupParameter"
+          },
+          {
+            "$ref": "../2016-05-01/Fabric.json#/parameters/LocationParameter"
+          },
+          {
+            "$ref": "#/parameters/ScaleUnitNodeParameter"
+          },
+          {
+            "$ref": "#/parameters/ApiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK"
+          },
+          "202": {
+            "description": "ACCEPTED"
+          }
+        },
+        "x-ms-long-running-operation": true
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Fabric.Admin/fabricLocations/{location}/scaleUnitNodes/{scaleUnitNode}/Repair": {
+      "post": {
+        "x-ms-examples": {
+          "Repairs a node of the cluster.": {
+            "$ref": "./examples/ScaleUnitNode/Repair.json"
+          }
+        },
+        "tags": [
+          "ScaleUnitNodes"
+        ],
+        "description": "Repairs a node of the cluster.",
+        "operationId": "ScaleUnitNodes_Repair",
+        "parameters": [
+          {
+            "$ref": "../2016-05-01/Fabric.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../2016-05-01/Fabric.json#/parameters/ResourceGroupParameter"
+          },
+          {
+            "$ref": "../2016-05-01/Fabric.json#/parameters/LocationParameter"
+          },
+          {
+            "$ref": "#/parameters/ScaleUnitNodeParameter"
+          },
+          {
+            "$ref": "#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "#/parameters/BareMetalNodeParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK"
+          },
+          "202": {
+            "description": "ACCEPTED"
+          }
+        },
+        "x-ms-long-running-operation": true
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Fabric.Admin/fabricLocations/{location}/scaleUnitNodes/{scaleUnitNode}": {
+      "get": {
+        "x-ms-examples": {
+          "Return the requested scale unit node.": {
+            "$ref": "./examples/ScaleUnitNode/Get.json"
+          }
+        },
+        "tags": [
+          "ScaleUnitNodes"
+        ],
+        "description": "Return the requested scale unit node.",
+        "operationId": "ScaleUnitNodes_Get",
+        "parameters": [
+          {
+            "$ref": "../2016-05-01/Fabric.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../2016-05-01/Fabric.json#/parameters/ResourceGroupParameter"
+          },
+          {
+            "$ref": "../2016-05-01/Fabric.json#/parameters/LocationParameter"
+          },
+          {
+            "$ref": "#/parameters/ScaleUnitNodeParameter"
+          },
+          {
+            "$ref": "#/parameters/ApiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/ScaleUnitNode"
+            }
+          },
+          "404": {
+            "description": "NOT FOUND"
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Fabric.Admin/fabricLocations/{location}/scaleUnitNodes": {
+      "get": {
+        "x-ms-examples": {
+          "List all scale unit node": {
+            "$ref": "./examples/ScaleUnitNode/List.json"
+          }
+        },
+        "tags": [
+          "ScaleUnitNodes"
+        ],
+        "description": "Returns a list of all scale unit nodes in a location.",
+        "operationId": "ScaleUnitNodes_List",
+        "parameters": [
+          {
+            "$ref": "../2016-05-01/Fabric.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../2016-05-01/Fabric.json#/parameters/ResourceGroupParameter"
+          },
+          {
+            "$ref": "../2016-05-01/Fabric.json#/parameters/LocationParameter"
+          },
+          {
+            "$ref": "#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "../2016-05-01/Fabric.json#/parameters/FilterParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/ScaleUnitNodeList"
+            }
+          },
+          "404": {
+            "description": "NOT FOUND"
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        },
+        "x-ms-odata": "#/definitions/ScaleUnitNode"
+      }
+    }
+  },
+  "definitions": {
+    "BareMetalNodeDescription": {
+      "description": "Description of a bare metal node used for ScaleOut operation on a cluster.",
+      "type": "object",
+      "properties": {
+        "bmcIpv4Address": {
+          "x-ms-client-name": "BMCIPv4Address",
+          "description": "BMC address of the physical machine.",
+          "type": "string"
+        },
+        "vendor": {
+          "description": "Vendor of the physical machine.",
+          "type": "string"
+        },
+        "model": {
+          "description": "Model of the physical machine.",
+          "type": "string"
+        },
+        "serialNumber": {
+          "description": "Serial number of the physical machine.",
+          "type": "string"
+        },
+        "biosVersion": {
+          "description": "Bios version of the physical machine.",
+          "type": "string"
+        },
+        "computerName": {
+          "description": "Name of the computer.",
+          "type": "string"
+        },
+        "clusterName": {
+          "description": "Name of the cluster.",
+          "type": "string"
+        },
+        "macAddress": {
+          "description": "Name of the MAC address of the bare metal node.",
+          "type": "string"
+        }
+      }
+    },
+    "ScaleUnitNode": {
+      "description": "The physical server in a cluster.",
+      "type": "object",
+      "properties": {
+        "properties": {
+          "description": "Holds all properties related to a scale unit node.",
+          "x-ms-client-flatten": true,
+          "$ref": "#/definitions/ScaleUnitNodeModel"
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "../2016-05-01/Fabric.json#/definitions/Resource"
+        }
+      ]
+    },
+    "ScaleUnitNodeModel": {
+      "description": "Holds all properties related to a scale unit node.",
+      "type": "object",
+      "properties": {
+        "scaleUnitNodeStatus": {
+          "description": "Status of the physical machine.",
+          "enum": [
+            "Running",
+            "Maintenance",
+            "Stopped"
+          ],
+          "type": "string",
+          "x-ms-enum": {
+            "modelAsString": true,
+            "name": "ScaleUnitNodeStatus"
+          }
+        },
+        "powerState": {
+          "description": "PowerState of the physical machine.",
+          "enum": [
+            "Stopped",
+            "Starting",
+            "Running",
+            "Stopping"
+          ],
+          "type": "string",
+          "x-ms-enum": {
+            "modelAsString": true,
+            "name": "PowerState"
+          }
+        },
+        "bmcAddress": {
+          "description": "BMC address of the physical machine.",
+          "type": "string"
+        },
+        "scaleUnitName": {
+          "description": "Cluster name of the physical machine.",
+          "type": "string"
+        },
+        "scaleUnitUri": {
+          "description": "URI of the corresponding cluster.",
+          "type": "string"
+        },
+        "canPowerOff": {
+          "description": "Value indicating whether the node can be powered off.",
+          "type": "boolean"
+        },
+        "vendor": {
+          "description": "Vendor of the physical machine.",
+          "type": "string"
+        },
+        "model": {
+          "description": "Model of the physical machine.",
+          "type": "string"
+        },
+        "serialNumber": {
+          "description": "Serial number of the physical machine.",
+          "type": "string"
+        },
+        "biosVersion": {
+          "description": "BIOS version of the physical machine.",
+          "type": "string"
+        },
+        "capacity": {
+          "description": "Capacity of the physical machine.",
+          "$ref": "ScaleUnit.json#/definitions/ScaleUnitCapacity"
+        },
+        "gpus": {
+          "description": "GPU resource list of the physical machine.",
+          "type": "array",
+          "items": {
+            "type": "object",
+            "$ref": "#/definitions/GpuModel"
+          }
+        }
+      }
+    },
+    "GpuModel": {
+      "description": "The GPU information on the physical machine.",
+      "type": "object",
+      "properties": {
+        "hostDriverVersion": {
+          "description": "GPU host driver version.",
+          "type": "string"
+        },
+        "name": {
+          "description": "GPU name.",
+          "type": "string"
+        },
+        "partitionSize": {
+          "description": "GPU partition size.",
+          "type": "integer",
+          "format": "int32"
+        },
+        "slotLocation": {
+          "description": "GPU slot location.",
+          "type": "string"
+        },
+        "oem": {
+          "description": "GPU OEM information",
+          "type": "string"
+        },
+        "type": {
+          "description": "Type of GPU.",
+          "enum": [
+            "GPUP",
+            "DDA",
+            "None"
+          ],
+          "type": "string",
+          "x-ms-enum": {
+            "modelAsString": true,
+            "name": "GpuType"
+          }
+        }
+      }
+    },
+    "ScaleUnitNodeList": {
+      "description": "A pageable list of scale unit nodes.",
+      "type": "object",
+      "properties": {
+        "value": {
+          "description": "List of scale unit nodes.",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/ScaleUnitNode"
+          }
+        },
+        "nextLink": {
+          "description": "The URI to the next page.",
+          "type": "string"
+        }
+      }
+    }
+  },
+  "parameters": {
+    "ApiVersionParameter": {
+      "name": "api-version",
+      "in": "query",
+      "description": "Client API Version.",
+      "required": true,
+      "type": "string",
+      "default": "2020-10-01"
+    },
+    "ScaleUnitNodeParameter": {
+      "name": "scaleUnitNode",
+      "description": "Name of the scale unit node.",
+      "in": "path",
+      "required": true,
+      "type": "string",
+      "x-ms-parameter-location": "method"
+    },
+    "BareMetalNodeParameter": {
+      "name": "bareMetalNode",
+      "description": "Description of a node.",
+      "in": "body",
+      "required": true,
+      "schema": {
+        "$ref": "#/definitions/BareMetalNodeDescription"
+      },
+      "x-ms-parameter-location": "method"
+    }
+  },
+  "securityDefinitions": {
+    "azure_auth": {
+      "type": "oauth2",
+      "authorizationUrl": "https://login.microsoftonline.com/common/oauth2/authorize",
+      "flow": "implicit",
+      "description": "Authorization uses an Azure Active Directory OAuth2 flow.",
+      "scopes": {
+        "user_impersonation": "impersonate your user account"
+      }
+    }
+  },
+  "security": [
+    {
+      "azure_auth": [
+        "user_impersonation"
+      ]
+    }
+  ]
+}
diff --git a/specification/azsadmin/resource-manager/fabric/Microsoft.Fabric.Admin/preview/2020-10-01/examples/ScaleUnit/CreateFromJson.json b/specification/azsadmin/resource-manager/fabric/Microsoft.Fabric.Admin/preview/2020-10-01/examples/ScaleUnit/CreateFromJson.json
new file mode 100644
index 000000000000..3fabf00b0637
--- /dev/null
+++ b/specification/azsadmin/resource-manager/fabric/Microsoft.Fabric.Admin/preview/2020-10-01/examples/ScaleUnit/CreateFromJson.json
@@ -0,0 +1,44 @@
+{
+  "parameters": {
+    "api-version": "2020-10-01",
+    "subscriptionId": "20ff7fc3-e762-44dd-bd96-b71116dcdc23",
+    "resourceGroupName": "System.local",
+    "location": "local",
+    "scaleUnit": "cluster",
+    "creationData": {
+      "clusterName": "cluster",
+      "physicalNodes": [
+        {
+          "bmcIpAddress": "192.0.0.1",
+          "name": "machine"
+        }
+      ],
+      "torSwitchBgpAsn": "64703",
+      "softwareBgpAsn": "64703",
+      "torSwitchBgpPeerIp": [
+        "10.0.0.1"
+      ],
+      "infrastructureNetwork": {
+        "subnet": [
+          "10.0.0.1/24"
+        ],
+        "vlanId": [
+          "0"
+        ]
+      },
+      "storageNetwork": {
+        "subnet": [
+          "10.0.0.1/24"
+        ],
+        "vlanId": [
+          "0"
+        ]
+      },
+      "netQosPriority": 1
+    }
+  },
+  "responses": {
+    "200": {},
+    "202": {}
+  }
+}
diff --git a/specification/azsadmin/resource-manager/fabric/Microsoft.Fabric.Admin/preview/2020-10-01/examples/ScaleUnit/Get.json b/specification/azsadmin/resource-manager/fabric/Microsoft.Fabric.Admin/preview/2020-10-01/examples/ScaleUnit/Get.json
new file mode 100644
index 000000000000..f756a3cd1e0f
--- /dev/null
+++ b/specification/azsadmin/resource-manager/fabric/Microsoft.Fabric.Admin/preview/2020-10-01/examples/ScaleUnit/Get.json
@@ -0,0 +1,37 @@
+{
+  "parameters": {
+    "api-version": "2020-10-01",
+    "subscriptionId": "20ff7fc3-e762-44dd-bd96-b71116dcdc23",
+    "resourceGroupName": "System.local",
+    "location": "local",
+    "scaleUnit": "S-Cluster"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/23a94a7f-64b3-42d8-807c-733284339015/resourceGroups/System.local/providers/Microsoft.Fabric.Admin/fabricLocations/local/scaleUnits/S-Cluster",
+        "name": "S-Cluster",
+        "type": "Microsoft.Fabric.Admin/fabricLocations/scaleUnits",
+        "location": "local",
+        "tags": {},
+        "properties": {
+          "isGpuAvailable": true,
+          "gpuType": "DDA",
+          "gpuPartitionSize": 8,
+          "scaleUnitType": "HyperConverged",
+          "logicalFaultDomain": 0,
+          "nodes": [
+            "/subscriptions/23a94a7f-64b3-42d8-807c-733284339015/resourceGroups/system.local/providers/Microsoft.Fabric.Admin/fabricLocations/local/scaleUnitNodes/HC1u15a2437"
+          ],
+          "state": "Running",
+          "totalCapacity": {
+            "memoryGB": 511.8877,
+            "cores": 32
+          },
+          "isMultiNode": false
+        }
+      }
+    },
+    "404": {}
+  }
+}
diff --git a/specification/azsadmin/resource-manager/fabric/Microsoft.Fabric.Admin/preview/2020-10-01/examples/ScaleUnit/List.json b/specification/azsadmin/resource-manager/fabric/Microsoft.Fabric.Admin/preview/2020-10-01/examples/ScaleUnit/List.json
new file mode 100644
index 000000000000..15d5eb427db8
--- /dev/null
+++ b/specification/azsadmin/resource-manager/fabric/Microsoft.Fabric.Admin/preview/2020-10-01/examples/ScaleUnit/List.json
@@ -0,0 +1,40 @@
+{
+  "parameters": {
+    "api-version": "2020-10-01",
+    "subscriptionId": "20ff7fc3-e762-44dd-bd96-b71116dcdc23",
+    "resourceGroupName": "System.local",
+    "location": "local"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "id": "/subscriptions/23a94a7f-64b3-42d8-807c-733284339015/resourceGroups/System.local/providers/Microsoft.Fabric.Admin/fabricLocations/local/scaleUnits/S-Cluster",
+            "name": "S-Cluster",
+            "type": "Microsoft.Fabric.Admin/fabricLocations/scaleUnits",
+            "location": "local",
+            "tags": {},
+            "properties": {
+              "isGpuAvailable": true,
+              "gpuType": "GPUP",
+              "gpuPartitionSize": 8,
+              "scaleUnitType": "HyperConverged",
+              "logicalFaultDomain": 0,
+              "nodes": [
+                "/subscriptions/23a94a7f-64b3-42d8-807c-733284339015/resourceGroups/system.local/providers/Microsoft.Fabric.Admin/fabricLocations/local/scaleUnitNodes/HC1u15a2437"
+              ],
+              "state": "Running",
+              "totalCapacity": {
+                "memoryGB": 511.8877,
+                "cores": 32
+              },
+              "isMultiNode": false
+            }
+          }
+        ]
+      }
+    },
+    "404": {}
+  }
+}
diff --git a/specification/azsadmin/resource-manager/fabric/Microsoft.Fabric.Admin/preview/2020-10-01/examples/ScaleUnit/ScaleOut.json b/specification/azsadmin/resource-manager/fabric/Microsoft.Fabric.Admin/preview/2020-10-01/examples/ScaleUnit/ScaleOut.json
new file mode 100644
index 000000000000..f422cfcb0a53
--- /dev/null
+++ b/specification/azsadmin/resource-manager/fabric/Microsoft.Fabric.Admin/preview/2020-10-01/examples/ScaleUnit/ScaleOut.json
@@ -0,0 +1,21 @@
+{
+  "parameters": {
+    "api-version": "2020-10-01",
+    "subscriptionId": "20ff7fc3-e762-44dd-bd96-b71116dcdc23",
+    "resourceGroupName": "System.local",
+    "location": "local",
+    "scaleUnit": "S-Cluster",
+    "scaleUnitNodeParameters": {
+      "nodeList": [
+        {
+          "bmcIpv4Address": "192.0.0.1",
+          "computerName": "N1S2"
+        }
+      ]
+    }
+  },
+  "responses": {
+    "200": {},
+    "202": {}
+  }
+}
diff --git a/specification/azsadmin/resource-manager/fabric/Microsoft.Fabric.Admin/preview/2020-10-01/examples/ScaleUnit/SetGpuPartitionSize.json b/specification/azsadmin/resource-manager/fabric/Microsoft.Fabric.Admin/preview/2020-10-01/examples/ScaleUnit/SetGpuPartitionSize.json
new file mode 100644
index 000000000000..c4d5ca48f9c2
--- /dev/null
+++ b/specification/azsadmin/resource-manager/fabric/Microsoft.Fabric.Admin/preview/2020-10-01/examples/ScaleUnit/SetGpuPartitionSize.json
@@ -0,0 +1,16 @@
+{
+  "parameters": {
+    "api-version": "2020-10-01",
+    "subscriptionId": "20ff7fc3-e762-44dd-bd96-b71116dcdc23",
+    "resourceGroupName": "System.local",
+    "location": "local",
+    "scaleUnit": "S-Cluster",
+    "gpuPartitionSizeParameters": {
+      "gpuPartitionSize": 4
+    }
+  },
+  "responses": {
+    "200": {},
+    "202": {}
+  }
+}
diff --git a/specification/azsadmin/resource-manager/fabric/Microsoft.Fabric.Admin/preview/2020-10-01/examples/ScaleUnitNode/Get.json b/specification/azsadmin/resource-manager/fabric/Microsoft.Fabric.Admin/preview/2020-10-01/examples/ScaleUnitNode/Get.json
new file mode 100644
index 000000000000..6dc22b8439e4
--- /dev/null
+++ b/specification/azsadmin/resource-manager/fabric/Microsoft.Fabric.Admin/preview/2020-10-01/examples/ScaleUnitNode/Get.json
@@ -0,0 +1,42 @@
+{
+  "parameters": {
+    "api-version": "2020-10-01",
+    "subscriptionId": "20ff7fc3-e762-44dd-bd96-b71116dcdc23",
+    "resourceGroupName": "System.local",
+    "location": "local",
+    "scaleUnitNode": "N1S2"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/System.local/providers/Microsoft.Fabric.Admin/fabricLocations/local/scaleUnitNodes/N1S2",
+        "name": "N1S2",
+        "type": "Microsoft.Fabric.Admin/fabricLocations/scaleUnitNodes",
+        "location": "local",
+        "tags": {},
+        "properties": {
+          "scaleUnitNodeStatus": "Running",
+          "powerState": "Running",
+          "scaleUnitName": "S-Cluster",
+          "scaleUnitUri": "/fabricLocations/local/scaleUnits/S-Cluster",
+          "canPowerOff": false,
+          "capacity": {
+            "memoryGB": 255.875,
+            "cores": 56
+          },
+          "gpus": [
+            {
+              "slotLocation": "PCI bus 59, device 0, function 0, UINumber 1",
+              "oem": "Nvidia",
+              "name": "Nvidia Tesla P40",
+              "type": "DDA",
+              "partitionSize": 8,
+              "hostDriverVersion": "12.34.5698.90"
+            }
+          ]
+        }
+      }
+    },
+    "404": {}
+  }
+}
diff --git a/specification/azsadmin/resource-manager/fabric/Microsoft.Fabric.Admin/preview/2020-10-01/examples/ScaleUnitNode/List.json b/specification/azsadmin/resource-manager/fabric/Microsoft.Fabric.Admin/preview/2020-10-01/examples/ScaleUnitNode/List.json
new file mode 100644
index 000000000000..2e5480c3c458
--- /dev/null
+++ b/specification/azsadmin/resource-manager/fabric/Microsoft.Fabric.Admin/preview/2020-10-01/examples/ScaleUnitNode/List.json
@@ -0,0 +1,45 @@
+{
+  "parameters": {
+    "api-version": "2020-10-01",
+    "subscriptionId": "20ff7fc3-e762-44dd-bd96-b71116dcdc23",
+    "resourceGroupName": "System.local",
+    "location": "local"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/System.local/providers/Microsoft.Fabric.Admin/fabricLocations/local/scaleUnitNodes/N1S2",
+            "name": "N1S2",
+            "type": "Microsoft.Fabric.Admin/fabricLocations/scaleUnitNodes",
+            "location": "local",
+            "tags": {},
+            "properties": {
+              "scaleUnitNodeStatus": "Running",
+              "powerState": "Running",
+              "scaleUnitName": "S-Cluster",
+              "scaleUnitUri": "/fabricLocations/local/scaleUnits/S-Cluster",
+              "canPowerOff": false,
+              "capacity": {
+                "memoryGB": 255.875,
+                "cores": 56
+              },
+              "gpus": [
+                {
+                  "slotLocation": "PCI bus 59, device 0, function 0, UINumber 1",
+                  "oem": "Nvidia",
+                  "name": "Nvidia Tesla P40",
+                  "type": "DDA",
+                  "partitionSize": 8,
+                  "hostDriverVersion": "12.34.5698.90"
+                }
+              ]
+            }
+          }
+        ]
+      }
+    },
+    "404": {}
+  }
+}
diff --git a/specification/azsadmin/resource-manager/fabric/Microsoft.Fabric.Admin/preview/2020-10-01/examples/ScaleUnitNode/PowerOff.json b/specification/azsadmin/resource-manager/fabric/Microsoft.Fabric.Admin/preview/2020-10-01/examples/ScaleUnitNode/PowerOff.json
new file mode 100644
index 000000000000..c729fdcfc69e
--- /dev/null
+++ b/specification/azsadmin/resource-manager/fabric/Microsoft.Fabric.Admin/preview/2020-10-01/examples/ScaleUnitNode/PowerOff.json
@@ -0,0 +1,13 @@
+{
+  "parameters": {
+    "api-version": "2020-10-01",
+    "subscriptionId": "20ff7fc3-e762-44dd-bd96-b71116dcdc23",
+    "resourceGroupName": "System.local",
+    "location": "local",
+    "scaleUnitNode": "N1S2"
+  },
+  "responses": {
+    "200": {},
+    "202": {}
+  }
+}
diff --git a/specification/azsadmin/resource-manager/fabric/Microsoft.Fabric.Admin/preview/2020-10-01/examples/ScaleUnitNode/PowerOn.json b/specification/azsadmin/resource-manager/fabric/Microsoft.Fabric.Admin/preview/2020-10-01/examples/ScaleUnitNode/PowerOn.json
new file mode 100644
index 000000000000..c729fdcfc69e
--- /dev/null
+++ b/specification/azsadmin/resource-manager/fabric/Microsoft.Fabric.Admin/preview/2020-10-01/examples/ScaleUnitNode/PowerOn.json
@@ -0,0 +1,13 @@
+{
+  "parameters": {
+    "api-version": "2020-10-01",
+    "subscriptionId": "20ff7fc3-e762-44dd-bd96-b71116dcdc23",
+    "resourceGroupName": "System.local",
+    "location": "local",
+    "scaleUnitNode": "N1S2"
+  },
+  "responses": {
+    "200": {},
+    "202": {}
+  }
+}
diff --git a/specification/azsadmin/resource-manager/fabric/Microsoft.Fabric.Admin/preview/2020-10-01/examples/ScaleUnitNode/Repair.json b/specification/azsadmin/resource-manager/fabric/Microsoft.Fabric.Admin/preview/2020-10-01/examples/ScaleUnitNode/Repair.json
new file mode 100644
index 000000000000..bd3d5e31bbb5
--- /dev/null
+++ b/specification/azsadmin/resource-manager/fabric/Microsoft.Fabric.Admin/preview/2020-10-01/examples/ScaleUnitNode/Repair.json
@@ -0,0 +1,23 @@
+{
+  "parameters": {
+    "api-version": "2020-10-01",
+    "subscriptionId": "20ff7fc3-e762-44dd-bd96-b71116dcdc23",
+    "resourceGroupName": "System.local",
+    "location": "local",
+    "scaleUnitNode": "N1S2",
+    "bareMetalNode": {
+      "bmcIpv4Address": "192.168.1.1",
+      "vendor": "Commodore",
+      "model": "64",
+      "serialNumber": "123456789",
+      "biosVersion": "0.0.1",
+      "computerName": "Gibson",
+      "clusterName": "T-Cluster",
+      "macAddress": "00-14-22-01-23-45"
+    }
+  },
+  "responses": {
+    "200": {},
+    "202": {}
+  }
+}
diff --git a/specification/azsadmin/resource-manager/fabric/Microsoft.Fabric.Admin/preview/2020-10-01/examples/ScaleUnitNode/Shutdown.json b/specification/azsadmin/resource-manager/fabric/Microsoft.Fabric.Admin/preview/2020-10-01/examples/ScaleUnitNode/Shutdown.json
new file mode 100644
index 000000000000..c729fdcfc69e
--- /dev/null
+++ b/specification/azsadmin/resource-manager/fabric/Microsoft.Fabric.Admin/preview/2020-10-01/examples/ScaleUnitNode/Shutdown.json
@@ -0,0 +1,13 @@
+{
+  "parameters": {
+    "api-version": "2020-10-01",
+    "subscriptionId": "20ff7fc3-e762-44dd-bd96-b71116dcdc23",
+    "resourceGroupName": "System.local",
+    "location": "local",
+    "scaleUnitNode": "N1S2"
+  },
+  "responses": {
+    "200": {},
+    "202": {}
+  }
+}
diff --git a/specification/azsadmin/resource-manager/fabric/Microsoft.Fabric.Admin/preview/2020-10-01/examples/ScaleUnitNode/StartMaintenanceMode.json b/specification/azsadmin/resource-manager/fabric/Microsoft.Fabric.Admin/preview/2020-10-01/examples/ScaleUnitNode/StartMaintenanceMode.json
new file mode 100644
index 000000000000..c729fdcfc69e
--- /dev/null
+++ b/specification/azsadmin/resource-manager/fabric/Microsoft.Fabric.Admin/preview/2020-10-01/examples/ScaleUnitNode/StartMaintenanceMode.json
@@ -0,0 +1,13 @@
+{
+  "parameters": {
+    "api-version": "2020-10-01",
+    "subscriptionId": "20ff7fc3-e762-44dd-bd96-b71116dcdc23",
+    "resourceGroupName": "System.local",
+    "location": "local",
+    "scaleUnitNode": "N1S2"
+  },
+  "responses": {
+    "200": {},
+    "202": {}
+  }
+}
diff --git a/specification/azsadmin/resource-manager/fabric/Microsoft.Fabric.Admin/preview/2020-10-01/examples/ScaleUnitNode/StopMaintenanceMode.json b/specification/azsadmin/resource-manager/fabric/Microsoft.Fabric.Admin/preview/2020-10-01/examples/ScaleUnitNode/StopMaintenanceMode.json
new file mode 100644
index 000000000000..c729fdcfc69e
--- /dev/null
+++ b/specification/azsadmin/resource-manager/fabric/Microsoft.Fabric.Admin/preview/2020-10-01/examples/ScaleUnitNode/StopMaintenanceMode.json
@@ -0,0 +1,13 @@
+{
+  "parameters": {
+    "api-version": "2020-10-01",
+    "subscriptionId": "20ff7fc3-e762-44dd-bd96-b71116dcdc23",
+    "resourceGroupName": "System.local",
+    "location": "local",
+    "scaleUnitNode": "N1S2"
+  },
+  "responses": {
+    "200": {},
+    "202": {}
+  }
+}
diff --git a/specification/azsadmin/resource-manager/fabric/readme.azsautogen.md b/specification/azsadmin/resource-manager/fabric/readme.azsautogen.md
index 351a32ded328..1f4ce0188bd8 100644
--- a/specification/azsadmin/resource-manager/fabric/readme.azsautogen.md
+++ b/specification/azsadmin/resource-manager/fabric/readme.azsautogen.md
@@ -51,6 +51,8 @@ input-file:
   - $(this-folder)/Microsoft.Fabric.Admin/preview/2019-05-01/Drive.json
   - $(this-folder)/Microsoft.Fabric.Admin/preview/2019-05-01/Volume.json
   - $(this-folder)/Microsoft.Fabric.Admin/preview/2019-05-01/NasCluster.json"
+  - $(this-folder)/Microsoft.Fabric.Admin/preview/2020-10-01/ScaleUnit.json"
+  - $(this-folder)/Microsoft.Fabric.Admin/preview/2020-10-01/ScaleUnitNode.json"
 ```
 
 ---
diff --git a/specification/azsadmin/resource-manager/fabric/readme.md b/specification/azsadmin/resource-manager/fabric/readme.md
index 742e9b9ab447..238e9584cb6d 100644
--- a/specification/azsadmin/resource-manager/fabric/readme.md
+++ b/specification/azsadmin/resource-manager/fabric/readme.md
@@ -107,14 +107,14 @@ input-file:
     - "Microsoft.Fabric.Admin/preview/2016-05-01/LogicalSubnet.json"
     - "Microsoft.Fabric.Admin/preview/2016-05-01/MacAddressPool.json"
     - "Microsoft.Fabric.Admin/preview/2016-05-01/NetworkOperationResults.json"
-    - "Microsoft.Fabric.Admin/preview/2016-05-01/ScaleUnit.json"
-    - "Microsoft.Fabric.Admin/preview/2016-05-01/ScaleUnitNode.json"
     - "Microsoft.Fabric.Admin/preview/2016-05-01/SlbMuxInstance.json"
     - "Microsoft.Fabric.Admin/preview/2016-05-01/StorageOperationResults.json"
     - "Microsoft.Fabric.Admin/preview/2018-10-01/StorageSubSystem.json"
     - "Microsoft.Fabric.Admin/preview/2019-05-01/Drive.json"
     - "Microsoft.Fabric.Admin/preview/2019-05-01/Volume.json"
     - "Microsoft.Fabric.Admin/preview/2019-05-01/NasCluster.json"
+    - "Microsoft.Fabric.Admin/preview/2020-10-01/ScaleUnit.json"
+    - "Microsoft.Fabric.Admin/preview/2020-10-01/ScaleUnitNode.json"
 ```
 
 ## Suppression
@@ -187,6 +187,8 @@ input-file:
   - $(this-folder)/Microsoft.Fabric.Admin/preview/2019-05-01/Drive.json
   - $(this-folder)/Microsoft.Fabric.Admin/preview/2019-05-01/Volume.json
   - $(this-folder)/Microsoft.Fabric.Admin/preview/2019-05-01/NasCluster.json
+  - $(this-folder)/Microsoft.Fabric.Admin/preview/2020-10-01/ScaleUnit.json
+  - $(this-folder)/Microsoft.Fabric.Admin/preview/2020-10-01/ScaleUnitNode.json
 
 ```
 
diff --git a/specification/azure-kusto/resource-manager/readme.java.md b/specification/azure-kusto/resource-manager/readme.java.md
index aad8458d0f18..5e32600d1a18 100644
--- a/specification/azure-kusto/resource-manager/readme.java.md
+++ b/specification/azure-kusto/resource-manager/readme.java.md
@@ -18,7 +18,8 @@ output-folder: $(azure-libraries-for-java-folder)/azure-mgmt-kusto
 batch:
   - tag: package-2019-11-09
   - tag: package-2020-02-15
-  - tag: package-2020-06-14  
+  - tag: package-2020-06-14
+  - tag: package-2020-09
 ```
 
 ### Tag: package-2018-09-07-preview and java
@@ -110,4 +111,17 @@ java:
   output-folder: $(azure-libraries-for-java-folder)/sdk/kusto/mgmt-v2020_06_14
 regenerate-manager: true
 generate-interface: true
+```
+
+### Tag: package-2020-09 and java
+
+These settings apply only when `--tag=package-2020-09 --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-09' && $(java) && $(multiapi)
+java:
+  namespace: com.microsoft.azure.management.kusto.v2020_09_18
+  output-folder: $(azure-libraries-for-java-folder)/sdk/kusto/mgmt-v2020_09_18
+regenerate-manager: true
+generate-interface: true
 ```
\ No newline at end of file
diff --git a/specification/batch/resource-manager/readme.python.md b/specification/batch/resource-manager/readme.python.md
index ead11e9bc5c6..66e1624afbd8 100644
--- a/specification/batch/resource-manager/readme.python.md
+++ b/specification/batch/resource-manager/readme.python.md
@@ -4,7 +4,7 @@ These settings apply only when `--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>`.
 Use `--python-mode=update` if you already have a setup.py and just want to update the code itself.
 
-``` yaml $(python)
+``` yaml $(python) && !$(track2)
 python-mode: create
 python:
   azure-arm: true
@@ -15,13 +15,27 @@ python:
   clear-output-folder: true
 ```
 
+``` yaml $(python) && $(track2)
+python-mode: create
+azure-arm: true
+license-header: MICROSOFT_MIT_NO_VERSION
+namespace: azure.mgmt.batch
+package-name: azure-mgmt-batch
+package-version: 14.0.0b1
+clear-output-folder: true
+```
+
 ``` yaml $(python) && $(python-mode) == 'update'
+no-namespace-folders: true
+output-folder: $(python-sdks-folder)/batch/azure-mgmt-batch/azure/mgmt/batch
 python:
   no-namespace-folders: true
   output-folder: $(python-sdks-folder)/batch/azure-mgmt-batch/azure/mgmt/batch
 ```
 
 ``` yaml $(python) && $(python-mode) == 'create'
+basic-setup-py: true
+output-folder: $(python-sdks-folder)/batch/azure-mgmt-batch
 python:
   basic-setup-py: true
   output-folder: $(python-sdks-folder)/batch/azure-mgmt-batch
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 6fe672df65ab..f9c58116ddc2 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
@@ -766,7 +766,7 @@
           "Customers"
         ],
         "x-ms-examples": {
-          "CustomersListByBillingAccount": {
+          "CustomersListByBillingProfile": {
             "$ref": "./examples/CustomersListByBillingProfile.json"
           }
         },
diff --git a/specification/billing/resource-manager/Microsoft.Billing/stable/2020-05-01/billing.json b/specification/billing/resource-manager/Microsoft.Billing/stable/2020-05-01/billing.json
index 7c1b3e583561..ede1bac4407f 100644
--- a/specification/billing/resource-manager/Microsoft.Billing/stable/2020-05-01/billing.json
+++ b/specification/billing/resource-manager/Microsoft.Billing/stable/2020-05-01/billing.json
@@ -607,7 +607,7 @@
           "Customers"
         ],
         "x-ms-examples": {
-          "CustomersListByBillingAccount": {
+          "CustomersListByBillingProfile": {
             "$ref": "./examples/CustomersListByBillingProfile.json"
           }
         },
diff --git a/specification/billing/resource-manager/readme.az.md b/specification/billing/resource-manager/readme.az.md
new file mode 100644
index 000000000000..824434fa5ef5
--- /dev/null
+++ b/specification/billing/resource-manager/readme.az.md
@@ -0,0 +1,208 @@
+## AZ
+These settings apply only when `--az` is specified on the command line.
+``` yaml $(az) && $(target-mode) != 'core'
+az:
+  extensions: billing
+  namespace: azure.mgmt.billing
+  package-name: azure-mgmt-billing
+az-output-folder: $(azure-cli-extension-folder)/src/billing
+python-sdk-output-folder: "$(az-output-folder)/azext_billing/vendored_sdks/billing"
+#cli:
+#    cli-directive:
+#      - where:
+#            group: MachineLearningCompute
+#            op: CreateOrUpdate
+#            param: properties
+#        poly-resource: true
+```
+``` yaml $(az) && $(target-mode) == 'core'
+az:
+  extensions: billing
+  namespace: azure.mgmt.billing
+  package-name: azure-mgmt-billing
+az-output-folder: $(azure-cli-folder)/src/azure-cli/azure/cli/command_modules/billing
+python-sdk-output-folder: "$(az-output-folder)/vendored_sdks/billing"
+```
+
+# Az.Billing
+This directory contains the Cli common model for the Billing service.
+
+> Metadata
+``` yaml
+# Migrated from Powershell's readme
+
+extension-mode: stable
+
+directive:
+  - where:
+      group: billing invoice-section
+    set:
+      group: billing invoice section
+
+cli:
+    cli-directive:
+# -------- DO NOT generate those command groups --------
+      - select: 'operationGroup'
+        where:
+          operationGroup: BillingPeriods|EnrollmentAccounts|Agreements|BillingPermissions|BillingRoleAssignments|BillingRoleDefinitions|Instructions|Address.*$
+        hidden: true
+
+      # rename --billing-profile-name to --profile-name
+      - where:
+          param: billingProfileName
+        name: profile_name
+
+ # -------- BillingAccounts --------
+      # rename --billing-account-name to --account-name globally
+      - where:
+          param: billingAccountName
+        name: account_name
+      # shorten the name in billing account command group
+      - where:
+          group: billingAccounts
+          param: billingAccountName
+        alias:
+          - name
+          - n
+      - where:
+          operationGroup: billingAccounts
+        set:
+          groupExtensionMode: preview
+      - where:
+          operationGroup: BillingAccounts
+        name: account
+      # Shouldn't appear in accounts command group, the responses is not related to BollingAccount
+      - where:
+          group: BillingAccounts
+          op: ListInvoiceSectionsByCreateSubscriptionPermission
+        hidden: true
+
+# -------- BillingProfile --------
+      - where:
+          operationGroup: BillingProfiles
+        set:
+          groupExtensionMode: preview
+      - where:
+          operationGroup: BillingProfiles
+        name: profile
+      - where:
+          group: billingProfiles
+          param: billingProfileName
+        alias:
+          - name
+          - n
+      - select: 'property'
+        where:
+            objectSchema: 'billingProfileCreationRequest'
+            property: 'poNumber'
+        set:
+            name: 'purchase_order_number'
+
+# -------- Balance --------
+      - where:
+            group: 'availableBalances'
+        set:
+            name: 'balance'
+      - where:
+          group: availableBalances
+        set:
+          groupExtensionMode: preview
+
+# -------- Customer --------
+      - where:
+          group: Customers
+        set:
+          groupExtensionMode: preview
+
+# -------- Invoice --------
+      # customize for download command by manual for ungraceful implmentation by default
+      - where:
+          group: Invoices
+          op: DownloadInvoice
+        hidden: true
+      - where:
+          group: Invoices
+          op: DownloadMultipleBillingProfileInvoices
+        hidden: true
+      - where:
+          group: Invoices
+          op: DownloadBillingSubscriptionInvoice
+        hidden: true
+      - where:
+          group: Invoices
+          op: DownloadMultipleBillingSubscriptionInvoices
+        hidden: true
+      # customize for series of get commands by manual for ungraceful implmentation by default
+      - where:
+          group: Invoices
+          op: GetById
+        hidden: true
+      - where:
+          group: Invoices
+          op: GetBySubscriptionAndInvoiceId
+        hidden: true
+      - where:
+          group: Invoices
+          param: invoiceName
+        name: name
+        alias:  # --invoice-name is unnecessary under "billing invoice" command group
+          - name
+          - n
+
+# -------- InvoiceSection --------
+      - where:
+          group: InvoiceSections
+        set:
+          groupExtensionMode: preview # bug, won't take effect
+
+# -------- Policy -------
+      - where:
+          group: Policies
+        set:
+          groupExtensionMode: preview
+      # GetByBillingProfile and GetByCustomer will be implemented in manually customized show command
+      - where:
+          group: Policies
+          op: GetByBillingProfile
+        hidden: true
+      - where:
+          group: Policies
+          op: GetByCustomer
+        hidden: true
+      - where:
+          group: Policies
+          op: UpdateCustomer
+        hidden: true
+
+# ------ Product ------
+      - where:
+          group: Products
+        set:
+          groupExtensionMode: preview
+
+# ------ Subscription ------
+      - where:
+          group: BillingSubscriptions
+        set:
+          name: subscription
+          groupExtensionMode: preview
+
+# ------ Property ------
+      - where:
+          group: BillingProperty
+        set:
+          name: property
+          groupExtensionMode: preview
+      - select: 'property'
+        where:
+            objectSchema: 'BillingProfileProperties'
+            property: 'poNumber'
+        set:
+            name: 'purchase_order_number'
+
+# ------ Transaction ------
+      - where:
+          group: Transactions
+        set:
+          groupExtensionMode: preview
+```
diff --git a/specification/billing/resource-manager/readme.cli.md b/specification/billing/resource-manager/readme.cli.md
index c13b35b5db95..0016d91bd5e7 100644
--- a/specification/billing/resource-manager/readme.cli.md
+++ b/specification/billing/resource-manager/readme.cli.md
@@ -1,33 +1,9 @@
 <!-- region Generated -->
-# Az.Aks
-This directory contains the Cli common model for the Aks service.
+# Az.Billing
+This directory contains the Cli common model for the Billing service.
 
 > Metadata
 ``` yaml
 # Migrated from Powershell's readme
-title: Billing
 
-cli:
-    cli-directive:
-      - select: 'property'
-        where:
-            objectSchema: 'billingProfileCreationRequest'
-            property: 'poNumber'
-        set:
-            name: 'purchase_order_number'
-      - select: 'operationGroup'
-        where: 
-            operationGroup: 'availableBalances'
-        set:
-            name: 'available_credit_balance'
-      - select: 'property'
-        where:
-            objectSchema: 'BillingProfileProperties'
-            property: 'poNumber'
-        set:
-            name: 'purchase_order_number'
-      - select: 'operationGroup'
-        where:
-          operationGroup: ^(?!^billingPeriod$)(?!^budget$)(?!^enrollmentAccounts$)(?!^invoices$)(?!^marketplace$)(?!^priceSheet$)(?!^reservationDetail$)(?!^reservationSummary$)(?!^usageAggregate$)(?!^usageDetail$).*$
-        hidden: true
 ```
diff --git a/specification/billing/resource-manager/readme.md b/specification/billing/resource-manager/readme.md
index 133322e3dbd8..54b10224deae 100644
--- a/specification/billing/resource-manager/readme.md
+++ b/specification/billing/resource-manager/readme.md
@@ -102,6 +102,7 @@ swagger-to-sdk:
   - repo: azure-sdk-for-js
   - repo: azure-sdk-for-node
   - repo: azure-sdk-for-ruby
+  - repo: azure-cli-extensions
     after_scripts:
       - bundle install && rake arm:regen_all_profiles['azure_mgmt_billing']
   - repo: azure-resource-manager-schemas
@@ -237,4 +238,3 @@ generate-interface: true
 ## AzureResourceSchema
 
 See configuration in [readme.azureresourceschema.md](./readme.azureresourceschema.md)
-
diff --git a/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/Training.json b/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/Training.json
new file mode 100644
index 000000000000..a7e681725a7d
--- /dev/null
+++ b/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/Training.json
@@ -0,0 +1,5759 @@
+{
+  "swagger": "2.0",
+  "info": {
+    "version": "3.4-preview",
+    "title": "Custom Vision Training Client"
+  },
+  "host": "southcentralus.api.cognitive.microsoft.com",
+  "basePath": "/customvision/v3.4-preview/training",
+  "schemes": [
+    "https"
+  ],
+  "paths": {
+    "/domains": {
+      "get": {
+        "tags": [
+          "DomainsApi"
+        ],
+        "summary": "Get a list of the available domains.",
+        "operationId": "GetDomains",
+        "consumes": [],
+        "produces": [
+          "application/json",
+          "application/xml",
+          "text/xml"
+        ],
+        "parameters": [],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "type": "array",
+              "items": {
+                "$ref": "#/definitions/Domain"
+              }
+            }
+          },
+          "default": {
+            "description": "Error response",
+            "schema": {
+              "$ref": "#/definitions/CustomVisionError"
+            }
+          }
+        },
+        "x-ms-examples": {
+          "Successful GetDomains request": {
+            "$ref": "./examples/GetDomains.json"
+          }
+        }
+      }
+    },
+    "/domains/{domainId}": {
+      "get": {
+        "tags": [
+          "DomainsApi"
+        ],
+        "summary": "Get information about a specific domain.",
+        "operationId": "GetDomain",
+        "consumes": [],
+        "produces": [
+          "application/json",
+          "application/xml",
+          "text/xml"
+        ],
+        "parameters": [
+          {
+            "name": "domainId",
+            "in": "path",
+            "description": "The id of the domain to get information about.",
+            "required": true,
+            "type": "string",
+            "format": "uuid",
+            "x-nullable": false
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/Domain"
+            }
+          },
+          "default": {
+            "description": "Error response",
+            "schema": {
+              "$ref": "#/definitions/CustomVisionError"
+            }
+          }
+        },
+        "x-ms-examples": {
+          "Successful GetDomain request": {
+            "$ref": "./examples/GetDomain.json"
+          }
+        }
+      }
+    },
+    "/projects": {
+      "get": {
+        "tags": [
+          "ProjectApi"
+        ],
+        "summary": "Get your projects.",
+        "operationId": "GetProjects",
+        "consumes": [],
+        "produces": [
+          "application/json",
+          "application/xml",
+          "text/xml"
+        ],
+        "parameters": [],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "type": "array",
+              "items": {
+                "$ref": "#/definitions/Project"
+              }
+            }
+          },
+          "default": {
+            "description": "Error response",
+            "schema": {
+              "$ref": "#/definitions/CustomVisionError"
+            }
+          }
+        },
+        "x-ms-examples": {
+          "Successful GetProjects request": {
+            "$ref": "./examples/GetProjects.json"
+          }
+        }
+      },
+      "post": {
+        "tags": [
+          "ProjectApi"
+        ],
+        "summary": "Create a project.",
+        "operationId": "CreateProject",
+        "consumes": [
+          "application/json",
+          "application/xml",
+          "text/xml",
+          "application/x-www-form-urlencoded"
+        ],
+        "produces": [
+          "application/json",
+          "application/xml",
+          "text/xml"
+        ],
+        "parameters": [
+          {
+            "name": "name",
+            "in": "query",
+            "description": "Name of the project.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "description",
+            "in": "query",
+            "description": "The description of the project.",
+            "required": false,
+            "type": "string"
+          },
+          {
+            "name": "domainId",
+            "in": "query",
+            "description": "The id of the domain to use for this project. Defaults to General.",
+            "required": false,
+            "type": "string",
+            "format": "uuid"
+          },
+          {
+            "name": "classificationType",
+            "in": "query",
+            "description": "The type of classifier to create for this project.",
+            "required": false,
+            "type": "string",
+            "enum": [
+              "Multiclass",
+              "Multilabel"
+            ]
+          },
+          {
+            "name": "targetExportPlatforms",
+            "in": "query",
+            "description": "List of platforms the trained model is intending exporting to.",
+            "required": false,
+            "type": "array",
+            "items": {
+              "type": "string",
+              "enum": [
+                "CoreML",
+                "TensorFlow",
+                "DockerFile",
+                "ONNX",
+                "VAIDK",
+                "OpenVino"
+              ]
+            },
+            "collectionFormat": "csv"
+          },
+          {
+            "name": "options",
+            "in": "body",
+            "description": "Additional project creation options.",
+            "required": false,
+            "schema": {
+              "$ref": "#/definitions/CreateProjectOptions"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/Project"
+            }
+          },
+          "default": {
+            "description": "Error response",
+            "schema": {
+              "$ref": "#/definitions/CustomVisionError"
+            }
+          }
+        },
+        "x-ms-examples": {
+          "Successful CreateProject request": {
+            "$ref": "./examples/CreateProject.json"
+          }
+        }
+      }
+    },
+    "/projects/{projectId}": {
+      "get": {
+        "tags": [
+          "ProjectApi"
+        ],
+        "summary": "Get a specific project.",
+        "operationId": "GetProject",
+        "consumes": [],
+        "produces": [
+          "application/json",
+          "application/xml",
+          "text/xml"
+        ],
+        "parameters": [
+          {
+            "name": "projectId",
+            "in": "path",
+            "description": "The id of the project to get.",
+            "required": true,
+            "type": "string",
+            "format": "uuid",
+            "x-nullable": false
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/Project"
+            }
+          },
+          "default": {
+            "description": "Error response",
+            "schema": {
+              "$ref": "#/definitions/CustomVisionError"
+            }
+          }
+        },
+        "x-ms-examples": {
+          "Successful GetProject request": {
+            "$ref": "./examples/GetProject.json"
+          }
+        }
+      },
+      "delete": {
+        "tags": [
+          "ProjectApi"
+        ],
+        "summary": "Delete a specific project.",
+        "operationId": "DeleteProject",
+        "consumes": [],
+        "produces": [],
+        "parameters": [
+          {
+            "name": "projectId",
+            "in": "path",
+            "description": "The project id.",
+            "required": true,
+            "type": "string",
+            "format": "uuid",
+            "x-nullable": false
+          }
+        ],
+        "responses": {
+          "204": {
+            "description": "No Content"
+          },
+          "default": {
+            "description": "Error response",
+            "schema": {
+              "$ref": "#/definitions/CustomVisionError"
+            }
+          }
+        },
+        "x-ms-examples": {
+          "Successful DeleteProject request": {
+            "$ref": "./examples/DeleteProject.json"
+          }
+        }
+      },
+      "patch": {
+        "tags": [
+          "ProjectApi"
+        ],
+        "summary": "Update a specific project.",
+        "operationId": "UpdateProject",
+        "consumes": [
+          "application/json",
+          "application/xml",
+          "text/xml",
+          "application/x-www-form-urlencoded"
+        ],
+        "produces": [
+          "application/json",
+          "application/xml",
+          "text/xml"
+        ],
+        "parameters": [
+          {
+            "name": "projectId",
+            "in": "path",
+            "description": "The id of the project to update.",
+            "required": true,
+            "type": "string",
+            "format": "uuid",
+            "x-nullable": false
+          },
+          {
+            "name": "updatedProject",
+            "in": "body",
+            "description": "The updated project model.",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/Project"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/Project"
+            }
+          },
+          "default": {
+            "description": "Error response",
+            "schema": {
+              "$ref": "#/definitions/CustomVisionError"
+            }
+          }
+        },
+        "x-ms-examples": {
+          "Successful UpdateProject request": {
+            "$ref": "./examples/UpdateProject.json"
+          }
+        }
+      }
+    },
+    "/projects/{projectId}/artifacts": {
+      "get": {
+        "tags": [
+          "ProjectApi"
+        ],
+        "summary": "Get artifact content from blob storage, based on artifact relative path in the blob.",
+        "operationId": "GetArtifact",
+        "consumes": [],
+        "produces": [
+          "application/octet-stream"
+        ],
+        "parameters": [
+          {
+            "name": "projectId",
+            "in": "path",
+            "description": "The project id.",
+            "required": true,
+            "type": "string",
+            "format": "uuid",
+            "x-nullable": false
+          },
+          {
+            "name": "path",
+            "in": "query",
+            "description": "The relative path for artifact.",
+            "required": true,
+            "type": "string"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "type": "file"
+            }
+          },
+          "default": {
+            "description": "Error response",
+            "schema": {
+              "$ref": "#/definitions/CustomVisionError"
+            }
+          }
+        },
+        "x-ms-examples": {
+          "Successful GetArtifact request": {
+            "$ref": "./examples/GetArtifact.json"
+          }
+        }
+      }
+    },
+    "/projects/{projectId}/export": {
+      "get": {
+        "tags": [
+          "ProjectApi"
+        ],
+        "summary": "Exports a project.",
+        "operationId": "ExportProject",
+        "consumes": [],
+        "produces": [
+          "application/json",
+          "application/xml",
+          "text/xml"
+        ],
+        "parameters": [
+          {
+            "name": "projectId",
+            "in": "path",
+            "description": "The project id of the project to export.",
+            "required": true,
+            "type": "string",
+            "format": "uuid",
+            "x-nullable": false
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/ProjectExport"
+            }
+          },
+          "default": {
+            "description": "Error response",
+            "schema": {
+              "$ref": "#/definitions/CustomVisionError"
+            }
+          }
+        },
+        "x-ms-examples": {
+          "Successful ExportProject request": {
+            "$ref": "./examples/ExportProject.json"
+          }
+        }
+      }
+    },
+    "/projects/{projectId}/images": {
+      "get": {
+        "tags": [
+          "ImageApi"
+        ],
+        "summary": "Get images for a given project iteration or workspace.",
+        "description": "This API supports batching and range selection. By default it will only return first 50 images matching images.\r\nUse the {take} and {skip} parameters to control how many images to return in a given batch.\r\nThe filtering is on an and/or relationship. For example, if the provided tag ids are for the \"Dog\" and\r\n\"Cat\" tags, then only images tagged with Dog and/or Cat will be returned",
+        "operationId": "GetImages",
+        "consumes": [],
+        "produces": [
+          "application/json",
+          "application/xml",
+          "text/xml"
+        ],
+        "parameters": [
+          {
+            "name": "projectId",
+            "in": "path",
+            "description": "The project id.",
+            "required": true,
+            "type": "string",
+            "format": "uuid",
+            "x-nullable": false
+          },
+          {
+            "name": "iterationId",
+            "in": "query",
+            "description": "The iteration id. Defaults to workspace.",
+            "required": false,
+            "type": "string",
+            "format": "uuid"
+          },
+          {
+            "name": "tagIds",
+            "in": "query",
+            "description": "A list of tags ids to filter the images. Defaults to all tagged images when null. Limited to 20.",
+            "required": false,
+            "type": "array",
+            "items": {
+              "type": "string",
+              "format": "uuid",
+              "x-nullable": false
+            },
+            "collectionFormat": "csv",
+            "maxItems": 20,
+            "minItems": 0
+          },
+          {
+            "name": "taggingStatus",
+            "in": "query",
+            "description": "The tagging status filter. It can be 'All', 'Tagged', or 'Untagged'. Defaults to 'All'.",
+            "required": false,
+            "type": "string",
+            "enum": [
+              "All",
+              "Tagged",
+              "Untagged"
+            ]
+          },
+          {
+            "name": "$filter",
+            "in": "query",
+            "description": "An expression to filter the images against image metadata. Only images where the expression evaluates to true are included in the response.\r\nThe expression supports eq (Equal), ne (Not equal), and (Logical and), or (Logical or) operators.\r\nHere is an example, metadata=key1 eq 'value1' and key2 ne 'value2'.",
+            "required": false,
+            "type": "string"
+          },
+          {
+            "name": "orderBy",
+            "in": "query",
+            "description": "The ordering. Defaults to newest.",
+            "required": false,
+            "type": "string",
+            "enum": [
+              "Newest",
+              "Oldest"
+            ]
+          },
+          {
+            "name": "take",
+            "in": "query",
+            "description": "Maximum number of images to return. Defaults to 50, limited to 256.",
+            "required": false,
+            "type": "integer",
+            "format": "int32",
+            "default": 50,
+            "maximum": 256,
+            "minimum": 0
+          },
+          {
+            "name": "skip",
+            "in": "query",
+            "description": "Number of images to skip before beginning the image batch. Defaults to 0.",
+            "required": false,
+            "type": "integer",
+            "format": "int32",
+            "default": 0
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "type": "array",
+              "items": {
+                "$ref": "#/definitions/Image"
+              }
+            }
+          },
+          "default": {
+            "description": "Error response",
+            "schema": {
+              "$ref": "#/definitions/CustomVisionError"
+            }
+          }
+        },
+        "x-ms-examples": {
+          "Successful GetImages request": {
+            "$ref": "./examples/GetImages.json"
+          }
+        }
+      },
+      "post": {
+        "tags": [
+          "ImageApi"
+        ],
+        "summary": "Add the provided images to the set of training images.",
+        "description": "This API accepts body content as multipart/form-data and application/octet-stream. When using multipart\r\nmultiple image files can be sent at once, with a maximum of 64 files.\r\nIf all images are successful created, 200(OK) status code will be returned.\r\nOtherwise, 207 (Multi-Status) status code will be returned and detail status for each image will be listed in the response payload.",
+        "operationId": "CreateImagesFromData",
+        "consumes": [
+          "multipart/form-data",
+          "application/octet-stream"
+        ],
+        "produces": [
+          "application/json",
+          "application/xml",
+          "text/xml"
+        ],
+        "parameters": [
+          {
+            "name": "projectId",
+            "in": "path",
+            "description": "The project id.",
+            "required": true,
+            "type": "string",
+            "format": "uuid",
+            "x-nullable": false
+          },
+          {
+            "name": "tagIds",
+            "in": "query",
+            "description": "The tags ids with which to tag each image. Limited to 20.",
+            "required": false,
+            "type": "array",
+            "items": {
+              "type": "string",
+              "format": "uuid",
+              "x-nullable": false
+            },
+            "collectionFormat": "csv",
+            "maxItems": 20,
+            "minItems": 0
+          },
+          {
+            "name": "imageData",
+            "in": "formData",
+            "description": "Binary image data. Supported formats are JPEG, GIF, PNG, and BMP. Supports images up to 6MB.",
+            "required": true,
+            "type": "file"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/ImageCreateSummary"
+            }
+          },
+          "207": {
+            "description": "207",
+            "schema": {
+              "$ref": "#/definitions/ImageCreateSummary"
+            }
+          },
+          "default": {
+            "description": "Error response",
+            "schema": {
+              "$ref": "#/definitions/CustomVisionError"
+            }
+          }
+        },
+        "x-ms-examples": {
+          "Successful CreateImagesFromData request": {
+            "$ref": "./examples/CreateImagesFromData.json"
+          }
+        }
+      },
+      "delete": {
+        "tags": [
+          "ImageApi"
+        ],
+        "summary": "Delete images from the set of training images.",
+        "operationId": "DeleteImages",
+        "consumes": [],
+        "produces": [
+          "application/json",
+          "application/xml",
+          "text/xml"
+        ],
+        "parameters": [
+          {
+            "name": "projectId",
+            "in": "path",
+            "description": "The project id.",
+            "required": true,
+            "type": "string",
+            "format": "uuid",
+            "x-nullable": false
+          },
+          {
+            "name": "imageIds",
+            "in": "query",
+            "description": "Ids of the images to be deleted. Limited to 256 images per batch.",
+            "required": false,
+            "type": "array",
+            "items": {
+              "type": "string",
+              "format": "uuid",
+              "x-nullable": false
+            },
+            "collectionFormat": "csv",
+            "maxItems": 256,
+            "minItems": 0
+          },
+          {
+            "name": "allImages",
+            "in": "query",
+            "description": "Flag to specify delete all images, specify this flag or a list of images. Using this flag will return a 202 response to indicate the images are being deleted.",
+            "required": false,
+            "type": "boolean"
+          },
+          {
+            "name": "allIterations",
+            "in": "query",
+            "description": "Removes these images from all iterations, not just the current workspace. Using this flag will return a 202 response to indicate the images are being deleted.",
+            "required": false,
+            "type": "boolean"
+          }
+        ],
+        "responses": {
+          "202": {
+            "description": "Accepted"
+          },
+          "204": {
+            "description": "No Content"
+          },
+          "default": {
+            "description": "Error response",
+            "schema": {
+              "$ref": "#/definitions/CustomVisionError"
+            }
+          }
+        },
+        "x-ms-examples": {
+          "Successful DeleteImages request": {
+            "$ref": "./examples/DeleteImages.json"
+          }
+        }
+      }
+    },
+    "/projects/{projectId}/images/{imageId}/regionproposals": {
+      "post": {
+        "tags": [
+          "ImageRegionProposalApi"
+        ],
+        "summary": "Get region proposals for an image. Returns empty array if no proposals are found.",
+        "description": "This API will get region proposals for an image along with confidences for the region. It returns an empty array if no proposals are found.",
+        "operationId": "GetImageRegionProposals",
+        "consumes": [],
+        "produces": [
+          "application/json",
+          "application/xml",
+          "text/xml"
+        ],
+        "parameters": [
+          {
+            "name": "projectId",
+            "in": "path",
+            "description": "The project id.",
+            "required": true,
+            "type": "string",
+            "format": "uuid",
+            "x-nullable": false
+          },
+          {
+            "name": "imageId",
+            "in": "path",
+            "description": "The image id.",
+            "required": true,
+            "type": "string",
+            "format": "uuid",
+            "x-nullable": false
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/ImageRegionProposal"
+            }
+          },
+          "default": {
+            "description": "Error response",
+            "schema": {
+              "$ref": "#/definitions/CustomVisionError"
+            }
+          }
+        },
+        "x-ms-examples": {
+          "Successful GetImageRegionProposals request": {
+            "$ref": "./examples/GetImageRegionProposals.json"
+          }
+        }
+      }
+    },
+    "/projects/{projectId}/images/count": {
+      "get": {
+        "tags": [
+          "ImageApi"
+        ],
+        "summary": "Get the number of images.",
+        "description": "The filtering is on an and/or relationship. For example, if the provided tag ids are for the \"Dog\" and\r\n\"Cat\" tags, then only images tagged with Dog and/or Cat will be returned",
+        "operationId": "GetImageCount",
+        "consumes": [],
+        "produces": [
+          "application/json",
+          "application/xml",
+          "text/xml"
+        ],
+        "parameters": [
+          {
+            "name": "projectId",
+            "in": "path",
+            "description": "The project id.",
+            "required": true,
+            "type": "string",
+            "format": "uuid",
+            "x-nullable": false
+          },
+          {
+            "name": "iterationId",
+            "in": "query",
+            "description": "The iteration id. Defaults to workspace.",
+            "required": false,
+            "type": "string",
+            "format": "uuid"
+          },
+          {
+            "name": "taggingStatus",
+            "in": "query",
+            "description": "The tagging status filter. It can be 'All', 'Tagged', or 'Untagged'. Defaults to 'All'.",
+            "required": false,
+            "type": "string",
+            "enum": [
+              "All",
+              "Tagged",
+              "Untagged"
+            ]
+          },
+          {
+            "name": "$filter",
+            "in": "query",
+            "description": "An expression to filter the images against image metadata. Only images where the expression evaluates to true are included in the response.\r\nThe expression supports eq (Equal), ne (Not equal), and (Logical and), or (Logical or) operators.\r\nHere is an example, metadata=key1 eq 'value1' and key2 ne 'value2'.",
+            "required": false,
+            "type": "string"
+          },
+          {
+            "name": "tagIds",
+            "in": "query",
+            "description": "A list of tags ids to filter the images to count. Defaults to all tags when null.",
+            "required": false,
+            "type": "array",
+            "items": {
+              "type": "string",
+              "format": "uuid",
+              "x-nullable": false
+            },
+            "collectionFormat": "csv"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "format": "int32",
+              "type": "integer"
+            }
+          },
+          "default": {
+            "description": "Error response",
+            "schema": {
+              "$ref": "#/definitions/CustomVisionError"
+            }
+          }
+        },
+        "x-ms-examples": {
+          "Successful GetImageCount request": {
+            "$ref": "./examples/GetImageCount.json"
+          }
+        }
+      }
+    },
+    "/projects/{projectId}/images/files": {
+      "post": {
+        "tags": [
+          "ImageApi"
+        ],
+        "summary": "Add the provided batch of images to the set of training images.",
+        "description": "This API accepts a batch of files, and optionally tags, to create images. There is a limit of 64 images and 20 tags.\r\nIf all images are successful created, 200(OK) status code will be returned.\r\nOtherwise, 207 (Multi-Status) status code will be returned and detail status for each image will be listed in the response payload.",
+        "operationId": "CreateImagesFromFiles",
+        "consumes": [
+          "application/json",
+          "application/xml",
+          "text/xml",
+          "application/x-www-form-urlencoded"
+        ],
+        "produces": [
+          "application/json",
+          "application/xml",
+          "text/xml"
+        ],
+        "parameters": [
+          {
+            "name": "projectId",
+            "in": "path",
+            "description": "The project id.",
+            "required": true,
+            "type": "string",
+            "format": "uuid",
+            "x-nullable": false
+          },
+          {
+            "name": "batch",
+            "in": "body",
+            "description": "The batch of image files to add. Limited to 64 images and 20 tags per batch.",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/ImageFileCreateBatch"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/ImageCreateSummary"
+            }
+          },
+          "207": {
+            "description": "207",
+            "schema": {
+              "$ref": "#/definitions/ImageCreateSummary"
+            }
+          },
+          "default": {
+            "description": "Error response",
+            "schema": {
+              "$ref": "#/definitions/CustomVisionError"
+            }
+          }
+        },
+        "x-ms-examples": {
+          "Successful CreateImagesFromFiles request": {
+            "$ref": "./examples/CreateImagesFromFiles.json"
+          }
+        }
+      }
+    },
+    "/projects/{projectId}/images/id": {
+      "get": {
+        "tags": [
+          "ImageApi"
+        ],
+        "summary": "Get images by id for a given project iteration.",
+        "description": "This API will return a set of Images for the specified tags and optionally iteration. If no iteration is specified the\r\ncurrent workspace is used.",
+        "operationId": "GetImagesByIds",
+        "consumes": [],
+        "produces": [
+          "application/json",
+          "application/xml",
+          "text/xml"
+        ],
+        "parameters": [
+          {
+            "name": "projectId",
+            "in": "path",
+            "description": "The project id.",
+            "required": true,
+            "type": "string",
+            "format": "uuid",
+            "x-nullable": false
+          },
+          {
+            "name": "imageIds",
+            "in": "query",
+            "description": "The list of image ids to retrieve. Limited to 256.",
+            "required": false,
+            "type": "array",
+            "items": {
+              "type": "string",
+              "format": "uuid",
+              "x-nullable": false
+            },
+            "collectionFormat": "csv",
+            "maxItems": 256,
+            "minItems": 0
+          },
+          {
+            "name": "iterationId",
+            "in": "query",
+            "description": "The iteration id. Defaults to workspace.",
+            "required": false,
+            "type": "string",
+            "format": "uuid"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "type": "array",
+              "items": {
+                "$ref": "#/definitions/Image"
+              }
+            }
+          },
+          "default": {
+            "description": "Error response",
+            "schema": {
+              "$ref": "#/definitions/CustomVisionError"
+            }
+          }
+        },
+        "x-ms-examples": {
+          "Successful GetImagesByIds request": {
+            "$ref": "./examples/GetImagesByIds.json"
+          }
+        }
+      }
+    },
+    "/projects/{projectId}/images/metadata": {
+      "post": {
+        "tags": [
+          "ImageApi"
+        ],
+        "summary": "Update metadata of images.",
+        "description": "This API accepts a batch of image Ids, and metadata, to update images. There is a limit of 64 images.",
+        "operationId": "UpdateImageMetadata",
+        "consumes": [
+          "application/json",
+          "application/xml",
+          "text/xml",
+          "application/x-www-form-urlencoded"
+        ],
+        "produces": [
+          "application/json",
+          "application/xml",
+          "text/xml"
+        ],
+        "parameters": [
+          {
+            "name": "projectId",
+            "in": "path",
+            "description": "The project id.",
+            "required": true,
+            "type": "string",
+            "format": "uuid",
+            "x-nullable": false
+          },
+          {
+            "name": "imageIds",
+            "in": "query",
+            "description": "The list of image ids to update. Limited to 64.",
+            "required": true,
+            "type": "array",
+            "items": {
+              "type": "string",
+              "format": "uuid",
+              "x-nullable": false
+            },
+            "collectionFormat": "csv",
+            "maxItems": 256,
+            "minItems": 0
+          },
+          {
+            "name": "metadata",
+            "in": "body",
+            "description": "The metadata to be updated to the specified images. Limited to 10 key-value pairs per image. The length of key is limited to 128. The length of value is limited to 256.",
+            "required": true,
+            "schema": {
+              "type": "object",
+              "additionalProperties": {
+                "type": "string"
+              }
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/ImageMetadataUpdateSummary"
+            }
+          },
+          "207": {
+            "description": "207",
+            "schema": {
+              "$ref": "#/definitions/ImageMetadataUpdateSummary"
+            }
+          },
+          "default": {
+            "description": "Error response",
+            "schema": {
+              "$ref": "#/definitions/CustomVisionError"
+            }
+          }
+        },
+        "x-ms-examples": {
+          "Successful UpdateImageMetadata request": {
+            "$ref": "./examples/UpdateImageMetadata.json"
+          }
+        }
+      }
+    },
+    "/projects/{projectId}/images/predictions": {
+      "post": {
+        "tags": [
+          "ImageApi"
+        ],
+        "summary": "Add the specified predicted images to the set of training images.",
+        "description": "This API creates a batch of images from predicted images specified. There is a limit of 64 images and 20 tags.\r\nIf all images are successful created, 200(OK) status code will be returned.\r\nOtherwise, 207 (Multi-Status) status code will be returned and detail status for each image will be listed in the response payload.",
+        "operationId": "CreateImagesFromPredictions",
+        "consumes": [
+          "application/json",
+          "application/xml",
+          "text/xml",
+          "application/x-www-form-urlencoded"
+        ],
+        "produces": [
+          "application/json",
+          "application/xml",
+          "text/xml"
+        ],
+        "parameters": [
+          {
+            "name": "projectId",
+            "in": "path",
+            "description": "The project id.",
+            "required": true,
+            "type": "string",
+            "format": "uuid",
+            "x-nullable": false
+          },
+          {
+            "name": "batch",
+            "in": "body",
+            "description": "Image, tag ids, and metadata. Limited to 64 images and 20 tags per batch.",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/ImageIdCreateBatch"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/ImageCreateSummary"
+            }
+          },
+          "207": {
+            "description": "207",
+            "schema": {
+              "$ref": "#/definitions/ImageCreateSummary"
+            }
+          },
+          "default": {
+            "description": "Error response",
+            "schema": {
+              "$ref": "#/definitions/CustomVisionError"
+            }
+          }
+        },
+        "x-ms-examples": {
+          "Successful CreateImagesFromPredictions request": {
+            "$ref": "./examples/CreateImagesFromPredictions.json"
+          }
+        }
+      }
+    },
+    "/projects/{projectId}/images/regions": {
+      "post": {
+        "tags": [
+          "ImageApi"
+        ],
+        "summary": "Create a set of image regions.",
+        "description": "This API accepts a batch of image regions, and optionally tags, to update existing images with region information.\r\nThere is a limit of 64 entries in the batch.\r\nIf all regions are successful created, 200(OK) status code will be returned.\r\nOtherwise, 207 (Multi-Status) status code will be returned and detail status for each region will be listed in the response payload.",
+        "operationId": "CreateImageRegions",
+        "consumes": [
+          "application/json",
+          "application/xml",
+          "text/xml",
+          "application/x-www-form-urlencoded"
+        ],
+        "produces": [
+          "application/json",
+          "application/xml",
+          "text/xml"
+        ],
+        "parameters": [
+          {
+            "name": "projectId",
+            "in": "path",
+            "description": "The project id.",
+            "required": true,
+            "type": "string",
+            "format": "uuid",
+            "x-nullable": false
+          },
+          {
+            "name": "batch",
+            "in": "body",
+            "description": "Batch of image regions which include a tag and bounding box. Limited to 64.",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/ImageRegionCreateBatch"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/ImageRegionCreateSummary"
+            }
+          },
+          "207": {
+            "description": "207",
+            "schema": {
+              "$ref": "#/definitions/ImageRegionCreateSummary"
+            }
+          },
+          "default": {
+            "description": "Error response",
+            "schema": {
+              "$ref": "#/definitions/CustomVisionError"
+            }
+          }
+        },
+        "x-ms-examples": {
+          "Successful CreateImageRegions request": {
+            "$ref": "./examples/CreateImageRegions.json"
+          }
+        }
+      },
+      "delete": {
+        "tags": [
+          "ImageApi"
+        ],
+        "summary": "Delete a set of image regions.",
+        "operationId": "DeleteImageRegions",
+        "consumes": [],
+        "produces": [],
+        "parameters": [
+          {
+            "name": "projectId",
+            "in": "path",
+            "description": "The project id.",
+            "required": true,
+            "type": "string",
+            "format": "uuid",
+            "x-nullable": false
+          },
+          {
+            "name": "regionIds",
+            "in": "query",
+            "description": "Regions to delete. Limited to 64.",
+            "required": true,
+            "type": "array",
+            "items": {
+              "type": "string",
+              "format": "uuid",
+              "x-nullable": false
+            },
+            "collectionFormat": "csv",
+            "maxItems": 64,
+            "minItems": 0
+          }
+        ],
+        "responses": {
+          "204": {
+            "description": "No Content"
+          },
+          "default": {
+            "description": "Error response",
+            "schema": {
+              "$ref": "#/definitions/CustomVisionError"
+            }
+          }
+        },
+        "x-ms-examples": {
+          "Successful DeleteImageRegions request": {
+            "$ref": "./examples/DeleteImageRegions.json"
+          }
+        }
+      }
+    },
+    "/projects/{projectId}/images/suggested": {
+      "post": {
+        "tags": [
+          "ImageApi"
+        ],
+        "summary": "Get untagged images whose suggested tags match given tags. Returns empty array if no images are found.",
+        "description": "This API will fetch untagged images filtered by suggested tags Ids. It returns an empty array if no images are found.",
+        "operationId": "QuerySuggestedImages",
+        "consumes": [
+          "application/json",
+          "application/xml",
+          "text/xml",
+          "application/x-www-form-urlencoded"
+        ],
+        "produces": [
+          "application/json",
+          "application/xml",
+          "text/xml"
+        ],
+        "parameters": [
+          {
+            "name": "projectId",
+            "in": "path",
+            "description": "The project id.",
+            "required": true,
+            "type": "string",
+            "format": "uuid",
+            "x-nullable": false
+          },
+          {
+            "name": "iterationId",
+            "in": "query",
+            "description": "IterationId to use for the suggested tags and regions.",
+            "required": true,
+            "type": "string",
+            "format": "uuid",
+            "x-nullable": false
+          },
+          {
+            "name": "query",
+            "in": "body",
+            "description": "Contains properties we need to query suggested images.",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/SuggestedTagAndRegionQueryToken"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/SuggestedTagAndRegionQuery"
+            }
+          },
+          "default": {
+            "description": "Error response",
+            "schema": {
+              "$ref": "#/definitions/CustomVisionError"
+            }
+          }
+        },
+        "x-ms-examples": {
+          "Successful QuerySuggestedImages request": {
+            "$ref": "./examples/QuerySuggestedImages.json"
+          }
+        }
+      }
+    },
+    "/projects/{projectId}/images/suggested/count": {
+      "post": {
+        "tags": [
+          "ImageApi"
+        ],
+        "summary": "Get count of images whose suggested tags match given tags and their probabilities are greater than or equal to the given threshold. Returns count as 0 if none found.",
+        "description": "This API takes in tagIds to get count of untagged images per suggested tags for a given threshold.",
+        "operationId": "QuerySuggestedImageCount",
+        "consumes": [
+          "application/json",
+          "application/xml",
+          "text/xml",
+          "application/x-www-form-urlencoded"
+        ],
+        "produces": [
+          "application/json",
+          "application/xml",
+          "text/xml"
+        ],
+        "parameters": [
+          {
+            "name": "projectId",
+            "in": "path",
+            "description": "The project id.",
+            "required": true,
+            "type": "string",
+            "format": "uuid",
+            "x-nullable": false
+          },
+          {
+            "name": "iterationId",
+            "in": "query",
+            "description": "IterationId to use for the suggested tags and regions.",
+            "required": true,
+            "type": "string",
+            "format": "uuid",
+            "x-nullable": false
+          },
+          {
+            "name": "query",
+            "in": "body",
+            "description": "Model that contains tagIds, threshold and projectType to query by.",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/TagFilter"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "type": "object",
+              "additionalProperties": {
+                "format": "int32",
+                "type": "integer"
+              }
+            }
+          },
+          "default": {
+            "description": "Error response",
+            "schema": {
+              "$ref": "#/definitions/CustomVisionError"
+            }
+          }
+        },
+        "x-ms-examples": {
+          "Successful QuerySuggestedImageCount request": {
+            "$ref": "./examples/QuerySuggestedImageCount.json"
+          }
+        }
+      }
+    },
+    "/projects/{projectId}/images/tagged": {
+      "get": {
+        "tags": [
+          "ImageApi"
+        ],
+        "summary": "Get tagged images for a given project iteration.",
+        "description": "This API supports batching and range selection. By default it will only return first 50 images matching images.\r\nUse the {take} and {skip} parameters to control how many images to return in a given batch.\r\nThe filtering is on an and/or relationship. For example, if the provided tag ids are for the \"Dog\" and\r\n\"Cat\" tags, then only images tagged with Dog and/or Cat will be returned",
+        "operationId": "GetTaggedImages",
+        "consumes": [],
+        "produces": [
+          "application/json",
+          "application/xml",
+          "text/xml"
+        ],
+        "parameters": [
+          {
+            "name": "projectId",
+            "in": "path",
+            "description": "The project id.",
+            "required": true,
+            "type": "string",
+            "format": "uuid",
+            "x-nullable": false
+          },
+          {
+            "name": "iterationId",
+            "in": "query",
+            "description": "The iteration id. Defaults to workspace.",
+            "required": false,
+            "type": "string",
+            "format": "uuid"
+          },
+          {
+            "name": "tagIds",
+            "in": "query",
+            "description": "A list of tags ids to filter the images. Defaults to all tagged images when null. Limited to 20.",
+            "required": false,
+            "type": "array",
+            "items": {
+              "type": "string",
+              "format": "uuid",
+              "x-nullable": false
+            },
+            "collectionFormat": "csv",
+            "maxItems": 20,
+            "minItems": 0
+          },
+          {
+            "name": "orderBy",
+            "in": "query",
+            "description": "The ordering. Defaults to newest.",
+            "required": false,
+            "type": "string",
+            "enum": [
+              "Newest",
+              "Oldest"
+            ]
+          },
+          {
+            "name": "take",
+            "in": "query",
+            "description": "Maximum number of images to return. Defaults to 50, limited to 256.",
+            "required": false,
+            "type": "integer",
+            "format": "int32",
+            "default": 50,
+            "maximum": 256,
+            "minimum": 0
+          },
+          {
+            "name": "skip",
+            "in": "query",
+            "description": "Number of images to skip before beginning the image batch. Defaults to 0.",
+            "required": false,
+            "type": "integer",
+            "format": "int32",
+            "default": 0
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "type": "array",
+              "items": {
+                "$ref": "#/definitions/Image"
+              }
+            }
+          },
+          "default": {
+            "description": "Error response",
+            "schema": {
+              "$ref": "#/definitions/CustomVisionError"
+            }
+          }
+        },
+        "x-ms-examples": {
+          "Successful GetTaggedImages request": {
+            "$ref": "./examples/GetTaggedImages.json"
+          }
+        }
+      }
+    },
+    "/projects/{projectId}/images/tagged/count": {
+      "get": {
+        "tags": [
+          "ImageApi"
+        ],
+        "summary": "Gets the number of images tagged with the provided {tagIds}.",
+        "description": "The filtering is on an and/or relationship. For example, if the provided tag ids are for the \"Dog\" and\r\n\"Cat\" tags, then only images tagged with Dog and/or Cat will be returned",
+        "operationId": "GetTaggedImageCount",
+        "consumes": [],
+        "produces": [
+          "application/json",
+          "application/xml",
+          "text/xml"
+        ],
+        "parameters": [
+          {
+            "name": "projectId",
+            "in": "path",
+            "description": "The project id.",
+            "required": true,
+            "type": "string",
+            "format": "uuid",
+            "x-nullable": false
+          },
+          {
+            "name": "iterationId",
+            "in": "query",
+            "description": "The iteration id. Defaults to workspace.",
+            "required": false,
+            "type": "string",
+            "format": "uuid"
+          },
+          {
+            "name": "tagIds",
+            "in": "query",
+            "description": "A list of tags ids to filter the images to count. Defaults to all tags when null.",
+            "required": false,
+            "type": "array",
+            "items": {
+              "type": "string",
+              "format": "uuid",
+              "x-nullable": false
+            },
+            "collectionFormat": "csv"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "format": "int32",
+              "type": "integer"
+            }
+          },
+          "default": {
+            "description": "Error response",
+            "schema": {
+              "$ref": "#/definitions/CustomVisionError"
+            }
+          }
+        },
+        "x-ms-examples": {
+          "Successful GetTaggedImageCount request": {
+            "$ref": "./examples/GetTaggedImageCount.json"
+          }
+        }
+      }
+    },
+    "/projects/{projectId}/images/tags": {
+      "post": {
+        "tags": [
+          "ImageApi"
+        ],
+        "summary": "Associate a set of images with a set of tags.",
+        "operationId": "CreateImageTags",
+        "consumes": [
+          "application/json",
+          "application/xml",
+          "text/xml",
+          "application/x-www-form-urlencoded"
+        ],
+        "produces": [
+          "application/json",
+          "application/xml",
+          "text/xml"
+        ],
+        "parameters": [
+          {
+            "name": "projectId",
+            "in": "path",
+            "description": "The project id.",
+            "required": true,
+            "type": "string",
+            "format": "uuid",
+            "x-nullable": false
+          },
+          {
+            "name": "batch",
+            "in": "body",
+            "description": "Batch of image tags. Limited to 128 tags per batch.",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/ImageTagCreateBatch"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/ImageTagCreateSummary"
+            }
+          },
+          "default": {
+            "description": "Error response",
+            "schema": {
+              "$ref": "#/definitions/CustomVisionError"
+            }
+          }
+        },
+        "x-ms-examples": {
+          "Successful CreateImageTags request": {
+            "$ref": "./examples/CreateImageTags.json"
+          }
+        }
+      },
+      "delete": {
+        "tags": [
+          "ImageApi"
+        ],
+        "summary": "Remove a set of tags from a set of images.",
+        "operationId": "DeleteImageTags",
+        "consumes": [],
+        "produces": [],
+        "parameters": [
+          {
+            "name": "projectId",
+            "in": "path",
+            "description": "The project id.",
+            "required": true,
+            "type": "string",
+            "format": "uuid",
+            "x-nullable": false
+          },
+          {
+            "name": "imageIds",
+            "in": "query",
+            "description": "Image ids. Limited to 64 images.",
+            "required": true,
+            "type": "array",
+            "items": {
+              "type": "string",
+              "format": "uuid",
+              "x-nullable": false
+            },
+            "collectionFormat": "csv",
+            "maxItems": 64,
+            "minItems": 0
+          },
+          {
+            "name": "tagIds",
+            "in": "query",
+            "description": "Tags to be deleted from the specified images. Limited to 20 tags.",
+            "required": true,
+            "type": "array",
+            "items": {
+              "type": "string",
+              "format": "uuid",
+              "x-nullable": false
+            },
+            "collectionFormat": "csv",
+            "maxItems": 20,
+            "minItems": 0
+          }
+        ],
+        "responses": {
+          "204": {
+            "description": "No Content"
+          },
+          "default": {
+            "description": "Error response",
+            "schema": {
+              "$ref": "#/definitions/CustomVisionError"
+            }
+          }
+        },
+        "x-ms-examples": {
+          "Successful DeleteImageTags request": {
+            "$ref": "./examples/DeleteImageTags.json"
+          }
+        }
+      }
+    },
+    "/projects/{projectId}/images/untagged": {
+      "get": {
+        "tags": [
+          "ImageApi"
+        ],
+        "summary": "Get untagged images for a given project iteration.",
+        "description": "This API supports batching and range selection. By default it will only return first 50 images matching images.\r\nUse the {take} and {skip} parameters to control how many images to return in a given batch.",
+        "operationId": "GetUntaggedImages",
+        "consumes": [],
+        "produces": [
+          "application/json",
+          "application/xml",
+          "text/xml"
+        ],
+        "parameters": [
+          {
+            "name": "projectId",
+            "in": "path",
+            "description": "The project id.",
+            "required": true,
+            "type": "string",
+            "format": "uuid",
+            "x-nullable": false
+          },
+          {
+            "name": "iterationId",
+            "in": "query",
+            "description": "The iteration id. Defaults to workspace.",
+            "required": false,
+            "type": "string",
+            "format": "uuid"
+          },
+          {
+            "name": "orderBy",
+            "in": "query",
+            "description": "The ordering. Defaults to newest.",
+            "required": false,
+            "type": "string",
+            "enum": [
+              "Newest",
+              "Oldest"
+            ]
+          },
+          {
+            "name": "take",
+            "in": "query",
+            "description": "Maximum number of images to return. Defaults to 50, limited to 256.",
+            "required": false,
+            "type": "integer",
+            "format": "int32",
+            "default": 50,
+            "maximum": 256,
+            "minimum": 0
+          },
+          {
+            "name": "skip",
+            "in": "query",
+            "description": "Number of images to skip before beginning the image batch. Defaults to 0.",
+            "required": false,
+            "type": "integer",
+            "format": "int32",
+            "default": 0
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "type": "array",
+              "items": {
+                "$ref": "#/definitions/Image"
+              }
+            }
+          },
+          "default": {
+            "description": "Error response",
+            "schema": {
+              "$ref": "#/definitions/CustomVisionError"
+            }
+          }
+        },
+        "x-ms-examples": {
+          "Successful GetUntaggedImages request": {
+            "$ref": "./examples/GetUntaggedImages.json"
+          }
+        }
+      }
+    },
+    "/projects/{projectId}/images/untagged/count": {
+      "get": {
+        "tags": [
+          "ImageApi"
+        ],
+        "summary": "Gets the number of untagged images.",
+        "description": "This API returns the images which have no tags for a given project and optionally an iteration. If no iteration is specified the\r\ncurrent workspace is used.",
+        "operationId": "GetUntaggedImageCount",
+        "consumes": [],
+        "produces": [
+          "application/json",
+          "application/xml",
+          "text/xml"
+        ],
+        "parameters": [
+          {
+            "name": "projectId",
+            "in": "path",
+            "description": "The project id.",
+            "required": true,
+            "type": "string",
+            "format": "uuid",
+            "x-nullable": false
+          },
+          {
+            "name": "iterationId",
+            "in": "query",
+            "description": "The iteration id. Defaults to workspace.",
+            "required": false,
+            "type": "string",
+            "format": "uuid"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "format": "int32",
+              "type": "integer"
+            }
+          },
+          "default": {
+            "description": "Error response",
+            "schema": {
+              "$ref": "#/definitions/CustomVisionError"
+            }
+          }
+        },
+        "x-ms-examples": {
+          "Successful GetUntaggedImageCount request": {
+            "$ref": "./examples/GetUntaggedImageCount.json"
+          }
+        }
+      }
+    },
+    "/projects/{projectId}/images/urls": {
+      "post": {
+        "tags": [
+          "ImageApi"
+        ],
+        "summary": "Add the provided images urls to the set of training images.",
+        "description": "This API accepts a batch of urls, and optionally tags, to create images. There is a limit of 64 images and 20 tags.\r\nIf all images are successful created, 200(OK) status code will be returned.\r\nOtherwise, 207 (Multi-Status) status code will be returned and detail status for each image will be listed in the response payload.",
+        "operationId": "CreateImagesFromUrls",
+        "consumes": [
+          "application/json",
+          "application/xml",
+          "text/xml",
+          "application/x-www-form-urlencoded"
+        ],
+        "produces": [
+          "application/json",
+          "application/xml",
+          "text/xml"
+        ],
+        "parameters": [
+          {
+            "name": "projectId",
+            "in": "path",
+            "description": "The project id.",
+            "required": true,
+            "type": "string",
+            "format": "uuid",
+            "x-nullable": false
+          },
+          {
+            "name": "batch",
+            "in": "body",
+            "description": "Image urls, tag ids, and metadata. Limited to 64 images and 20 tags per batch.",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/ImageUrlCreateBatch"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/ImageCreateSummary"
+            }
+          },
+          "207": {
+            "description": "207",
+            "schema": {
+              "$ref": "#/definitions/ImageCreateSummary"
+            }
+          },
+          "default": {
+            "description": "Error response",
+            "schema": {
+              "$ref": "#/definitions/CustomVisionError"
+            }
+          }
+        },
+        "x-ms-examples": {
+          "Successful CreateImagesFromUrls request": {
+            "$ref": "./examples/CreateImagesFromUrls.json"
+          }
+        }
+      }
+    },
+    "/projects/{projectId}/iterations": {
+      "get": {
+        "tags": [
+          "ProjectApi"
+        ],
+        "summary": "Get iterations for the project.",
+        "operationId": "GetIterations",
+        "consumes": [],
+        "produces": [
+          "application/json",
+          "application/xml",
+          "text/xml"
+        ],
+        "parameters": [
+          {
+            "name": "projectId",
+            "in": "path",
+            "description": "The project id.",
+            "required": true,
+            "type": "string",
+            "format": "uuid",
+            "x-nullable": false
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "type": "array",
+              "items": {
+                "$ref": "#/definitions/Iteration"
+              }
+            }
+          },
+          "default": {
+            "description": "Error response",
+            "schema": {
+              "$ref": "#/definitions/CustomVisionError"
+            }
+          }
+        },
+        "x-ms-examples": {
+          "Successful GetIterations request": {
+            "$ref": "./examples/GetIterations.json"
+          }
+        }
+      }
+    },
+    "/projects/{projectId}/iterations/{iterationId}": {
+      "get": {
+        "tags": [
+          "ProjectApi"
+        ],
+        "summary": "Get a specific iteration.",
+        "operationId": "GetIteration",
+        "consumes": [],
+        "produces": [
+          "application/json",
+          "application/xml",
+          "text/xml"
+        ],
+        "parameters": [
+          {
+            "name": "projectId",
+            "in": "path",
+            "description": "The id of the project the iteration belongs to.",
+            "required": true,
+            "type": "string",
+            "format": "uuid",
+            "x-nullable": false
+          },
+          {
+            "name": "iterationId",
+            "in": "path",
+            "description": "The id of the iteration to get.",
+            "required": true,
+            "type": "string",
+            "format": "uuid",
+            "x-nullable": false
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/Iteration"
+            }
+          },
+          "default": {
+            "description": "Error response",
+            "schema": {
+              "$ref": "#/definitions/CustomVisionError"
+            }
+          }
+        },
+        "x-ms-examples": {
+          "Successful GetIteration request": {
+            "$ref": "./examples/GetIteration.json"
+          }
+        }
+      },
+      "delete": {
+        "tags": [
+          "ProjectApi"
+        ],
+        "summary": "Delete a specific iteration of a project.",
+        "operationId": "DeleteIteration",
+        "consumes": [],
+        "produces": [],
+        "parameters": [
+          {
+            "name": "projectId",
+            "in": "path",
+            "description": "The project id.",
+            "required": true,
+            "type": "string",
+            "format": "uuid",
+            "x-nullable": false
+          },
+          {
+            "name": "iterationId",
+            "in": "path",
+            "description": "The iteration id.",
+            "required": true,
+            "type": "string",
+            "format": "uuid",
+            "x-nullable": false
+          }
+        ],
+        "responses": {
+          "204": {
+            "description": "No Content"
+          },
+          "default": {
+            "description": "Error response",
+            "schema": {
+              "$ref": "#/definitions/CustomVisionError"
+            }
+          }
+        },
+        "x-ms-examples": {
+          "Successful DeleteIteration request": {
+            "$ref": "./examples/DeleteIteration.json"
+          }
+        }
+      },
+      "patch": {
+        "tags": [
+          "ProjectApi"
+        ],
+        "summary": "Update a specific iteration.",
+        "operationId": "UpdateIteration",
+        "consumes": [
+          "application/json",
+          "application/xml",
+          "text/xml",
+          "application/x-www-form-urlencoded"
+        ],
+        "produces": [
+          "application/json",
+          "application/xml",
+          "text/xml"
+        ],
+        "parameters": [
+          {
+            "name": "projectId",
+            "in": "path",
+            "description": "Project id.",
+            "required": true,
+            "type": "string",
+            "format": "uuid",
+            "x-nullable": false
+          },
+          {
+            "name": "iterationId",
+            "in": "path",
+            "description": "Iteration id.",
+            "required": true,
+            "type": "string",
+            "format": "uuid",
+            "x-nullable": false
+          },
+          {
+            "name": "updatedIteration",
+            "in": "body",
+            "description": "The updated iteration model.",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/Iteration"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/Iteration"
+            }
+          },
+          "default": {
+            "description": "Error response",
+            "schema": {
+              "$ref": "#/definitions/CustomVisionError"
+            }
+          }
+        },
+        "x-ms-examples": {
+          "Successful UpdateIteration request": {
+            "$ref": "./examples/UpdateIteration.json"
+          }
+        }
+      }
+    },
+    "/projects/{projectId}/iterations/{iterationId}/export": {
+      "get": {
+        "tags": [
+          "ProjectApi"
+        ],
+        "summary": "Get the list of exports for a specific iteration.",
+        "operationId": "GetExports",
+        "consumes": [],
+        "produces": [
+          "application/json",
+          "application/xml",
+          "text/xml"
+        ],
+        "parameters": [
+          {
+            "name": "projectId",
+            "in": "path",
+            "description": "The project id.",
+            "required": true,
+            "type": "string",
+            "format": "uuid",
+            "x-nullable": false
+          },
+          {
+            "name": "iterationId",
+            "in": "path",
+            "description": "The iteration id.",
+            "required": true,
+            "type": "string",
+            "format": "uuid",
+            "x-nullable": false
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "type": "array",
+              "items": {
+                "$ref": "#/definitions/Export"
+              }
+            }
+          },
+          "default": {
+            "description": "Error response",
+            "schema": {
+              "$ref": "#/definitions/CustomVisionError"
+            }
+          }
+        },
+        "x-ms-examples": {
+          "Successful GetExports request": {
+            "$ref": "./examples/GetExports.json"
+          }
+        }
+      },
+      "post": {
+        "tags": [
+          "ProjectApi"
+        ],
+        "summary": "Export a trained iteration.",
+        "operationId": "ExportIteration",
+        "consumes": [],
+        "produces": [
+          "application/json",
+          "application/xml",
+          "text/xml"
+        ],
+        "parameters": [
+          {
+            "name": "projectId",
+            "in": "path",
+            "description": "The project id.",
+            "required": true,
+            "type": "string",
+            "format": "uuid",
+            "x-nullable": false
+          },
+          {
+            "name": "iterationId",
+            "in": "path",
+            "description": "The iteration id.",
+            "required": true,
+            "type": "string",
+            "format": "uuid",
+            "x-nullable": false
+          },
+          {
+            "name": "platform",
+            "in": "query",
+            "description": "The target platform.",
+            "required": true,
+            "type": "string",
+            "enum": [
+              "CoreML",
+              "TensorFlow",
+              "DockerFile",
+              "ONNX",
+              "VAIDK",
+              "OpenVino"
+            ]
+          },
+          {
+            "name": "flavor",
+            "in": "query",
+            "description": "The flavor of the target platform.",
+            "required": false,
+            "type": "string",
+            "enum": [
+              "Linux",
+              "Windows",
+              "ONNX10",
+              "ONNX12",
+              "ARM",
+              "TensorFlowNormal",
+              "TensorFlowLite"
+            ]
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/Export"
+            }
+          },
+          "default": {
+            "description": "Error response",
+            "schema": {
+              "$ref": "#/definitions/CustomVisionError"
+            }
+          }
+        },
+        "x-ms-examples": {
+          "Successful ExportIteration request": {
+            "$ref": "./examples/ExportIteration.json"
+          }
+        }
+      }
+    },
+    "/projects/{projectId}/iterations/{iterationId}/performance": {
+      "get": {
+        "tags": [
+          "ProjectApi"
+        ],
+        "summary": "Get detailed performance information about an iteration.",
+        "operationId": "GetIterationPerformance",
+        "consumes": [],
+        "produces": [
+          "application/json",
+          "application/xml",
+          "text/xml"
+        ],
+        "parameters": [
+          {
+            "name": "projectId",
+            "in": "path",
+            "description": "The id of the project the iteration belongs to.",
+            "required": true,
+            "type": "string",
+            "format": "uuid",
+            "x-nullable": false
+          },
+          {
+            "name": "iterationId",
+            "in": "path",
+            "description": "The id of the iteration to get.",
+            "required": true,
+            "type": "string",
+            "format": "uuid",
+            "x-nullable": false
+          },
+          {
+            "name": "threshold",
+            "in": "query",
+            "description": "The threshold used to determine true predictions.",
+            "required": false,
+            "type": "number",
+            "format": "float"
+          },
+          {
+            "name": "overlapThreshold",
+            "in": "query",
+            "description": "If applicable, the bounding box overlap threshold used to determine true predictions.",
+            "required": false,
+            "type": "number",
+            "format": "float"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/IterationPerformance"
+            }
+          },
+          "default": {
+            "description": "Error response",
+            "schema": {
+              "$ref": "#/definitions/CustomVisionError"
+            }
+          }
+        },
+        "x-ms-examples": {
+          "Successful GetIterationPerformance request": {
+            "$ref": "./examples/GetIterationPerformance.json"
+          }
+        }
+      }
+    },
+    "/projects/{projectId}/iterations/{iterationId}/performance/images": {
+      "get": {
+        "tags": [
+          "ProjectApi"
+        ],
+        "summary": "Get image with its prediction for a given project iteration.",
+        "description": "This API supports batching and range selection. By default it will only return first 50 images matching images.\r\nUse the {take} and {skip} parameters to control how many images to return in a given batch.\r\nThe filtering is on an and/or relationship. For example, if the provided tag ids are for the \"Dog\" and\r\n\"Cat\" tags, then only images tagged with Dog and/or Cat will be returned",
+        "operationId": "GetImagePerformances",
+        "consumes": [],
+        "produces": [
+          "application/json",
+          "application/xml",
+          "text/xml"
+        ],
+        "parameters": [
+          {
+            "name": "projectId",
+            "in": "path",
+            "description": "The project id.",
+            "required": true,
+            "type": "string",
+            "format": "uuid",
+            "x-nullable": false
+          },
+          {
+            "name": "iterationId",
+            "in": "path",
+            "description": "The iteration id. Defaults to workspace.",
+            "required": true,
+            "type": "string",
+            "format": "uuid",
+            "x-nullable": false
+          },
+          {
+            "name": "tagIds",
+            "in": "query",
+            "description": "A list of tags ids to filter the images. Defaults to all tagged images when null. Limited to 20.",
+            "required": false,
+            "type": "array",
+            "items": {
+              "type": "string",
+              "format": "uuid",
+              "x-nullable": false
+            },
+            "collectionFormat": "csv",
+            "maxItems": 20,
+            "minItems": 0
+          },
+          {
+            "name": "orderBy",
+            "in": "query",
+            "description": "The ordering. Defaults to newest.",
+            "required": false,
+            "type": "string",
+            "enum": [
+              "Newest",
+              "Oldest"
+            ]
+          },
+          {
+            "name": "take",
+            "in": "query",
+            "description": "Maximum number of images to return. Defaults to 50, limited to 256.",
+            "required": false,
+            "type": "integer",
+            "format": "int32",
+            "default": 50,
+            "maximum": 256,
+            "minimum": 0
+          },
+          {
+            "name": "skip",
+            "in": "query",
+            "description": "Number of images to skip before beginning the image batch. Defaults to 0.",
+            "required": false,
+            "type": "integer",
+            "format": "int32",
+            "default": 0
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "type": "array",
+              "items": {
+                "$ref": "#/definitions/ImagePerformance"
+              }
+            }
+          },
+          "default": {
+            "description": "Error response",
+            "schema": {
+              "$ref": "#/definitions/CustomVisionError"
+            }
+          }
+        },
+        "x-ms-examples": {
+          "Successful GetImagePerformances request": {
+            "$ref": "./examples/GetImagePerformances.json"
+          }
+        }
+      }
+    },
+    "/projects/{projectId}/iterations/{iterationId}/performance/images/count": {
+      "get": {
+        "tags": [
+          "ProjectApi"
+        ],
+        "summary": "Gets the number of images tagged with the provided {tagIds} that have prediction results from\r\ntraining for the provided iteration {iterationId}.",
+        "description": "The filtering is on an and/or relationship. For example, if the provided tag ids are for the \"Dog\" and\r\n\"Cat\" tags, then only images tagged with Dog and/or Cat will be returned",
+        "operationId": "GetImagePerformanceCount",
+        "consumes": [],
+        "produces": [
+          "application/json",
+          "application/xml",
+          "text/xml"
+        ],
+        "parameters": [
+          {
+            "name": "projectId",
+            "in": "path",
+            "description": "The project id.",
+            "required": true,
+            "type": "string",
+            "format": "uuid",
+            "x-nullable": false
+          },
+          {
+            "name": "iterationId",
+            "in": "path",
+            "description": "The iteration id. Defaults to workspace.",
+            "required": true,
+            "type": "string",
+            "format": "uuid",
+            "x-nullable": false
+          },
+          {
+            "name": "tagIds",
+            "in": "query",
+            "description": "A list of tags ids to filter the images to count. Defaults to all tags when null.",
+            "required": false,
+            "type": "array",
+            "items": {
+              "type": "string",
+              "format": "uuid",
+              "x-nullable": false
+            },
+            "collectionFormat": "csv"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "format": "int32",
+              "type": "integer"
+            }
+          },
+          "default": {
+            "description": "Error response",
+            "schema": {
+              "$ref": "#/definitions/CustomVisionError"
+            }
+          }
+        },
+        "x-ms-examples": {
+          "Successful GetImagePerformanceCount request": {
+            "$ref": "./examples/GetImagePerformanceCount.json"
+          }
+        }
+      }
+    },
+    "/projects/{projectId}/iterations/{iterationId}/publish": {
+      "post": {
+        "tags": [
+          "ProjectApi"
+        ],
+        "summary": "Publish a specific iteration.",
+        "operationId": "PublishIteration",
+        "consumes": [],
+        "produces": [
+          "application/json",
+          "application/xml",
+          "text/xml"
+        ],
+        "parameters": [
+          {
+            "name": "projectId",
+            "in": "path",
+            "description": "The project id.",
+            "required": true,
+            "type": "string",
+            "format": "uuid",
+            "x-nullable": false
+          },
+          {
+            "name": "iterationId",
+            "in": "path",
+            "description": "The iteration id.",
+            "required": true,
+            "type": "string",
+            "format": "uuid",
+            "x-nullable": false
+          },
+          {
+            "name": "publishName",
+            "in": "query",
+            "description": "The name to give the published iteration.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "predictionId",
+            "in": "query",
+            "description": "The id of the prediction resource to publish to.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "overwrite",
+            "in": "query",
+            "description": "Whether to overwrite the published model with the given name (default: false).",
+            "required": false,
+            "type": "boolean"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "type": "boolean"
+            }
+          },
+          "default": {
+            "description": "Error response",
+            "schema": {
+              "$ref": "#/definitions/CustomVisionError"
+            }
+          }
+        },
+        "x-ms-examples": {
+          "Successful PublishIteration request": {
+            "$ref": "./examples/PublishIteration.json"
+          }
+        }
+      },
+      "delete": {
+        "tags": [
+          "ProjectApi"
+        ],
+        "summary": "Unpublish a specific iteration.",
+        "operationId": "UnpublishIteration",
+        "consumes": [],
+        "produces": [],
+        "parameters": [
+          {
+            "name": "projectId",
+            "in": "path",
+            "description": "The project id.",
+            "required": true,
+            "type": "string",
+            "format": "uuid",
+            "x-nullable": false
+          },
+          {
+            "name": "iterationId",
+            "in": "path",
+            "description": "The iteration id.",
+            "required": true,
+            "type": "string",
+            "format": "uuid",
+            "x-nullable": false
+          }
+        ],
+        "responses": {
+          "204": {
+            "description": "No Content"
+          },
+          "default": {
+            "description": "Error response",
+            "schema": {
+              "$ref": "#/definitions/CustomVisionError"
+            }
+          }
+        },
+        "x-ms-examples": {
+          "Successful UnpublishIteration request": {
+            "$ref": "./examples/UnpublishIteration.json"
+          }
+        }
+      }
+    },
+    "/projects/{projectId}/predictions": {
+      "delete": {
+        "tags": [
+          "PredictionsApi"
+        ],
+        "summary": "Delete a set of predicted images and their associated prediction results.",
+        "operationId": "DeletePrediction",
+        "consumes": [],
+        "produces": [],
+        "parameters": [
+          {
+            "name": "projectId",
+            "in": "path",
+            "description": "The project id.",
+            "required": true,
+            "type": "string",
+            "format": "uuid",
+            "x-nullable": false
+          },
+          {
+            "name": "ids",
+            "in": "query",
+            "description": "The prediction ids. Limited to 64.",
+            "required": true,
+            "type": "array",
+            "items": {
+              "type": "string",
+              "format": "uuid",
+              "x-nullable": false
+            },
+            "collectionFormat": "csv",
+            "maxItems": 64,
+            "minItems": 0
+          }
+        ],
+        "responses": {
+          "204": {
+            "description": "No Content"
+          },
+          "default": {
+            "description": "Error response",
+            "schema": {
+              "$ref": "#/definitions/CustomVisionError"
+            }
+          }
+        },
+        "x-ms-examples": {
+          "Successful DeletePrediction request": {
+            "$ref": "./examples/DeletePrediction.json"
+          }
+        }
+      }
+    },
+    "/projects/{projectId}/predictions/query": {
+      "post": {
+        "tags": [
+          "PredictionsApi"
+        ],
+        "summary": "Get images that were sent to your prediction endpoint.",
+        "operationId": "QueryPredictions",
+        "consumes": [
+          "application/json",
+          "application/xml",
+          "text/xml",
+          "application/x-www-form-urlencoded"
+        ],
+        "produces": [
+          "application/json",
+          "application/xml",
+          "text/xml"
+        ],
+        "parameters": [
+          {
+            "name": "projectId",
+            "in": "path",
+            "description": "The project id.",
+            "required": true,
+            "type": "string",
+            "format": "uuid",
+            "x-nullable": false
+          },
+          {
+            "name": "query",
+            "in": "body",
+            "description": "Parameters used to query the predictions. Limited to combining 2 tags.",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/PredictionQueryToken"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/PredictionQueryResult"
+            }
+          },
+          "default": {
+            "description": "Error response",
+            "schema": {
+              "$ref": "#/definitions/CustomVisionError"
+            }
+          }
+        },
+        "x-ms-examples": {
+          "Successful QueryPredictions request": {
+            "$ref": "./examples/QueryPredictions.json"
+          }
+        }
+      }
+    },
+    "/projects/{projectId}/quicktest/image": {
+      "post": {
+        "tags": [
+          "PredictionsApi"
+        ],
+        "summary": "Quick test an image.",
+        "operationId": "QuickTestImage",
+        "consumes": [
+          "multipart/form-data",
+          "application/octet-stream"
+        ],
+        "produces": [
+          "application/json",
+          "application/xml",
+          "text/xml"
+        ],
+        "parameters": [
+          {
+            "name": "projectId",
+            "in": "path",
+            "description": "The project id.",
+            "required": true,
+            "type": "string",
+            "format": "uuid",
+            "x-nullable": false
+          },
+          {
+            "name": "iterationId",
+            "in": "query",
+            "description": "Optional. Specifies the id of a particular iteration to evaluate against.\r\n            The default iteration for the project will be used when not specified.",
+            "required": false,
+            "type": "string",
+            "format": "uuid"
+          },
+          {
+            "name": "store",
+            "in": "query",
+            "description": "Optional. Specifies whether or not to store the result of this prediction. The default is true, to store.",
+            "required": false,
+            "type": "boolean",
+            "default": true
+          },
+          {
+            "name": "imageData",
+            "in": "formData",
+            "description": "Binary image data. Supported formats are JPEG, GIF, PNG, and BMP. Supports images up to 6MB.",
+            "required": true,
+            "type": "file"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/ImagePrediction"
+            }
+          },
+          "default": {
+            "description": "Error response",
+            "schema": {
+              "$ref": "#/definitions/CustomVisionError"
+            }
+          }
+        },
+        "x-ms-examples": {
+          "Successful QuickTestImage request": {
+            "$ref": "./examples/QuickTestImage.json"
+          }
+        }
+      }
+    },
+    "/projects/{projectId}/quicktest/url": {
+      "post": {
+        "tags": [
+          "PredictionsApi"
+        ],
+        "summary": "Quick test an image url.",
+        "operationId": "QuickTestImageUrl",
+        "consumes": [
+          "application/json",
+          "application/xml",
+          "text/xml",
+          "application/x-www-form-urlencoded"
+        ],
+        "produces": [
+          "application/json",
+          "application/xml",
+          "text/xml"
+        ],
+        "parameters": [
+          {
+            "name": "projectId",
+            "in": "path",
+            "description": "The project to evaluate against.",
+            "required": true,
+            "type": "string",
+            "format": "uuid",
+            "x-nullable": false
+          },
+          {
+            "name": "imageUrl",
+            "in": "body",
+            "description": "An ImageUrl that contains the url of the image to be evaluated.",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/ImageUrl"
+            }
+          },
+          {
+            "name": "iterationId",
+            "in": "query",
+            "description": "Optional. Specifies the id of a particular iteration to evaluate against.\r\n            The default iteration for the project will be used when not specified.",
+            "required": false,
+            "type": "string",
+            "format": "uuid"
+          },
+          {
+            "name": "store",
+            "in": "query",
+            "description": "Optional. Specifies whether or not to store the result of this prediction. The default is true, to store.",
+            "required": false,
+            "type": "boolean",
+            "default": true
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/ImagePrediction"
+            }
+          },
+          "default": {
+            "description": "Error response",
+            "schema": {
+              "$ref": "#/definitions/CustomVisionError"
+            }
+          }
+        },
+        "x-ms-examples": {
+          "Successful QuickTestImageUrl request": {
+            "$ref": "./examples/QuickTestImageUrl.json"
+          }
+        }
+      }
+    },
+    "/projects/{projectId}/tags": {
+      "get": {
+        "tags": [
+          "TagsApi"
+        ],
+        "summary": "Get the tags for a given project and iteration.",
+        "operationId": "GetTags",
+        "consumes": [],
+        "produces": [
+          "application/json",
+          "application/xml",
+          "text/xml"
+        ],
+        "parameters": [
+          {
+            "name": "projectId",
+            "in": "path",
+            "description": "The project id.",
+            "required": true,
+            "type": "string",
+            "format": "uuid",
+            "x-nullable": false
+          },
+          {
+            "name": "iterationId",
+            "in": "query",
+            "description": "The iteration id. Defaults to workspace.",
+            "required": false,
+            "type": "string",
+            "format": "uuid"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "type": "array",
+              "items": {
+                "$ref": "#/definitions/Tag"
+              }
+            }
+          },
+          "default": {
+            "description": "Error response",
+            "schema": {
+              "$ref": "#/definitions/CustomVisionError"
+            }
+          }
+        },
+        "x-ms-examples": {
+          "Successful GetTags request": {
+            "$ref": "./examples/GetTags.json"
+          }
+        }
+      },
+      "post": {
+        "tags": [
+          "TagsApi"
+        ],
+        "summary": "Create a tag for the project.",
+        "operationId": "CreateTag",
+        "consumes": [],
+        "produces": [
+          "application/json",
+          "application/xml",
+          "text/xml"
+        ],
+        "parameters": [
+          {
+            "name": "projectId",
+            "in": "path",
+            "description": "The project id.",
+            "required": true,
+            "type": "string",
+            "format": "uuid",
+            "x-nullable": false
+          },
+          {
+            "name": "name",
+            "in": "query",
+            "description": "The tag name.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "description",
+            "in": "query",
+            "description": "Optional description for the tag.",
+            "required": false,
+            "type": "string"
+          },
+          {
+            "name": "type",
+            "in": "query",
+            "description": "Optional type for the tag.",
+            "required": false,
+            "type": "string",
+            "enum": [
+              "Regular",
+              "Negative",
+              "GeneralProduct"
+            ]
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/Tag"
+            }
+          },
+          "default": {
+            "description": "Error response",
+            "schema": {
+              "$ref": "#/definitions/CustomVisionError"
+            }
+          }
+        },
+        "x-ms-examples": {
+          "Successful CreateTag request": {
+            "$ref": "./examples/CreateTag.json"
+          }
+        }
+      }
+    },
+    "/projects/{projectId}/tags/{tagId}": {
+      "get": {
+        "tags": [
+          "TagsApi"
+        ],
+        "summary": "Get information about a specific tag.",
+        "operationId": "GetTag",
+        "consumes": [],
+        "produces": [
+          "application/json",
+          "application/xml",
+          "text/xml"
+        ],
+        "parameters": [
+          {
+            "name": "projectId",
+            "in": "path",
+            "description": "The project this tag belongs to.",
+            "required": true,
+            "type": "string",
+            "format": "uuid",
+            "x-nullable": false
+          },
+          {
+            "name": "tagId",
+            "in": "path",
+            "description": "The tag id.",
+            "required": true,
+            "type": "string",
+            "format": "uuid",
+            "x-nullable": false
+          },
+          {
+            "name": "iterationId",
+            "in": "query",
+            "description": "The iteration to retrieve this tag from. Optional, defaults to current training set.",
+            "required": false,
+            "type": "string",
+            "format": "uuid"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/Tag"
+            }
+          },
+          "default": {
+            "description": "Error response",
+            "schema": {
+              "$ref": "#/definitions/CustomVisionError"
+            }
+          }
+        },
+        "x-ms-examples": {
+          "Successful GetTag request": {
+            "$ref": "./examples/GetTag.json"
+          }
+        }
+      },
+      "delete": {
+        "tags": [
+          "TagsApi"
+        ],
+        "summary": "Delete a tag from the project.",
+        "operationId": "DeleteTag",
+        "consumes": [],
+        "produces": [],
+        "parameters": [
+          {
+            "name": "projectId",
+            "in": "path",
+            "description": "The project id.",
+            "required": true,
+            "type": "string",
+            "format": "uuid",
+            "x-nullable": false
+          },
+          {
+            "name": "tagId",
+            "in": "path",
+            "description": "Id of the tag to be deleted.",
+            "required": true,
+            "type": "string",
+            "format": "uuid",
+            "x-nullable": false
+          }
+        ],
+        "responses": {
+          "204": {
+            "description": "No Content"
+          },
+          "default": {
+            "description": "Error response",
+            "schema": {
+              "$ref": "#/definitions/CustomVisionError"
+            }
+          }
+        },
+        "x-ms-examples": {
+          "Successful DeleteTag request": {
+            "$ref": "./examples/DeleteTag.json"
+          }
+        }
+      },
+      "patch": {
+        "tags": [
+          "TagsApi"
+        ],
+        "summary": "Update a tag.",
+        "operationId": "UpdateTag",
+        "consumes": [
+          "application/json",
+          "application/xml",
+          "text/xml",
+          "application/x-www-form-urlencoded"
+        ],
+        "produces": [
+          "application/json",
+          "application/xml",
+          "text/xml"
+        ],
+        "parameters": [
+          {
+            "name": "projectId",
+            "in": "path",
+            "description": "The project id.",
+            "required": true,
+            "type": "string",
+            "format": "uuid",
+            "x-nullable": false
+          },
+          {
+            "name": "tagId",
+            "in": "path",
+            "description": "The id of the target tag.",
+            "required": true,
+            "type": "string",
+            "format": "uuid",
+            "x-nullable": false
+          },
+          {
+            "name": "updatedTag",
+            "in": "body",
+            "description": "The updated tag model.",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/Tag"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/Tag"
+            }
+          },
+          "default": {
+            "description": "Error response",
+            "schema": {
+              "$ref": "#/definitions/CustomVisionError"
+            }
+          }
+        },
+        "x-ms-examples": {
+          "Successful UpdateTag request": {
+            "$ref": "./examples/UpdateTag.json"
+          }
+        }
+      }
+    },
+    "/projects/{projectId}/tagsandregions/suggestions": {
+      "post": {
+        "tags": [
+          "SuggestTagsAndRegionsApi"
+        ],
+        "summary": "Suggest tags and regions for an array/batch of untagged images. Returns empty array if no tags are found.",
+        "description": "This API will get suggested tags and regions for an array/batch of untagged images along with confidences for the tags. It returns an empty array if no tags are found.\r\nThere is a limit of 64 images in the batch.",
+        "operationId": "SuggestTagsAndRegions",
+        "consumes": [],
+        "produces": [
+          "application/json",
+          "application/xml",
+          "text/xml"
+        ],
+        "parameters": [
+          {
+            "name": "projectId",
+            "in": "path",
+            "description": "The project id.",
+            "required": true,
+            "type": "string",
+            "format": "uuid",
+            "x-nullable": false
+          },
+          {
+            "name": "iterationId",
+            "in": "query",
+            "description": "IterationId to use for tag and region suggestion.",
+            "required": true,
+            "type": "string",
+            "format": "uuid",
+            "x-nullable": false
+          },
+          {
+            "name": "imageIds",
+            "in": "query",
+            "description": "Array of image ids tag suggestion are needed for. Use GetUntaggedImages API to get imageIds.",
+            "required": true,
+            "type": "array",
+            "items": {
+              "type": "string",
+              "format": "uuid",
+              "x-nullable": false
+            },
+            "collectionFormat": "csv",
+            "maxItems": 64,
+            "minItems": 0
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "type": "array",
+              "items": {
+                "$ref": "#/definitions/SuggestedTagAndRegion"
+              }
+            }
+          },
+          "default": {
+            "description": "Error response",
+            "schema": {
+              "$ref": "#/definitions/CustomVisionError"
+            }
+          }
+        },
+        "x-ms-examples": {
+          "Successful SuggestTagsAndRegions request": {
+            "$ref": "./examples/SuggestTagsAndRegions.json"
+          }
+        }
+      }
+    },
+    "/projects/{projectId}/train": {
+      "post": {
+        "tags": [
+          "ProjectApi"
+        ],
+        "summary": "Queues project for training.",
+        "operationId": "TrainProject",
+        "consumes": [
+          "application/json",
+          "application/xml",
+          "text/xml",
+          "application/x-www-form-urlencoded"
+        ],
+        "produces": [
+          "application/json",
+          "application/xml",
+          "text/xml"
+        ],
+        "parameters": [
+          {
+            "name": "projectId",
+            "in": "path",
+            "description": "The project id.",
+            "required": true,
+            "type": "string",
+            "format": "uuid",
+            "x-nullable": false
+          },
+          {
+            "name": "trainingType",
+            "in": "query",
+            "description": "The type of training to use to train the project (default: Regular).",
+            "required": false,
+            "type": "string",
+            "enum": [
+              "Regular",
+              "Advanced"
+            ]
+          },
+          {
+            "name": "reservedBudgetInHours",
+            "in": "query",
+            "description": "The number of hours reserved as budget for training (if applicable).",
+            "required": false,
+            "type": "integer",
+            "format": "int32",
+            "default": 0
+          },
+          {
+            "name": "forceTrain",
+            "in": "query",
+            "description": "Whether to force train even if dataset and configuration does not change (default: false).",
+            "required": false,
+            "type": "boolean",
+            "default": false
+          },
+          {
+            "name": "notificationEmailAddress",
+            "in": "query",
+            "description": "The email address to send notification to when training finishes (default: null).",
+            "required": false,
+            "type": "string"
+          },
+          {
+            "name": "trainingParameters",
+            "in": "body",
+            "description": "Additional training parameters passed in to control how the project is trained.",
+            "required": false,
+            "schema": {
+              "$ref": "#/definitions/TrainingParameters"
+            },
+            "x-nullable": true
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/Iteration"
+            }
+          },
+          "default": {
+            "description": "Error response",
+            "schema": {
+              "$ref": "#/definitions/CustomVisionError"
+            }
+          }
+        },
+        "x-ms-examples": {
+          "Successful TrainProject request": {
+            "$ref": "./examples/TrainProject.json"
+          }
+        }
+      }
+    },
+    "/projects/import": {
+      "post": {
+        "tags": [
+          "ProjectApi"
+        ],
+        "summary": "Imports a project.",
+        "operationId": "ImportProject",
+        "consumes": [],
+        "produces": [
+          "application/json",
+          "application/xml",
+          "text/xml"
+        ],
+        "parameters": [
+          {
+            "name": "token",
+            "in": "query",
+            "description": "Token generated from the export project call.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "name",
+            "in": "query",
+            "description": "Optional, name of the project to use instead of auto-generated name.",
+            "required": false,
+            "type": "string"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/Project"
+            }
+          },
+          "default": {
+            "description": "Error response",
+            "schema": {
+              "$ref": "#/definitions/CustomVisionError"
+            }
+          }
+        },
+        "x-ms-examples": {
+          "Successful ImportProject request": {
+            "$ref": "./examples/ImportProject.json"
+          }
+        }
+      }
+    }
+  },
+  "definitions": {
+    "BoundingBox": {
+      "description": "Bounding box that defines a region of an image.",
+      "required": [
+        "left",
+        "top",
+        "width",
+        "height"
+      ],
+      "type": "object",
+      "properties": {
+        "left": {
+          "format": "float",
+          "description": "Coordinate of the left boundary.",
+          "type": "number",
+          "readOnly": false,
+          "x-nullable": false
+        },
+        "top": {
+          "format": "float",
+          "description": "Coordinate of the top boundary.",
+          "type": "number",
+          "readOnly": false,
+          "x-nullable": false
+        },
+        "width": {
+          "format": "float",
+          "description": "Width.",
+          "type": "number",
+          "readOnly": false,
+          "x-nullable": false
+        },
+        "height": {
+          "format": "float",
+          "description": "Height.",
+          "type": "number",
+          "readOnly": false,
+          "x-nullable": false
+        }
+      }
+    },
+    "CreateProjectOptions": {
+      "description": "Options used for createProject.",
+      "type": "object",
+      "properties": {
+        "exportModelContainerUri": {
+          "description": "The uri to the Azure Storage container that will be used to store exported models.",
+          "type": "string",
+          "readOnly": false,
+          "x-nullable": false
+        },
+        "notificationQueueUri": {
+          "description": "The uri to the Azure Storage queue that will be used to send project-related notifications. See <a href=\"https://go.microsoft.com/fwlink/?linkid=2144149\">Storage notifications</a> documentation for setup and message format.",
+          "type": "string",
+          "readOnly": false,
+          "x-nullable": false
+        }
+      }
+    },
+    "CustomBaseModelInfo": {
+      "required": [
+        "projectId",
+        "iterationId"
+      ],
+      "type": "object",
+      "properties": {
+        "projectId": {
+          "format": "uuid",
+          "description": "Project Id of the previously trained project to be used for current iteration's training.",
+          "type": "string",
+          "readOnly": false,
+          "x-nullable": false
+        },
+        "iterationId": {
+          "format": "uuid",
+          "description": "Iteration Id of the previously trained project to be used for current iteration's training.",
+          "type": "string",
+          "readOnly": false,
+          "x-nullable": false
+        }
+      }
+    },
+    "CustomVisionError": {
+      "required": [
+        "code",
+        "message"
+      ],
+      "type": "object",
+      "properties": {
+        "code": {
+          "description": "The error code.",
+          "enum": [
+            "NoError",
+            "BadRequest",
+            "BadRequestExceededBatchSize",
+            "BadRequestNotSupported",
+            "BadRequestInvalidIds",
+            "BadRequestProjectName",
+            "BadRequestProjectNameNotUnique",
+            "BadRequestProjectDescription",
+            "BadRequestProjectUnknownDomain",
+            "BadRequestProjectUnknownClassification",
+            "BadRequestProjectUnsupportedDomainTypeChange",
+            "BadRequestProjectUnsupportedExportPlatform",
+            "BadRequestProjectImagePreprocessingSettings",
+            "BadRequestProjectDuplicated",
+            "BadRequestIterationName",
+            "BadRequestIterationNameNotUnique",
+            "BadRequestIterationDescription",
+            "BadRequestIterationIsNotTrained",
+            "BadRequestIterationValidationFailed",
+            "BadRequestWorkspaceCannotBeModified",
+            "BadRequestWorkspaceNotDeletable",
+            "BadRequestTagName",
+            "BadRequestTagNameNotUnique",
+            "BadRequestTagDescription",
+            "BadRequestTagType",
+            "BadRequestMultipleNegativeTag",
+            "BadRequestMultipleGeneralProductTag",
+            "BadRequestImageTags",
+            "BadRequestImageRegions",
+            "BadRequestNegativeAndRegularTagOnSameImage",
+            "BadRequestUnsupportedDomain",
+            "BadRequestRequiredParamIsNull",
+            "BadRequestIterationIsPublished",
+            "BadRequestInvalidPublishName",
+            "BadRequestInvalidPublishTarget",
+            "BadRequestUnpublishFailed",
+            "BadRequestIterationNotPublished",
+            "BadRequestSubscriptionApi",
+            "BadRequestExceedProjectLimit",
+            "BadRequestExceedIterationPerProjectLimit",
+            "BadRequestExceedTagPerProjectLimit",
+            "BadRequestExceedTagPerImageLimit",
+            "BadRequestExceededQuota",
+            "BadRequestCannotMigrateProjectWithName",
+            "BadRequestNotLimitedTrial",
+            "BadRequestImageBatch",
+            "BadRequestImageStream",
+            "BadRequestImageUrl",
+            "BadRequestImageFormat",
+            "BadRequestImageSizeBytes",
+            "BadRequestImageDimensions",
+            "BadRequestImageAspectRatio",
+            "BadRequestImageExceededCount",
+            "BadRequestTrainingNotNeeded",
+            "BadRequestTrainingNotNeededButTrainingPipelineUpdated",
+            "BadRequestTrainingValidationFailed",
+            "BadRequestClassificationTrainingValidationFailed",
+            "BadRequestMultiClassClassificationTrainingValidationFailed",
+            "BadRequestMultiLabelClassificationTrainingValidationFailed",
+            "BadRequestDetectionTrainingValidationFailed",
+            "BadRequestTrainingAlreadyInProgress",
+            "BadRequestDetectionTrainingNotAllowNegativeTag",
+            "BadRequestInvalidEmailAddress",
+            "BadRequestRetiredDomainNotSupportedForTraining",
+            "BadRequestDomainNotSupportedForAdvancedTraining",
+            "BadRequestExportPlatformNotSupportedForAdvancedTraining",
+            "BadRequestReservedBudgetInHoursNotEnoughForAdvancedTraining",
+            "BadRequestCustomBaseModelIterationStatusNotCompleted",
+            "BadRequestCustomBaseModelDomainNotCompatible",
+            "BadRequestCustomBaseModelArchitectureRetired",
+            "BadRequestExportValidationFailed",
+            "BadRequestExportAlreadyInProgress",
+            "BadRequestPredictionIdsMissing",
+            "BadRequestPredictionIdsExceededCount",
+            "BadRequestPredictionTagsExceededCount",
+            "BadRequestPredictionResultsExceededCount",
+            "BadRequestPredictionInvalidApplicationName",
+            "BadRequestPredictionInvalidQueryParameters",
+            "BadRequestInvalidImportToken",
+            "BadRequestExportWhileTraining",
+            "BadRequestImageMetadataKey",
+            "BadRequestImageMetadataValue",
+            "BadRequestOperationNotSupported",
+            "BadRequestInvalidArtifactUri",
+            "BadRequestCustomerManagedKeyRevoked",
+            "BadRequestInvalidUri",
+            "BadRequestInvalid",
+            "UnsupportedMediaType",
+            "Forbidden",
+            "ForbiddenUser",
+            "ForbiddenUserResource",
+            "ForbiddenUserSignupDisabled",
+            "ForbiddenUserSignupAllowanceExceeded",
+            "ForbiddenUserDoesNotExist",
+            "ForbiddenUserDisabled",
+            "ForbiddenUserInsufficientCapability",
+            "ForbiddenDRModeEnabled",
+            "ForbiddenInvalid",
+            "NotFound",
+            "NotFoundProject",
+            "NotFoundProjectDefaultIteration",
+            "NotFoundIteration",
+            "NotFoundIterationPerformance",
+            "NotFoundTag",
+            "NotFoundImage",
+            "NotFoundDomain",
+            "NotFoundApimSubscription",
+            "NotFoundInvalid",
+            "Conflict",
+            "ConflictInvalid",
+            "ErrorUnknown",
+            "ErrorIterationCopyFailed",
+            "ErrorPreparePerformanceMigrationFailed",
+            "ErrorProjectInvalidWorkspace",
+            "ErrorProjectInvalidPipelineConfiguration",
+            "ErrorProjectInvalidDomain",
+            "ErrorProjectTrainingRequestFailed",
+            "ErrorProjectImportRequestFailed",
+            "ErrorProjectExportRequestFailed",
+            "ErrorFeaturizationServiceUnavailable",
+            "ErrorFeaturizationQueueTimeout",
+            "ErrorFeaturizationInvalidFeaturizer",
+            "ErrorFeaturizationAugmentationUnavailable",
+            "ErrorFeaturizationUnrecognizedJob",
+            "ErrorFeaturizationAugmentationError",
+            "ErrorExporterInvalidPlatform",
+            "ErrorExporterInvalidFeaturizer",
+            "ErrorExporterInvalidClassifier",
+            "ErrorPredictionServiceUnavailable",
+            "ErrorPredictionModelNotFound",
+            "ErrorPredictionModelNotCached",
+            "ErrorPrediction",
+            "ErrorPredictionStorage",
+            "ErrorRegionProposal",
+            "ErrorUnknownBaseModel",
+            "ErrorServerTimeOut",
+            "ErrorInvalid"
+          ],
+          "type": "string",
+          "x-ms-enum": {
+            "name": "CustomVisionErrorCodes",
+            "modelAsString": true
+          }
+        },
+        "message": {
+          "description": "A message explaining the error reported by the service.",
+          "type": "string"
+        }
+      }
+    },
+    "Domain": {
+      "description": "Domains are used as the starting point for your project. Each domain is optimized for specific types of images. Domains with compact in their name can be exported. For more information visit the <a href=\"https://go.microsoft.com/fwlink/?linkid=2117014\">domain documentation</a>.",
+      "type": "object",
+      "properties": {
+        "id": {
+          "format": "uuid",
+          "description": "Domain id.",
+          "type": "string",
+          "readOnly": true,
+          "example": "00000000-0000-0000-0000-000000000000",
+          "x-nullable": false
+        },
+        "name": {
+          "description": "Name of the domain, describing the types of images used to train it.",
+          "type": "string",
+          "readOnly": true,
+          "x-nullable": false
+        },
+        "type": {
+          "description": "Domain type: Classification or ObjectDetection.",
+          "enum": [
+            "Classification",
+            "ObjectDetection"
+          ],
+          "type": "string",
+          "readOnly": true,
+          "x-nullable": false,
+          "x-ms-enum": {
+            "name": "DomainType",
+            "modelAsString": true
+          }
+        },
+        "exportable": {
+          "description": "Indicating if the domain is exportable.",
+          "type": "boolean",
+          "readOnly": true,
+          "x-nullable": false
+        },
+        "enabled": {
+          "description": "Indicating if the domain is enabled.",
+          "type": "boolean",
+          "readOnly": true,
+          "x-nullable": false
+        },
+        "exportablePlatforms": {
+          "description": "Platforms that the domain can be exported to.",
+          "type": "array",
+          "items": {
+            "enum": [
+              "CoreML",
+              "TensorFlow",
+              "DockerFile",
+              "ONNX",
+              "VAIDK",
+              "OpenVino"
+            ],
+            "type": "string",
+            "x-nullable": false
+          },
+          "readOnly": true
+        },
+        "modelInformation": {
+          "$ref": "#/definitions/ModelInformation",
+          "description": "Model information.",
+          "readOnly": true
+        }
+      }
+    },
+    "Export": {
+      "type": "object",
+      "properties": {
+        "platform": {
+          "description": "Platform of the export.",
+          "enum": [
+            "CoreML",
+            "TensorFlow",
+            "DockerFile",
+            "ONNX",
+            "VAIDK",
+            "OpenVino"
+          ],
+          "type": "string",
+          "readOnly": true,
+          "x-nullable": false,
+          "x-ms-enum": {
+            "name": "ExportPlatform",
+            "modelAsString": true
+          }
+        },
+        "status": {
+          "description": "Status of the export.",
+          "enum": [
+            "Exporting",
+            "Failed",
+            "Done"
+          ],
+          "type": "string",
+          "readOnly": true,
+          "x-nullable": false,
+          "x-ms-enum": {
+            "name": "ExportStatus",
+            "modelAsString": true
+          }
+        },
+        "downloadUri": {
+          "description": "URI used to download the model. If VNET feature is enabled this will be a relative path to be used with GetArtifact, otherwise this will be an absolute URI to the resource.",
+          "type": "string",
+          "readOnly": true
+        },
+        "flavor": {
+          "description": "Flavor of the export. These are specializations of the export platform.\r\nDocker platform has valid flavors: Linux, Windows, ARM.\r\nTensorflow platform has valid flavors: TensorFlowNormal, TensorFlowLite.\r\nONNX platform has valid flavors: ONNX10, ONNX12.",
+          "enum": [
+            "Linux",
+            "Windows",
+            "ONNX10",
+            "ONNX12",
+            "ARM",
+            "TensorFlowNormal",
+            "TensorFlowLite"
+          ],
+          "type": "string",
+          "readOnly": true,
+          "x-nullable": true,
+          "x-ms-enum": {
+            "name": "ExportFlavor",
+            "modelAsString": true
+          }
+        },
+        "newerVersionAvailable": {
+          "description": "Indicates an updated version of the export package is available and should be re-exported for the latest changes.",
+          "type": "boolean",
+          "readOnly": true,
+          "x-nullable": false
+        }
+      }
+    },
+    "Image": {
+      "description": "Image model to be sent as JSON.",
+      "type": "object",
+      "properties": {
+        "id": {
+          "format": "uuid",
+          "description": "Id of the image.",
+          "type": "string",
+          "readOnly": true,
+          "example": "00000000-0000-0000-0000-000000000000",
+          "x-nullable": false
+        },
+        "created": {
+          "format": "date-time",
+          "description": "Date the image was created.",
+          "type": "string",
+          "readOnly": true,
+          "x-nullable": false
+        },
+        "width": {
+          "format": "int32",
+          "description": "Width of the image.",
+          "type": "integer",
+          "readOnly": true,
+          "x-nullable": false
+        },
+        "height": {
+          "format": "int32",
+          "description": "Height of the image.",
+          "type": "integer",
+          "readOnly": true,
+          "x-nullable": false
+        },
+        "resizedImageUri": {
+          "description": "The URI to the (resized) image used for training. If VNET feature is enabled this will be a relative path to be used with GetArtifact, otherwise this will be an absolute URI to the resource.",
+          "type": "string",
+          "readOnly": true
+        },
+        "thumbnailUri": {
+          "description": "The URI to the thumbnail of the original image. If VNET feature is enabled this will be a relative path to be used with GetArtifact, otherwise this will be an absolute URI to the resource.",
+          "type": "string",
+          "readOnly": true
+        },
+        "originalImageUri": {
+          "description": "The URI to the original uploaded image. If VNET feature is enabled this will be a relative path to be used with GetArtifact, otherwise this will be an absolute URI to the resource.",
+          "type": "string",
+          "readOnly": true
+        },
+        "tags": {
+          "description": "Tags associated with this image.",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/ImageTag"
+          },
+          "readOnly": true,
+          "x-nullable": true
+        },
+        "regions": {
+          "description": "Regions associated with this image.",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/ImageRegion"
+          },
+          "readOnly": true,
+          "x-nullable": true
+        },
+        "metadata": {
+          "description": "Metadata associated with this image.",
+          "type": "object",
+          "additionalProperties": {
+            "type": "string"
+          },
+          "readOnly": true,
+          "x-nullable": true
+        }
+      }
+    },
+    "ImageCreateResult": {
+      "type": "object",
+      "properties": {
+        "sourceUrl": {
+          "description": "Source URL of the image.",
+          "type": "string",
+          "readOnly": true,
+          "x-nullable": false
+        },
+        "status": {
+          "description": "Status of the image creation.",
+          "enum": [
+            "OK",
+            "OKDuplicate",
+            "ErrorSource",
+            "ErrorImageFormat",
+            "ErrorImageSize",
+            "ErrorStorage",
+            "ErrorLimitExceed",
+            "ErrorTagLimitExceed",
+            "ErrorRegionLimitExceed",
+            "ErrorUnknown",
+            "ErrorNegativeAndRegularTagOnSameImage",
+            "ErrorImageDimensions",
+            "ErrorInvalidTag"
+          ],
+          "type": "string",
+          "readOnly": true,
+          "x-nullable": false,
+          "x-ms-enum": {
+            "name": "ImageCreateStatus",
+            "modelAsString": true
+          }
+        },
+        "image": {
+          "$ref": "#/definitions/Image",
+          "description": "The image.",
+          "readOnly": true
+        }
+      }
+    },
+    "ImageCreateSummary": {
+      "type": "object",
+      "properties": {
+        "isBatchSuccessful": {
+          "description": "True if all of the images in the batch were created successfully, otherwise false.",
+          "type": "boolean",
+          "readOnly": true,
+          "x-nullable": false
+        },
+        "images": {
+          "description": "List of the image creation results.",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/ImageCreateResult",
+            "x-nullable": false
+          },
+          "readOnly": true
+        }
+      }
+    },
+    "ImageFileCreateBatch": {
+      "type": "object",
+      "properties": {
+        "images": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/ImageFileCreateEntry",
+            "x-nullable": false
+          },
+          "readOnly": false
+        },
+        "tagIds": {
+          "type": "array",
+          "items": {
+            "format": "uuid",
+            "type": "string",
+            "example": "00000000-0000-0000-0000-000000000000",
+            "x-nullable": false
+          },
+          "readOnly": false
+        },
+        "metadata": {
+          "description": "The metadata of image. Limited to 10 key-value pairs per image. The length of key is limited to 128. The length of value is limited to 256.",
+          "type": "object",
+          "additionalProperties": {
+            "type": "string"
+          },
+          "readOnly": false,
+          "x-nullable": true
+        }
+      }
+    },
+    "ImageFileCreateEntry": {
+      "type": "object",
+      "properties": {
+        "name": {
+          "type": "string",
+          "readOnly": false,
+          "x-nullable": false
+        },
+        "contents": {
+          "format": "byte",
+          "type": "string",
+          "readOnly": false
+        },
+        "tagIds": {
+          "type": "array",
+          "items": {
+            "format": "uuid",
+            "type": "string",
+            "example": "00000000-0000-0000-0000-000000000000",
+            "x-nullable": false
+          },
+          "readOnly": false
+        },
+        "regions": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/Region",
+            "x-nullable": false
+          },
+          "readOnly": false
+        }
+      }
+    },
+    "ImageIdCreateBatch": {
+      "type": "object",
+      "properties": {
+        "images": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/ImageIdCreateEntry",
+            "x-nullable": false
+          },
+          "readOnly": false
+        },
+        "tagIds": {
+          "type": "array",
+          "items": {
+            "format": "uuid",
+            "type": "string",
+            "x-nullable": false
+          },
+          "readOnly": false
+        },
+        "metadata": {
+          "description": "The metadata of image. Limited to 10 key-value pairs per image. The length of key is limited to 128. The length of value is limited to 256.",
+          "type": "object",
+          "additionalProperties": {
+            "type": "string"
+          },
+          "readOnly": false,
+          "x-nullable": true
+        }
+      }
+    },
+    "ImageIdCreateEntry": {
+      "type": "object",
+      "properties": {
+        "id": {
+          "format": "uuid",
+          "description": "Id of the image.",
+          "type": "string",
+          "readOnly": false,
+          "x-nullable": false
+        },
+        "tagIds": {
+          "type": "array",
+          "items": {
+            "format": "uuid",
+            "type": "string",
+            "x-nullable": false
+          },
+          "readOnly": false
+        },
+        "regions": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/Region",
+            "x-nullable": false
+          },
+          "readOnly": false
+        }
+      }
+    },
+    "ImageMetadataUpdateEntry": {
+      "description": "Entry associating a metadata to an image.",
+      "type": "object",
+      "properties": {
+        "imageId": {
+          "format": "uuid",
+          "description": "Id of the image.",
+          "type": "string",
+          "readOnly": false,
+          "x-nullable": false
+        },
+        "status": {
+          "description": "Status of the metadata update.",
+          "enum": [
+            "OK",
+            "ErrorImageNotFound",
+            "ErrorLimitExceed",
+            "ErrorUnknown"
+          ],
+          "type": "string",
+          "readOnly": false,
+          "x-nullable": false,
+          "x-ms-enum": {
+            "name": "ImageMetadataUpdateStatus",
+            "modelAsString": true
+          }
+        },
+        "metadata": {
+          "description": "Metadata of the image.",
+          "type": "object",
+          "additionalProperties": {
+            "type": "string"
+          },
+          "readOnly": false,
+          "x-nullable": true
+        }
+      }
+    },
+    "ImageMetadataUpdateSummary": {
+      "type": "object",
+      "properties": {
+        "isBatchSuccessful": {
+          "type": "boolean",
+          "readOnly": true,
+          "x-nullable": false
+        },
+        "images": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/ImageMetadataUpdateEntry",
+            "x-nullable": false
+          },
+          "readOnly": true
+        }
+      }
+    },
+    "ImagePerformance": {
+      "description": "Image performance model.",
+      "type": "object",
+      "properties": {
+        "predictions": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/Prediction"
+          },
+          "readOnly": true,
+          "x-nullable": true
+        },
+        "id": {
+          "format": "uuid",
+          "description": "Id of the image.",
+          "type": "string",
+          "readOnly": true,
+          "x-nullable": false
+        },
+        "created": {
+          "format": "date-time",
+          "description": "Date the image was created.",
+          "type": "string",
+          "readOnly": true,
+          "x-nullable": false
+        },
+        "width": {
+          "format": "int32",
+          "description": "Width of the image.",
+          "type": "integer",
+          "readOnly": true,
+          "x-nullable": false
+        },
+        "height": {
+          "format": "int32",
+          "description": "Height of the image.",
+          "type": "integer",
+          "readOnly": true,
+          "x-nullable": false
+        },
+        "imageUri": {
+          "description": "The URI to the image used for training. If VNET feature is enabled this will be a relative path to be used with GetArtifact, otherwise this will be an absolute URI to the resource.",
+          "type": "string",
+          "readOnly": true
+        },
+        "thumbnailUri": {
+          "description": "The URI to the thumbnail of the original image. If VNET feature is enabled this will be a relative path to be used with GetArtifact, otherwise this will be an absolute URI to the resource.",
+          "type": "string",
+          "readOnly": true
+        },
+        "tags": {
+          "description": "Tags associated with this image.",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/ImageTag"
+          },
+          "readOnly": true,
+          "x-nullable": true
+        },
+        "regions": {
+          "description": "Regions associated with this image.",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/ImageRegion"
+          },
+          "readOnly": true,
+          "x-nullable": true
+        }
+      }
+    },
+    "ImagePrediction": {
+      "description": "Result of an image prediction request.",
+      "type": "object",
+      "properties": {
+        "id": {
+          "format": "uuid",
+          "description": "Prediction Id.",
+          "type": "string",
+          "readOnly": true,
+          "x-nullable": false
+        },
+        "project": {
+          "format": "uuid",
+          "description": "Project Id.",
+          "type": "string",
+          "readOnly": true,
+          "x-nullable": false
+        },
+        "iteration": {
+          "format": "uuid",
+          "description": "Iteration Id.",
+          "type": "string",
+          "readOnly": true,
+          "x-nullable": false
+        },
+        "created": {
+          "format": "date-time",
+          "description": "Date this prediction was created.",
+          "type": "string",
+          "readOnly": true,
+          "x-nullable": false
+        },
+        "predictions": {
+          "description": "List of predictions.",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/Prediction",
+            "x-nullable": false
+          },
+          "readOnly": true
+        }
+      }
+    },
+    "ImageProcessingSettings": {
+      "description": "Represents image preprocessing settings used by image augmentation.",
+      "type": "object",
+      "properties": {
+        "augmentationMethods": {
+          "description": "Gets or sets enabled image transforms. The key corresponds to the transform name. If value is set to true, then correspondent transform is enabled. Otherwise this transform will not be used.\r\nAugmentation will be uniformly distributed among enabled transforms.",
+          "type": "object",
+          "additionalProperties": {
+            "type": "boolean"
+          },
+          "readOnly": false,
+          "x-nullable": true
+        }
+      }
+    },
+    "ImageRegion": {
+      "required": [
+        "tagId",
+        "left",
+        "top",
+        "width",
+        "height"
+      ],
+      "type": "object",
+      "properties": {
+        "regionId": {
+          "format": "uuid",
+          "type": "string",
+          "readOnly": true,
+          "x-nullable": false
+        },
+        "tagName": {
+          "type": "string",
+          "readOnly": true,
+          "x-nullable": false
+        },
+        "created": {
+          "format": "date-time",
+          "type": "string",
+          "readOnly": true,
+          "x-nullable": false
+        },
+        "tagId": {
+          "format": "uuid",
+          "description": "Id of the tag associated with this region.",
+          "type": "string",
+          "readOnly": false,
+          "x-nullable": false
+        },
+        "left": {
+          "format": "float",
+          "description": "Coordinate of the left boundary.",
+          "type": "number",
+          "readOnly": false,
+          "x-nullable": false
+        },
+        "top": {
+          "format": "float",
+          "description": "Coordinate of the top boundary.",
+          "type": "number",
+          "readOnly": false,
+          "x-nullable": false
+        },
+        "width": {
+          "format": "float",
+          "description": "Width.",
+          "type": "number",
+          "readOnly": false,
+          "x-nullable": false
+        },
+        "height": {
+          "format": "float",
+          "description": "Height.",
+          "type": "number",
+          "readOnly": false,
+          "x-nullable": false
+        }
+      }
+    },
+    "ImageRegionCreateBatch": {
+      "description": "Batch of image region information to create.",
+      "type": "object",
+      "properties": {
+        "regions": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/ImageRegionCreateEntry",
+            "x-nullable": false
+          },
+          "readOnly": false
+        }
+      }
+    },
+    "ImageRegionCreateEntry": {
+      "description": "Entry associating a region to an image.",
+      "required": [
+        "imageId",
+        "tagId",
+        "left",
+        "top",
+        "width",
+        "height"
+      ],
+      "type": "object",
+      "properties": {
+        "imageId": {
+          "format": "uuid",
+          "description": "Id of the image.",
+          "type": "string",
+          "readOnly": false,
+          "x-nullable": false
+        },
+        "tagId": {
+          "format": "uuid",
+          "description": "Id of the tag associated with this region.",
+          "type": "string",
+          "readOnly": false,
+          "x-nullable": false
+        },
+        "left": {
+          "format": "float",
+          "description": "Coordinate of the left boundary.",
+          "type": "number",
+          "readOnly": false,
+          "x-nullable": false
+        },
+        "top": {
+          "format": "float",
+          "description": "Coordinate of the top boundary.",
+          "type": "number",
+          "readOnly": false,
+          "x-nullable": false
+        },
+        "width": {
+          "format": "float",
+          "description": "Width.",
+          "type": "number",
+          "readOnly": false,
+          "x-nullable": false
+        },
+        "height": {
+          "format": "float",
+          "description": "Height.",
+          "type": "number",
+          "readOnly": false,
+          "x-nullable": false
+        }
+      }
+    },
+    "ImageRegionCreateResult": {
+      "required": [
+        "tagId",
+        "left",
+        "top",
+        "width",
+        "height"
+      ],
+      "type": "object",
+      "properties": {
+        "imageId": {
+          "format": "uuid",
+          "type": "string",
+          "readOnly": true,
+          "x-nullable": false
+        },
+        "regionId": {
+          "format": "uuid",
+          "type": "string",
+          "readOnly": true,
+          "x-nullable": false
+        },
+        "tagName": {
+          "type": "string",
+          "readOnly": true,
+          "x-nullable": false
+        },
+        "created": {
+          "format": "date-time",
+          "type": "string",
+          "readOnly": true,
+          "x-nullable": false
+        },
+        "tagId": {
+          "format": "uuid",
+          "description": "Id of the tag associated with this region.",
+          "type": "string",
+          "readOnly": false,
+          "x-nullable": false
+        },
+        "left": {
+          "format": "float",
+          "description": "Coordinate of the left boundary.",
+          "type": "number",
+          "readOnly": false,
+          "x-nullable": false
+        },
+        "top": {
+          "format": "float",
+          "description": "Coordinate of the top boundary.",
+          "type": "number",
+          "readOnly": false,
+          "x-nullable": false
+        },
+        "width": {
+          "format": "float",
+          "description": "Width.",
+          "type": "number",
+          "readOnly": false,
+          "x-nullable": false
+        },
+        "height": {
+          "format": "float",
+          "description": "Height.",
+          "type": "number",
+          "readOnly": false,
+          "x-nullable": false
+        }
+      }
+    },
+    "ImageRegionCreateSummary": {
+      "type": "object",
+      "properties": {
+        "created": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/ImageRegionCreateResult"
+          },
+          "readOnly": false,
+          "x-nullable": true
+        },
+        "duplicated": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/ImageRegionCreateEntry"
+          },
+          "readOnly": false,
+          "x-nullable": true
+        },
+        "exceeded": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/ImageRegionCreateEntry"
+          },
+          "readOnly": false,
+          "x-nullable": true
+        }
+      }
+    },
+    "ImageRegionProposal": {
+      "type": "object",
+      "properties": {
+        "projectId": {
+          "format": "uuid",
+          "type": "string",
+          "readOnly": true,
+          "x-nullable": false
+        },
+        "imageId": {
+          "format": "uuid",
+          "type": "string",
+          "readOnly": true,
+          "x-nullable": false
+        },
+        "proposals": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/RegionProposal",
+            "x-nullable": false
+          },
+          "readOnly": true
+        }
+      }
+    },
+    "ImageTag": {
+      "type": "object",
+      "properties": {
+        "tagId": {
+          "format": "uuid",
+          "type": "string",
+          "readOnly": true,
+          "x-nullable": false
+        },
+        "tagName": {
+          "type": "string",
+          "readOnly": true,
+          "x-nullable": false
+        },
+        "created": {
+          "format": "date-time",
+          "type": "string",
+          "readOnly": true,
+          "x-nullable": false
+        }
+      }
+    },
+    "ImageTagCreateBatch": {
+      "description": "Batch of image tags.",
+      "type": "object",
+      "properties": {
+        "tags": {
+          "description": "Image Tag entries to include in this batch.",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/ImageTagCreateEntry",
+            "x-nullable": false
+          },
+          "readOnly": false
+        }
+      }
+    },
+    "ImageTagCreateEntry": {
+      "description": "Entry associating a tag to an image.",
+      "type": "object",
+      "properties": {
+        "imageId": {
+          "format": "uuid",
+          "description": "Id of the image.",
+          "type": "string",
+          "readOnly": false,
+          "x-nullable": false
+        },
+        "tagId": {
+          "format": "uuid",
+          "description": "Id of the tag.",
+          "type": "string",
+          "readOnly": false,
+          "x-nullable": false
+        }
+      }
+    },
+    "ImageTagCreateSummary": {
+      "type": "object",
+      "properties": {
+        "created": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/ImageTagCreateEntry"
+          },
+          "readOnly": false,
+          "x-nullable": true
+        },
+        "duplicated": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/ImageTagCreateEntry"
+          },
+          "readOnly": false,
+          "x-nullable": true
+        },
+        "exceeded": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/ImageTagCreateEntry"
+          },
+          "readOnly": false,
+          "x-nullable": true
+        }
+      }
+    },
+    "ImageUrl": {
+      "description": "Image url.",
+      "required": [
+        "url"
+      ],
+      "type": "object",
+      "properties": {
+        "url": {
+          "description": "Url of the image.",
+          "type": "string",
+          "readOnly": false,
+          "x-nullable": false
+        }
+      }
+    },
+    "ImageUrlCreateBatch": {
+      "type": "object",
+      "properties": {
+        "images": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/ImageUrlCreateEntry",
+            "x-nullable": false
+          },
+          "readOnly": false
+        },
+        "tagIds": {
+          "type": "array",
+          "items": {
+            "format": "uuid",
+            "type": "string",
+            "x-nullable": false
+          },
+          "readOnly": false
+        },
+        "metadata": {
+          "description": "The metadata of image. Limited to 10 key-value pairs per image. The length of key is limited to 128. The length of value is limited to 256.",
+          "type": "object",
+          "additionalProperties": {
+            "type": "string"
+          },
+          "readOnly": false,
+          "x-nullable": true
+        }
+      }
+    },
+    "ImageUrlCreateEntry": {
+      "required": [
+        "url"
+      ],
+      "type": "object",
+      "properties": {
+        "url": {
+          "description": "Url of the image.",
+          "type": "string",
+          "readOnly": false,
+          "x-nullable": false
+        },
+        "tagIds": {
+          "type": "array",
+          "items": {
+            "format": "uuid",
+            "type": "string",
+            "x-nullable": false
+          },
+          "readOnly": false
+        },
+        "regions": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/Region",
+            "x-nullable": false
+          },
+          "readOnly": false
+        }
+      }
+    },
+    "Iteration": {
+      "description": "Iteration model to be sent over JSON.",
+      "required": [
+        "name"
+      ],
+      "type": "object",
+      "properties": {
+        "id": {
+          "format": "uuid",
+          "description": "Gets the id of the iteration.",
+          "type": "string",
+          "readOnly": true,
+          "x-nullable": false
+        },
+        "name": {
+          "description": "Gets or sets the name of the iteration.",
+          "type": "string",
+          "readOnly": false,
+          "x-nullable": false
+        },
+        "status": {
+          "description": "Gets the current iteration status.",
+          "type": "string",
+          "readOnly": true,
+          "x-nullable": false
+        },
+        "created": {
+          "format": "date-time",
+          "description": "Gets the time this iteration was completed.",
+          "type": "string",
+          "readOnly": true,
+          "x-nullable": false
+        },
+        "lastModified": {
+          "format": "date-time",
+          "description": "Gets the time this iteration was last modified.",
+          "type": "string",
+          "readOnly": true,
+          "x-nullable": false
+        },
+        "trainedAt": {
+          "format": "date-time",
+          "description": "Gets the time this iteration was last modified.",
+          "type": "string",
+          "readOnly": true,
+          "x-nullable": true
+        },
+        "projectId": {
+          "format": "uuid",
+          "description": "Gets the project id of the iteration.",
+          "type": "string",
+          "readOnly": true,
+          "x-nullable": false
+        },
+        "exportable": {
+          "description": "Whether the iteration can be exported to another format for download.",
+          "type": "boolean",
+          "readOnly": true,
+          "x-nullable": false
+        },
+        "exportableTo": {
+          "description": "A set of platforms this iteration can export to.",
+          "type": "array",
+          "items": {
+            "enum": [
+              "CoreML",
+              "TensorFlow",
+              "DockerFile",
+              "ONNX",
+              "VAIDK",
+              "OpenVino"
+            ],
+            "type": "string",
+            "x-nullable": false
+          },
+          "readOnly": true
+        },
+        "domainId": {
+          "format": "uuid",
+          "description": "Get or sets a guid of the domain the iteration has been trained on.",
+          "type": "string",
+          "readOnly": true,
+          "x-nullable": true
+        },
+        "classificationType": {
+          "description": "Gets the classification type of the project.",
+          "enum": [
+            "Multiclass",
+            "Multilabel"
+          ],
+          "type": "string",
+          "readOnly": true,
+          "x-nullable": true,
+          "x-ms-enum": {
+            "name": "Classifier",
+            "modelAsString": true
+          }
+        },
+        "trainingType": {
+          "description": "Gets the training type of the iteration.",
+          "enum": [
+            "Regular",
+            "Advanced"
+          ],
+          "type": "string",
+          "readOnly": true,
+          "x-nullable": false,
+          "x-ms-enum": {
+            "name": "TrainingType",
+            "modelAsString": true
+          }
+        },
+        "reservedBudgetInHours": {
+          "format": "int32",
+          "description": "Gets the reserved advanced training budget for the iteration.",
+          "type": "integer",
+          "readOnly": true,
+          "x-nullable": false
+        },
+        "trainingTimeInMinutes": {
+          "format": "int32",
+          "description": "Gets the training time for the iteration.",
+          "type": "integer",
+          "readOnly": true,
+          "x-nullable": false
+        },
+        "publishName": {
+          "description": "Name of the published model.",
+          "type": "string",
+          "readOnly": true,
+          "x-nullable": false
+        },
+        "originalPublishResourceId": {
+          "description": "Resource Provider Id this iteration was originally published to.",
+          "type": "string",
+          "readOnly": true,
+          "x-nullable": false
+        },
+        "customBaseModelInfo": {
+          "$ref": "#/definitions/CustomBaseModelInfo",
+          "description": "Information of the previously trained iteration which provides the base model for current iteration's training.\r\nDefault value of null specifies that no previously trained iteration will be used for incremental learning.",
+          "readOnly": true
+        },
+        "trainingErrorDetails": {
+          "description": "Training error details, when training fails.\r\nValue is null when training succeeds.",
+          "type": "string",
+          "readOnly": true
+        }
+      }
+    },
+    "IterationPerformance": {
+      "description": "Represents the detailed performance data for a trained iteration.",
+      "type": "object",
+      "properties": {
+        "perTagPerformance": {
+          "description": "Gets the per-tag performance details for this iteration.",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/TagPerformance",
+            "x-nullable": false
+          },
+          "readOnly": true
+        },
+        "precision": {
+          "format": "float",
+          "description": "Gets the precision.",
+          "type": "number",
+          "readOnly": true,
+          "x-nullable": false
+        },
+        "precisionStdDeviation": {
+          "format": "float",
+          "description": "Gets the standard deviation for the precision.",
+          "type": "number",
+          "readOnly": true,
+          "x-nullable": false
+        },
+        "recall": {
+          "format": "float",
+          "description": "Gets the recall.",
+          "type": "number",
+          "readOnly": true,
+          "x-nullable": false
+        },
+        "recallStdDeviation": {
+          "format": "float",
+          "description": "Gets the standard deviation for the recall.",
+          "type": "number",
+          "readOnly": true,
+          "x-nullable": false
+        },
+        "averagePrecision": {
+          "format": "float",
+          "description": "Gets the average precision when applicable.",
+          "type": "number",
+          "readOnly": true,
+          "x-nullable": true
+        }
+      }
+    },
+    "ModelInformation": {
+      "description": "Model information.",
+      "required": [
+        "description"
+      ],
+      "type": "object",
+      "properties": {
+        "estimatedModelSizeInMegabytes": {
+          "format": "int32",
+          "description": "Estimation of the exported FP32 Onnx model size (2 tags) in megabytes. This information is not present if the model cannot be exported.",
+          "type": "integer",
+          "readOnly": false
+        },
+        "description": {
+          "description": "Model description.",
+          "type": "string",
+          "readOnly": false,
+          "x-nullable": false
+        }
+      }
+    },
+    "Prediction": {
+      "description": "Prediction result.",
+      "type": "object",
+      "properties": {
+        "probability": {
+          "format": "float",
+          "description": "Probability of the tag.",
+          "type": "number",
+          "readOnly": true,
+          "x-nullable": false
+        },
+        "tagId": {
+          "format": "uuid",
+          "description": "Id of the predicted tag.",
+          "type": "string",
+          "readOnly": true,
+          "x-nullable": false
+        },
+        "tagName": {
+          "description": "Name of the predicted tag.",
+          "type": "string",
+          "readOnly": true,
+          "x-nullable": true
+        },
+        "boundingBox": {
+          "$ref": "#/definitions/BoundingBox",
+          "description": "Bounding box of the prediction.",
+          "readOnly": true,
+          "x-nullable": true
+        },
+        "tagType": {
+          "description": "Type of the predicted tag.",
+          "enum": [
+            "Regular",
+            "Negative",
+            "GeneralProduct"
+          ],
+          "type": "string",
+          "readOnly": true,
+          "x-nullable": true,
+          "x-ms-enum": {
+            "name": "TagType",
+            "modelAsString": true
+          }
+        }
+      }
+    },
+    "PredictionQueryResult": {
+      "description": "Query result of the prediction images that were sent to your prediction endpoint.",
+      "type": "object",
+      "properties": {
+        "token": {
+          "$ref": "#/definitions/PredictionQueryToken",
+          "description": "Prediction Query Token.",
+          "readOnly": false
+        },
+        "results": {
+          "description": "Result of an image prediction request.",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/StoredImagePrediction",
+            "x-nullable": false
+          },
+          "readOnly": true
+        }
+      }
+    },
+    "PredictionQueryTag": {
+      "type": "object",
+      "properties": {
+        "id": {
+          "format": "uuid",
+          "type": "string",
+          "readOnly": false,
+          "x-nullable": false
+        },
+        "minThreshold": {
+          "format": "float",
+          "type": "number",
+          "readOnly": false,
+          "x-nullable": false
+        },
+        "maxThreshold": {
+          "format": "float",
+          "type": "number",
+          "readOnly": false,
+          "x-nullable": false
+        }
+      }
+    },
+    "PredictionQueryToken": {
+      "type": "object",
+      "properties": {
+        "session": {
+          "type": "string",
+          "readOnly": false,
+          "x-nullable": false
+        },
+        "continuation": {
+          "type": "string",
+          "readOnly": false,
+          "x-nullable": false
+        },
+        "maxCount": {
+          "format": "int32",
+          "type": "integer",
+          "readOnly": false,
+          "x-nullable": false
+        },
+        "orderBy": {
+          "enum": [
+            "Newest",
+            "Oldest",
+            "Suggested"
+          ],
+          "type": "string",
+          "readOnly": false,
+          "x-nullable": false,
+          "x-ms-enum": {
+            "name": "OrderBy",
+            "modelAsString": true
+          }
+        },
+        "tags": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/PredictionQueryTag",
+            "x-nullable": false
+          },
+          "readOnly": false
+        },
+        "iterationId": {
+          "format": "uuid",
+          "type": "string",
+          "readOnly": false,
+          "x-nullable": true
+        },
+        "startTime": {
+          "format": "date-time",
+          "type": "string",
+          "readOnly": false,
+          "x-nullable": true
+        },
+        "endTime": {
+          "format": "date-time",
+          "type": "string",
+          "readOnly": false,
+          "x-nullable": true
+        },
+        "application": {
+          "type": "string",
+          "readOnly": false,
+          "x-nullable": false
+        }
+      }
+    },
+    "Project": {
+      "description": "Represents a project.",
+      "required": [
+        "name",
+        "description",
+        "settings"
+      ],
+      "type": "object",
+      "properties": {
+        "id": {
+          "format": "uuid",
+          "description": "Gets the project id.",
+          "type": "string",
+          "readOnly": true,
+          "x-nullable": false
+        },
+        "name": {
+          "description": "Gets or sets the name of the project.",
+          "type": "string",
+          "readOnly": false,
+          "x-nullable": false
+        },
+        "description": {
+          "description": "Gets or sets the description of the project.",
+          "type": "string",
+          "readOnly": false,
+          "x-nullable": true
+        },
+        "settings": {
+          "$ref": "#/definitions/ProjectSettings",
+          "description": "Gets or sets the project settings.",
+          "readOnly": false
+        },
+        "created": {
+          "format": "date-time",
+          "description": "Gets the date this project was created.",
+          "type": "string",
+          "readOnly": true,
+          "x-nullable": false
+        },
+        "lastModified": {
+          "format": "date-time",
+          "description": "Gets the date this project was last modified.",
+          "type": "string",
+          "readOnly": true,
+          "x-nullable": false
+        },
+        "thumbnailUri": {
+          "description": "Gets the thumbnail url representing the image. If VNET feature is enabled this will be a relative path to be used with GetArtifact, otherwise this will be an absolute URI to the resource.",
+          "type": "string",
+          "readOnly": true
+        },
+        "drModeEnabled": {
+          "description": "Gets if the Disaster Recovery (DR) mode is on, indicating the project is temporarily read-only.",
+          "type": "boolean",
+          "readOnly": true,
+          "x-nullable": true
+        },
+        "status": {
+          "description": "Gets the status of the project.",
+          "enum": [
+            "Succeeded",
+            "Importing",
+            "Failed"
+          ],
+          "type": "string",
+          "readOnly": false,
+          "x-nullable": false,
+          "x-ms-enum": {
+            "name": "ProjectStatus",
+            "modelAsString": true
+          }
+        }
+      }
+    },
+    "ProjectExport": {
+      "description": "Represents information about a project export.",
+      "type": "object",
+      "properties": {
+        "iterationCount": {
+          "format": "int32",
+          "description": "Count of iterations that will be exported.",
+          "type": "integer",
+          "readOnly": true,
+          "x-nullable": false
+        },
+        "imageCount": {
+          "format": "int32",
+          "description": "Count of images that will be exported.",
+          "type": "integer",
+          "readOnly": true,
+          "x-nullable": false
+        },
+        "tagCount": {
+          "format": "int32",
+          "description": "Count of tags that will be exported.",
+          "type": "integer",
+          "readOnly": true,
+          "x-nullable": false
+        },
+        "regionCount": {
+          "format": "int32",
+          "description": "Count of regions that will be exported.",
+          "type": "integer",
+          "readOnly": true,
+          "x-nullable": false
+        },
+        "estimatedImportTimeInMS": {
+          "format": "int32",
+          "description": "Estimated time this project will take to import, can change based on network connectivity and load between\r\nsource and destination regions.",
+          "type": "integer",
+          "readOnly": true,
+          "x-nullable": false
+        },
+        "token": {
+          "description": "Opaque token that should be passed to ImportProject to perform the import. This token grants access to import this\r\nproject to all that have the token.",
+          "type": "string",
+          "readOnly": true,
+          "x-nullable": false
+        }
+      }
+    },
+    "ProjectSettings": {
+      "description": "Represents settings associated with a project.",
+      "type": "object",
+      "properties": {
+        "domainId": {
+          "format": "uuid",
+          "description": "Gets or sets the id of the Domain to use with this project.",
+          "type": "string",
+          "readOnly": false,
+          "x-nullable": false
+        },
+        "classificationType": {
+          "description": "Gets or sets the classification type of the project.",
+          "enum": [
+            "Multiclass",
+            "Multilabel"
+          ],
+          "type": "string",
+          "readOnly": false,
+          "x-nullable": true,
+          "x-ms-enum": {
+            "name": "Classifier",
+            "modelAsString": true
+          }
+        },
+        "targetExportPlatforms": {
+          "description": "A list of ExportPlatform that the trained model should be able to support.",
+          "type": "array",
+          "items": {
+            "enum": [
+              "CoreML",
+              "TensorFlow",
+              "DockerFile",
+              "ONNX",
+              "VAIDK",
+              "OpenVino"
+            ],
+            "type": "string",
+            "x-nullable": false
+          },
+          "readOnly": false
+        },
+        "useNegativeSet": {
+          "description": "Indicates if negative set is being used.",
+          "type": "boolean",
+          "readOnly": true,
+          "x-nullable": true
+        },
+        "detectionParameters": {
+          "description": "Detection parameters in use, if any.",
+          "type": "string",
+          "readOnly": true,
+          "x-nullable": false
+        },
+        "imageProcessingSettings": {
+          "$ref": "#/definitions/ImageProcessingSettings",
+          "description": "Gets or sets image preprocessing settings.",
+          "readOnly": false
+        },
+        "exportModelContainerUri": {
+          "description": "The uri to the Azure Storage container that will be used to store exported models.",
+          "type": "string",
+          "readOnly": true,
+          "x-nullable": true
+        },
+        "notificationQueueUri": {
+          "description": "The uri to the Azure Storage queue that will be used to send project-related notifications. See <a href=\"https://go.microsoft.com/fwlink/?linkid=2144149\">Storage notifications</a> documentation for setup and message format.",
+          "type": "string",
+          "readOnly": true,
+          "x-nullable": true
+        }
+      }
+    },
+    "Region": {
+      "required": [
+        "tagId",
+        "left",
+        "top",
+        "width",
+        "height"
+      ],
+      "type": "object",
+      "properties": {
+        "tagId": {
+          "format": "uuid",
+          "description": "Id of the tag associated with this region.",
+          "type": "string",
+          "readOnly": false,
+          "x-nullable": false
+        },
+        "left": {
+          "format": "float",
+          "description": "Coordinate of the left boundary.",
+          "type": "number",
+          "readOnly": false,
+          "x-nullable": false
+        },
+        "top": {
+          "format": "float",
+          "description": "Coordinate of the top boundary.",
+          "type": "number",
+          "readOnly": false,
+          "x-nullable": false
+        },
+        "width": {
+          "format": "float",
+          "description": "Width.",
+          "type": "number",
+          "readOnly": false,
+          "x-nullable": false
+        },
+        "height": {
+          "format": "float",
+          "description": "Height.",
+          "type": "number",
+          "readOnly": false,
+          "x-nullable": false
+        }
+      }
+    },
+    "RegionProposal": {
+      "type": "object",
+      "properties": {
+        "confidence": {
+          "format": "float",
+          "type": "number",
+          "readOnly": true,
+          "x-nullable": false
+        },
+        "boundingBox": {
+          "$ref": "#/definitions/BoundingBox",
+          "readOnly": true
+        }
+      }
+    },
+    "StoredImagePrediction": {
+      "description": "Result of an image prediction request.",
+      "type": "object",
+      "properties": {
+        "resizedImageUri": {
+          "description": "The URI to the (resized) prediction image. If VNET feature is enabled this will be a relative path to be used with GetArtifact, otherwise this will be an absolute URI to the resource.",
+          "type": "string",
+          "readOnly": true
+        },
+        "thumbnailUri": {
+          "description": "The URI to the thumbnail of the original prediction image. If VNET feature is enabled this will be a relative path to be used with GetArtifact, otherwise this will be an absolute URI to the resource.",
+          "type": "string",
+          "readOnly": true
+        },
+        "originalImageUri": {
+          "description": "The URI to the original prediction image. If VNET feature is enabled this will be a relative path to be used with GetArtifact, otherwise this will be an absolute URI to the resource.",
+          "type": "string",
+          "readOnly": true
+        },
+        "domain": {
+          "format": "uuid",
+          "description": "Domain used for the prediction.",
+          "type": "string",
+          "readOnly": true,
+          "x-nullable": false
+        },
+        "id": {
+          "format": "uuid",
+          "description": "Prediction Id.",
+          "type": "string",
+          "readOnly": true,
+          "x-nullable": false
+        },
+        "project": {
+          "format": "uuid",
+          "description": "Project Id.",
+          "type": "string",
+          "readOnly": true,
+          "x-nullable": false
+        },
+        "iteration": {
+          "format": "uuid",
+          "description": "Iteration Id.",
+          "type": "string",
+          "readOnly": true,
+          "x-nullable": false
+        },
+        "created": {
+          "format": "date-time",
+          "description": "Date this prediction was created.",
+          "type": "string",
+          "readOnly": true,
+          "x-nullable": false
+        },
+        "predictions": {
+          "description": "List of predictions.",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/Prediction",
+            "x-nullable": false
+          },
+          "readOnly": true
+        }
+      }
+    },
+    "StoredSuggestedTagAndRegion": {
+      "description": "Result of a suggested tags and regions request of the untagged image.",
+      "type": "object",
+      "properties": {
+        "width": {
+          "format": "int32",
+          "description": "Width of the resized image.",
+          "type": "integer",
+          "readOnly": true,
+          "x-nullable": false
+        },
+        "height": {
+          "format": "int32",
+          "description": "Height of the resized image.",
+          "type": "integer",
+          "readOnly": true,
+          "x-nullable": false
+        },
+        "resizedImageUri": {
+          "description": "The URI to the (resized) prediction image. If VNET feature is enabled this will be a relative path to be used with GetArtifact, otherwise this will be an absolute URI to the resource.",
+          "type": "string",
+          "readOnly": true
+        },
+        "thumbnailUri": {
+          "description": "The URI to the thumbnail of the original prediction image. If VNET feature is enabled this will be a relative path to be used with GetArtifact, otherwise this will be an absolute URI to the resource.",
+          "type": "string",
+          "readOnly": true
+        },
+        "originalImageUri": {
+          "description": "The URI to the original prediction image. If VNET feature is enabled this will be a relative path to be used with GetArtifact, otherwise this will be an absolute URI to the resource.",
+          "type": "string",
+          "readOnly": true
+        },
+        "domain": {
+          "format": "uuid",
+          "description": "Domain used for the prediction.",
+          "type": "string",
+          "readOnly": true,
+          "x-nullable": false
+        },
+        "id": {
+          "format": "uuid",
+          "description": "Prediction Id.",
+          "type": "string",
+          "readOnly": true,
+          "x-nullable": false
+        },
+        "project": {
+          "format": "uuid",
+          "description": "Project Id.",
+          "type": "string",
+          "readOnly": true,
+          "x-nullable": false
+        },
+        "iteration": {
+          "format": "uuid",
+          "description": "Iteration Id.",
+          "type": "string",
+          "readOnly": true,
+          "x-nullable": false
+        },
+        "created": {
+          "format": "date-time",
+          "description": "Date this prediction was created.",
+          "type": "string",
+          "readOnly": true,
+          "x-nullable": false
+        },
+        "predictions": {
+          "description": "List of predictions.",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/Prediction",
+            "x-nullable": false
+          },
+          "readOnly": true
+        },
+        "predictionUncertainty": {
+          "format": "double",
+          "description": "Uncertainty (entropy) of suggested tags or regions per image.",
+          "type": "number",
+          "readOnly": true,
+          "x-nullable": false
+        }
+      }
+    },
+    "SuggestedTagAndRegion": {
+      "description": "Result of a suggested tags and regions request.",
+      "type": "object",
+      "properties": {
+        "id": {
+          "format": "uuid",
+          "description": "Prediction Id.",
+          "type": "string",
+          "readOnly": true,
+          "x-nullable": false
+        },
+        "project": {
+          "format": "uuid",
+          "description": "Project Id.",
+          "type": "string",
+          "readOnly": true,
+          "x-nullable": false
+        },
+        "iteration": {
+          "format": "uuid",
+          "description": "Iteration Id.",
+          "type": "string",
+          "readOnly": true,
+          "x-nullable": false
+        },
+        "created": {
+          "format": "date-time",
+          "description": "Date this prediction was created.",
+          "type": "string",
+          "readOnly": true,
+          "x-nullable": false
+        },
+        "predictions": {
+          "description": "List of predictions.",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/Prediction",
+            "x-nullable": false
+          },
+          "readOnly": true
+        },
+        "predictionUncertainty": {
+          "format": "double",
+          "description": "Uncertainty (entropy) of suggested tags or regions per image.",
+          "type": "number",
+          "readOnly": true,
+          "x-nullable": false
+        }
+      }
+    },
+    "SuggestedTagAndRegionQuery": {
+      "description": "The array of result images and token containing session and continuation Ids for the next query.",
+      "type": "object",
+      "properties": {
+        "token": {
+          "$ref": "#/definitions/SuggestedTagAndRegionQueryToken",
+          "description": "Contains properties we need to fetch suggested tags for.",
+          "readOnly": false
+        },
+        "results": {
+          "description": "Result of a suggested tags and regions request of the untagged image.",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/StoredSuggestedTagAndRegion",
+            "x-nullable": false
+          },
+          "readOnly": true
+        }
+      }
+    },
+    "SuggestedTagAndRegionQueryToken": {
+      "description": "Contains properties we need to fetch suggested tags for. For the first call, Session and continuation set to null.\r\nThen on subsequent calls, uses the session/continuation from the previous SuggestedTagAndRegionQuery result to fetch additional results.",
+      "type": "object",
+      "properties": {
+        "tagIds": {
+          "description": "Existing TagIds in project to filter suggested tags on.",
+          "type": "array",
+          "items": {
+            "format": "uuid",
+            "type": "string",
+            "x-nullable": false
+          },
+          "readOnly": false
+        },
+        "threshold": {
+          "format": "double",
+          "description": "Confidence threshold to filter suggested tags on.",
+          "type": "number",
+          "readOnly": false,
+          "x-nullable": false
+        },
+        "session": {
+          "description": "SessionId for database query. Initially set to null but later used to paginate.",
+          "type": "string",
+          "readOnly": false,
+          "x-nullable": false
+        },
+        "continuation": {
+          "description": "Continuation Id for database pagination. Initially null but later used to paginate.",
+          "type": "string",
+          "readOnly": false,
+          "x-nullable": false
+        },
+        "maxCount": {
+          "format": "int32",
+          "description": "Maximum number of results you want to be returned in the response.",
+          "type": "integer",
+          "readOnly": false,
+          "x-nullable": false
+        },
+        "sortBy": {
+          "description": "OrderBy. Ordering mechanism for your results.",
+          "enum": [
+            "UncertaintyAscending",
+            "UncertaintyDescending"
+          ],
+          "type": "string",
+          "readOnly": false,
+          "x-nullable": false,
+          "x-ms-enum": {
+            "name": "SortBy",
+            "modelAsString": true
+          }
+        }
+      }
+    },
+    "Tag": {
+      "description": "Represents a Tag.",
+      "required": [
+        "name",
+        "description",
+        "type"
+      ],
+      "type": "object",
+      "properties": {
+        "id": {
+          "format": "uuid",
+          "description": "Gets the Tag ID.",
+          "type": "string",
+          "readOnly": true,
+          "x-nullable": false
+        },
+        "name": {
+          "description": "Gets or sets the name of the tag.",
+          "type": "string",
+          "readOnly": false,
+          "x-nullable": false
+        },
+        "description": {
+          "description": "Gets or sets the description of the tag.",
+          "type": "string",
+          "readOnly": false,
+          "x-nullable": true
+        },
+        "type": {
+          "description": "Gets or sets the type of the tag.",
+          "enum": [
+            "Regular",
+            "Negative",
+            "GeneralProduct"
+          ],
+          "type": "string",
+          "readOnly": false,
+          "x-nullable": false,
+          "x-ms-enum": {
+            "name": "TagType",
+            "modelAsString": true
+          }
+        },
+        "imageCount": {
+          "format": "int32",
+          "description": "Gets the number of images with this tag.",
+          "type": "integer",
+          "readOnly": true,
+          "x-nullable": false
+        }
+      }
+    },
+    "TagFilter": {
+      "description": "Model that query for counting of images whose suggested tags match given tags and their probability are greater than or equal to the given threshold.",
+      "type": "object",
+      "properties": {
+        "tagIds": {
+          "description": "Existing TagIds in project to get suggested tags count for.",
+          "type": "array",
+          "items": {
+            "format": "uuid",
+            "type": "string",
+            "x-nullable": false
+          },
+          "readOnly": false
+        },
+        "threshold": {
+          "format": "double",
+          "description": "Confidence threshold to filter suggested tags on.",
+          "type": "number",
+          "readOnly": false,
+          "x-nullable": false
+        }
+      }
+    },
+    "TagPerformance": {
+      "description": "Represents performance data for a particular tag in a trained iteration.",
+      "type": "object",
+      "properties": {
+        "id": {
+          "format": "uuid",
+          "type": "string",
+          "readOnly": true,
+          "x-nullable": false
+        },
+        "name": {
+          "type": "string",
+          "readOnly": true,
+          "x-nullable": false
+        },
+        "precision": {
+          "format": "float",
+          "description": "Gets the precision.",
+          "type": "number",
+          "readOnly": true,
+          "x-nullable": false
+        },
+        "precisionStdDeviation": {
+          "format": "float",
+          "description": "Gets the standard deviation for the precision.",
+          "type": "number",
+          "readOnly": true,
+          "x-nullable": false
+        },
+        "recall": {
+          "format": "float",
+          "description": "Gets the recall.",
+          "type": "number",
+          "readOnly": true,
+          "x-nullable": false
+        },
+        "recallStdDeviation": {
+          "format": "float",
+          "description": "Gets the standard deviation for the recall.",
+          "type": "number",
+          "readOnly": true,
+          "x-nullable": false
+        },
+        "averagePrecision": {
+          "format": "float",
+          "description": "Gets the average precision when applicable.",
+          "type": "number",
+          "readOnly": true,
+          "x-nullable": true
+        }
+      }
+    },
+    "TrainingParameters": {
+      "description": "Parameters used for training.",
+      "type": "object",
+      "properties": {
+        "selectedTags": {
+          "description": "List of tags selected for this training session, other tags in the project will be ignored.",
+          "type": "array",
+          "items": {
+            "format": "uuid",
+            "type": "string",
+            "x-nullable": false
+          },
+          "readOnly": false
+        },
+        "customBaseModelInfo": {
+          "$ref": "#/definitions/CustomBaseModelInfo",
+          "description": "Information of the previously trained iteration which provides the base model for current iteration's training.",
+          "readOnly": false
+        }
+      }
+    }
+  },
+  "parameters": {
+    "Endpoint": {
+      "name": "Endpoint",
+      "in": "path",
+      "description": "Supported Cognitive Services endpoints.",
+      "required": true,
+      "type": "string",
+      "x-ms-parameter-location": "client",
+      "x-ms-skip-url-encoding": true
+    }
+  },
+  "securityDefinitions": {
+    "apim_key": {
+      "type": "apiKey",
+      "name": "Training-Key",
+      "in": "header"
+    }
+  },
+  "security": [
+    {
+      "apim_key": []
+    }
+  ],
+  "x-ms-parameterized-host": {
+    "hostTemplate": "{Endpoint}",
+    "useSchemePrefix": false,
+    "parameters": [
+      {
+        "$ref": "#/parameters/Endpoint"
+      }
+    ]
+  }
+}
diff --git a/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/CreateImageRegions.json b/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/CreateImageRegions.json
new file mode 100644
index 000000000000..9f554c49071c
--- /dev/null
+++ b/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/CreateImageRegions.json
@@ -0,0 +1,81 @@
+{
+  "parameters": {
+    "Endpoint": "https://westus.api.cognitive.microsoft.com",
+    "Content-Type": "application/json",
+    "Training-Key": "{API Key}",
+    "projectId": "bc3f7dad-5544-468c-8573-3ef04d55463e",
+    "batch": {
+      "regions": [
+        {
+          "imageId": "4d6eb844-42ee-42bc-bd6f-c32455ef07c9",
+          "tagId": "b607964f-7bd6-4a3b-a869-6791fb6aab87",
+          "left": 0.25,
+          "top": 0.25,
+          "width": 0.25,
+          "height": 0.25
+        },
+        {
+          "imageId": "4d6eb844-42ee-42bc-bd6f-c32455ef07c9",
+          "tagId": "b607964f-7bd6-4a3b-a869-6791fb6aab87",
+          "left": 0.35,
+          "top": 0.35,
+          "width": 0.25,
+          "height": 0.25
+        }
+      ]
+    }
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": {
+        "created": [
+          {
+            "imageId": "4d6eb844-42ee-42bc-bd6f-c32455ef07c9",
+            "tagId": "b607964f-7bd6-4a3b-a869-6791fb6aab87",
+            "left": 0.25,
+            "top": 0.25,
+            "width": 0.25,
+            "height": 0.25
+          },
+          {
+            "imageId": "4d6eb844-42ee-42bc-bd6f-c32455ef07c9",
+            "tagId": "b607964f-7bd6-4a3b-a869-6791fb6aab87",
+            "left": 0.35,
+            "top": 0.35,
+            "width": 0.25,
+            "height": 0.25
+          }
+        ],
+        "duplicated": [],
+        "exceeded": []
+      }
+    },
+    "207": {
+      "headers": {},
+      "body": {
+        "created": [
+          {
+            "imageId": "4d6eb844-42ee-42bc-bd6f-c32455ef07c9",
+            "tagId": "b607964f-7bd6-4a3b-a869-6791fb6aab87",
+            "left": 0.25,
+            "top": 0.25,
+            "width": 0.25,
+            "height": 0.25
+          }
+        ],
+        "duplicated": [],
+        "exceeded": [
+          {
+            "imageId": "4d6eb844-42ee-42bc-bd6f-c32455ef07c9",
+            "tagId": "b607964f-7bd6-4a3b-a869-6791fb6aab87",
+            "left": 0.35,
+            "top": 0.35,
+            "width": 0.25,
+            "height": 0.25
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/CreateImageTags.json b/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/CreateImageTags.json
new file mode 100644
index 000000000000..5b7395424693
--- /dev/null
+++ b/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/CreateImageTags.json
@@ -0,0 +1,31 @@
+{
+  "parameters": {
+    "Endpoint": "https://westus.api.cognitive.microsoft.com",
+    "Content-Type": "application/json",
+    "Training-Key": "{API Key}",
+    "projectId": "bc3f7dad-5544-468c-8573-3ef04d55463e",
+    "batch": {
+      "tags": [
+        {
+          "imageId": "e31a14ab-5d78-4f7b-a267-3a1e4fd8a758",
+          "tagId": "349d72ac-0948-4d51-b1e4-c14a1f9b848a"
+        }
+      ]
+    }
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": {
+        "created": [
+          {
+            "imageId": "e31a14ab-5d78-4f7b-a267-3a1e4fd8a758",
+            "tagId": "349d72ac-0948-4d51-b1e4-c14a1f9b848a"
+          }
+        ],
+        "duplicated": null,
+        "exceeded": null
+      }
+    }
+  }
+}
diff --git a/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/CreateImagesFromData.json b/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/CreateImagesFromData.json
new file mode 100644
index 000000000000..05b0b07590b5
--- /dev/null
+++ b/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/CreateImagesFromData.json
@@ -0,0 +1,94 @@
+{
+  "parameters": {
+    "Endpoint": "https://westus.api.cognitive.microsoft.com",
+    "Content-Type": "application/json",
+    "Training-Key": "{API Key}",
+    "projectId": "64b822c5-8082-4b36-a426-27225f4aa18c",
+    "tagIds": [
+      "b607964f-7bd6-4a3b-a869-6791fb6aab87"
+    ],
+    "imageData": "multipart data"
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": {
+        "isBatchSuccessful": true,
+        "images": [
+          {
+            "sourceUrl": "\"hemlock_10.jpg\"",
+            "status": "OK",
+            "image": {
+              "id": "4d6eb844-42ee-42bc-bd6f-c32455ef07c9",
+              "created": "2017-12-19T15:56:10Z",
+              "width": 1095,
+              "height": 900,
+              "resizedImageUri": "{Resized Image Uri}",
+              "originalImageUri": "{Image Uri}",
+              "thumbnailUri": "{Thumbnail Uri}",
+              "tags": [
+                {
+                  "tagId": "b607964f-7bd6-4a3b-a869-6791fb6aab87",
+                  "created": "2017-12-19T15:56:09Z",
+                  "tagName": "tag 1"
+                }
+              ]
+            }
+          },
+          {
+            "sourceUrl": "\"hemlock_6.jpg\"",
+            "status": "OK",
+            "image": {
+              "id": "f1855a92-b873-47e7-b513-f07a667ceda1",
+              "created": "2017-12-19T15:56:10Z",
+              "width": 900,
+              "height": 1531,
+              "resizedImageUri": "{Resized Image Uri}",
+              "originalImageUri": "{Image Uri}",
+              "thumbnailUri": "{Thumbnail Uri}",
+              "tags": [
+                {
+                  "tagId": "b607964f-7bd6-4a3b-a869-6791fb6aab87",
+                  "created": "2017-12-19T15:56:09Z",
+                  "tagName": "tag 1"
+                }
+              ]
+            }
+          }
+        ]
+      }
+    },
+    "207": {
+      "headers": {},
+      "body": {
+        "isBatchSuccessful": false,
+        "images": [
+          {
+            "sourceUrl": "\"hemlock_10.jpg\"",
+            "status": "OK",
+            "image": {
+              "id": "4d6eb844-42ee-42bc-bd6f-c32455ef07c9",
+              "created": "2017-12-19T15:56:10Z",
+              "width": 1095,
+              "height": 900,
+              "resizedImageUri": "{Resized Image Uri}",
+              "originalImageUri": "{Image Uri}",
+              "thumbnailUri": "{Thumbnail Uri}",
+              "tags": [
+                {
+                  "tagId": "b607964f-7bd6-4a3b-a869-6791fb6aab87",
+                  "created": "2017-12-19T15:56:09Z",
+                  "tagName": "tag 1"
+                }
+              ]
+            }
+          },
+          {
+            "sourceUrl": "\"hemlock_6.jpg\"",
+            "status": "ErrorLimitExceed"
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/CreateImagesFromFiles.json b/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/CreateImagesFromFiles.json
new file mode 100644
index 000000000000..6853f6ab1401
--- /dev/null
+++ b/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/CreateImagesFromFiles.json
@@ -0,0 +1,82 @@
+{
+  "parameters": {
+    "Endpoint": "https://westus.api.cognitive.microsoft.com",
+    "Content-Type": "application/json",
+    "Training-Key": "{API Key}",
+    "projectId": "64b822c5-8082-4b36-a426-27225f4aa18c",
+    "tagIds": "b607964f-7bd6-4a3b-a869-6791fb6aab87",
+    "batch": {
+      "images": [
+        {
+          "name": "hemlock_10.jpg",
+          "contents": "{image contents}"
+        }
+      ],
+      "tagIds": [
+        "b607964f-7bd6-4a3b-a869-6791fb6aab87"
+      ]
+    }
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": {
+        "isBatchSuccessful": true,
+        "images": [
+          {
+            "sourceUrl": "\"hemlock_10.jpg\"",
+            "status": "OK",
+            "image": {
+              "id": "4d6eb844-42ee-42bc-bd6f-c32455ef07c9",
+              "created": "2017-12-19T15:56:10Z",
+              "width": 1095,
+              "height": 900,
+              "resizedImageUri": "{Resized Image Uri}",
+              "originalImageUri": "{Image Uri}",
+              "thumbnailUri": "{Thumbnail Uri}",
+              "tags": [
+                {
+                  "tagId": "b607964f-7bd6-4a3b-a869-6791fb6aab87",
+                  "created": "2017-12-19T15:56:09Z",
+                  "tagName": "tag 1"
+                }
+              ]
+            }
+          }
+        ]
+      }
+    },
+    "207": {
+      "headers": {},
+      "body": {
+        "isBatchSuccessful": false,
+        "images": [
+          {
+            "sourceUrl": "\"hemlock_10.jpg\"",
+            "status": "OK",
+            "image": {
+              "id": "4d6eb844-42ee-42bc-bd6f-c32455ef07c9",
+              "created": "2017-12-19T15:56:10Z",
+              "width": 1095,
+              "height": 900,
+              "resizedImageUri": "{Resized Image Uri}",
+              "originalImageUri": "{Image Uri}",
+              "thumbnailUri": "{Thumbnail Uri}",
+              "tags": [
+                {
+                  "tagId": "b607964f-7bd6-4a3b-a869-6791fb6aab87",
+                  "created": "2017-12-19T15:56:09Z",
+                  "tagName": "tag 1"
+                }
+              ]
+            }
+          },
+          {
+            "sourceUrl": "{url}",
+            "status": "ErrorLimitExceed"
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/CreateImagesFromPredictions.json b/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/CreateImagesFromPredictions.json
new file mode 100644
index 000000000000..1970c61d0d39
--- /dev/null
+++ b/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/CreateImagesFromPredictions.json
@@ -0,0 +1,81 @@
+{
+  "parameters": {
+    "Endpoint": "https://westus.api.cognitive.microsoft.com",
+    "Content-Type": "application/json",
+    "Training-Key": "{API Key}",
+    "projectId": "64b822c5-8082-4b36-a426-27225f4aa18c",
+    "tagIds": "b607964f-7bd6-4a3b-a869-6791fb6aab87",
+    "batch": {
+      "images": [
+        {
+          "id": "4d6eb844-42ee-42bc-bd6f-c32455ef07c9"
+        }
+      ],
+      "tagIds": [
+        "b607964f-7bd6-4a3b-a869-6791fb6aab87"
+      ]
+    }
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": {
+        "isBatchSuccessful": true,
+        "images": [
+          {
+            "sourceUrl": "\"hemlock_10.jpg\"",
+            "status": "OK",
+            "image": {
+              "id": "4d6eb844-42ee-42bc-bd6f-c32455ef07c9",
+              "created": "2017-12-19T15:56:10Z",
+              "width": 1095,
+              "height": 900,
+              "resizedImageUri": "{Resized Image Uri}",
+              "originalImageUri": "{Image Uri}",
+              "thumbnailUri": "{Thumbnail Uri}",
+              "tags": [
+                {
+                  "tagId": "b607964f-7bd6-4a3b-a869-6791fb6aab87",
+                  "created": "2017-12-19T15:56:09Z",
+                  "tagName": "tag 1"
+                }
+              ]
+            }
+          }
+        ]
+      }
+    },
+    "207": {
+      "headers": {},
+      "body": {
+        "isBatchSuccessful": false,
+        "images": [
+          {
+            "sourceUrl": "\"hemlock_10.jpg\"",
+            "status": "OK",
+            "image": {
+              "id": "4d6eb844-42ee-42bc-bd6f-c32455ef07c9",
+              "created": "2017-12-19T15:56:10Z",
+              "width": 1095,
+              "height": 900,
+              "resizedImageUri": "{Resized Image Uri}",
+              "originalImageUri": "{Image Uri}",
+              "thumbnailUri": "{Thumbnail Uri}",
+              "tags": [
+                {
+                  "tagId": "b607964f-7bd6-4a3b-a869-6791fb6aab87",
+                  "created": "2017-12-19T15:56:09Z",
+                  "tagName": "tag 1"
+                }
+              ]
+            }
+          },
+          {
+            "sourceUrl": "{url}",
+            "status": "ErrorLimitExceed"
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/CreateImagesFromUrls.json b/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/CreateImagesFromUrls.json
new file mode 100644
index 000000000000..a3ecd489a1f7
--- /dev/null
+++ b/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/CreateImagesFromUrls.json
@@ -0,0 +1,82 @@
+{
+  "parameters": {
+    "Endpoint": "https://westus.api.cognitive.microsoft.com",
+    "Content-Type": "application/json",
+    "Training-Key": "{API Key}",
+    "projectId": "64b822c5-8082-4b36-a426-27225f4aa18c",
+    "tagIds": "b607964f-7bd6-4a3b-a869-6791fb6aab87",
+    "batch": {
+      "images": [
+        {
+          "url": "{url to image}"
+        }
+      ],
+      "tagIds": [
+        "b607964f-7bd6-4a3b-a869-6791fb6aab87"
+      ]
+    }
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": {
+        "isBatchSuccessful": true,
+        "images": [
+          {
+            "sourceUrl": "{url to image}",
+            "status": "OK",
+            "image": {
+              "id": "4d6eb844-42ee-42bc-bd6f-c32455ef07c9",
+              "created": "2017-12-19T15:56:10Z",
+              "width": 1095,
+              "height": 900,
+              "resizedImageUri": "{Resized Image Uri}",
+              "originalImageUri": "{Image Uri}",
+              "thumbnailUri": "{Thumbnail Uri}",
+              "tags": [
+                {
+                  "tagId": "b607964f-7bd6-4a3b-a869-6791fb6aab87",
+                  "created": "2017-12-19T15:56:09Z",
+                  "tagName": "tag name"
+                }
+              ]
+            }
+          }
+        ]
+      }
+    },
+    "207": {
+      "headers": {},
+      "body": {
+        "isBatchSuccessful": false,
+        "images": [
+          {
+            "sourceUrl": "{url to image}",
+            "status": "OK",
+            "image": {
+              "id": "4d6eb844-42ee-42bc-bd6f-c32455ef07c9",
+              "created": "2017-12-19T15:56:10Z",
+              "width": 1095,
+              "height": 900,
+              "resizedImageUri": "{Resized Image Uri}",
+              "originalImageUri": "{Image Uri}",
+              "thumbnailUri": "{Thumbnail Uri}",
+              "tags": [
+                {
+                  "tagId": "b607964f-7bd6-4a3b-a869-6791fb6aab87",
+                  "created": "2017-12-19T15:56:09Z",
+                  "tagName": "tag name"
+                }
+              ]
+            }
+          },
+          {
+            "sourceUrl": "{url to image}",
+            "status": "ErrorSource",
+            "image": null
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/CreateProject.json b/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/CreateProject.json
new file mode 100644
index 000000000000..88f852ced738
--- /dev/null
+++ b/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/CreateProject.json
@@ -0,0 +1,26 @@
+{
+  "parameters": {
+    "Endpoint": "https://westus.api.cognitive.microsoft.com",
+    "Content-Type": "application/json",
+    "Training-Key": "{API Key}",
+    "name": "My New Project",
+    "description": "A test project",
+    "domainId": "ee85a74c-405e-4adc-bb47-ffa8ca0c9f31"
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": {
+        "id": "bc3f7dad-5544-468c-8573-3ef04d55463e",
+        "name": "My New Project",
+        "description": "A test project",
+        "settings": {
+          "domainId": "ee85a74c-405e-4adc-bb47-ffa8ca0c9f31"
+        },
+        "created": "2017-12-18T05:43:18Z",
+        "lastModified": "2017-12-18T05:43:18Z",
+        "thumbnailUri": ""
+      }
+    }
+  }
+}
diff --git a/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/CreateTag.json b/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/CreateTag.json
new file mode 100644
index 000000000000..ed19817462ae
--- /dev/null
+++ b/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/CreateTag.json
@@ -0,0 +1,23 @@
+{
+  "parameters": {
+    "Endpoint": "https://westus.api.cognitive.microsoft.com",
+    "Content-Type": "application/json",
+    "Training-Key": "{API Key}",
+    "projectId": "bc3f7dad-5544-468c-8573-3ef04d55463e",
+    "name": "Tag1",
+    "description": "Description of Tag1",
+    "body": ""
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": {
+        "id": "9e27bc1b-7ae7-4e3b-a4e5-36153479dc01",
+        "name": "Tag1",
+        "description": "Description of Tag1",
+        "type": "Regular",
+        "imageCount": 0
+      }
+    }
+  }
+}
diff --git a/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/DeleteImageRegions.json b/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/DeleteImageRegions.json
new file mode 100644
index 000000000000..8931d4e2629e
--- /dev/null
+++ b/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/DeleteImageRegions.json
@@ -0,0 +1,14 @@
+{
+  "parameters": {
+    "Endpoint": "https://westus.api.cognitive.microsoft.com",
+    "Content-Type": "application/json",
+    "Training-Key": "{API Key}",
+    "projectId": "bc3f7dad-5544-468c-8573-3ef04d55463e",
+    "regionIds": [
+      ""
+    ]
+  },
+  "responses": {
+    "204": {}
+  }
+}
diff --git a/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/DeleteImageTags.json b/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/DeleteImageTags.json
new file mode 100644
index 000000000000..d6a188454e9b
--- /dev/null
+++ b/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/DeleteImageTags.json
@@ -0,0 +1,19 @@
+{
+  "parameters": {
+    "Endpoint": "https://westus.api.cognitive.microsoft.com",
+    "Content-Type": "application/json",
+    "Training-Key": "{API Key}",
+    "projectId": "64b822c5-8082-4b36-a426-27225f4aa18c",
+    "imageIds": [
+      "e31a14ab-5d78-4f7b-a267-3a1e4fd8a758",
+      "cf0f83fb-ebaa-4b25-8e34-613a6a0b8a12"
+    ],
+    "tagIds": [
+      "e31a14ab-5d78-4f7b-a267-3a1e4fd8a758",
+      "cf0f83fb-ebaa-4b25-8e34-613a6a0b8a12"
+    ]
+  },
+  "responses": {
+    "204": {}
+  }
+}
diff --git a/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/DeleteImages.json b/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/DeleteImages.json
new file mode 100644
index 000000000000..ccc479209fd2
--- /dev/null
+++ b/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/DeleteImages.json
@@ -0,0 +1,16 @@
+{
+  "parameters": {
+    "Endpoint": "https://westus.api.cognitive.microsoft.com",
+    "Content-Type": "application/json",
+    "Training-Key": "{API Key}",
+    "projectId": "64b822c5-8082-4b36-a426-27225f4aa18c",
+    "imageIds": [
+      "e31a14ab-5d78-4f7b-a267-3a1e4fd8a758",
+      "cf0f83fb-ebaa-4b25-8e34-613a6a0b8a12"
+    ]
+  },
+  "responses": {
+    "204": {},
+    "202": {}
+  }
+}
diff --git a/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/DeleteIteration.json b/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/DeleteIteration.json
new file mode 100644
index 000000000000..d1f9b7629958
--- /dev/null
+++ b/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/DeleteIteration.json
@@ -0,0 +1,12 @@
+{
+  "parameters": {
+    "Endpoint": "https://westus.api.cognitive.microsoft.com",
+    "Content-Type": "application/json",
+    "Training-Key": "{API Key}",
+    "projectId": "64b822c5-8082-4b36-a426-27225f4aa18c",
+    "iterationId": "e31a14ab-5d78-4f7b-a267-3a1e4fd8a758"
+  },
+  "responses": {
+    "204": {}
+  }
+}
diff --git a/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/DeletePrediction.json b/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/DeletePrediction.json
new file mode 100644
index 000000000000..c6b2d5c0bc58
--- /dev/null
+++ b/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/DeletePrediction.json
@@ -0,0 +1,15 @@
+{
+  "parameters": {
+    "Endpoint": "https://westus.api.cognitive.microsoft.com",
+    "Content-Type": "application/json",
+    "Training-Key": "{API Key}",
+    "projectId": "64b822c5-8082-4b36-a426-27225f4aa18c",
+    "ids": [
+      "e31a14ab-5d78-4f7b-a267-3a1e4fd8a758",
+      "cf0f83fb-ebaa-4b25-8e34-613a6a0b8a12"
+    ]
+  },
+  "responses": {
+    "204": {}
+  }
+}
diff --git a/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/DeleteProject.json b/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/DeleteProject.json
new file mode 100644
index 000000000000..2b4cb5723a6a
--- /dev/null
+++ b/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/DeleteProject.json
@@ -0,0 +1,11 @@
+{
+  "parameters": {
+    "Endpoint": "https://westus.api.cognitive.microsoft.com",
+    "Content-Type": "application/json",
+    "Training-Key": "{API Key}",
+    "projectId": "bc3f7dad-5544-468c-8573-3ef04d55463e"
+  },
+  "responses": {
+    "204": {}
+  }
+}
diff --git a/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/DeleteTag.json b/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/DeleteTag.json
new file mode 100644
index 000000000000..e9f802505a09
--- /dev/null
+++ b/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/DeleteTag.json
@@ -0,0 +1,12 @@
+{
+  "parameters": {
+    "Endpoint": "https://westus.api.cognitive.microsoft.com",
+    "Content-Type": "application/json",
+    "Training-Key": "{API Key}",
+    "projectId": "bc3f7dad-5544-468c-8573-3ef04d55463e",
+    "tagId": "9e27bc1b-7ae7-4e3b-a4e5-36153479dc01"
+  },
+  "responses": {
+    "204": {}
+  }
+}
diff --git a/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/ExportIteration.json b/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/ExportIteration.json
new file mode 100644
index 000000000000..1bbfa05a5d86
--- /dev/null
+++ b/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/ExportIteration.json
@@ -0,0 +1,21 @@
+{
+  "parameters": {
+    "Endpoint": "https://westus.api.cognitive.microsoft.com",
+    "Content-Type": "application/json",
+    "Training-Key": "{API Key}",
+    "projectId": "64b822c5-8082-4b36-a426-27225f4aa18c",
+    "iterationId": "e31a14ab-5d78-4f7b-a267-3a1e4fd8a758",
+    "platform": "TensorFlow"
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": {
+        "platform": "TensorFlow",
+        "status": "Exporting",
+        "downloadUri": "",
+        "newerVersionAvailable": false
+      }
+    }
+  }
+}
diff --git a/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/ExportProject.json b/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/ExportProject.json
new file mode 100644
index 000000000000..8d59acb577d1
--- /dev/null
+++ b/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/ExportProject.json
@@ -0,0 +1,16 @@
+{
+  "parameters": {
+    "Endpoint": "https://westus.api.cognitive.microsoft.com",
+    "Content-Type": "application/json",
+    "Training-Key": "{API Key}",
+    "projectId": "bc3f7dad-5544-468c-8573-3ef04d55463e"
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": {
+        "token": "<token>"
+      }
+    }
+  }
+}
diff --git a/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/GetArtifact.json b/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/GetArtifact.json
new file mode 100644
index 000000000000..e48a4cf6fd86
--- /dev/null
+++ b/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/GetArtifact.json
@@ -0,0 +1,14 @@
+{
+  "parameters": {
+    "Endpoint": "https://westus.api.cognitive.microsoft.com",
+    "Content-Type": "application/json",
+    "Training-Key": "{API Key}",
+    "projectId": "bc3f7dad-5544-468c-8573-3ef04d55463e",
+    "path": "i-40b66b39b86b4583be8c0fe223aa9ec5/t-5c882c62ca2b4458b39a2041b111dd73"
+  },
+  "responses": {
+    "200": {
+      "body": "{file}"
+    }
+  }
+}
diff --git a/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/GetDomain.json b/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/GetDomain.json
new file mode 100644
index 000000000000..c6702b3a8f29
--- /dev/null
+++ b/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/GetDomain.json
@@ -0,0 +1,20 @@
+{
+  "parameters": {
+    "Endpoint": "https://westus.api.cognitive.microsoft.com",
+    "Content-Type": "application/json",
+    "Training-Key": "{API Key}",
+    "domainId": "b30a91ae-e3c1-4f73-a81e-c270bff27c39"
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": {
+        "id": "b30a91ae-e3c1-4f73-a81e-c270bff27c39",
+        "name": "Retail",
+        "type": "Classification",
+        "exportable": false,
+        "enabled": true
+      }
+    }
+  }
+}
diff --git a/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/GetDomains.json b/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/GetDomains.json
new file mode 100644
index 000000000000..a10887726fcb
--- /dev/null
+++ b/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/GetDomains.json
@@ -0,0 +1,70 @@
+{
+  "parameters": {
+    "Endpoint": "https://westus.api.cognitive.microsoft.com",
+    "Content-Type": "application/json",
+    "Training-Key": "{API Key}"
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": [
+        {
+          "id": "ee85a74c-405e-4adc-bb47-ffa8ca0c9f31",
+          "name": "General",
+          "type": "Classification",
+          "exportable": false,
+          "enabled": true
+        },
+        {
+          "id": "c151d5b5-dd07-472a-acc8-15d29dea8518",
+          "name": "Food",
+          "type": "Classification",
+          "exportable": false,
+          "enabled": true
+        },
+        {
+          "id": "ca455789-012d-4b50-9fec-5bb63841c793",
+          "name": "Landmarks",
+          "type": "Classification",
+          "exportable": false,
+          "enabled": true
+        },
+        {
+          "id": "b30a91ae-e3c1-4f73-a81e-c270bff27c39",
+          "name": "Retail",
+          "type": "Classification",
+          "exportable": false,
+          "enabled": true
+        },
+        {
+          "id": "45badf75-3591-4f26-a705-45678d3e9f5f",
+          "name": "Adult",
+          "type": "Classification",
+          "exportable": false,
+          "enabled": true
+        },
+        {
+          "id": "0732100f-1a38-4e49-a514-c9b44c697ab5",
+          "name": "General (compact)",
+          "type": "Classification",
+          "exportable": false,
+          "enabled": true
+        },
+        {
+          "id": "b5cfd229-2ac7-4b2b-8d0a-2b0661344894",
+          "name": "Landmarks (compact)",
+          "type": "Classification",
+          "exportable": false,
+          "enabled": true
+        },
+        {
+          "id": "6b4faeda-8396-481b-9f8b-177b9fa3097f",
+          "name": "Retail (compact)",
+          "type": "Classification",
+          "exportable": false,
+          "enabled": true
+        }
+      ]
+    }
+  }
+}
diff --git a/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/GetExports.json b/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/GetExports.json
new file mode 100644
index 000000000000..1267168dbb4c
--- /dev/null
+++ b/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/GetExports.json
@@ -0,0 +1,22 @@
+{
+  "parameters": {
+    "Endpoint": "https://westus.api.cognitive.microsoft.com",
+    "Content-Type": "application/json",
+    "Training-Key": "{API Key}",
+    "projectId": "64b822c5-8082-4b36-a426-27225f4aa18c",
+    "iterationId": "e31a14ab-5d78-4f7b-a267-3a1e4fd8a758"
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": [
+        {
+          "platform": "TensorFlow",
+          "status": "Done",
+          "newerVersionAvailable": false,
+          "downloadUri": "{Download URI}"
+        }
+      ]
+    }
+  }
+}
diff --git a/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/GetImageCount.json b/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/GetImageCount.json
new file mode 100644
index 000000000000..ee6e4980eefa
--- /dev/null
+++ b/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/GetImageCount.json
@@ -0,0 +1,14 @@
+{
+  "parameters": {
+    "Endpoint": "https://westus.api.cognitive.microsoft.com",
+    "Content-Type": "application/json",
+    "Training-Key": "{API Key}",
+    "projectId": "bc3f7dad-5544-468c-8573-3ef04d55463e"
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": 12
+    }
+  }
+}
diff --git a/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/GetImagePerformanceCount.json b/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/GetImagePerformanceCount.json
new file mode 100644
index 000000000000..c57ffd50669b
--- /dev/null
+++ b/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/GetImagePerformanceCount.json
@@ -0,0 +1,18 @@
+{
+  "parameters": {
+    "Endpoint": "https://westus.api.cognitive.microsoft.com",
+    "Content-Type": "application/json",
+    "Training-Key": "{API Key}",
+    "projectId": "bc3f7dad-5544-468c-8573-3ef04d55463e",
+    "iterationId": "cf0f83fb-ebaa-4b25-8e34-613a6a0b8a12",
+    "tagIds": [
+      "b5f7e6a2-a481-49a6-afec-a7cef1af3544"
+    ]
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": "1"
+    }
+  }
+}
diff --git a/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/GetImagePerformances.json b/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/GetImagePerformances.json
new file mode 100644
index 000000000000..dfe6eb5a7208
--- /dev/null
+++ b/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/GetImagePerformances.json
@@ -0,0 +1,43 @@
+{
+  "parameters": {
+    "Endpoint": "https://westus.api.cognitive.microsoft.com",
+    "Content-Type": "application/json",
+    "Training-Key": "{API Key}",
+    "projectId": "bc3f7dad-5544-468c-8573-3ef04d55463e",
+    "iterationId": "b7b9d99c-a2c6-4658-9900-a98d2ff5bc66",
+    "tagIds": [
+      ""
+    ],
+    "orderBy": "Newest"
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": [
+        {
+          "id": "dfd2d346-3ed5-4e1e-857d-af4e32cec042",
+          "created": "2018-01-31T20:18:26Z",
+          "predictions": [
+            {
+              "tagId": "b5f7e6a2-a481-49a6-afec-a7cef1af3544",
+              "tagName": "Tag 1",
+              "probability": 1.0,
+              "boundingBox": {
+                "left": 0.25,
+                "top": 0.25,
+                "width": 0.25,
+                "height": 0.25
+              }
+            }
+          ],
+          "width": 600,
+          "height": 1600,
+          "imageUri": "<image uri>",
+          "thumbnailUri": "<thumbnail uri>",
+          "tags": [],
+          "regions": []
+        }
+      ]
+    }
+  }
+}
diff --git a/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/GetImageRegionProposals.json b/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/GetImageRegionProposals.json
new file mode 100644
index 000000000000..7638215aae62
--- /dev/null
+++ b/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/GetImageRegionProposals.json
@@ -0,0 +1,29 @@
+{
+  "parameters": {
+    "Endpoint": "https://westus.api.cognitive.microsoft.com",
+    "Content-Type": "application/json",
+    "Training-Key": "{API Key}",
+    "projectId": "bc3f7dad-5544-468c-8573-3ef04d55463e",
+    "imageId": "4d6eb844-42ee-42bc-bd6f-c32455ef07c9"
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": {
+        "projectId": "bc3f7dad-5544-468c-8573-3ef04d55463e",
+        "imageId": "4d6eb844-42ee-42bc-bd6f-c32455ef07c9",
+        "proposals": [
+          {
+            "confidence": 0.25,
+            "boundingBox": {
+              "left": 0.25,
+              "top": 0.25,
+              "width": 0.25,
+              "height": 0.25
+            }
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/GetImages.json b/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/GetImages.json
new file mode 100644
index 000000000000..d02bd9b585ef
--- /dev/null
+++ b/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/GetImages.json
@@ -0,0 +1,47 @@
+{
+  "parameters": {
+    "Endpoint": "https://westus.api.cognitive.microsoft.com",
+    "Content-Type": "application/json",
+    "Training-Key": "{API Key}",
+    "projectId": "bc3f7dad-5544-468c-8573-3ef04d55463e"
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": [
+        {
+          "id": "4d6eb844-42ee-42bc-bd6f-c32455ef07c9",
+          "created": "2017-12-19T15:56:10Z",
+          "width": 1095,
+          "height": 900,
+          "resizedImageUri": "{Resized Image Uri}",
+          "originalImageUri": "{Image Uri}",
+          "thumbnailUri": "{Thumbnail Uri}",
+          "tags": [
+            {
+              "tagId": "b607964f-7bd6-4a3b-a869-6791fb6aab87",
+              "created": "2017-12-19T15:56:09Z",
+              "tagName": "tag 1"
+            }
+          ]
+        },
+        {
+          "id": "f1855a92-b873-47e7-b513-f07a667ceda1",
+          "created": "2017-12-19T15:56:10Z",
+          "width": 900,
+          "height": 1531,
+          "resizedImageUri": "{Resized Image Uri}",
+          "originalImageUri": "{Image Uri}",
+          "thumbnailUri": "{Thumbnail Uri}",
+          "tags": [
+            {
+              "tagId": "b607964f-7bd6-4a3b-a869-6791fb6aab87",
+              "created": "2017-12-19T15:56:09Z",
+              "tagName": "tag 1"
+            }
+          ]
+        }
+      ]
+    }
+  }
+}
diff --git a/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/GetImagesByIds.json b/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/GetImagesByIds.json
new file mode 100644
index 000000000000..037118bc9d41
--- /dev/null
+++ b/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/GetImagesByIds.json
@@ -0,0 +1,15 @@
+{
+  "parameters": {
+    "Endpoint": "https://westus.api.cognitive.microsoft.com",
+    "Content-Type": "application/json",
+    "Training-Key": "{API Key}",
+    "projectId": "bc3f7dad-5544-468c-8573-3ef04d55463e",
+    "iterationId": "cf0f83fb-ebaa-4b25-8e34-613a6a0b8a12"
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": []
+    }
+  }
+}
diff --git a/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/GetIteration.json b/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/GetIteration.json
new file mode 100644
index 000000000000..2383a6c6f910
--- /dev/null
+++ b/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/GetIteration.json
@@ -0,0 +1,34 @@
+{
+  "parameters": {
+    "Endpoint": "https://westus.api.cognitive.microsoft.com",
+    "Content-Type": "application/json",
+    "Training-Key": "{API Key}",
+    "projectId": "64b822c5-8082-4b36-a426-27225f4aa18c",
+    "iterationId": "e31a14ab-5d78-4f7b-a267-3a1e4fd8a758"
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": {
+        "id": "e31a14ab-5d78-4f7b-a267-3a1e4fd8a758",
+        "name": "Iteration 2",
+        "status": "Completed",
+        "created": "2017-12-18T22:40:36Z",
+        "lastModified": "2017-12-19T15:47:02Z",
+        "trainedAt": "2017-12-19T15:47:02Z",
+        "projectId": "64b822c5-8082-4b36-a426-27225f4aa18c",
+        "exportable": false,
+        "domainId": "ee85a74c-405e-4adc-bb47-ffa8ca0c9f31",
+        "exportableTo": [
+          "ONNX",
+          "DockerFile",
+          "TensorFlow",
+          "CoreML"
+        ],
+        "trainingType": "Regular",
+        "reservedBudgetInHours": 0,
+        "publishName": ""
+      }
+    }
+  }
+}
diff --git a/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/GetIterationPerformance.json b/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/GetIterationPerformance.json
new file mode 100644
index 000000000000..323173c03a51
--- /dev/null
+++ b/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/GetIterationPerformance.json
@@ -0,0 +1,39 @@
+{
+  "parameters": {
+    "Endpoint": "https://westus.api.cognitive.microsoft.com",
+    "Content-Type": "application/json",
+    "Training-Key": "{API Key}",
+    "projectId": "bc3f7dad-5544-468c-8573-3ef04d55463e",
+    "iterationId": "fe1e83c4-6f50-4899-9544-6bb08cf0e15a",
+    "threshold": 0.9
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": {
+        "perTagPerformance": [
+          {
+            "id": "e31ff107-5505-4753-be42-b369b21b026c",
+            "name": "Hemlock",
+            "precision": 1.0,
+            "precisionStdDeviation": 0.0,
+            "recall": 1.0,
+            "recallStdDeviation": 0.0
+          },
+          {
+            "id": "349d72ac-0948-4d51-b1e4-c14a1f9b848a",
+            "name": "Japanese Cherry",
+            "precision": 1.0,
+            "precisionStdDeviation": 0.0,
+            "recall": 1.0,
+            "recallStdDeviation": 0.0
+          }
+        ],
+        "precision": 1.0,
+        "precisionStdDeviation": 0.0,
+        "recall": 1.0,
+        "recallStdDeviation": 0.0
+      }
+    }
+  }
+}
diff --git a/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/GetIterations.json b/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/GetIterations.json
new file mode 100644
index 000000000000..ac0c78134a80
--- /dev/null
+++ b/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/GetIterations.json
@@ -0,0 +1,74 @@
+{
+  "parameters": {
+    "Endpoint": "https://westus.api.cognitive.microsoft.com",
+    "Content-Type": "application/json",
+    "Training-Key": "{API Key}",
+    "projectId": "64b822c5-8082-4b36-a426-27225f4aa18c"
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": [
+        {
+          "id": "fe1e83c4-6f50-4899-9544-6bb08cf0e15a",
+          "name": "Iteration 1",
+          "status": "Completed",
+          "created": "2017-12-18T22:40:29Z",
+          "lastModified": "2017-12-18T22:40:41Z",
+          "trainedAt": "2017-12-18T22:40:41Z",
+          "projectId": "64b822c5-8082-4b36-a426-27225f4aa18c",
+          "exportable": false,
+          "domainId": "ee85a74c-405e-4adc-bb47-ffa8ca0c9f31",
+          "exportableTo": [
+            "ONNX",
+            "DockerFile",
+            "TensorFlow",
+            "CoreML"
+          ],
+          "trainingType": "Regular",
+          "reservedBudgetInHours": 0,
+          "publishName": ""
+        },
+        {
+          "id": "e31a14ab-5d78-4f7b-a267-3a1e4fd8a758",
+          "name": "Iteration 2",
+          "status": "Completed",
+          "created": "2017-12-18T22:40:36Z",
+          "lastModified": "2017-12-19T15:47:02Z",
+          "trainedAt": "2017-12-19T15:47:02Z",
+          "projectId": "64b822c5-8082-4b36-a426-27225f4aa18c",
+          "exportable": false,
+          "domainId": "ee85a74c-405e-4adc-bb47-ffa8ca0c9f31",
+          "exportableTo": [
+            "ONNX",
+            "DockerFile",
+            "TensorFlow",
+            "CoreML"
+          ],
+          "trainingType": "Regular",
+          "reservedBudgetInHours": 5,
+          "publishName": "model1"
+        },
+        {
+          "id": "3adaf7b2-18fc-4376-9da4-b5ea160a7cf5",
+          "name": "Iteration 3",
+          "status": "New",
+          "created": "2017-12-19T15:46:59Z",
+          "lastModified": "2017-12-19T15:46:59Z",
+          "projectId": "64b822c5-8082-4b36-a426-27225f4aa18c",
+          "exportable": false,
+          "domainId": null,
+          "exportableTo": [
+            "ONNX",
+            "DockerFile",
+            "TensorFlow",
+            "CoreML"
+          ],
+          "trainingType": "Regular",
+          "reservedBudgetInHours": 0,
+          "publishName": ""
+        }
+      ]
+    }
+  }
+}
diff --git a/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/GetProject.json b/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/GetProject.json
new file mode 100644
index 000000000000..4b68bf1ea390
--- /dev/null
+++ b/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/GetProject.json
@@ -0,0 +1,24 @@
+{
+  "parameters": {
+    "Endpoint": "https://westus.api.cognitive.microsoft.com",
+    "Content-Type": "application/json",
+    "Training-Key": "{API Key}",
+    "projectId": "bc3f7dad-5544-468c-8573-3ef04d55463e"
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": {
+        "id": "bc3f7dad-5544-468c-8573-3ef04d55463e",
+        "name": "My New Project",
+        "description": "A test project",
+        "settings": {
+          "domainId": "ee85a74c-405e-4adc-bb47-ffa8ca0c9f31"
+        },
+        "created": "2017-12-18T05:43:18Z",
+        "lastModified": "2017-12-18T05:43:18Z",
+        "thumbnailUri": ""
+      }
+    }
+  }
+}
diff --git a/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/GetProjects.json b/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/GetProjects.json
new file mode 100644
index 000000000000..b5166555936f
--- /dev/null
+++ b/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/GetProjects.json
@@ -0,0 +1,25 @@
+{
+  "parameters": {
+    "Endpoint": "https://westus.api.cognitive.microsoft.com",
+    "Content-Type": "application/json",
+    "Training-Key": "{API Key}"
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": [
+        {
+          "id": "bc3f7dad-5544-468c-8573-3ef04d55463e",
+          "name": "My New Project",
+          "description": "",
+          "settings": {
+            "domainId": "ee85a74c-405e-4adc-bb47-ffa8ca0c9f31"
+          },
+          "created": "2017-12-18T05:43:18Z",
+          "lastModified": "2017-12-18T05:43:18Z",
+          "thumbnailUri": ""
+        }
+      ]
+    }
+  }
+}
diff --git a/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/GetTag.json b/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/GetTag.json
new file mode 100644
index 000000000000..4ad3135822ae
--- /dev/null
+++ b/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/GetTag.json
@@ -0,0 +1,21 @@
+{
+  "parameters": {
+    "Endpoint": "https://westus.api.cognitive.microsoft.com",
+    "Content-Type": "application/json",
+    "Training-Key": "{API Key}",
+    "projectId": "bc3f7dad-5544-468c-8573-3ef04d55463e",
+    "tagId": "9e27bc1b-7ae7-4e3b-a4e5-36153479dc01"
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": {
+        "id": "9e27bc1b-7ae7-4e3b-a4e5-36153479dc01",
+        "name": "Tag1",
+        "description": "Description of Tag1",
+        "type": "Regular",
+        "imageCount": 0
+      }
+    }
+  }
+}
diff --git a/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/GetTaggedImageCount.json b/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/GetTaggedImageCount.json
new file mode 100644
index 000000000000..c0ed09aa6ae9
--- /dev/null
+++ b/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/GetTaggedImageCount.json
@@ -0,0 +1,15 @@
+{
+  "parameters": {
+    "Endpoint": "https://westus.api.cognitive.microsoft.com",
+    "Content-Type": "application/json",
+    "Training-Key": "{API Key}",
+    "projectId": "bc3f7dad-5544-468c-8573-3ef04d55463e",
+    "iterationId": "cf0f83fb-ebaa-4b25-8e34-613a6a0b8a12"
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": "10"
+    }
+  }
+}
diff --git a/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/GetTaggedImages.json b/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/GetTaggedImages.json
new file mode 100644
index 000000000000..037118bc9d41
--- /dev/null
+++ b/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/GetTaggedImages.json
@@ -0,0 +1,15 @@
+{
+  "parameters": {
+    "Endpoint": "https://westus.api.cognitive.microsoft.com",
+    "Content-Type": "application/json",
+    "Training-Key": "{API Key}",
+    "projectId": "bc3f7dad-5544-468c-8573-3ef04d55463e",
+    "iterationId": "cf0f83fb-ebaa-4b25-8e34-613a6a0b8a12"
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": []
+    }
+  }
+}
diff --git a/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/GetTags.json b/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/GetTags.json
new file mode 100644
index 000000000000..6ad8ea76c689
--- /dev/null
+++ b/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/GetTags.json
@@ -0,0 +1,22 @@
+{
+  "parameters": {
+    "Endpoint": "https://westus.api.cognitive.microsoft.com",
+    "Content-Type": "application/json",
+    "Training-Key": "{API Key}",
+    "projectId": "bc3f7dad-5544-468c-8573-3ef04d55463e"
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": [
+        {
+          "id": "9e27bc1b-7ae7-4e3b-a4e5-36153479dc01",
+          "name": "Tag1",
+          "description": "Description of Tag1",
+          "type": "Regular",
+          "imageCount": 0
+        }
+      ]
+    }
+  }
+}
diff --git a/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/GetUntaggedImageCount.json b/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/GetUntaggedImageCount.json
new file mode 100644
index 000000000000..c0ed09aa6ae9
--- /dev/null
+++ b/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/GetUntaggedImageCount.json
@@ -0,0 +1,15 @@
+{
+  "parameters": {
+    "Endpoint": "https://westus.api.cognitive.microsoft.com",
+    "Content-Type": "application/json",
+    "Training-Key": "{API Key}",
+    "projectId": "bc3f7dad-5544-468c-8573-3ef04d55463e",
+    "iterationId": "cf0f83fb-ebaa-4b25-8e34-613a6a0b8a12"
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": "10"
+    }
+  }
+}
diff --git a/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/GetUntaggedImages.json b/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/GetUntaggedImages.json
new file mode 100644
index 000000000000..037118bc9d41
--- /dev/null
+++ b/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/GetUntaggedImages.json
@@ -0,0 +1,15 @@
+{
+  "parameters": {
+    "Endpoint": "https://westus.api.cognitive.microsoft.com",
+    "Content-Type": "application/json",
+    "Training-Key": "{API Key}",
+    "projectId": "bc3f7dad-5544-468c-8573-3ef04d55463e",
+    "iterationId": "cf0f83fb-ebaa-4b25-8e34-613a6a0b8a12"
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": []
+    }
+  }
+}
diff --git a/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/ImportProject.json b/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/ImportProject.json
new file mode 100644
index 000000000000..87702da27426
--- /dev/null
+++ b/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/ImportProject.json
@@ -0,0 +1,25 @@
+{
+  "parameters": {
+    "Endpoint": "https://westus.api.cognitive.microsoft.com",
+    "Content-Type": "application/json",
+    "Training-Key": "{API Key}",
+    "token": "token"
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": {
+        "id": "bc3f7dad-5544-468c-8573-3ef04d55463e",
+        "name": "Import Project",
+        "description": "",
+        "settings": {
+          "domainId": "ee85a74c-405e-4adc-bb47-ffa8ca0c9f31"
+        },
+        "created": "2019-10-06T05:43:18Z",
+        "lastModified": "2019-10-06T05:43:18Z",
+        "thumbnailUri": "",
+        "status": "Importing"
+      }
+    }
+  }
+}
diff --git a/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/PublishIteration.json b/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/PublishIteration.json
new file mode 100644
index 000000000000..67d6ad03e29f
--- /dev/null
+++ b/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/PublishIteration.json
@@ -0,0 +1,17 @@
+{
+  "parameters": {
+    "Endpoint": "https://westus.api.cognitive.microsoft.com",
+    "Content-Type": "application/json",
+    "Training-Key": "{API Key}",
+    "projectId": "64b822c5-8082-4b36-a426-27225f4aa18c",
+    "iterationId": "e31a14ab-5d78-4f7b-a267-3a1e4fd8a758",
+    "publishName": "Model1",
+    "predictionId": "/subscriptions/{subscription}/resourceGroups/{resource group name}/providers/Microsoft.CognitiveServices/accounts/{resource name}"
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": true
+    }
+  }
+}
diff --git a/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/QueryPredictions.json b/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/QueryPredictions.json
new file mode 100644
index 000000000000..0bd19d6b7980
--- /dev/null
+++ b/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/QueryPredictions.json
@@ -0,0 +1,66 @@
+{
+  "parameters": {
+    "Endpoint": "https://westus.api.cognitive.microsoft.com",
+    "Content-Type": "application/json",
+    "Training-Key": "{API Key}",
+    "projectId": "bc3f7dad-5544-468c-8573-3ef04d55463e",
+    "query": {
+      "orderBy": "Newest",
+      "tags": [
+        {
+          "id": "b5f7e6a2-a481-49a6-afec-a7cef1af3544",
+          "maxThreshold": 1,
+          "minThreshold": 0.9
+        }
+      ]
+    }
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": {
+        "results": [
+          {
+            "id": "dfd2d346-3ed5-4e1e-857d-af4e32cec042",
+            "project": "8988643a-ae70-447d-9a22-15c4255e5ecb",
+            "iteration": "b7b9d99c-a2c6-4658-9900-a98d2ff5bc66",
+            "created": "2018-01-31T20:18:26Z",
+            "predictions": [
+              {
+                "tagId": "b5f7e6a2-a481-49a6-afec-a7cef1af3544",
+                "tagName": "Tag 1",
+                "probability": 1.0
+              },
+              {
+                "tagId": "45619cda-d1c9-4bc8-a3e1-87c5d81adbc3",
+                "tagName": "Tag 2",
+                "probability": 3.60627153E-12
+              }
+            ],
+            "originalImageUri": "<image uri>",
+            "thumbnailUri": "<thumbnail uri>",
+            "resizedImageUri": "<resized image uri>",
+            "domain": "b30a91ae-e3c1-4f73-a81e-c270bff27c39"
+          }
+        ],
+        "token": {
+          "session": "1:286613",
+          "continuation": "",
+          "maxCount": 0,
+          "orderBy": "Newest",
+          "tags": [
+            {
+              "id": "b5f7e6a2-a481-49a6-afec-a7cef1af3544",
+              "minThreshold": 0.9,
+              "maxThreshold": 1.0
+            }
+          ],
+          "iterationId": null,
+          "startTime": null,
+          "endTime": null,
+          "application": ""
+        }
+      }
+    }
+  }
+}
diff --git a/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/QuerySuggestedImageCount.json b/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/QuerySuggestedImageCount.json
new file mode 100644
index 000000000000..bfe12dad0540
--- /dev/null
+++ b/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/QuerySuggestedImageCount.json
@@ -0,0 +1,22 @@
+{
+  "parameters": {
+    "Endpoint": "https://westus.api.cognitive.microsoft.com",
+    "Content-Type": "application/json",
+    "Training-Key": "{API Key}",
+    "projectId": "bc3f7dad-5544-468c-8573-3ef04d55463e",
+    "iterationId": "b7b9d99c-a2c6-4658-9900-a98d2ff5bc66",
+    "query": {
+      "tagIds": [
+        "b5f7e6a2-a481-49a6-afec-a7cef1af3544"
+      ]
+    }
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": {
+        "b5f7e6a2-a481-49a6-afec-a7cef1af3544": 1
+      }
+    }
+  }
+}
diff --git a/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/QuerySuggestedImages.json b/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/QuerySuggestedImages.json
new file mode 100644
index 000000000000..c42db2bc784f
--- /dev/null
+++ b/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/QuerySuggestedImages.json
@@ -0,0 +1,54 @@
+{
+  "parameters": {
+    "Endpoint": "https://westus.api.cognitive.microsoft.com",
+    "Content-Type": "application/json",
+    "Training-Key": "{API Key}",
+    "projectId": "bc3f7dad-5544-468c-8573-3ef04d55463e",
+    "iterationId": "b7b9d99c-a2c6-4658-9900-a98d2ff5bc66",
+    "query": {
+      "tagIds": [
+        "b5f7e6a2-a481-49a6-afec-a7cef1af3544"
+      ]
+    }
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": {
+        "results": [
+          {
+            "id": "dfd2d346-3ed5-4e1e-857d-af4e32cec042",
+            "project": "8988643a-ae70-447d-9a22-15c4255e5ecb",
+            "iteration": "b7b9d99c-a2c6-4658-9900-a98d2ff5bc66",
+            "created": "2018-01-31T20:18:26Z",
+            "predictions": [
+              {
+                "tagId": "b5f7e6a2-a481-49a6-afec-a7cef1af3544",
+                "tagName": "Tag 1",
+                "probability": 1.0
+              },
+              {
+                "tagId": "45619cda-d1c9-4bc8-a3e1-87c5d81adbc3",
+                "tagName": "Tag 2",
+                "probability": 3.60627153E-12
+              }
+            ],
+            "originalImageUri": "<image uri>",
+            "thumbnailUri": "<thumbnail uri>",
+            "resizedImageUri": "<resized image uri>",
+            "domain": "b30a91ae-e3c1-4f73-a81e-c270bff27c39"
+          }
+        ],
+        "token": {
+          "session": "1:286613",
+          "continuation": "",
+          "maxCount": 0,
+          "sortBy": "Newest",
+          "tagIds": [
+            "b5f7e6a2-a481-49a6-afec-a7cef1af3544"
+          ]
+        }
+      }
+    }
+  }
+}
diff --git a/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/QuickTestImage.json b/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/QuickTestImage.json
new file mode 100644
index 000000000000..489852dc79df
--- /dev/null
+++ b/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/QuickTestImage.json
@@ -0,0 +1,33 @@
+{
+  "parameters": {
+    "Endpoint": "https://westus.api.cognitive.microsoft.com",
+    "Content-Type": "application/json",
+    "Training-Key": "{API Key}",
+    "projectId": "64b822c5-8082-4b36-a426-27225f4aa18c",
+    "iterationId": "fe1e83c4-6f50-4899-9544-6bb08cf0e15a",
+    "imageData": "multipart-form-data"
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": {
+        "id": "951098b2-9b69-427b-bddb-d5cb618874e3",
+        "project": "64b822c5-8082-4b36-a426-27225f4aa18c",
+        "iteration": "fe1e83c4-6f50-4899-9544-6bb08cf0e15a",
+        "created": "2017-12-19T14:21:41Z",
+        "predictions": [
+          {
+            "tagId": "e31ff107-5505-4753-be42-b369b21b026c",
+            "tagName": "Hemlock",
+            "probability": 0.05149666
+          },
+          {
+            "tagId": "349d72ac-0948-4d51-b1e4-c14a1f9b848a",
+            "tagName": "Japanese Cherry",
+            "probability": 0.00
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/QuickTestImageUrl.json b/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/QuickTestImageUrl.json
new file mode 100644
index 000000000000..dc904ef6f116
--- /dev/null
+++ b/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/QuickTestImageUrl.json
@@ -0,0 +1,35 @@
+{
+  "parameters": {
+    "Endpoint": "https://westus.api.cognitive.microsoft.com",
+    "Content-Type": "application/json",
+    "Training-Key": "{API Key}",
+    "projectId": "64b822c5-8082-4b36-a426-27225f4aa18c",
+    "iterationId": "fe1e83c4-6f50-4899-9544-6bb08cf0e15a",
+    "imageUrl": {
+      "url": "{Image URL}"
+    }
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": {
+        "id": "951098b2-9b69-427b-bddb-d5cb618874e3",
+        "project": "64b822c5-8082-4b36-a426-27225f4aa18c",
+        "iteration": "fe1e83c4-6f50-4899-9544-6bb08cf0e15a",
+        "created": "2017-12-19T14:21:41Z",
+        "predictions": [
+          {
+            "tagId": "e31ff107-5505-4753-be42-b369b21b026c",
+            "tagName": "Hemlock",
+            "probability": 0.05149666
+          },
+          {
+            "tagId": "349d72ac-0948-4d51-b1e4-c14a1f9b848a",
+            "tagName": "Japanese Cherry",
+            "probability": 0.00
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/SuggestTagsAndRegions.json b/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/SuggestTagsAndRegions.json
new file mode 100644
index 000000000000..175a0a2a01e0
--- /dev/null
+++ b/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/SuggestTagsAndRegions.json
@@ -0,0 +1,39 @@
+{
+  "parameters": {
+    "Endpoint": "https://westus.api.cognitive.microsoft.com",
+    "Content-Type": "application/json",
+    "Training-Key": "{API Key}",
+    "projectId": "bc3f7dad-5544-468c-8573-3ef04d55463e",
+    "iterationId": "4d6eb844-42ee-42bc-bd6f-c32455ef07c9",
+    "imageIds": [
+      "e7f08c23-9e54-49f7-b609-69a0240ba306",
+      "ce632666-4b66-4adb-aa0a-ad8b7c32df06"
+    ]
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": [
+        {
+          "id": "8497e814-23cc-47d7-b24b-691cef0bcec9",
+          "project": "bc3f7dad-5544-468c-8573-3ef04d55463e",
+          "iteration": "ce271ee4-cc13-460f-b66f-993f8005522d",
+          "created": "2019-07-08T13:43:18Z",
+          "predictions": [
+            {
+              "tagId": "b5f7e6a2-a481-49a6-afec-a7cef1af3544",
+              "tagName": "Tag 1",
+              "probability": 1.0
+            },
+            {
+              "tagId": "45619cda-d1c9-4bc8-a3e1-87c5d81adbc3",
+              "tagName": "Tag 2",
+              "probability": 3.60627153E-12
+            }
+          ],
+          "predictionUncertainty": 0.32
+        }
+      ]
+    }
+  }
+}
diff --git a/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/TrainProject.json b/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/TrainProject.json
new file mode 100644
index 000000000000..dd3deca15afb
--- /dev/null
+++ b/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/TrainProject.json
@@ -0,0 +1,33 @@
+{
+  "parameters": {
+    "Endpoint": "https://westus.api.cognitive.microsoft.com",
+    "Content-Type": "application/json",
+    "Training-Key": "{API Key}",
+    "projectId": "64b822c5-8082-4b36-a426-27225f4aa18c",
+    "trainingParameters": {}
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": {
+        "id": "e31a14ab-5d78-4f7b-a267-3a1e4fd8a758",
+        "name": "Iteration 2",
+        "status": "Training",
+        "created": "2017-12-18T22:40:36Z",
+        "lastModified": "2017-12-19T15:46:58Z",
+        "projectId": "64b822c5-8082-4b36-a426-27225f4aa18c",
+        "exportable": false,
+        "domainId": null,
+        "exportableTo": [
+          "ONNX",
+          "DockerFile",
+          "TensorFlow",
+          "CoreML"
+        ],
+        "trainingType": "Regular",
+        "reservedBudgetInHours": 0,
+        "publishName": ""
+      }
+    }
+  }
+}
diff --git a/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/UnpublishIteration.json b/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/UnpublishIteration.json
new file mode 100644
index 000000000000..d1f9b7629958
--- /dev/null
+++ b/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/UnpublishIteration.json
@@ -0,0 +1,12 @@
+{
+  "parameters": {
+    "Endpoint": "https://westus.api.cognitive.microsoft.com",
+    "Content-Type": "application/json",
+    "Training-Key": "{API Key}",
+    "projectId": "64b822c5-8082-4b36-a426-27225f4aa18c",
+    "iterationId": "e31a14ab-5d78-4f7b-a267-3a1e4fd8a758"
+  },
+  "responses": {
+    "204": {}
+  }
+}
diff --git a/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/UpdateImageMetadata.json b/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/UpdateImageMetadata.json
new file mode 100644
index 000000000000..54ac8a7a0725
--- /dev/null
+++ b/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/UpdateImageMetadata.json
@@ -0,0 +1,43 @@
+{
+  "parameters": {
+    "Endpoint": "https://westus.api.cognitive.microsoft.com",
+    "Content-Type": "application/json",
+    "Training-Key": "{API Key}",
+    "projectId": "bc3f7dad-5544-468c-8573-3ef04d55463e",
+    "imageIds": [
+      "4d6eb844-42ee-42bc-bd6f-c32455ef07c9"
+    ],
+    "metadata": {
+      "tag": "value"
+    }
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": {
+        "isBatchSuccessful": true,
+        "images": [
+          {
+            "imageId": "4d6eb844-42ee-42bc-bd6f-c32455ef07c9",
+            "status": "OK",
+            "metadata": {
+              "tag": "value"
+            }
+          }
+        ]
+      }
+    },
+    "207": {
+      "headers": {},
+      "body": {
+        "isBatchSuccessful": false,
+        "images": [
+          {
+            "imageId": "4d6eb844-42ee-42bc-bd6f-c32455ef07c9",
+            "status": "ErrorLimitExceed"
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/UpdateIteration.json b/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/UpdateIteration.json
new file mode 100644
index 000000000000..a965deb8aa0f
--- /dev/null
+++ b/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/UpdateIteration.json
@@ -0,0 +1,37 @@
+{
+  "parameters": {
+    "Endpoint": "https://westus.api.cognitive.microsoft.com",
+    "Content-Type": "application/json",
+    "Training-Key": "{API Key}",
+    "projectId": "64b822c5-8082-4b36-a426-27225f4aa18c",
+    "iterationId": "e31a14ab-5d78-4f7b-a267-3a1e4fd8a758",
+    "updatedIteration": {
+      "name": "Best Iteration"
+    }
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": {
+        "id": "e31a14ab-5d78-4f7b-a267-3a1e4fd8a758",
+        "name": "Best Iteration",
+        "status": "Completed",
+        "created": "2017-12-18T22:40:36Z",
+        "lastModified": "2017-12-19T15:53:07Z",
+        "trainedAt": "2017-12-19T15:47:02Z",
+        "projectId": "64b822c5-8082-4b36-a426-27225f4aa18c",
+        "exportable": false,
+        "exportableTo": [
+          "ONNX",
+          "DockerFile",
+          "TensorFlow",
+          "CoreML"
+        ],
+        "domainId": "ee85a74c-405e-4adc-bb47-ffa8ca0c9f31",
+        "trainingType": "Regular",
+        "reservedBudgetInHours": 0,
+        "publishName": ""
+      }
+    }
+  }
+}
diff --git a/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/UpdateProject.json b/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/UpdateProject.json
new file mode 100644
index 000000000000..e19735364b5e
--- /dev/null
+++ b/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/UpdateProject.json
@@ -0,0 +1,31 @@
+{
+  "parameters": {
+    "Endpoint": "https://westus.api.cognitive.microsoft.com",
+    "Content-Type": "application/json",
+    "Training-Key": "{API Key}",
+    "projectId": "bc3f7dad-5544-468c-8573-3ef04d55463e",
+    "updatedProject": {
+      "name": "New Project Name",
+      "description": "A new Description",
+      "settings": {
+        "domainId": "ee85a74c-405e-4adc-bb47-ffa8ca0c9f31"
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": {
+        "id": "bc3f7dad-5544-468c-8573-3ef04d55463e",
+        "name": "New Project Name",
+        "description": "A new Description",
+        "settings": {
+          "domainId": "ee85a74c-405e-4adc-bb47-ffa8ca0c9f31"
+        },
+        "created": "2017-12-18T05:43:18Z",
+        "lastModified": "2017-12-18T05:43:19Z",
+        "thumbnailUri": ""
+      }
+    }
+  }
+}
diff --git a/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/UpdateTag.json b/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/UpdateTag.json
new file mode 100644
index 000000000000..51e0ee680aab
--- /dev/null
+++ b/specification/cognitiveservices/data-plane/CustomVision/Training/preview/v3.4-preview/examples/UpdateTag.json
@@ -0,0 +1,26 @@
+{
+  "parameters": {
+    "Endpoint": "https://westus.api.cognitive.microsoft.com",
+    "Content-Type": "application/json",
+    "Training-Key": "{API Key}",
+    "projectId": "bc3f7dad-5544-468c-8573-3ef04d55463e",
+    "tagId": "9e27bc1b-7ae7-4e3b-a4e5-36153479dc01",
+    "updatedTag": {
+      "name": "Better Tag Name",
+      "type": "Regular",
+      "description": "Better description"
+    }
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": {
+        "id": "9e27bc1b-7ae7-4e3b-a4e5-36153479dc01",
+        "name": "Better Tag Name",
+        "description": "Better description",
+        "type": "Regular",
+        "imageCount": 0
+      }
+    }
+  }
+}
diff --git a/specification/cognitiveservices/data-plane/CustomVision/Training/readme.go.md b/specification/cognitiveservices/data-plane/CustomVision/Training/readme.go.md
index c61b06fde524..e772a9b2b5db 100644
--- a/specification/cognitiveservices/data-plane/CustomVision/Training/readme.go.md
+++ b/specification/cognitiveservices/data-plane/CustomVision/Training/readme.go.md
@@ -21,6 +21,7 @@ batch:
   - tag: release_3_1
   - tag: release_3_2
   - tag: release_3_3
+  - tag: release_3_4_preview
 ```
 
 ### Tag: release_1_0 and go
@@ -84,4 +85,13 @@ Please also specify `--go-sdk-folder=<path to the root directory of your azure-s
 
 ``` yaml $(tag) == 'release_3_3' && $(go)
 output-folder: $(go-sdk-folder)/services/cognitiveservices/v3.3/customvision/$(namespace)
+```
+
+### Tag: release_3_4_preview and go
+
+These settings apply only when `--tag=release_3_4_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) == 'release_3_4_preview' && $(go)
+output-folder: $(go-sdk-folder)/services/preview/cognitiveservices/v3.4-preview/customvision/$(namespace)
 ```
\ No newline at end of file
diff --git a/specification/cognitiveservices/data-plane/CustomVision/Training/readme.md b/specification/cognitiveservices/data-plane/CustomVision/Training/readme.md
index 4941afe9c847..24c4d5e09848 100644
--- a/specification/cognitiveservices/data-plane/CustomVision/Training/readme.md
+++ b/specification/cognitiveservices/data-plane/CustomVision/Training/readme.md
@@ -4,11 +4,11 @@
 
 Configuration for generating Custom Vision Training SDK.
 
-The current release is `release_3_3`.
+The current release is `release_3_4_preview`.
 
 ``` yaml
 
-tag: release_3_3
+tag: release_3_4_preview
 openapi-type: data-plane
 ```
 # Releases
@@ -64,6 +64,14 @@ input-file: stable/v3.3/Training.json
 add-credentials: true
 ```
 
+### Release 3.4-preview
+These settings apply only when `--tag=release_3_4_preview` is specified on the command line.
+
+``` yaml $(tag) == 'release_3_4_preview'
+input-file: preview/v3.4-preview/Training.json
+add-credentials: true
+```
+
 # Validation
 
 ## Suppression
@@ -172,6 +180,7 @@ input-file:
   - $(this-folder)/stable/v3.1/Training.json
   - $(this-folder)/stable/v3.2/Training.json
   - $(this-folder)/stable/v3.3/Training.json
+  - $(this-folder)/preview/v3.4-preview/Training.json
 
 ```
 
diff --git a/specification/cognitiveservices/data-plane/CustomVision/Training/readme.ruby.md b/specification/cognitiveservices/data-plane/CustomVision/Training/readme.ruby.md
index 517819d1250a..e4360fa9e63c 100644
--- a/specification/cognitiveservices/data-plane/CustomVision/Training/readme.ruby.md
+++ b/specification/cognitiveservices/data-plane/CustomVision/Training/readme.ruby.md
@@ -17,6 +17,7 @@ batch:
   - tag: release_3_1
   - tag: release_3_2
   - tag: release_3_3
+  - tag: release_3_4_preview
 ```
 
 ### Tag: release_1_0 and ruby
@@ -73,3 +74,14 @@ namespace: "Azure::CognitiveServices::CustomVision::Training::V3_3"
 output-folder: $(ruby-sdks-folder)/data/azure_cognitiveservices_customvisiontraining/lib
 title: "TrainingClient"
 ```
+
+### Tag: release_3_4_preview and ruby
+
+These settings apply only when `--tag=release_3_4_preview --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) == 'release_3_4_preview' && $(ruby)
+namespace: "Azure::CognitiveServices::CustomVision::Training::V3_4_preview"
+output-folder: $(ruby-sdks-folder)/data/azure_cognitiveservices_customvisiontraining/lib
+title: "TrainingClient"
+```
\ No newline at end of file
diff --git a/specification/cognitiveservices/data-plane/TextAnalytics/preview/v3.2-preview.1/TextAnalytics.json b/specification/cognitiveservices/data-plane/TextAnalytics/preview/v3.1-preview.3/TextAnalytics.json
similarity index 96%
rename from specification/cognitiveservices/data-plane/TextAnalytics/preview/v3.2-preview.1/TextAnalytics.json
rename to specification/cognitiveservices/data-plane/TextAnalytics/preview/v3.1-preview.3/TextAnalytics.json
index 4919269e69fa..3af58c58c528 100644
--- a/specification/cognitiveservices/data-plane/TextAnalytics/preview/v3.2-preview.1/TextAnalytics.json
+++ b/specification/cognitiveservices/data-plane/TextAnalytics/preview/v3.1-preview.3/TextAnalytics.json
@@ -1,7 +1,7 @@
 {
   "swagger": "2.0",
   "info": {
-    "version": "v3.2-preview.1",
+    "version": "v3.1-preview.3",
     "contact": {
       "name": "Microsoft Cognitive Services",
       "url": "https://azure.microsoft.com/en-us/services/cognitive-services/text-analytics/",
@@ -23,7 +23,7 @@
     }
   ],
   "x-ms-parameterized-host": {
-    "hostTemplate": "{Endpoint}/text/analytics/v3.2-preview.1",
+    "hostTemplate": "{Endpoint}/text/analytics/v3.1-preview.3",
     "useSchemePrefix": false,
     "parameters": [
       {
@@ -685,23 +685,11 @@
                 "$ref": "#/definitions/PiiTask"
               }
             },
-            "entityLinkingTasks": {
-              "type": "array",
-              "items": {
-                "$ref": "#/definitions/EntityLinkingTask"
-              }
-            },
             "keyPhraseExtractionTasks": {
               "type": "array",
               "items": {
                 "$ref": "#/definitions/KeyPhrasesTask"
               }
-            },
-            "sentimentAnalysisTasks": {
-              "type": "array",
-              "items": {
-                "$ref": "#/definitions/SentimentTask"
-              }
             }
           },
           "type": "object"
@@ -1021,27 +1009,6 @@
         }
       }
     },
-    "SentimentTask": {
-      "properties": {
-        "parameters": {
-          "properties": {
-            "model-version": {
-              "default": "latest",
-              "type": "string"
-            },
-            "opinionMining": {
-              "default": false,
-              "type": "boolean"
-            },
-            "stringIndexType": {
-              "$ref": "#/definitions/StringIndexType"
-            }
-          },
-          "type": "object"
-        }
-      },
-      "type": "object"
-    },
     "TaskState": {
       "properties": {
         "lastUpdateDateTime": {
@@ -1133,25 +1100,6 @@
                 ]
               }
             },
-            "entityLinkingTasks": {
-              "type": "array",
-              "items": {
-                "type": "object",
-                "allOf": [
-                  {
-                    "$ref": "#/definitions/TaskState"
-                  },
-                  {
-                    "type": "object",
-                    "properties": {
-                      "results": {
-                        "$ref": "#/definitions/EntityLinkingResult"
-                      }
-                    }
-                  }
-                ]
-              }
-            },
             "keyPhraseExtractionTasks": {
               "type": "array",
               "items": {
@@ -1170,25 +1118,6 @@
                   }
                 ]
               }
-            },
-            "sentimentAnalysisTasks": {
-              "type": "array",
-              "items": {
-                "type": "object",
-                "allOf": [
-                  {
-                    "$ref": "#/definitions/TaskState"
-                  },
-                  {
-                    "type": "object",
-                    "properties": {
-                      "results": {
-                        "$ref": "#/definitions/SentimentResponse"
-                      }
-                    }
-                  }
-                ]
-              }
             }
           },
           "required": [
@@ -1732,23 +1661,6 @@
         }
       }
     },
-    "EntityLinkingTask": {
-      "properties": {
-        "parameters": {
-          "properties": {
-            "model-version": {
-              "default": "latest",
-              "type": "string"
-            },
-            "stringIndexType": {
-              "$ref": "#/definitions/StringIndexType"
-            }
-          },
-          "type": "object"
-        }
-      },
-      "type": "object"
-    },
     "HealthcareJobState": {
       "allOf": [
         {
diff --git a/specification/cognitiveservices/data-plane/TextAnalytics/preview/v3.2-preview.1/examples/SuccessfulAnalyzeRequest.json b/specification/cognitiveservices/data-plane/TextAnalytics/preview/v3.1-preview.3/examples/SuccessfulAnalyzeRequest.json
similarity index 91%
rename from specification/cognitiveservices/data-plane/TextAnalytics/preview/v3.2-preview.1/examples/SuccessfulAnalyzeRequest.json
rename to specification/cognitiveservices/data-plane/TextAnalytics/preview/v3.1-preview.3/examples/SuccessfulAnalyzeRequest.json
index bbf8eec44697..87414f0d5cf7 100644
--- a/specification/cognitiveservices/data-plane/TextAnalytics/preview/v3.2-preview.1/examples/SuccessfulAnalyzeRequest.json
+++ b/specification/cognitiveservices/data-plane/TextAnalytics/preview/v3.1-preview.3/examples/SuccessfulAnalyzeRequest.json
@@ -22,7 +22,6 @@
       "tasks": {
         "entityRecognitionTasks": [
           {
-            "enable": true,
             "parameters": {
               "model-version": "latest"
             }
@@ -34,7 +33,7 @@
   "responses": {
     "202": {
       "headers": {
-        "Operation-Location": "{endpoint}/text/analytics/v3.2-preview.1/analyze/jobs/{jobId}"
+        "Operation-Location": "{endpoint}/text/analytics/v3.1-preview.3/analyze/jobs/{jobId}"
       }
     },
     "400": {
diff --git a/specification/cognitiveservices/data-plane/TextAnalytics/preview/v3.2-preview.1/examples/SuccessfulAnalyzeStatusRequest.json b/specification/cognitiveservices/data-plane/TextAnalytics/preview/v3.1-preview.3/examples/SuccessfulAnalyzeStatusRequest.json
similarity index 100%
rename from specification/cognitiveservices/data-plane/TextAnalytics/preview/v3.2-preview.1/examples/SuccessfulAnalyzeStatusRequest.json
rename to specification/cognitiveservices/data-plane/TextAnalytics/preview/v3.1-preview.3/examples/SuccessfulAnalyzeStatusRequest.json
diff --git a/specification/cognitiveservices/data-plane/TextAnalytics/preview/v3.2-preview.1/examples/SuccessfulEntitiesRequest.json b/specification/cognitiveservices/data-plane/TextAnalytics/preview/v3.1-preview.3/examples/SuccessfulEntitiesRequest.json
similarity index 100%
rename from specification/cognitiveservices/data-plane/TextAnalytics/preview/v3.2-preview.1/examples/SuccessfulEntitiesRequest.json
rename to specification/cognitiveservices/data-plane/TextAnalytics/preview/v3.1-preview.3/examples/SuccessfulEntitiesRequest.json
diff --git a/specification/cognitiveservices/data-plane/TextAnalytics/preview/v3.2-preview.1/examples/SuccessfulEntityLinkingRequest.json b/specification/cognitiveservices/data-plane/TextAnalytics/preview/v3.1-preview.3/examples/SuccessfulEntityLinkingRequest.json
similarity index 100%
rename from specification/cognitiveservices/data-plane/TextAnalytics/preview/v3.2-preview.1/examples/SuccessfulEntityLinkingRequest.json
rename to specification/cognitiveservices/data-plane/TextAnalytics/preview/v3.1-preview.3/examples/SuccessfulEntityLinkingRequest.json
diff --git a/specification/cognitiveservices/data-plane/TextAnalytics/preview/v3.2-preview.1/examples/SuccessfulEntityPIIRequest.json b/specification/cognitiveservices/data-plane/TextAnalytics/preview/v3.1-preview.3/examples/SuccessfulEntityPIIRequest.json
similarity index 100%
rename from specification/cognitiveservices/data-plane/TextAnalytics/preview/v3.2-preview.1/examples/SuccessfulEntityPIIRequest.json
rename to specification/cognitiveservices/data-plane/TextAnalytics/preview/v3.1-preview.3/examples/SuccessfulEntityPIIRequest.json
diff --git a/specification/cognitiveservices/data-plane/TextAnalytics/preview/v3.2-preview.1/examples/SuccessfulHealthDeleteRequest.json b/specification/cognitiveservices/data-plane/TextAnalytics/preview/v3.1-preview.3/examples/SuccessfulHealthDeleteRequest.json
similarity index 85%
rename from specification/cognitiveservices/data-plane/TextAnalytics/preview/v3.2-preview.1/examples/SuccessfulHealthDeleteRequest.json
rename to specification/cognitiveservices/data-plane/TextAnalytics/preview/v3.1-preview.3/examples/SuccessfulHealthDeleteRequest.json
index 383705014761..ef2721ece65d 100644
--- a/specification/cognitiveservices/data-plane/TextAnalytics/preview/v3.2-preview.1/examples/SuccessfulHealthDeleteRequest.json
+++ b/specification/cognitiveservices/data-plane/TextAnalytics/preview/v3.1-preview.3/examples/SuccessfulHealthDeleteRequest.json
@@ -7,7 +7,7 @@
   "responses": {
     "202": {
       "headers": {
-        "Operation-Location": "{endpoint}/text/analytics/v3.2-preview.1/entities/healthcare/jobs/{jobId}"
+        "Operation-Location": "{endpoint}/text/analytics/v3.1-preview.3/entities/healthcare/jobs/{jobId}"
       }
     },
     "404": {
diff --git a/specification/cognitiveservices/data-plane/TextAnalytics/preview/v3.2-preview.1/examples/SuccessfulHealthRequest.json b/specification/cognitiveservices/data-plane/TextAnalytics/preview/v3.1-preview.3/examples/SuccessfulHealthRequest.json
similarity index 89%
rename from specification/cognitiveservices/data-plane/TextAnalytics/preview/v3.2-preview.1/examples/SuccessfulHealthRequest.json
rename to specification/cognitiveservices/data-plane/TextAnalytics/preview/v3.1-preview.3/examples/SuccessfulHealthRequest.json
index 989b7d60ad85..7fe69d163906 100644
--- a/specification/cognitiveservices/data-plane/TextAnalytics/preview/v3.2-preview.1/examples/SuccessfulHealthRequest.json
+++ b/specification/cognitiveservices/data-plane/TextAnalytics/preview/v3.1-preview.3/examples/SuccessfulHealthRequest.json
@@ -16,7 +16,7 @@
   "responses": {
     "202": {
       "headers": {
-        "Operation-Location": "{endpoint}/text/analytics/v3.2-preview.1/entities/healthcare/jobs/{jobId}"
+        "Operation-Location": "{endpoint}/text/analytics/v3.1-preview.3/entities/healthcare/jobs/{jobId}"
       }
     },
     "400": {
diff --git a/specification/cognitiveservices/data-plane/TextAnalytics/preview/v3.2-preview.1/examples/SuccessfulHealthStatusRequest.json b/specification/cognitiveservices/data-plane/TextAnalytics/preview/v3.1-preview.3/examples/SuccessfulHealthStatusRequest.json
similarity index 100%
rename from specification/cognitiveservices/data-plane/TextAnalytics/preview/v3.2-preview.1/examples/SuccessfulHealthStatusRequest.json
rename to specification/cognitiveservices/data-plane/TextAnalytics/preview/v3.1-preview.3/examples/SuccessfulHealthStatusRequest.json
diff --git a/specification/cognitiveservices/data-plane/TextAnalytics/preview/v3.2-preview.1/examples/SuccessfulKeyPhrasesRequest.json b/specification/cognitiveservices/data-plane/TextAnalytics/preview/v3.1-preview.3/examples/SuccessfulKeyPhrasesRequest.json
similarity index 100%
rename from specification/cognitiveservices/data-plane/TextAnalytics/preview/v3.2-preview.1/examples/SuccessfulKeyPhrasesRequest.json
rename to specification/cognitiveservices/data-plane/TextAnalytics/preview/v3.1-preview.3/examples/SuccessfulKeyPhrasesRequest.json
diff --git a/specification/cognitiveservices/data-plane/TextAnalytics/preview/v3.2-preview.1/examples/SuccessfulLanguagesRequest.json b/specification/cognitiveservices/data-plane/TextAnalytics/preview/v3.1-preview.3/examples/SuccessfulLanguagesRequest.json
similarity index 100%
rename from specification/cognitiveservices/data-plane/TextAnalytics/preview/v3.2-preview.1/examples/SuccessfulLanguagesRequest.json
rename to specification/cognitiveservices/data-plane/TextAnalytics/preview/v3.1-preview.3/examples/SuccessfulLanguagesRequest.json
diff --git a/specification/cognitiveservices/data-plane/TextAnalytics/preview/v3.2-preview.1/examples/SuccessfulSentimentRequest.json b/specification/cognitiveservices/data-plane/TextAnalytics/preview/v3.1-preview.3/examples/SuccessfulSentimentRequest.json
similarity index 100%
rename from specification/cognitiveservices/data-plane/TextAnalytics/preview/v3.2-preview.1/examples/SuccessfulSentimentRequest.json
rename to specification/cognitiveservices/data-plane/TextAnalytics/preview/v3.1-preview.3/examples/SuccessfulSentimentRequest.json
diff --git a/specification/cognitiveservices/data-plane/TextAnalytics/readme.md b/specification/cognitiveservices/data-plane/TextAnalytics/readme.md
index 615abb66e584..5fb753b1b464 100644
--- a/specification/cognitiveservices/data-plane/TextAnalytics/readme.md
+++ b/specification/cognitiveservices/data-plane/TextAnalytics/readme.md
@@ -92,12 +92,12 @@ These settings apply only when `--tag=release_3_1_preview.2` is specified on the
 input-file: preview/v3.1-preview.2/TextAnalytics.json
 ```
 
-### Release 3.2-Preview.1
+### Release 3.1-Preview.3
 
 These settings apply only when `--tag=release_3_2_preview.1` is specified on the command line.
 
 ``` yaml $(tag) == 'release_3_2_preview.1'
-input-file: preview/v3.2-preview.1/TextAnalytics.json
+input-file: preview/v3.1-preview.3/TextAnalytics.json
 ```
 
 ## Swagger to SDK
diff --git a/specification/common-types/resource-management/v1/types.json b/specification/common-types/resource-management/v1/types.json
index 7415ea29529d..765dd32c358d 100644
--- a/specification/common-types/resource-management/v1/types.json
+++ b/specification/common-types/resource-management/v1/types.json
@@ -7,11 +7,13 @@
   "paths": {},
   "definitions": {
     "Resource": {
+      "title": "Resource",
+      "description": "Common fields that are returned in the response for all Azure Resource Manager resources",
       "properties": {
         "id": {
           "readOnly": true,
           "type": "string",
-          "description": "Fully qualified resource Id for the resource. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
+          "description": "Fully qualified resource ID for the resource. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
         },
         "name": {
           "readOnly": true,
@@ -21,14 +23,15 @@
         "type": {
           "readOnly": true,
           "type": "string",
-          "description": "The type of the resource. Ex- Microsoft.Compute/virtualMachines or Microsoft.Storage/storageAccounts."
+          "description": "The type of the resource. E.g. \"Microsoft.Compute/virtualMachines\" or \"Microsoft.Storage/storageAccounts\""
         }
       },
       "x-ms-azure-resource": true
     },
     "AzureEntityResource": {
       "x-ms-client-name": "AzureEntityResource",
-      "description": "The resource model definition for a Azure Resource Manager resource with an etag.",
+      "title": "Entity Resource",
+      "description": "The resource model definition for an Azure Resource Manager resource with an etag.",
       "properties": {
         "etag": {
           "type": "string",
@@ -43,7 +46,8 @@
       ]
     },
     "TrackedResource": {
-      "description": "The resource model definition for a ARM tracked top level resource",
+      "title": "Tracked Resource",
+      "description": "The resource model definition for an Azure Resource Manager tracked top level resource which has 'tags' and a 'location'",
       "properties": {
         "tags": {
           "type": "object",
@@ -76,7 +80,8 @@
       ]
     },
     "ProxyResource": {
-      "description": "The resource model definition for a ARM proxy resource. It will have everything other than required location and tags",
+      "title": "Proxy Resource",
+      "description": "The resource model definition for a Azure Resource Manager proxy resource. It will not have tags and a location",
       "allOf": [
         {
           "$ref": "#/definitions/Resource"
@@ -92,7 +97,7 @@
           "x-ms-mutability": [
             "read"
           ],
-          "description": "Fully qualified resource Id for the resource. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
+          "description": "Fully qualified resource ID for the resource. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
         },
         "name": {
           "readOnly": true,
@@ -105,7 +110,7 @@
           "x-ms-mutability": [
             "read"
           ],
-          "description": "The type of the resource. Ex- Microsoft.Compute/virtualMachines or Microsoft.Storage/storageAccounts.."
+          "description": "The type of the resource. E.g. \"Microsoft.Compute/virtualMachines\" or \"Microsoft.Storage/storageAccounts\""
         },
         "location": {
           "type": "string",
@@ -270,6 +275,8 @@
       ]
     },
     "ErrorResponse": {
+      "title": "Error Response",
+      "description": "Common error response for all Azure Resource Manager APIs to return error details for failed operations. (This also follows the OData error response format.)",
       "properties": {
         "code": {
           "readOnly": true,
@@ -302,8 +309,7 @@
           },
           "description": "The error additional info."
         }
-      },
-      "description": "The resource management error response."
+      }
     },
     "ErrorAdditionalInfo": {
       "properties": {
@@ -320,6 +326,92 @@
       },
       "description": "The resource management error additional info."
     },
+    "Operation": {
+      "title": "REST API Operation",
+      "description": "Details of a REST API operation, returned from the Resource Provider Operations API",
+      "type": "object",
+      "properties": {
+        "name": {
+          "description": "The name of the operation, as per Resource-Based Access Control (RBAC). Examples: \"Microsoft.Compute/virtualMachines/write\", \"Microsoft.Compute/virtualMachines/capture/action\"",
+          "type": "string",
+          "readOnly": true
+        },
+        "isDataAction": {
+          "description": "Whether the operation applies to data-plane. This is \"true\" for data-plane operations and \"false\" for ARM/control-plane operations.",
+          "type": "boolean",
+          "readOnly": true
+        },
+        "display": {
+          "description": "Localized display information for this particular operation.",
+          "properties": {
+            "provider": {
+              "description": "The localized friendly form of the resource provider name, e.g. \"Microsoft Monitoring Insights\" or \"Microsoft Compute\".",
+              "type": "string",
+              "readOnly": true
+            },
+            "resource": {
+              "description": "The localized friendly name of the resource type related to this operation. E.g. \"Virtual Machines\" or \"Job Schedule Collections\".",
+              "type": "string",
+              "readOnly": true
+            },
+            "operation": {
+              "description": "The concise, localized friendly name for the operation; suitable for dropdowns. E.g. \"Create or Update Virtual Machine\", \"Restart Virtual Machine\".",
+              "type": "string",
+              "readOnly": true
+            },
+            "description": {
+              "description": "The short, localized friendly description of the operation; suitable for tool tips and detailed views.",
+              "type": "string",
+              "readOnly": true
+            }
+          }
+        },
+        "origin": {
+          "description": "The intended executor of the operation; as in Resource Based Access Control (RBAC) and audit logs UX. Default value is \"user,system\"",
+          "type": "string",
+          "readOnly": true,
+          "enum": [
+            "user",
+            "system",
+            "user,system"
+          ],
+          "x-ms-enum": {
+            "name": "Origin",
+            "modelAsString": true
+          }
+        },
+        "actionType": {
+          "description": "Enum. Indicates the action type. \"Internal\" refers to actions that are for internal only APIs.",
+          "type": "string",
+          "readOnly": true,
+          "enum": [
+            "Internal"
+          ],
+          "x-ms-enum": {
+            "name": "ActionType",
+            "modelAsString": true
+          }
+        }
+      }
+    },
+    "OperationListResult": {
+      "description": "A list of REST API operations supported by an Azure Resource Provider. It contains an URL link to get the next set of results.",
+      "properties": {
+        "value": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/Operation"
+          },
+          "description": "List of operations supported by the resource provider",
+          "readOnly": true
+        },
+        "nextLink": {
+          "type": "string",
+          "description": "URL to get the next set of operation list results (if there are any).",
+          "readOnly": true
+        }
+      }
+    },
     "locationData": {
       "description": "Metadata pertaining to the geographic location of the resource.",
       "type": "object",
@@ -429,7 +521,7 @@
           "type": "string"
         },
         "identity": {
-          "description": "The client id of the identity which will be used to access key vault.",
+          "description": "The client ID of the identity which will be used to access key vault.",
           "type": "string"
         }
       }
diff --git a/specification/common-types/resource-management/v2/types.json b/specification/common-types/resource-management/v2/types.json
index 7ef5fc2bb4a0..b350d61b7e98 100644
--- a/specification/common-types/resource-management/v2/types.json
+++ b/specification/common-types/resource-management/v2/types.json
@@ -7,11 +7,12 @@
   "paths": {},
   "definitions": {
     "Resource": {
+      "description": "Common fields that are returned in the response for all Azure Resource Manager resources",
       "properties": {
         "id": {
           "readOnly": true,
           "type": "string",
-          "description": "Fully qualified resource Id for the resource. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
+          "description": "Fully qualified resource ID for the resource. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
         },
         "name": {
           "readOnly": true,
@@ -21,15 +22,14 @@
         "type": {
           "readOnly": true,
           "type": "string",
-          "description": "The type of the resource. Ex- Microsoft.Compute/virtualMachines or Microsoft.Storage/storageAccounts."
+          "description": "The type of the resource. E.g. \"Microsoft.Compute/virtualMachines\" or \"Microsoft.Storage/storageAccounts\""
         }
       },
-      "description": "The resource model definition for a ARM tracked top level resource",
       "x-ms-azure-resource": true
     },
     "AzureEntityResource": {
       "x-ms-client-name": "AzureEntityResource",
-      "description": "The resource model definition for a Azure Resource Manager resource with an etag.",
+      "description": "The resource model definition for an Azure Resource Manager resource with an etag.",
       "properties": {
         "etag": {
           "type": "string",
@@ -44,7 +44,7 @@
       ]
     },
     "TrackedResource": {
-      "description": "The resource model definition for a ARM tracked top level resource",
+      "description": "The resource model definition for an Azure Resource Manager tracked top level resource",
       "properties": {
         "tags": {
           "type": "object",
@@ -77,7 +77,7 @@
       ]
     },
     "ProxyResource": {
-      "description": "The resource model definition for a ARM proxy resource. It will have everything other than required location and tags",
+      "description": "The resource model definition for an Azure Resource Manager proxy resource. It will have everything other than required location and tags",
       "allOf": [
         {
           "$ref": "#/definitions/Resource"
@@ -93,7 +93,7 @@
           "x-ms-mutability": [
             "read"
           ],
-          "description": "Fully qualified resource Id for the resource. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
+          "description": "Fully qualified resource ID for the resource. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
         },
         "name": {
           "readOnly": true,
@@ -106,7 +106,7 @@
           "x-ms-mutability": [
             "read"
           ],
-          "description": "The type of the resource. Ex- Microsoft.Compute/virtualMachines or Microsoft.Storage/storageAccounts.."
+          "description": "The type of the resource. E.g. \"Microsoft.Compute/virtualMachines\" or \"Microsoft.Storage/storageAccounts\""
         },
         "location": {
           "type": "string",
@@ -123,7 +123,7 @@
             "create",
             "update"
           ],
-          "description": "The  fully qualified resource ID of the resource that manages this resource. Indicates if this resource is managed by another azure resource. If this is present, complete mode deployment will not delete the resource if it is removed from the template since it is managed by another resource."
+          "description": "The fully qualified resource ID of the resource that manages this resource. Indicates if this resource is managed by another Azure resource. If this is present, complete mode deployment will not delete the resource if it is removed from the template since it is managed by another resource."
         },
         "kind": {
           "type": "string",
@@ -207,7 +207,7 @@
         "capacity": {
           "type": "integer",
           "format": "int32",
-          "description": "If the SKU supports scale out/in then the capacity integer should be included. If scale out/in is not possible for the resource this may be omitted."
+          "description": "If the SKU supports scale out/in then the capacity integer indicates the current scaling-factor of the resource. If scale out/in is not possible for the resource this may be omitted."
         }
       },
       "required": [
@@ -327,6 +327,91 @@
       },
       "description": "The resource management error additional info."
     },
+    "Operation": {
+      "description": "Details of a REST API operation, returned from the Resource Provider Operations API",
+      "type": "object",
+      "properties": {
+        "name": {
+          "description": "The name of the operation, as per Resource-Based Access Control (RBAC). Examples: \"Microsoft.Compute/virtualMachines/write\", \"Microsoft.Compute/virtualMachines/capture/action\"",
+          "type": "string",
+          "readOnly": true
+        },
+        "isDataAction": {
+          "description": "Whether the operation applies to data-plane. This is \"true\" for data-plane operations and \"false\" for ARM/control-plane operations.",
+          "type": "boolean",
+          "readOnly": true
+        },
+        "display": {
+          "description": "Localized display information for this particular operation.",
+          "properties": {
+            "provider": {
+              "description": "The localized friendly form of the resource provider name, e.g. \"Microsoft Monitoring Insights\" or \"Microsoft Compute\".",
+              "type": "string",
+              "readOnly": true
+            },
+            "resource": {
+              "description": "The localized friendly name of the resource type related to this operation. E.g. \"Virtual Machines\" or \"Job Schedule Collections\".",
+              "type": "string",
+              "readOnly": true
+            },
+            "operation": {
+              "description": "The concise, localized friendly name for the operation; suitable for dropdowns. E.g. \"Create or Update Virtual Machine\", \"Restart Virtual Machine\".",
+              "type": "string",
+              "readOnly": true
+            },
+            "description": {
+              "description": "The short, localized friendly description of the operation; suitable for tool tips and detailed views.",
+              "type": "string",
+              "readOnly": true
+            }
+          }
+        },
+        "origin": {
+          "description": "The intended executor of the operation; as in Resource Based Access Control (RBAC) and audit logs UX. Default value is \"user,system\"",
+          "type": "string",
+          "readOnly": true,
+          "enum": [
+            "user",
+            "system",
+            "user,system"
+          ],
+          "x-ms-enum": {
+            "name": "Origin",
+            "modelAsString": true
+          }
+        },
+        "actionType": {
+          "description": "Enum. Indicates the action type. \"Internal\" refers to actions that are for internal only APIs.",
+          "type": "string",
+          "readOnly": true,
+          "enum": [
+            "Internal"
+          ],
+          "x-ms-enum": {
+            "name": "ActionType",
+            "modelAsString": true
+          }
+        }
+      }
+    },
+    "OperationListResult": {
+      "description": "A list of REST API operations supported by an Azure Resource Provider. It contains an URL link to get the next set of results.",
+      "properties": {
+        "value": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/Operation"
+          },
+          "description": "List of operations supported by the resource provider",
+          "readOnly": true
+        },
+        "nextLink": {
+          "type": "string",
+          "description": "URL to get the next set of operation list results (if there are any).",
+          "readOnly": true
+        }
+      }
+    },
     "locationData": {
       "description": "Metadata pertaining to the geographic location of the resource.",
       "type": "object",
@@ -436,7 +521,7 @@
           "type": "string"
         },
         "identity": {
-          "description": "The client id of the identity which will be used to access key vault.",
+          "description": "The client ID of the identity which will be used to access key vault.",
           "type": "string"
         }
       }
diff --git a/specification/communication/resource-manager/Microsoft.Communication/preview/2020-08-20-preview/CommunicationService.json b/specification/communication/resource-manager/Microsoft.Communication/preview/2020-08-20-preview/CommunicationService.json
index 6e840a1d9a20..33b5c40e5fef 100644
--- a/specification/communication/resource-manager/Microsoft.Communication/preview/2020-08-20-preview/CommunicationService.json
+++ b/specification/communication/resource-manager/Microsoft.Communication/preview/2020-08-20-preview/CommunicationService.json
@@ -62,6 +62,60 @@
         }
       }
     },
+    "/subscriptions/{subscriptionId}/providers/Microsoft.Communication/checkNameAvailability": {
+      "post": {
+        "description": "Checks that the CommunicationService name is valid and is not already in use.",
+        "operationId": "CommunicationService_CheckNameAvailability",
+        "summary": "Check Name Availability",
+        "tags": [
+          "CommunicationService"
+        ],
+        "parameters": [
+          {
+            "name": "nameAvailabilityParameters",
+            "in": "body",
+            "schema": {
+              "$ref": "#/definitions/NameAvailabilityParameters"
+            },
+            "description": "Parameters supplied to the operation."
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          }
+        ],
+        "consumes": [
+          "application/json"
+        ],
+        "responses": {
+          "200": {
+            "description": "Success. The response describes the name availability.",
+            "schema": {
+              "$ref": "#/definitions/NameAvailability"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "produces": [
+          "application/json"
+        ],
+        "x-ms-examples": {
+          "Check name availability available": {
+            "$ref": "./examples/checkNameAvailabilityAvailable.json"
+          },
+          "Check name availability unavailable": {
+            "$ref": "./examples/checkNameAvailabilityUnavailable.json"
+          }
+        }
+      }
+    },
     "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Communication/communicationServices/{communicationServiceName}/linkNotificationHub": {
       "post": {
         "description": "Links an Azure Notification Hub to this communication service.",
@@ -763,6 +817,42 @@
         }
       }
     },
+    "NameAvailabilityParameters": {
+      "description": "Data POST-ed to the nameAvailability action",
+      "required": [
+        "type",
+        "name"
+      ],
+      "type": "object",
+      "properties": {
+        "type": {
+          "description": "The resource type. Should be always \"Microsoft.Communication/CommunicationServices\".",
+          "type": "string"
+        },
+        "name": {
+          "description": "The CommunicationService name to validate. e.g.\"my-CommunicationService-name-here\"",
+          "type": "string"
+        }
+      }
+    },
+    "NameAvailability": {
+      "description": "Result of the request to check name availability. It contains a flag and possible reason of failure.",
+      "type": "object",
+      "properties": {
+        "nameAvailable": {
+          "description": "Indicates whether the name is available or not.",
+          "type": "boolean"
+        },
+        "reason": {
+          "description": "The reason of the availability. Required if name is not available.",
+          "type": "string"
+        },
+        "message": {
+          "description": "The message of the operation.",
+          "type": "string"
+        }
+      }
+    },
     "LinkNotificationHubParameters": {
       "description": "Description of an Azure Notification Hub to link to the communication service",
       "required": [
@@ -796,7 +886,7 @@
       "type": "object",
       "properties": {
         "id": {
-          "description": "The operation Id.",
+          "description": "Fully qualified ID for the operation status.",
           "type": "string",
           "readOnly": true
         },
diff --git a/specification/communication/resource-manager/Microsoft.Communication/preview/2020-08-20-preview/examples/checkNameAvailabilityAvailable.json b/specification/communication/resource-manager/Microsoft.Communication/preview/2020-08-20-preview/examples/checkNameAvailabilityAvailable.json
new file mode 100644
index 000000000000..ed8a879a190e
--- /dev/null
+++ b/specification/communication/resource-manager/Microsoft.Communication/preview/2020-08-20-preview/examples/checkNameAvailabilityAvailable.json
@@ -0,0 +1,19 @@
+{
+  "parameters": {
+    "subscriptionId": "12345",
+    "api-version": "2020-08-20-preview",
+    "nameAvailabilityParameters": {
+      "type": "Microsoft.Communication/CommunicationServices",
+      "name": "MyCommunicationService"
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "nameAvailable": true,
+        "reason": "NameAvailable",
+        "message": "Requested name is available for the requested type"
+      }
+    }
+  }
+}
diff --git a/specification/communication/resource-manager/Microsoft.Communication/preview/2020-08-20-preview/examples/checkNameAvailabilityUnavailable.json b/specification/communication/resource-manager/Microsoft.Communication/preview/2020-08-20-preview/examples/checkNameAvailabilityUnavailable.json
new file mode 100644
index 000000000000..a2e050f47ccc
--- /dev/null
+++ b/specification/communication/resource-manager/Microsoft.Communication/preview/2020-08-20-preview/examples/checkNameAvailabilityUnavailable.json
@@ -0,0 +1,19 @@
+{
+  "parameters": {
+    "subscriptionId": "12345",
+    "api-version": "2020-08-20-preview",
+    "nameAvailabilityParameters": {
+      "type": "Microsoft.Communication/CommunicationServices",
+      "name": "MyCommunicationService"
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "nameAvailable": false,
+        "reason": "AlreadyExists",
+        "message": "Requested name is unavailable for the requested type"
+      }
+    }
+  }
+}
diff --git a/specification/communication/resource-manager/readme.java.md b/specification/communication/resource-manager/readme.java.md
new file mode 100644
index 000000000000..9c6341c30e98
--- /dev/null
+++ b/specification/communication/resource-manager/readme.java.md
@@ -0,0 +1,33 @@
+## Java
+
+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)
+azure-arm: true
+fluent: true
+namespace: com.microsoft.azure.management.communication
+license-header: MICROSOFT_MIT_NO_CODEGEN
+payload-flattening-threshold: 1
+output-folder: $(azure-libraries-for-java-folder)/azure-mgmt-communication
+```
+
+### Java multi-api
+
+``` yaml $(java) && $(multiapi)
+batch:
+  - tag: package-2020-08-20-preview
+```
+
+### Tag: package-2020-08-20-preview and java
+
+These settings apply only when `--tag=package-2020-08-20-preview --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-08-20-preview' && $(java) && $(multiapi)
+java:
+  namespace: com.microsoft.azure.management.communication.v2020_08_20_preview
+  output-folder: $(azure-libraries-for-java-folder)/sdk/communication/mgmt-v2020_08_20_preview
+regenerate-manager: true
+generate-interface: true
+```
\ No newline at end of file
diff --git a/specification/communication/resource-manager/readme.md b/specification/communication/resource-manager/readme.md
index f5b5483ca415..ecbda968e72b 100644
--- a/specification/communication/resource-manager/readme.md
+++ b/specification/communication/resource-manager/readme.md
@@ -54,6 +54,7 @@ swagger-to-sdk:
   - repo: azure-sdk-for-python-track2
   - repo: azure-sdk-for-go
   - repo: azure-sdk-for-js
+  - repo: azure-sdk-for-java
 ```
 
 ## CSharp
diff --git a/specification/compute/resource-manager/Microsoft.Compute/preview/2020-09-30/examples/CreateOrUpdateASimpleGalleryApplicationVersion.json b/specification/compute/resource-manager/Microsoft.Compute/preview/2020-09-30/examples/CreateOrUpdateASimpleGalleryApplicationVersion.json
index 6942466a93b3..079b456f748a 100644
--- a/specification/compute/resource-manager/Microsoft.Compute/preview/2020-09-30/examples/CreateOrUpdateASimpleGalleryApplicationVersion.json
+++ b/specification/compute/resource-manager/Microsoft.Compute/preview/2020-09-30/examples/CreateOrUpdateASimpleGalleryApplicationVersion.json
@@ -11,9 +11,12 @@
       "properties": {
         "publishingProfile": {
           "source": {
-            "fileName": "package.zip",
             "mediaLink": "https://mystorageaccount.blob.core.windows.net/mycontainer/package.zip?{sasKey}"
           },
+          "manageActions": {
+            "install": "powershell -command \"Expand-Archive -Path package.zip -DestinationPath C:\\package\"",
+            "remove": "del C:\\package "
+          },
           "targetRegions": [
             {
               "name": "West US",
@@ -38,9 +41,12 @@
         "properties": {
           "publishingProfile": {
             "source": {
-              "fileName": "package.zip",
               "mediaLink": "https://mystorageaccount.blob.core.windows.net/mycontainer/package.zip?{sasKey}"
             },
+            "manageActions": {
+              "install": "powershell -command \"Expand-Archive -Path package.zip -DestinationPath C:\\package\"",
+              "remove": "del C:\\package "
+            },
             "enableHealthCheck": false,
             "targetRegions": [
               {
@@ -68,9 +74,12 @@
         "properties": {
           "publishingProfile": {
             "source": {
-              "fileName": "package.zip",
               "mediaLink": "https://mystorageaccount.blob.core.windows.net/mycontainer/package.zip?{sasKey}"
             },
+            "manageActions": {
+              "install": "powershell -command \"Expand-Archive -Path package.zip -DestinationPath C:\\package\"",
+              "remove": "del C:\\package "
+            },
             "enableHealthCheck": false,
             "targetRegions": [
               {
@@ -98,9 +107,12 @@
         "properties": {
           "publishingProfile": {
             "source": {
-              "fileName": "package.zip",
               "mediaLink": "https://mystorageaccount.blob.core.windows.net/mycontainer/package.zip?{sasKey}"
             },
+            "manageActions": {
+              "install": "powershell -command \"Expand-Archive -Path package.zip -DestinationPath C:\\package\"",
+              "remove": "del C:\\package "
+            },
             "enableHealthCheck": false,
             "targetRegions": [
               {
diff --git a/specification/compute/resource-manager/Microsoft.Compute/preview/2020-09-30/examples/GetAGalleryApplicationVersion.json b/specification/compute/resource-manager/Microsoft.Compute/preview/2020-09-30/examples/GetAGalleryApplicationVersion.json
index ca16dd2d6f84..0affffec2e45 100644
--- a/specification/compute/resource-manager/Microsoft.Compute/preview/2020-09-30/examples/GetAGalleryApplicationVersion.json
+++ b/specification/compute/resource-manager/Microsoft.Compute/preview/2020-09-30/examples/GetAGalleryApplicationVersion.json
@@ -17,9 +17,12 @@
         "properties": {
           "publishingProfile": {
             "source": {
-              "fileName": "package.zip",
               "mediaLink": "https://mystorageaccount.blob.core.windows.net/mycontainer/package.zip?{sasKey}"
             },
+            "manageActions": {
+              "install": "powershell -command \"Expand-Archive -Path package.zip -DestinationPath C:\\package\"",
+              "remove": "del C:\\package "
+            },
             "enableHealthCheck": false,
             "targetRegions": [
               {
diff --git a/specification/compute/resource-manager/Microsoft.Compute/preview/2020-09-30/examples/GetAGalleryApplicationVersionWithReplicationStatus.json b/specification/compute/resource-manager/Microsoft.Compute/preview/2020-09-30/examples/GetAGalleryApplicationVersionWithReplicationStatus.json
index e3d246d4bf3e..776ea72e0c03 100644
--- a/specification/compute/resource-manager/Microsoft.Compute/preview/2020-09-30/examples/GetAGalleryApplicationVersionWithReplicationStatus.json
+++ b/specification/compute/resource-manager/Microsoft.Compute/preview/2020-09-30/examples/GetAGalleryApplicationVersionWithReplicationStatus.json
@@ -14,9 +14,12 @@
         "properties": {
           "publishingProfile": {
             "source": {
-              "fileName": "package.zip",
               "mediaLink": "https://mystorageaccount.blob.core.windows.net/mycontainer/package.zip?{sasKey}"
             },
+            "manageActions": {
+              "install": "powershell -command \"Expand-Archive -Path package.zip -DestinationPath C:\\package\"",
+              "remove": "del C:\\package "
+            },
             "enableHealthCheck": false,
             "targetRegions": [
               {
diff --git a/specification/compute/resource-manager/Microsoft.Compute/preview/2020-09-30/examples/ListGalleryApplicationVersionsInAGalleryApplication.json b/specification/compute/resource-manager/Microsoft.Compute/preview/2020-09-30/examples/ListGalleryApplicationVersionsInAGalleryApplication.json
index 0899c17bfafe..b0ea6bfdba57 100644
--- a/specification/compute/resource-manager/Microsoft.Compute/preview/2020-09-30/examples/ListGalleryApplicationVersionsInAGalleryApplication.json
+++ b/specification/compute/resource-manager/Microsoft.Compute/preview/2020-09-30/examples/ListGalleryApplicationVersionsInAGalleryApplication.json
@@ -18,9 +18,12 @@
             "properties": {
               "publishingProfile": {
                 "source": {
-                  "fileName": "package.zip",
                   "mediaLink": "https://mystorageaccount.blob.core.windows.net/mycontainer/package.zip?{sasKey}"
                 },
+                "manageActions": {
+                  "install": "powershell -command \"Expand-Archive -Path package.zip -DestinationPath C:\\package\"",
+                  "remove": "del C:\\package "
+                },
                 "enableHealthCheck": false,
                 "targetRegions": [
                   {
diff --git a/specification/compute/resource-manager/Microsoft.Compute/preview/2020-09-30/examples/UpdateASimpleGalleryApplicationVersion.json b/specification/compute/resource-manager/Microsoft.Compute/preview/2020-09-30/examples/UpdateASimpleGalleryApplicationVersion.json
index 8d473b578024..9933e2d8d709 100644
--- a/specification/compute/resource-manager/Microsoft.Compute/preview/2020-09-30/examples/UpdateASimpleGalleryApplicationVersion.json
+++ b/specification/compute/resource-manager/Microsoft.Compute/preview/2020-09-30/examples/UpdateASimpleGalleryApplicationVersion.json
@@ -10,9 +10,12 @@
       "properties": {
         "publishingProfile": {
           "source": {
-            "fileName": "package.zip",
             "mediaLink": "https://mystorageaccount.blob.core.windows.net/mycontainer/package.zip?{sasKey}"
           },
+          "manageActions": {
+            "install": "powershell -command \"Expand-Archive -Path package.zip -DestinationPath C:\\package\"",
+            "remove": "del C:\\package "
+          },
           "targetRegions": [
             {
               "name": "West US",
@@ -37,9 +40,12 @@
         "properties": {
           "publishingProfile": {
             "source": {
-              "fileName": "package.zip",
               "mediaLink": "https://mystorageaccount.blob.core.windows.net/mycontainer/package.zip?{sasKey}"
             },
+            "manageActions": {
+              "install": "powershell -command \"Expand-Archive -Path package.zip -DestinationPath C:\\package\"",
+              "remove": "del C:\\package "
+            },
             "enableHealthCheck": false,
             "targetRegions": [
               {
diff --git a/specification/compute/resource-manager/Microsoft.Compute/preview/2020-09-30/gallery.json b/specification/compute/resource-manager/Microsoft.Compute/preview/2020-09-30/gallery.json
index b5e64bcf9dde..9a8a338f6bc5 100644
--- a/specification/compute/resource-manager/Microsoft.Compute/preview/2020-09-30/gallery.json
+++ b/specification/compute/resource-manager/Microsoft.Compute/preview/2020-09-30/gallery.json
@@ -191,7 +191,7 @@
               "Permissions"
             ],
             "x-ms-enum": {
-              "name": "Permissions",
+              "name": "SelectPermissions",
               "modelAsString": true
             }
           }
@@ -1943,9 +1943,8 @@
         "source": {
           "$ref": "#/definitions/UserArtifactSource"
         },
-        "contentType": {
-          "type": "string",
-          "description": "Optional. May be used to help process this file. The type of file contained in the source, e.g. zip, json, etc."
+        "manageActions": {
+          "$ref": "#/definitions/UserArtifactManage"
         },
         "enableHealthCheck": {
           "type": "boolean",
@@ -1964,21 +1963,40 @@
     },
     "UserArtifactSource": {
       "properties": {
-        "fileName": {
+        "mediaLink": {
           "type": "string",
-          "description": "Required. The fileName of the artifact."
+          "description": "Required. The mediaLink of the artifact, must be a readable storage page blob."
         },
-        "mediaLink": {
+        "defaultConfigurationLink": {
           "type": "string",
-          "description": "Required. The mediaLink of the artifact, must be a readable storage blob."
+          "description": "Optional. The defaultConfigurationLink of the artifact, must be a readable storage page blob."
         }
       },
       "required": [
-        "fileName",
         "mediaLink"
       ],
       "description": "The source image from which the Image Version is going to be created."
     },
+    "UserArtifactManage": {
+      "properties": {
+        "install": {
+          "type": "string",
+          "description": "Required. The path and arguments to install the gallery application. This is limited to 4096 characters."
+        },
+        "remove": {
+          "type": "string",
+          "description": "Required. The path and arguments to remove the gallery application. This is limited to 4096 characters."
+        },
+        "update": {
+          "type": "string",
+          "description": "Optional. The path and arguments to update the gallery application. If not present, then update operation will invoke remove command on the previous version and install command on the current version of the gallery application. This is limited to 4096 characters."
+        }
+      },
+      "required": [
+        "install",
+        "remove"
+      ]
+    },
     "GalleryImage": {
       "properties": {
         "properties": {
diff --git a/specification/compute/resource-manager/Microsoft.Compute/stable/2018-06-01/compute.json b/specification/compute/resource-manager/Microsoft.Compute/stable/2018-06-01/compute.json
index acdb3a9dc59d..fcf7286b3a90 100644
--- a/specification/compute/resource-manager/Microsoft.Compute/stable/2018-06-01/compute.json
+++ b/specification/compute/resource-manager/Microsoft.Compute/stable/2018-06-01/compute.json
@@ -6230,6 +6230,7 @@
           "type": "object",
           "additionalProperties": {
             "type": "object",
+            "x-ms-client-name": "userAssignedIdentitiesValue",
             "properties": {
               "principalId": {
                 "readOnly": true,
@@ -6816,6 +6817,7 @@
           "type": "object",
           "additionalProperties": {
             "type": "object",
+            "x-ms-client-name": "VirtualMachineScaleSetIdentityUserAssignedIdentitiesValue",
             "properties": {
               "principalId": {
                 "readOnly": true,
diff --git a/specification/compute/resource-manager/Microsoft.Compute/stable/2018-10-01/compute.json b/specification/compute/resource-manager/Microsoft.Compute/stable/2018-10-01/compute.json
index 429401d44d5f..c1ca9d3fb99c 100644
--- a/specification/compute/resource-manager/Microsoft.Compute/stable/2018-10-01/compute.json
+++ b/specification/compute/resource-manager/Microsoft.Compute/stable/2018-10-01/compute.json
@@ -6261,6 +6261,7 @@
           "type": "object",
           "additionalProperties": {
             "type": "object",
+            "x-ms-client-name": "userAssignedIdentitiesValue",
             "properties": {
               "principalId": {
                 "readOnly": true,
@@ -6847,6 +6848,7 @@
           "type": "object",
           "additionalProperties": {
             "type": "object",
+            "x-ms-client-name": "VirtualMachineScaleSetIdentityUserAssignedIdentitiesValue",
             "properties": {
               "principalId": {
                 "readOnly": true,
diff --git a/specification/compute/resource-manager/Microsoft.Compute/stable/2019-03-01/compute.json b/specification/compute/resource-manager/Microsoft.Compute/stable/2019-03-01/compute.json
index 7c34a03be331..dea2056032ca 100644
--- a/specification/compute/resource-manager/Microsoft.Compute/stable/2019-03-01/compute.json
+++ b/specification/compute/resource-manager/Microsoft.Compute/stable/2019-03-01/compute.json
@@ -7183,6 +7183,7 @@
           "type": "object",
           "additionalProperties": {
             "type": "object",
+            "x-ms-client-name": "userAssignedIdentitiesValue",
             "properties": {
               "principalId": {
                 "readOnly": true,
@@ -7846,6 +7847,7 @@
           "type": "object",
           "additionalProperties": {
             "type": "object",
+            "x-ms-client-name": "VirtualMachineScaleSetIdentityUserAssignedIdentitiesValue",
             "properties": {
               "principalId": {
                 "readOnly": true,
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 cf7a3113540a..a62367787669 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
@@ -2597,7 +2597,7 @@
           "VirtualMachines"
         ],
         "operationId": "VirtualMachines_ConvertToManagedDisks",
-        "description": "Converts virtual machine disks from blob-based to managed disks. Virtual machine must be stop-deallocated before invoking this operation.",
+        "description": "Converts virtual machine disks from blob-based to managed disks. Virtual machine must be stop-deallocated before invoking this operation. <br>For Windows, please refer to [Convert a virtual machine from unmanaged disks to managed disks.](https://docs.microsoft.com/en-us/azure/virtual-machines/windows/convert-unmanaged-to-managed-disks).<br>For Linux, please refer to [Convert a virtual machine from unmanaged disks to managed disks.](https://docs.microsoft.com/en-us/azure/virtual-machines/linux/convert-unmanaged-to-managed-disks).",
         "parameters": [
           {
             "name": "resourceGroupName",
@@ -2628,6 +2628,11 @@
             "description": "Accepted"
           }
         },
+        "x-ms-examples": {
+          "Generalize a Virtual Machine.": {
+            "$ref": "./examples/ConvertToManagedDisks.json"
+          }
+        },
         "x-ms-long-running-operation": true
       }
     },
@@ -3108,7 +3113,7 @@
           "VirtualMachines"
         ],
         "operationId": "VirtualMachines_PerformMaintenance",
-        "description": "The operation to perform maintenance on a virtual machine.",
+        "description": "Shuts down the virtual machine, moves it to an already updated node, and powers it back on during the self-service phase of planned maintenance.",
         "parameters": [
           {
             "name": "resourceGroupName",
@@ -5555,7 +5560,7 @@
           "VirtualMachineScaleSetVMs"
         ],
         "operationId": "VirtualMachineScaleSetVMs_PerformMaintenance",
-        "description": "Performs maintenance on a virtual machine in a VM scale set.",
+        "description": "Shuts down the virtual machine in a VMScaleSet, moves it to an already updated node, and powers it back on during the self-service phase of planned maintenance.",
         "parameters": [
           {
             "name": "resourceGroupName",
@@ -7735,6 +7740,7 @@
           "type": "object",
           "additionalProperties": {
             "type": "object",
+            "x-ms-client-name": "userAssignedIdentitiesValue",
             "properties": {
               "principalId": {
                 "readOnly": true,
@@ -8373,6 +8379,7 @@
           "type": "object",
           "additionalProperties": {
             "type": "object",
+            "x-ms-client-name": "VirtualMachineScaleSetIdentityUserAssignedIdentitiesValue",
             "properties": {
               "principalId": {
                 "readOnly": true,
diff --git a/specification/compute/resource-manager/Microsoft.Compute/stable/2019-07-01/examples/ConvertToManagedDisks.json b/specification/compute/resource-manager/Microsoft.Compute/stable/2019-07-01/examples/ConvertToManagedDisks.json
new file mode 100644
index 000000000000..1fbfea58c94c
--- /dev/null
+++ b/specification/compute/resource-manager/Microsoft.Compute/stable/2019-07-01/examples/ConvertToManagedDisks.json
@@ -0,0 +1,12 @@
+{
+  "parameters": {
+    "subscriptionId": "{subscription-id}",
+    "resourceGroupName": "myResourceGroup",
+    "api-version": "2019-07-01",
+    "vmName": "myVMName"
+  },
+  "responses": {
+    "200": {},
+    "202": {}
+  }
+}
diff --git a/specification/compute/resource-manager/Microsoft.Compute/stable/2019-12-01/compute.json b/specification/compute/resource-manager/Microsoft.Compute/stable/2019-12-01/compute.json
index 338767d2b350..dab0c1d0b7a3 100644
--- a/specification/compute/resource-manager/Microsoft.Compute/stable/2019-12-01/compute.json
+++ b/specification/compute/resource-manager/Microsoft.Compute/stable/2019-12-01/compute.json
@@ -2894,7 +2894,7 @@
           "VirtualMachines"
         ],
         "operationId": "VirtualMachines_ConvertToManagedDisks",
-        "description": "Converts virtual machine disks from blob-based to managed disks. Virtual machine must be stop-deallocated before invoking this operation.",
+        "description": "Converts virtual machine disks from blob-based to managed disks. Virtual machine must be stop-deallocated before invoking this operation. <br>For Windows, please refer to [Convert a virtual machine from unmanaged disks to managed disks.](https://docs.microsoft.com/en-us/azure/virtual-machines/windows/convert-unmanaged-to-managed-disks).<br>For Linux, please refer to [Convert a virtual machine from unmanaged disks to managed disks.](https://docs.microsoft.com/en-us/azure/virtual-machines/linux/convert-unmanaged-to-managed-disks).",
         "parameters": [
           {
             "name": "resourceGroupName",
@@ -2925,6 +2925,11 @@
             "description": "Accepted"
           }
         },
+        "x-ms-examples": {
+          "Generalize a Virtual Machine.": {
+            "$ref": "./examples/ConvertToManagedDisks.json"
+          }
+        },
         "x-ms-long-running-operation": true
       }
     },
@@ -3405,7 +3410,7 @@
           "VirtualMachines"
         ],
         "operationId": "VirtualMachines_PerformMaintenance",
-        "description": "The operation to perform maintenance on a virtual machine.",
+        "description": "Shuts down the virtual machine, moves it to an already updated node, and powers it back on during the self-service phase of planned maintenance.",
         "parameters": [
           {
             "name": "resourceGroupName",
@@ -5946,7 +5951,7 @@
           "VirtualMachineScaleSetVMs"
         ],
         "operationId": "VirtualMachineScaleSetVMs_PerformMaintenance",
-        "description": "Performs maintenance on a virtual machine in a VM scale set.",
+        "description": "Shuts down the virtual machine in a VMScaleSet, moves it to an already updated node, and powers it back on during the self-service phase of planned maintenance.",
         "parameters": [
           {
             "name": "resourceGroupName",
@@ -8271,6 +8276,7 @@
           "type": "object",
           "additionalProperties": {
             "type": "object",
+            "x-ms-client-name": "userAssignedIdentitiesValue",
             "properties": {
               "principalId": {
                 "readOnly": true,
@@ -8909,6 +8915,7 @@
           "type": "object",
           "additionalProperties": {
             "type": "object",
+            "x-ms-client-name": "VirtualMachineScaleSetIdentityUserAssignedIdentitiesValue",
             "properties": {
               "principalId": {
                 "readOnly": true,
diff --git a/specification/compute/resource-manager/Microsoft.Compute/stable/2019-12-01/examples/ConvertToManagedDisks.json b/specification/compute/resource-manager/Microsoft.Compute/stable/2019-12-01/examples/ConvertToManagedDisks.json
new file mode 100644
index 000000000000..39ec366b8d4d
--- /dev/null
+++ b/specification/compute/resource-manager/Microsoft.Compute/stable/2019-12-01/examples/ConvertToManagedDisks.json
@@ -0,0 +1,12 @@
+{
+  "parameters": {
+    "subscriptionId": "{subscription-id}",
+    "resourceGroupName": "myResourceGroup",
+    "api-version": "2019-12-01",
+    "vmName": "myVMName"
+  },
+  "responses": {
+    "200": {},
+    "202": {}
+  }
+}
diff --git a/specification/compute/resource-manager/Microsoft.Compute/stable/2020-06-01/compute.json b/specification/compute/resource-manager/Microsoft.Compute/stable/2020-06-01/compute.json
index e680df16e276..c5b9fffa733b 100644
--- a/specification/compute/resource-manager/Microsoft.Compute/stable/2020-06-01/compute.json
+++ b/specification/compute/resource-manager/Microsoft.Compute/stable/2020-06-01/compute.json
@@ -5181,7 +5181,7 @@
             "in": "body",
             "required": true,
             "schema": {
-              "$ref": "#/definitions/VirtualMachineExtension"
+              "$ref": "#/definitions/VirtualMachineScaleSetVMExtension"
             },
             "description": "Parameters supplied to the Create Virtual Machine Extension operation."
           },
@@ -5196,13 +5196,13 @@
           "200": {
             "description": "OK",
             "schema": {
-              "$ref": "#/definitions/VirtualMachineExtension"
+              "$ref": "#/definitions/VirtualMachineScaleSetVMExtension"
             }
           },
           "201": {
             "description": "Created",
             "schema": {
-              "$ref": "#/definitions/VirtualMachineExtension"
+              "$ref": "#/definitions/VirtualMachineScaleSetVMExtension"
             }
           },
           "default": {
@@ -5259,7 +5259,7 @@
             "in": "body",
             "required": true,
             "schema": {
-              "$ref": "#/definitions/VirtualMachineExtensionUpdate"
+              "$ref": "#/definitions/VirtualMachineScaleSetVMExtensionUpdate"
             },
             "description": "Parameters supplied to the Update Virtual Machine Extension operation."
           },
@@ -5274,7 +5274,7 @@
           "200": {
             "description": "OK",
             "schema": {
-              "$ref": "#/definitions/VirtualMachineExtension"
+              "$ref": "#/definitions/VirtualMachineScaleSetVMExtension"
             }
           },
           "default": {
@@ -5410,7 +5410,7 @@
           "200": {
             "description": "OK",
             "schema": {
-              "$ref": "#/definitions/VirtualMachineExtension"
+              "$ref": "#/definitions/VirtualMachineScaleSetVMExtension"
             }
           },
           "default": {
@@ -5474,7 +5474,7 @@
           "200": {
             "description": "OK",
             "schema": {
-              "$ref": "#/definitions/VirtualMachineExtensionsListResult"
+              "$ref": "#/definitions/VirtualMachineScaleSetVMExtensionsListResult"
             }
           },
           "default": {
@@ -7340,6 +7340,30 @@
       ],
       "description": "Describes a Virtual Machine Extension."
     },
+    "VirtualMachineScaleSetVMExtension": {
+      "properties": {
+        "name": {
+          "readOnly": true,
+          "type": "string",
+          "description": "The name of the extension."
+        },
+        "type": {
+          "readOnly": true,
+          "type": "string",
+          "description": "Resource type"
+        },
+        "properties": {
+          "x-ms-client-flatten": true,
+          "$ref": "#/definitions/VirtualMachineExtensionProperties"
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "#/definitions/SubResourceReadOnly"
+        }
+      ],
+      "description": "Describes a VMSS VM Extension."
+    },
     "VirtualMachineExtensionUpdate": {
       "properties": {
         "properties": {
@@ -7354,6 +7378,30 @@
       ],
       "description": "Describes a Virtual Machine Extension."
     },
+    "VirtualMachineScaleSetVMExtensionUpdate": {
+      "properties": {
+        "name": {
+          "readOnly": true,
+          "type": "string",
+          "description": "The name of the extension."
+        },
+        "type": {
+          "readOnly": true,
+          "type": "string",
+          "description": "Resource type"
+        },
+        "properties": {
+          "x-ms-client-flatten": true,
+          "$ref": "#/definitions/VirtualMachineExtensionUpdateProperties"
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "#/definitions/SubResourceReadOnly"
+        }
+      ],
+      "description": "Describes a VMSS VM Extension."
+    },
     "VirtualMachineExtensionsListResult": {
       "properties": {
         "value": {
@@ -7366,6 +7414,18 @@
       },
       "description": "The List Extension operation response"
     },
+    "VirtualMachineScaleSetVMExtensionsListResult": {
+      "properties": {
+        "value": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/VirtualMachineScaleSetVMExtension"
+          },
+          "description": "The list of VMSS VM extensions"
+        }
+      },
+      "description": "The List VMSS VM Extension operation response"
+    },
     "VirtualMachineSoftwarePatchProperties": {
       "properties": {
         "patchId": {
@@ -8750,6 +8810,7 @@
           "type": "object",
           "additionalProperties": {
             "type": "object",
+            "x-ms-client-name": "userAssignedIdentitiesValue",
             "properties": {
               "principalId": {
                 "readOnly": true,
@@ -9414,6 +9475,7 @@
           "type": "object",
           "additionalProperties": {
             "type": "object",
+            "x-ms-client-name": "VirtualMachineScaleSetIdentityUserAssignedIdentitiesValue",
             "properties": {
               "principalId": {
                 "readOnly": true,
diff --git a/specification/compute/resource-manager/Microsoft.Compute/stable/2020-06-01/examples/CreateOrUpdateVirtualMachineScaleSetVMExtensions.json b/specification/compute/resource-manager/Microsoft.Compute/stable/2020-06-01/examples/CreateOrUpdateVirtualMachineScaleSetVMExtensions.json
index 5e3dbf00975a..40185d51f90e 100644
--- a/specification/compute/resource-manager/Microsoft.Compute/stable/2020-06-01/examples/CreateOrUpdateVirtualMachineScaleSetVMExtensions.json
+++ b/specification/compute/resource-manager/Microsoft.Compute/stable/2020-06-01/examples/CreateOrUpdateVirtualMachineScaleSetVMExtensions.json
@@ -7,7 +7,6 @@
     "vmExtensionName": "myVMExtension",
     "api-version": "2020-06-01",
     "extensionParameters": {
-      "location": "westus",
       "properties": {
         "autoUpgradeMinorVersion": true,
         "publisher": "extPublisher",
@@ -23,7 +22,6 @@
     "201": {
       "body": {
         "name": "myVMExtension",
-        "location": "westus",
         "type": "Microsoft.Compute/virtualMachineScaleSets/virtualMachines/extensions",
         "id": "/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/myvmScaleSet/virtualMachines/0/extensions/myVMExtension",
         "properties": {
@@ -41,7 +39,6 @@
     "200": {
       "body": {
         "name": "myVMExtension",
-        "location": "westus",
         "type": "Microsoft.Compute/virtualMachineScaleSets/virtualMachines/extensions",
         "id": "/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/myvmScaleSet/virtualMachines/0/extensions/myVMExtension",
         "properties": {
diff --git a/specification/compute/resource-manager/Microsoft.Compute/stable/2020-06-01/examples/GetVirtualMachineScaleSetVMExtensions.json b/specification/compute/resource-manager/Microsoft.Compute/stable/2020-06-01/examples/GetVirtualMachineScaleSetVMExtensions.json
index 2c27ae1e263c..fbba0cdbf56c 100644
--- a/specification/compute/resource-manager/Microsoft.Compute/stable/2020-06-01/examples/GetVirtualMachineScaleSetVMExtensions.json
+++ b/specification/compute/resource-manager/Microsoft.Compute/stable/2020-06-01/examples/GetVirtualMachineScaleSetVMExtensions.json
@@ -21,7 +21,6 @@
           }
         },
         "name": "myVMExtension",
-        "location": "westus",
         "type": "Microsoft.Compute/virtualMachineScaleSets/virtualMachines/extensions",
         "id": "/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/myvmScaleSet/virtualMachines/0/extensions/myVMExtension"
       }
diff --git a/specification/compute/resource-manager/Microsoft.Compute/stable/2020-06-01/examples/ListVirtualMachineScaleSetVMExtensions.json b/specification/compute/resource-manager/Microsoft.Compute/stable/2020-06-01/examples/ListVirtualMachineScaleSetVMExtensions.json
index f2120acb750a..f670b23fd41d 100644
--- a/specification/compute/resource-manager/Microsoft.Compute/stable/2020-06-01/examples/ListVirtualMachineScaleSetVMExtensions.json
+++ b/specification/compute/resource-manager/Microsoft.Compute/stable/2020-06-01/examples/ListVirtualMachineScaleSetVMExtensions.json
@@ -22,7 +22,6 @@
               }
             },
             "name": "myVMExtension",
-            "location": "westus",
             "type": "Microsoft.Compute/virtualMachineScaleSets/virtualMachines/extensions",
             "id": "/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/myvmScaleSet/virtualMachines/0/extensions/myVMExtension"
           },
@@ -38,7 +37,6 @@
               }
             },
             "name": "myVMExtension1",
-            "location": "westus",
             "type": "Microsoft.Compute/virtualMachineScaleSets/virtualMachines/extensions",
             "id": "/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/myvmScaleSet/virtualMachines/0/extensions/myVMExtension1"
           }
diff --git a/specification/compute/resource-manager/Microsoft.Compute/stable/2020-06-01/examples/UpdateVirtualMachineScaleSetVMExtensions.json b/specification/compute/resource-manager/Microsoft.Compute/stable/2020-06-01/examples/UpdateVirtualMachineScaleSetVMExtensions.json
index 659ea562168a..c1a159448f23 100644
--- a/specification/compute/resource-manager/Microsoft.Compute/stable/2020-06-01/examples/UpdateVirtualMachineScaleSetVMExtensions.json
+++ b/specification/compute/resource-manager/Microsoft.Compute/stable/2020-06-01/examples/UpdateVirtualMachineScaleSetVMExtensions.json
@@ -22,7 +22,6 @@
     "200": {
       "body": {
         "name": "myVMExtension",
-        "location": "westus",
         "type": "Microsoft.Compute/virtualMachineScaleSets/virtualMachines/extensions",
         "id": "/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/myvmScaleSet/virtualMachines/0/extensions/myVMExtension",
         "properties": {
diff --git a/specification/compute/resource-manager/readme.md b/specification/compute/resource-manager/readme.md
index 052addaaae0f..77a4f29a7025 100644
--- a/specification/compute/resource-manager/readme.md
+++ b/specification/compute/resource-manager/readme.md
@@ -34,7 +34,7 @@ These are the global settings for the Compute API.
 title: ComputeManagementClient
 description: Compute Client
 openapi-type: arm
-tag: package-2020-06-30
+tag: package-2020-09-30
 
 directive:
   - where:
@@ -209,52 +209,52 @@ directive:
       - ACS service is deprecated so a PATCH endpoint won't be implemented
 
 ```
-### Tag: package-2020-06-30
+### Tag: package-2020-09-30
 
-These settings apply only when `--tag=package-2020-06-30` is specified on the command line.
+These settings apply only when `--tag=package-2020-09-30` is specified on the command line.
 
-``` yaml $(tag) == 'package-2020-06-30'
+``` yaml $(tag) == 'package-2020-09-30'
 input-file:
 - Microsoft.Compute/stable/2020-06-01/compute.json
 - Microsoft.Compute/stable/2020-06-01/runCommands.json
 - Microsoft.Compute/stable/2019-04-01/skus.json
 - Microsoft.Compute/stable/2020-06-30/disk.json
-- Microsoft.Compute/stable/2019-12-01/gallery.json
+- Microsoft.Compute/preview/2020-09-30/gallery.json
+- Microsoft.Compute/preview/2020-09-30/sharedGallery.json
 - Microsoft.ContainerService/stable/2017-01-31/containerService.json
 ```
 
-### Tag: package-2020-06-30-only
+### Tag: package-2020-09-30-only
 
-These settings apply only when `--tag=package-2020-06-30-only` is specified on the command line.
+These settings apply only when `--tag=package-2020-09-30-only` is specified on the command line.
 
-``` yaml $(tag) == 'package-2020-06-30-only'
+``` yaml $(tag) == 'package-2020-09-30-only'
 input-file:
-- Microsoft.Compute/stable/2020-06-30/disk.json
+- Microsoft.Compute/preview/2020-09-30/gallery.json
+- Microsoft.Compute/preview/2020-09-30/sharedGallery.json
 ```
 
-### Tag: package-2020-09-30
+### Tag: package-2020-06-30
 
-These settings apply only when `--tag=package-2020-09-30` is specified on the command line.
+These settings apply only when `--tag=package-2020-06-30` is specified on the command line.
 
-``` yaml $(tag) == 'package-2020-09-30'
+``` yaml $(tag) == 'package-2020-06-30'
 input-file:
 - Microsoft.Compute/stable/2020-06-01/compute.json
 - Microsoft.Compute/stable/2020-06-01/runCommands.json
 - Microsoft.Compute/stable/2019-04-01/skus.json
-- Microsoft.Compute/stable/2020-05-01/disk.json
-- Microsoft.Compute/preview/2020-09-30/gallery.json
-- Microsoft.Compute/preview/2020-09-30/sharedGallery.json
+- Microsoft.Compute/stable/2020-06-30/disk.json
+- Microsoft.Compute/stable/2019-12-01/gallery.json
 - Microsoft.ContainerService/stable/2017-01-31/containerService.json
 ```
 
-### Tag: package-2020-09-30-only
+### Tag: package-2020-06-30-only
 
-These settings apply only when `--tag=package-2020-09-30-only` is specified on the command line.
+These settings apply only when `--tag=package-2020-06-30-only` is specified on the command line.
 
-``` yaml $(tag) == 'package-2020-09-30-only'
+``` yaml $(tag) == 'package-2020-06-30-only'
 input-file:
-- Microsoft.Compute/preview/2020-09-30/gallery.json
-- Microsoft.Compute/preview/2020-09-30/sharedGallery.json
+- Microsoft.Compute/stable/2020-06-30/disk.json
 ```
 
 ### Tag: package-2020-06-01
diff --git a/specification/confluent/resource-manager/Microsoft.Confluent/preview/2020-03-01-preview/confluent.json b/specification/confluent/resource-manager/Microsoft.Confluent/preview/2020-03-01-preview/confluent.json
index 548105316200..ac78123f302a 100644
--- a/specification/confluent/resource-manager/Microsoft.Confluent/preview/2020-03-01-preview/confluent.json
+++ b/specification/confluent/resource-manager/Microsoft.Confluent/preview/2020-03-01-preview/confluent.json
@@ -561,7 +561,7 @@
         },
         "emailAddress": {
           "description": "Email address",
-          "pattern": "^[\\w\\.\\-+!%\"\\s]+@[a-zA-Z_]+?\\.[a-zA-Z]{2,3}$",
+          "pattern": "^[\\w\\.\\-+!%\"\\s]+@[a-zA-Z0-9_\\-]+?\\.[a-zA-Z0-9]{2,7}$",
           "type": "string"
         }
       }
diff --git a/specification/confluent/resource-manager/readme.go.md b/specification/confluent/resource-manager/readme.go.md
index b77f72b8db96..11ba4585bdff 100644
--- a/specification/confluent/resource-manager/readme.go.md
+++ b/specification/confluent/resource-manager/readme.go.md
@@ -9,6 +9,13 @@ go:
   clear-output-folder: true
 ```
 
+### Go multi-api
+
+``` yaml $(go) && $(multiapi)
+batch:
+  - tag: package-2020-03-01-preview
+```
+
 ### Tag: package-2020-03-01-preview and go
 
 These settings apply only when `--tag=package-2020-03-01-preview --go` is specified on the command line.
diff --git a/specification/containerservice/resource-manager/Microsoft.ContainerService/stable/2019-04-01/managedClusters.json b/specification/containerservice/resource-manager/Microsoft.ContainerService/stable/2019-04-01/managedClusters.json
index fb24414f041a..49f59d3be75c 100644
--- a/specification/containerservice/resource-manager/Microsoft.ContainerService/stable/2019-04-01/managedClusters.json
+++ b/specification/containerservice/resource-manager/Microsoft.ContainerService/stable/2019-04-01/managedClusters.json
@@ -1386,13 +1386,11 @@
       "properties": {
         "adminUsername": {
           "type": "string",
-          "description": "The administrator username to use for Windows VMs.",
-          "pattern": "^[a-zA-Z0-9]+([._]?[a-zA-Z0-9]+)*$"
+          "description": "Specifies the name of the administrator account. <br><br> **restriction:** Cannot end in \".\" <br><br> **Disallowed values:** \"administrator\", \"admin\", \"user\", \"user1\", \"test\", \"user2\", \"test1\", \"user3\", \"admin1\", \"1\", \"123\", \"a\", \"actuser\", \"adm\", \"admin2\", \"aspnet\", \"backup\", \"console\", \"david\", \"guest\", \"john\", \"owner\", \"root\", \"server\", \"sql\", \"support\", \"support_388945a0\", \"sys\", \"test2\", \"test3\", \"user4\", \"user5\". <br><br> **Minimum-length:** 1 character <br><br> **Max-length:** 20 characters"
         },
         "adminPassword": {
           "type": "string",
-          "description": "The administrator password to use for Windows VMs.",
-          "pattern": "^(?=.*[a-z])(?=.*[A-Z])(?=.*[!@#$%\\^&\\*\\(\\)])[a-zA-Z\\d!@#$%\\^&\\*\\(\\)]{12,123}$"
+          "description": "Specifies the password of the administrator account. <br><br> **Minimum-length:** 8 characters <br><br> **Max-length:** 123 characters <br><br> **Complexity requirements:** 3 out of 4 conditions below need to be fulfilled <br> Has lower characters <br>Has upper characters <br> Has a digit <br> Has a special character (Regex match [\\W_]) <br><br> **Disallowed values:** \"abc@123\", \"P@$$w0rd\", \"P@ssw0rd\", \"P@ssword123\", \"Pa$$word\", \"pass@word1\", \"Password!\", \"Password1\", \"Password22\", \"iloveyou!\""
         }
       },
       "required": [
diff --git a/specification/containerservice/resource-manager/Microsoft.ContainerService/stable/2019-06-01/managedClusters.json b/specification/containerservice/resource-manager/Microsoft.ContainerService/stable/2019-06-01/managedClusters.json
index da7e5b3496df..c476b8355ae6 100644
--- a/specification/containerservice/resource-manager/Microsoft.ContainerService/stable/2019-06-01/managedClusters.json
+++ b/specification/containerservice/resource-manager/Microsoft.ContainerService/stable/2019-06-01/managedClusters.json
@@ -1488,13 +1488,11 @@
       "properties": {
         "adminUsername": {
           "type": "string",
-          "description": "The administrator username to use for Windows VMs.",
-          "pattern": "^[a-zA-Z0-9]+([._]?[a-zA-Z0-9]+)*$"
+          "description": "Specifies the name of the administrator account. <br><br> **restriction:** Cannot end in \".\" <br><br> **Disallowed values:** \"administrator\", \"admin\", \"user\", \"user1\", \"test\", \"user2\", \"test1\", \"user3\", \"admin1\", \"1\", \"123\", \"a\", \"actuser\", \"adm\", \"admin2\", \"aspnet\", \"backup\", \"console\", \"david\", \"guest\", \"john\", \"owner\", \"root\", \"server\", \"sql\", \"support\", \"support_388945a0\", \"sys\", \"test2\", \"test3\", \"user4\", \"user5\". <br><br> **Minimum-length:** 1 character <br><br> **Max-length:** 20 characters"
         },
         "adminPassword": {
           "type": "string",
-          "description": "The administrator password to use for Windows VMs.",
-          "pattern": "^(?=.*[a-z])(?=.*[A-Z])(?=.*[!@#$%\\^&\\*\\(\\)])[a-zA-Z\\d!@#$%\\^&\\*\\(\\)]{12,123}$"
+          "description": "Specifies the password of the administrator account. <br><br> **Minimum-length:** 8 characters <br><br> **Max-length:** 123 characters <br><br> **Complexity requirements:** 3 out of 4 conditions below need to be fulfilled <br> Has lower characters <br>Has upper characters <br> Has a digit <br> Has a special character (Regex match [\\W_]) <br><br> **Disallowed values:** \"abc@123\", \"P@$$w0rd\", \"P@ssw0rd\", \"P@ssword123\", \"Pa$$word\", \"pass@word1\", \"Password!\", \"Password1\", \"Password22\", \"iloveyou!\""
         }
       },
       "required": [
diff --git a/specification/containerservice/resource-manager/Microsoft.ContainerService/stable/2019-08-01/managedClusters.json b/specification/containerservice/resource-manager/Microsoft.ContainerService/stable/2019-08-01/managedClusters.json
index d50dcee822ab..d336ac2148f8 100644
--- a/specification/containerservice/resource-manager/Microsoft.ContainerService/stable/2019-08-01/managedClusters.json
+++ b/specification/containerservice/resource-manager/Microsoft.ContainerService/stable/2019-08-01/managedClusters.json
@@ -1532,13 +1532,11 @@
       "properties": {
         "adminUsername": {
           "type": "string",
-          "description": "The administrator username to use for Windows VMs.",
-          "pattern": "^[a-zA-Z0-9]+([._]?[a-zA-Z0-9]+)*$"
+          "description": "Specifies the name of the administrator account. <br><br> **restriction:** Cannot end in \".\" <br><br> **Disallowed values:** \"administrator\", \"admin\", \"user\", \"user1\", \"test\", \"user2\", \"test1\", \"user3\", \"admin1\", \"1\", \"123\", \"a\", \"actuser\", \"adm\", \"admin2\", \"aspnet\", \"backup\", \"console\", \"david\", \"guest\", \"john\", \"owner\", \"root\", \"server\", \"sql\", \"support\", \"support_388945a0\", \"sys\", \"test2\", \"test3\", \"user4\", \"user5\". <br><br> **Minimum-length:** 1 character <br><br> **Max-length:** 20 characters"
         },
         "adminPassword": {
           "type": "string",
-          "description": "The administrator password to use for Windows VMs.",
-          "pattern": "^(?=.*[a-z])(?=.*[A-Z])(?=.*[!@#$%\\^&\\*\\(\\)])[a-zA-Z\\d!@#$%\\^&\\*\\(\\)]{12,123}$"
+          "description": "Specifies the password of the administrator account. <br><br> **Minimum-length:** 8 characters <br><br> **Max-length:** 123 characters <br><br> **Complexity requirements:** 3 out of 4 conditions below need to be fulfilled <br> Has lower characters <br>Has upper characters <br> Has a digit <br> Has a special character (Regex match [\\W_]) <br><br> **Disallowed values:** \"abc@123\", \"P@$$w0rd\", \"P@ssw0rd\", \"P@ssword123\", \"Pa$$word\", \"pass@word1\", \"Password!\", \"Password1\", \"Password22\", \"iloveyou!\""
         }
       },
       "required": [
diff --git a/specification/containerservice/resource-manager/Microsoft.ContainerService/stable/2019-10-01/managedClusters.json b/specification/containerservice/resource-manager/Microsoft.ContainerService/stable/2019-10-01/managedClusters.json
index 585ad556f9e0..b218cd442c75 100644
--- a/specification/containerservice/resource-manager/Microsoft.ContainerService/stable/2019-10-01/managedClusters.json
+++ b/specification/containerservice/resource-manager/Microsoft.ContainerService/stable/2019-10-01/managedClusters.json
@@ -1575,13 +1575,11 @@
       "properties": {
         "adminUsername": {
           "type": "string",
-          "description": "The administrator username to use for Windows VMs.",
-          "pattern": "^[a-zA-Z0-9]+([._]?[a-zA-Z0-9]+)*$"
+          "description": "Specifies the name of the administrator account. <br><br> **restriction:** Cannot end in \".\" <br><br> **Disallowed values:** \"administrator\", \"admin\", \"user\", \"user1\", \"test\", \"user2\", \"test1\", \"user3\", \"admin1\", \"1\", \"123\", \"a\", \"actuser\", \"adm\", \"admin2\", \"aspnet\", \"backup\", \"console\", \"david\", \"guest\", \"john\", \"owner\", \"root\", \"server\", \"sql\", \"support\", \"support_388945a0\", \"sys\", \"test2\", \"test3\", \"user4\", \"user5\". <br><br> **Minimum-length:** 1 character <br><br> **Max-length:** 20 characters"
         },
         "adminPassword": {
           "type": "string",
-          "description": "The administrator password to use for Windows VMs.",
-          "pattern": "^(?=.*[a-z])(?=.*[A-Z])(?=.*[!@#$%\\^&\\*\\(\\)])[a-zA-Z\\d!@#$%\\^&\\*\\(\\)]{12,123}$"
+          "description": "Specifies the password of the administrator account. <br><br> **Minimum-length:** 8 characters <br><br> **Max-length:** 123 characters <br><br> **Complexity requirements:** 3 out of 4 conditions below need to be fulfilled <br> Has lower characters <br>Has upper characters <br> Has a digit <br> Has a special character (Regex match [\\W_]) <br><br> **Disallowed values:** \"abc@123\", \"P@$$w0rd\", \"P@ssw0rd\", \"P@ssword123\", \"Pa$$word\", \"pass@word1\", \"Password!\", \"Password1\", \"Password22\", \"iloveyou!\""
         }
       },
       "required": [
diff --git a/specification/containerservice/resource-manager/Microsoft.ContainerService/stable/2019-11-01/managedClusters.json b/specification/containerservice/resource-manager/Microsoft.ContainerService/stable/2019-11-01/managedClusters.json
index 8ebd1e442d6b..0be553652cb2 100644
--- a/specification/containerservice/resource-manager/Microsoft.ContainerService/stable/2019-11-01/managedClusters.json
+++ b/specification/containerservice/resource-manager/Microsoft.ContainerService/stable/2019-11-01/managedClusters.json
@@ -1589,13 +1589,11 @@
       "properties": {
         "adminUsername": {
           "type": "string",
-          "description": "The administrator username to use for Windows VMs.",
-          "pattern": "^[a-zA-Z0-9]+([._]?[a-zA-Z0-9]+)*$"
+          "description": "Specifies the name of the administrator account. <br><br> **restriction:** Cannot end in \".\" <br><br> **Disallowed values:** \"administrator\", \"admin\", \"user\", \"user1\", \"test\", \"user2\", \"test1\", \"user3\", \"admin1\", \"1\", \"123\", \"a\", \"actuser\", \"adm\", \"admin2\", \"aspnet\", \"backup\", \"console\", \"david\", \"guest\", \"john\", \"owner\", \"root\", \"server\", \"sql\", \"support\", \"support_388945a0\", \"sys\", \"test2\", \"test3\", \"user4\", \"user5\". <br><br> **Minimum-length:** 1 character <br><br> **Max-length:** 20 characters"
         },
         "adminPassword": {
           "type": "string",
-          "description": "The administrator password to use for Windows VMs.",
-          "pattern": "^(?=.*[a-z])(?=.*[A-Z])(?=.*[!@#$%\\^&\\*\\(\\)])[a-zA-Z\\d!@#$%\\^&\\*\\(\\)]{12,123}$"
+          "description": "Specifies the password of the administrator account. <br><br> **Minimum-length:** 8 characters <br><br> **Max-length:** 123 characters <br><br> **Complexity requirements:** 3 out of 4 conditions below need to be fulfilled <br> Has lower characters <br>Has upper characters <br> Has a digit <br> Has a special character (Regex match [\\W_]) <br><br> **Disallowed values:** \"abc@123\", \"P@$$w0rd\", \"P@ssw0rd\", \"P@ssword123\", \"Pa$$word\", \"pass@word1\", \"Password!\", \"Password1\", \"Password22\", \"iloveyou!\""
         }
       },
       "required": [
diff --git a/specification/containerservice/resource-manager/Microsoft.ContainerService/stable/2020-01-01/managedClusters.json b/specification/containerservice/resource-manager/Microsoft.ContainerService/stable/2020-01-01/managedClusters.json
index 83a3690c1e3d..9052f5a6c66f 100644
--- a/specification/containerservice/resource-manager/Microsoft.ContainerService/stable/2020-01-01/managedClusters.json
+++ b/specification/containerservice/resource-manager/Microsoft.ContainerService/stable/2020-01-01/managedClusters.json
@@ -1589,13 +1589,11 @@
       "properties": {
         "adminUsername": {
           "type": "string",
-          "description": "The administrator username to use for Windows VMs.",
-          "pattern": "^[a-zA-Z0-9]+([._]?[a-zA-Z0-9]+)*$"
+          "description": "Specifies the name of the administrator account. <br><br> **restriction:** Cannot end in \".\" <br><br> **Disallowed values:** \"administrator\", \"admin\", \"user\", \"user1\", \"test\", \"user2\", \"test1\", \"user3\", \"admin1\", \"1\", \"123\", \"a\", \"actuser\", \"adm\", \"admin2\", \"aspnet\", \"backup\", \"console\", \"david\", \"guest\", \"john\", \"owner\", \"root\", \"server\", \"sql\", \"support\", \"support_388945a0\", \"sys\", \"test2\", \"test3\", \"user4\", \"user5\". <br><br> **Minimum-length:** 1 character <br><br> **Max-length:** 20 characters"
         },
         "adminPassword": {
           "type": "string",
-          "description": "The administrator password to use for Windows VMs.",
-          "pattern": "^(?=.*[a-z])(?=.*[A-Z])(?=.*[!@#$%\\^&\\*\\(\\)])[a-zA-Z\\d!@#$%\\^&\\*\\(\\)]{12,123}$"
+          "description": "Specifies the password of the administrator account. <br><br> **Minimum-length:** 8 characters <br><br> **Max-length:** 123 characters <br><br> **Complexity requirements:** 3 out of 4 conditions below need to be fulfilled <br> Has lower characters <br>Has upper characters <br> Has a digit <br> Has a special character (Regex match [\\W_]) <br><br> **Disallowed values:** \"abc@123\", \"P@$$w0rd\", \"P@ssw0rd\", \"P@ssword123\", \"Pa$$word\", \"pass@word1\", \"Password!\", \"Password1\", \"Password22\", \"iloveyou!\""
         }
       },
       "required": [
diff --git a/specification/containerservice/resource-manager/Microsoft.ContainerService/stable/2020-02-01/managedClusters.json b/specification/containerservice/resource-manager/Microsoft.ContainerService/stable/2020-02-01/managedClusters.json
index 656eceb27f8d..4572d2dec90e 100644
--- a/specification/containerservice/resource-manager/Microsoft.ContainerService/stable/2020-02-01/managedClusters.json
+++ b/specification/containerservice/resource-manager/Microsoft.ContainerService/stable/2020-02-01/managedClusters.json
@@ -1596,13 +1596,11 @@
       "properties": {
         "adminUsername": {
           "type": "string",
-          "description": "The administrator username to use for Windows VMs.",
-          "pattern": "^[a-zA-Z0-9]+([._]?[a-zA-Z0-9]+)*$"
+          "description": "Specifies the name of the administrator account. <br><br> **restriction:** Cannot end in \".\" <br><br> **Disallowed values:** \"administrator\", \"admin\", \"user\", \"user1\", \"test\", \"user2\", \"test1\", \"user3\", \"admin1\", \"1\", \"123\", \"a\", \"actuser\", \"adm\", \"admin2\", \"aspnet\", \"backup\", \"console\", \"david\", \"guest\", \"john\", \"owner\", \"root\", \"server\", \"sql\", \"support\", \"support_388945a0\", \"sys\", \"test2\", \"test3\", \"user4\", \"user5\". <br><br> **Minimum-length:** 1 character <br><br> **Max-length:** 20 characters"
         },
         "adminPassword": {
           "type": "string",
-          "description": "The administrator password to use for Windows VMs.",
-          "pattern": "^(?=.*[a-z])(?=.*[A-Z])(?=.*[!@#$%\\^&\\*\\(\\)])[a-zA-Z\\d!@#$%\\^&\\*\\(\\)]{12,123}$"
+          "description": "Specifies the password of the administrator account. <br><br> **Minimum-length:** 8 characters <br><br> **Max-length:** 123 characters <br><br> **Complexity requirements:** 3 out of 4 conditions below need to be fulfilled <br> Has lower characters <br>Has upper characters <br> Has a digit <br> Has a special character (Regex match [\\W_]) <br><br> **Disallowed values:** \"abc@123\", \"P@$$w0rd\", \"P@ssw0rd\", \"P@ssword123\", \"Pa$$word\", \"pass@word1\", \"Password!\", \"Password1\", \"Password22\", \"iloveyou!\""
         }
       },
       "required": [
diff --git a/specification/containerservice/resource-manager/Microsoft.ContainerService/stable/2020-03-01/managedClusters.json b/specification/containerservice/resource-manager/Microsoft.ContainerService/stable/2020-03-01/managedClusters.json
index f23476495830..772ab033df01 100644
--- a/specification/containerservice/resource-manager/Microsoft.ContainerService/stable/2020-03-01/managedClusters.json
+++ b/specification/containerservice/resource-manager/Microsoft.ContainerService/stable/2020-03-01/managedClusters.json
@@ -1612,13 +1612,11 @@
       "properties": {
         "adminUsername": {
           "type": "string",
-          "description": "The administrator username to use for Windows VMs.",
-          "pattern": "^[a-zA-Z0-9]+([._]?[a-zA-Z0-9]+)*$"
+          "description": "Specifies the name of the administrator account. <br><br> **restriction:** Cannot end in \".\" <br><br> **Disallowed values:** \"administrator\", \"admin\", \"user\", \"user1\", \"test\", \"user2\", \"test1\", \"user3\", \"admin1\", \"1\", \"123\", \"a\", \"actuser\", \"adm\", \"admin2\", \"aspnet\", \"backup\", \"console\", \"david\", \"guest\", \"john\", \"owner\", \"root\", \"server\", \"sql\", \"support\", \"support_388945a0\", \"sys\", \"test2\", \"test3\", \"user4\", \"user5\". <br><br> **Minimum-length:** 1 character <br><br> **Max-length:** 20 characters"
         },
         "adminPassword": {
           "type": "string",
-          "description": "The administrator password to use for Windows VMs.",
-          "pattern": "^(?=.*[a-z])(?=.*[A-Z])(?=.*[!@#$%\\^&\\*\\(\\)])[a-zA-Z\\d!@#$%\\^&\\*\\(\\)]{12,123}$"
+          "description": "Specifies the password of the administrator account. <br><br> **Minimum-length:** 8 characters <br><br> **Max-length:** 123 characters <br><br> **Complexity requirements:** 3 out of 4 conditions below need to be fulfilled <br> Has lower characters <br>Has upper characters <br> Has a digit <br> Has a special character (Regex match [\\W_]) <br><br> **Disallowed values:** \"abc@123\", \"P@$$w0rd\", \"P@ssw0rd\", \"P@ssword123\", \"Pa$$word\", \"pass@word1\", \"Password!\", \"Password1\", \"Password22\", \"iloveyou!\""
         }
       },
       "required": [
diff --git a/specification/containerservice/resource-manager/Microsoft.ContainerService/stable/2020-04-01/managedClusters.json b/specification/containerservice/resource-manager/Microsoft.ContainerService/stable/2020-04-01/managedClusters.json
index e8797a360276..3a813866b029 100644
--- a/specification/containerservice/resource-manager/Microsoft.ContainerService/stable/2020-04-01/managedClusters.json
+++ b/specification/containerservice/resource-manager/Microsoft.ContainerService/stable/2020-04-01/managedClusters.json
@@ -1630,13 +1630,11 @@
       "properties": {
         "adminUsername": {
           "type": "string",
-          "description": "The administrator username to use for Windows VMs.",
-          "pattern": "^[a-zA-Z0-9]+([._]?[a-zA-Z0-9]+)*$"
+          "description": "Specifies the name of the administrator account. <br><br> **restriction:** Cannot end in \".\" <br><br> **Disallowed values:** \"administrator\", \"admin\", \"user\", \"user1\", \"test\", \"user2\", \"test1\", \"user3\", \"admin1\", \"1\", \"123\", \"a\", \"actuser\", \"adm\", \"admin2\", \"aspnet\", \"backup\", \"console\", \"david\", \"guest\", \"john\", \"owner\", \"root\", \"server\", \"sql\", \"support\", \"support_388945a0\", \"sys\", \"test2\", \"test3\", \"user4\", \"user5\". <br><br> **Minimum-length:** 1 character <br><br> **Max-length:** 20 characters"
         },
         "adminPassword": {
           "type": "string",
-          "description": "The administrator password to use for Windows VMs.",
-          "pattern": "^(?=.*[a-z])(?=.*[A-Z])(?=.*[!@#$%\\^&\\*\\(\\)])[a-zA-Z\\d!@#$%\\^&\\*\\(\\)]{12,123}$"
+          "description": "Specifies the password of the administrator account. <br><br> **Minimum-length:** 8 characters <br><br> **Max-length:** 123 characters <br><br> **Complexity requirements:** 3 out of 4 conditions below need to be fulfilled <br> Has lower characters <br>Has upper characters <br> Has a digit <br> Has a special character (Regex match [\\W_]) <br><br> **Disallowed values:** \"abc@123\", \"P@$$w0rd\", \"P@ssw0rd\", \"P@ssword123\", \"Pa$$word\", \"pass@word1\", \"Password!\", \"Password1\", \"Password22\", \"iloveyou!\""
         }
       },
       "required": [
diff --git a/specification/containerservice/resource-manager/Microsoft.ContainerService/stable/2020-06-01/managedClusters.json b/specification/containerservice/resource-manager/Microsoft.ContainerService/stable/2020-06-01/managedClusters.json
index 0a3991450f28..b953c50c7963 100644
--- a/specification/containerservice/resource-manager/Microsoft.ContainerService/stable/2020-06-01/managedClusters.json
+++ b/specification/containerservice/resource-manager/Microsoft.ContainerService/stable/2020-06-01/managedClusters.json
@@ -1842,13 +1842,11 @@
       "properties": {
         "adminUsername": {
           "type": "string",
-          "description": "The administrator username to use for Windows VMs.",
-          "pattern": "^[a-zA-Z0-9]+([._]?[a-zA-Z0-9]+)*$"
+          "description": "Specifies the name of the administrator account. <br><br> **restriction:** Cannot end in \".\" <br><br> **Disallowed values:** \"administrator\", \"admin\", \"user\", \"user1\", \"test\", \"user2\", \"test1\", \"user3\", \"admin1\", \"1\", \"123\", \"a\", \"actuser\", \"adm\", \"admin2\", \"aspnet\", \"backup\", \"console\", \"david\", \"guest\", \"john\", \"owner\", \"root\", \"server\", \"sql\", \"support\", \"support_388945a0\", \"sys\", \"test2\", \"test3\", \"user4\", \"user5\". <br><br> **Minimum-length:** 1 character <br><br> **Max-length:** 20 characters"
         },
         "adminPassword": {
           "type": "string",
-          "description": "The administrator password to use for Windows VMs.",
-          "pattern": "^(?=.*[a-z])(?=.*[A-Z])(?=.*[!@#$%\\^&\\*\\(\\)])[a-zA-Z\\d!@#$%\\^&\\*\\(\\)]{12,123}$"
+          "description": "Specifies the password of the administrator account. <br><br> **Minimum-length:** 8 characters <br><br> **Max-length:** 123 characters <br><br> **Complexity requirements:** 3 out of 4 conditions below need to be fulfilled <br> Has lower characters <br>Has upper characters <br> Has a digit <br> Has a special character (Regex match [\\W_]) <br><br> **Disallowed values:** \"abc@123\", \"P@$$w0rd\", \"P@ssw0rd\", \"P@ssword123\", \"Pa$$word\", \"pass@word1\", \"Password!\", \"Password1\", \"Password22\", \"iloveyou!\""
         }
       },
       "required": [
diff --git a/specification/containerservice/resource-manager/Microsoft.ContainerService/stable/2020-07-01/managedClusters.json b/specification/containerservice/resource-manager/Microsoft.ContainerService/stable/2020-07-01/managedClusters.json
index 5a07097c6d67..d1c2f34c1d52 100644
--- a/specification/containerservice/resource-manager/Microsoft.ContainerService/stable/2020-07-01/managedClusters.json
+++ b/specification/containerservice/resource-manager/Microsoft.ContainerService/stable/2020-07-01/managedClusters.json
@@ -1900,13 +1900,11 @@
       "properties": {
         "adminUsername": {
           "type": "string",
-          "description": "The administrator username to use for Windows VMs.",
-          "pattern": "^[a-zA-Z0-9]+([._]?[a-zA-Z0-9]+)*$"
+          "description": "Specifies the name of the administrator account. <br><br> **restriction:** Cannot end in \".\" <br><br> **Disallowed values:** \"administrator\", \"admin\", \"user\", \"user1\", \"test\", \"user2\", \"test1\", \"user3\", \"admin1\", \"1\", \"123\", \"a\", \"actuser\", \"adm\", \"admin2\", \"aspnet\", \"backup\", \"console\", \"david\", \"guest\", \"john\", \"owner\", \"root\", \"server\", \"sql\", \"support\", \"support_388945a0\", \"sys\", \"test2\", \"test3\", \"user4\", \"user5\". <br><br> **Minimum-length:** 1 character <br><br> **Max-length:** 20 characters"
         },
         "adminPassword": {
           "type": "string",
-          "description": "The administrator password to use for Windows VMs.",
-          "pattern": "^(?=.*[a-z])(?=.*[A-Z])(?=.*[!@#$%\\^&\\*\\(\\)])[a-zA-Z\\d!@#$%\\^&\\*\\(\\)]{12,123}$"
+          "description": "Specifies the password of the administrator account. <br><br> **Minimum-length:** 8 characters <br><br> **Max-length:** 123 characters <br><br> **Complexity requirements:** 3 out of 4 conditions below need to be fulfilled <br> Has lower characters <br>Has upper characters <br> Has a digit <br> Has a special character (Regex match [\\W_]) <br><br> **Disallowed values:** \"abc@123\", \"P@$$w0rd\", \"P@ssw0rd\", \"P@ssword123\", \"Pa$$word\", \"pass@word1\", \"Password!\", \"Password1\", \"Password22\", \"iloveyou!\""
         },
         "licenseType": {
           "type": "string",
diff --git a/specification/containerservice/resource-manager/Microsoft.ContainerService/stable/2020-09-01/managedClusters.json b/specification/containerservice/resource-manager/Microsoft.ContainerService/stable/2020-09-01/managedClusters.json
index be924c99384f..aa5a00d3e6c5 100644
--- a/specification/containerservice/resource-manager/Microsoft.ContainerService/stable/2020-09-01/managedClusters.json
+++ b/specification/containerservice/resource-manager/Microsoft.ContainerService/stable/2020-09-01/managedClusters.json
@@ -2095,13 +2095,11 @@
       "properties": {
         "adminUsername": {
           "type": "string",
-          "description": "The administrator username to use for Windows VMs.",
-          "pattern": "^[a-zA-Z0-9]+([._]?[a-zA-Z0-9]+)*$"
+          "description": "Specifies the name of the administrator account. <br><br> **restriction:** Cannot end in \".\" <br><br> **Disallowed values:** \"administrator\", \"admin\", \"user\", \"user1\", \"test\", \"user2\", \"test1\", \"user3\", \"admin1\", \"1\", \"123\", \"a\", \"actuser\", \"adm\", \"admin2\", \"aspnet\", \"backup\", \"console\", \"david\", \"guest\", \"john\", \"owner\", \"root\", \"server\", \"sql\", \"support\", \"support_388945a0\", \"sys\", \"test2\", \"test3\", \"user4\", \"user5\". <br><br> **Minimum-length:** 1 character <br><br> **Max-length:** 20 characters"
         },
         "adminPassword": {
           "type": "string",
-          "description": "The administrator password to use for Windows VMs.",
-          "pattern": "^(?=.*[a-z])(?=.*[A-Z])(?=.*[!@#$%\\^&\\*\\(\\)])[a-zA-Z\\d!@#$%\\^&\\*\\(\\)]{12,123}$"
+          "description": "Specifies the password of the administrator account. <br><br> **Minimum-length:** 8 characters <br><br> **Max-length:** 123 characters <br><br> **Complexity requirements:** 3 out of 4 conditions below need to be fulfilled <br> Has lower characters <br>Has upper characters <br> Has a digit <br> Has a special character (Regex match [\\W_]) <br><br> **Disallowed values:** \"abc@123\", \"P@$$w0rd\", \"P@ssw0rd\", \"P@ssword123\", \"Pa$$word\", \"pass@word1\", \"Password!\", \"Password1\", \"Password22\", \"iloveyou!\""
         },
         "licenseType": {
           "type": "string",
diff --git a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/preview/2020-06-01-preview/cosmos-db.json b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/preview/2020-06-01-preview/cosmos-db.json
index cde658ad05ed..918f269d90aa 100644
--- a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/preview/2020-06-01-preview/cosmos-db.json
+++ b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/preview/2020-06-01-preview/cosmos-db.json
@@ -7686,7 +7686,7 @@
         },
         "restoreSource": {
           "type": "string",
-          "description": "Path of the source account from which the restore has to be initiated"
+          "description": "The id of the restorable database account from which the restore has to be initiated. For example: /subscriptions/{subscriptionId}/providers/Microsoft.DocumentDB/locations/{location}/restorableDatabaseAccounts/{restorableDatabaseAccountName}"
         },
         "restoreTimestampInUtc": {
           "type": "string",
diff --git a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/cosmos-db.json b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/cosmos-db.json
new file mode 100644
index 000000000000..81461e3fd2f2
--- /dev/null
+++ b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/cosmos-db.json
@@ -0,0 +1,8521 @@
+{
+  "swagger": "2.0",
+  "info": {
+    "title": "Cosmos DB",
+    "description": "Azure Cosmos DB Database Service Resource Provider REST API",
+    "version": "2020-09-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.DocumentDB/databaseAccounts/{accountName}": {
+      "get": {
+        "operationId": "DatabaseAccounts_Get",
+        "x-ms-examples": {
+          "CosmosDBDatabaseAccountGet": {
+            "$ref": "./examples/CosmosDBDatabaseAccountGet.json"
+          }
+        },
+        "description": "Retrieves the properties of an existing Azure Cosmos DB database account.",
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/accountNameParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The database account properties were retrieved successfully.",
+            "schema": {
+              "$ref": "#/definitions/DatabaseAccountGetResults"
+            }
+          }
+        }
+      },
+      "patch": {
+        "operationId": "DatabaseAccounts_Update",
+        "x-ms-examples": {
+          "CosmosDBDatabaseAccountPatch": {
+            "$ref": "./examples/CosmosDBDatabaseAccountPatch.json"
+          }
+        },
+        "description": "Updates the properties of an existing Azure Cosmos DB database account.",
+        "x-ms-long-running-operation": true,
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/accountNameParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "name": "updateParameters",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/DatabaseAccountUpdateParameters"
+            },
+            "description": "The parameters to provide for the current database account."
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The database account update operation will complete asynchronously.",
+            "schema": {
+              "$ref": "#/definitions/DatabaseAccountGetResults"
+            }
+          }
+        }
+      },
+      "put": {
+        "operationId": "DatabaseAccounts_CreateOrUpdate",
+        "x-ms-examples": {
+          "CosmosDBDatabaseAccountCreateMin": {
+            "$ref": "./examples/CosmosDBDatabaseAccountCreateMin.json"
+          },
+          "CosmosDBDatabaseAccountCreateMax": {
+            "$ref": "./examples/CosmosDBDatabaseAccountCreateMax.json"
+          }
+        },
+        "description": "Creates or updates an Azure Cosmos DB database account. The \"Update\" method is preferred when performing updates on an account.",
+        "x-ms-long-running-operation": true,
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/accountNameParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "name": "createUpdateParameters",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/DatabaseAccountCreateUpdateParameters"
+            },
+            "description": "The parameters to provide for the current database account."
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The database account create or update operation will complete asynchronously.",
+            "schema": {
+              "$ref": "#/definitions/DatabaseAccountGetResults"
+            }
+          }
+        }
+      },
+      "delete": {
+        "operationId": "DatabaseAccounts_Delete",
+        "x-ms-examples": {
+          "CosmosDBDatabaseAccountDelete": {
+            "$ref": "./examples/CosmosDBDatabaseAccountDelete.json"
+          }
+        },
+        "description": "Deletes an existing Azure Cosmos DB database account.",
+        "x-ms-long-running-operation": true,
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/accountNameParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          }
+        ],
+        "responses": {
+          "202": {
+            "description": "The database account delete operation will complete asynchronously."
+          },
+          "204": {
+            "description": "The specified account does not exist in the subscription."
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{accountName}/failoverPriorityChange": {
+      "post": {
+        "operationId": "DatabaseAccounts_FailoverPriorityChange",
+        "x-ms-examples": {
+          "CosmosDBDatabaseAccountFailoverPriorityChange": {
+            "$ref": "./examples/CosmosDBDatabaseAccountFailoverPriorityChange.json"
+          }
+        },
+        "description": "Changes the failover priority for the Azure Cosmos DB database account. A failover priority of 0 indicates a write region. The maximum value for a failover priority = (total number of regions - 1). Failover priority values must be unique for each of the regions in which the database account exists.",
+        "x-ms-long-running-operation": true,
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/accountNameParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "name": "failoverParameters",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/FailoverPolicies"
+            },
+            "description": "The new failover policies for the database account."
+          }
+        ],
+        "responses": {
+          "202": {
+            "description": "Accepted. The failover policy change operation will complete asynchronously."
+          },
+          "204": {
+            "description": "No Content"
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/providers/Microsoft.DocumentDB/databaseAccounts": {
+      "get": {
+        "operationId": "DatabaseAccounts_List",
+        "x-ms-examples": {
+          "CosmosDBDatabaseAccountList": {
+            "$ref": "./examples/CosmosDBDatabaseAccountList.json"
+          }
+        },
+        "description": "Lists all the Azure Cosmos DB database accounts available under the subscription.",
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The operation completed successfully.",
+            "schema": {
+              "$ref": "#/definitions/DatabaseAccountsListResult"
+            }
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": null
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts": {
+      "get": {
+        "operationId": "DatabaseAccounts_ListByResourceGroup",
+        "x-ms-examples": {
+          "CosmosDBDatabaseAccountListByResourceGroup": {
+            "$ref": "./examples/CosmosDBDatabaseAccountListByResourceGroup.json"
+          }
+        },
+        "description": "Lists all the Azure Cosmos DB database accounts available under the given resource group.",
+        "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": "The operation completed successfully.",
+            "schema": {
+              "$ref": "#/definitions/DatabaseAccountsListResult"
+            }
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": null
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{accountName}/listKeys": {
+      "post": {
+        "operationId": "DatabaseAccounts_ListKeys",
+        "x-ms-examples": {
+          "CosmosDBDatabaseAccountListKeys": {
+            "$ref": "./examples/CosmosDBDatabaseAccountListKeys.json"
+          }
+        },
+        "description": "Lists the access keys for the specified Azure Cosmos DB database account.",
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/accountNameParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The operation completed successfully.",
+            "schema": {
+              "$ref": "#/definitions/DatabaseAccountListKeysResult"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{accountName}/listConnectionStrings": {
+      "post": {
+        "operationId": "DatabaseAccounts_ListConnectionStrings",
+        "x-ms-examples": {
+          "CosmosDBDatabaseAccountListConnectionStrings": {
+            "$ref": "./examples/CosmosDBDatabaseAccountListConnectionStrings.json"
+          },
+          "CosmosDBDatabaseAccountListConnectionStringsMongo": {
+            "$ref": "./examples/CosmosDBDatabaseAccountListConnectionStringsMongo.json"
+          }
+        },
+        "description": "Lists the connection strings for the specified Azure Cosmos DB database account.",
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/accountNameParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The operation completed successfully.",
+            "schema": {
+              "$ref": "#/definitions/DatabaseAccountListConnectionStringsResult"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{accountName}/offlineRegion": {
+      "post": {
+        "operationId": "DatabaseAccounts_OfflineRegion",
+        "x-ms-examples": {
+          "CosmosDBDatabaseAccountOfflineRegion": {
+            "$ref": "./examples/CosmosDBDatabaseAccountOfflineRegion.json"
+          }
+        },
+        "description": "Offline the specified region for the specified Azure Cosmos DB database account.",
+        "x-ms-long-running-operation": true,
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/accountNameParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "name": "regionParameterForOffline",
+            "in": "body",
+            "required": true,
+            "description": "Cosmos DB region to offline for the database account.",
+            "schema": {
+              "$ref": "#/definitions/RegionForOnlineOffline"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The offline region operation is completed successfully."
+          },
+          "202": {
+            "description": "Accepted. The offline region operation will complete asynchronously."
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponse"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{accountName}/onlineRegion": {
+      "post": {
+        "operationId": "DatabaseAccounts_OnlineRegion",
+        "x-ms-examples": {
+          "CosmosDBDatabaseAccountOnlineRegion": {
+            "$ref": "./examples/CosmosDBDatabaseAccountOnlineRegion.json"
+          }
+        },
+        "description": "Online the specified region for the specified Azure Cosmos DB database account.",
+        "x-ms-long-running-operation": true,
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/accountNameParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "name": "regionParameterForOnline",
+            "in": "body",
+            "required": true,
+            "description": "Cosmos DB region to online for the database account.",
+            "schema": {
+              "$ref": "#/definitions/RegionForOnlineOffline"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The online region operation is completed successfully."
+          },
+          "202": {
+            "description": "Accepted. The online region operation will complete asynchronously."
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponse"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{accountName}/readonlykeys": {
+      "get": {
+        "operationId": "DatabaseAccounts_GetReadOnlyKeys",
+        "x-ms-examples": {
+          "CosmosDBDatabaseAccountListReadOnlyKeys": {
+            "$ref": "./examples/CosmosDBDatabaseAccountListReadOnlyKeys.json"
+          }
+        },
+        "description": "Lists the read-only access keys for the specified Azure Cosmos DB database account.",
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/accountNameParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The operation completed successfully.",
+            "schema": {
+              "$ref": "#/definitions/DatabaseAccountListReadOnlyKeysResult"
+            }
+          }
+        }
+      },
+      "post": {
+        "operationId": "DatabaseAccounts_ListReadOnlyKeys",
+        "x-ms-examples": {
+          "CosmosDBDatabaseAccountListReadOnlyKeys": {
+            "$ref": "./examples/CosmosDBDatabaseAccountListReadOnlyKeys.json"
+          }
+        },
+        "description": "Lists the read-only access keys for the specified Azure Cosmos DB database account.",
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/accountNameParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The operation completed successfully.",
+            "schema": {
+              "$ref": "#/definitions/DatabaseAccountListReadOnlyKeysResult"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{accountName}/regenerateKey": {
+      "post": {
+        "operationId": "DatabaseAccounts_RegenerateKey",
+        "x-ms-examples": {
+          "CosmosDBDatabaseAccountRegenerateKey": {
+            "$ref": "./examples/CosmosDBDatabaseAccountRegenerateKey.json"
+          }
+        },
+        "description": "Regenerates an access key for the specified Azure Cosmos DB database account.",
+        "x-ms-long-running-operation": true,
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/accountNameParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "name": "keyToRegenerate",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/DatabaseAccountRegenerateKeyParameters"
+            },
+            "description": "The name of the key to regenerate."
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK"
+          },
+          "202": {
+            "description": "Accepted. The regenerate key operation will complete asynchronously."
+          }
+        }
+      }
+    },
+    "/providers/Microsoft.DocumentDB/databaseAccountNames/{accountName}": {
+      "head": {
+        "operationId": "DatabaseAccounts_CheckNameExists",
+        "x-ms-examples": {
+          "CosmosDBDatabaseAccountCheckNameExists": {
+            "$ref": "./examples/CosmosDBDatabaseAccountCheckNameExists.json"
+          }
+        },
+        "description": "Checks that the Azure Cosmos DB account name already exists. A valid account name may contain only lowercase letters, numbers, and the '-' character, and must be between 3 and 50 characters.",
+        "parameters": [
+          {
+            "$ref": "#/parameters/accountNameParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK. The account name is valid but is already in use."
+          },
+          "404": {
+            "description": "Not Found. The account name is available and valid."
+          }
+        }
+      }
+    },
+    "/providers/Microsoft.DocumentDB/operations": {
+      "get": {
+        "tags": [
+          "Operations"
+        ],
+        "description": "Lists all of the available Cosmos DB Resource Provider operations.",
+        "operationId": "Operations_List",
+        "x-ms-examples": {
+          "CosmosDBOperationsList": {
+            "$ref": "./examples/CosmosDBOperationsList.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/OperationListResult"
+            }
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{accountName}/metrics": {
+      "get": {
+        "operationId": "DatabaseAccounts_ListMetrics",
+        "x-ms-examples": {
+          "CosmosDBDatabaseAccountGetMetrics": {
+            "$ref": "./examples/CosmosDBDatabaseAccountGetMetrics.json"
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": null
+        },
+        "description": "Retrieves the metrics determined by the given filter for the given database account.",
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/accountNameParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "#/parameters/filterParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The metrics for the database account were retrieved successfully.",
+            "schema": {
+              "$ref": "#/definitions/MetricListResult"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{accountName}/databases/{databaseRid}/metrics": {
+      "get": {
+        "operationId": "Database_ListMetrics",
+        "x-ms-examples": {
+          "CosmosDBDatabaseGetMetrics": {
+            "$ref": "./examples/CosmosDBDatabaseGetMetrics.json"
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": null
+        },
+        "description": "Retrieves the metrics determined by the given filter for the given database account and database.",
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/accountNameParameter"
+          },
+          {
+            "$ref": "#/parameters/databaseRidParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "#/parameters/filterParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The metrics for the database account were retrieved successfully.",
+            "schema": {
+              "$ref": "#/definitions/MetricListResult"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{accountName}/databases/{databaseRid}/collections/{collectionRid}/metrics": {
+      "get": {
+        "operationId": "Collection_ListMetrics",
+        "x-ms-examples": {
+          "CosmosDBCollectionGetMetrics": {
+            "$ref": "./examples/CosmosDBCollectionGetMetrics.json"
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": null
+        },
+        "description": "Retrieves the metrics determined by the given filter for the given database account and collection.",
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/accountNameParameter"
+          },
+          {
+            "$ref": "#/parameters/databaseRidParameter"
+          },
+          {
+            "$ref": "#/parameters/collectionRidParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "#/parameters/filterParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The metrics for the database account were retrieved successfully.",
+            "schema": {
+              "$ref": "#/definitions/MetricListResult"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{accountName}/region/{region}/databases/{databaseRid}/collections/{collectionRid}/metrics": {
+      "get": {
+        "operationId": "CollectionRegion_ListMetrics",
+        "x-ms-examples": {
+          "CosmosDBRegionCollectionGetMetrics": {
+            "$ref": "./examples/CosmosDBRegionCollectionGetMetrics.json"
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": null
+        },
+        "description": "Retrieves the metrics determined by the given filter for the given database account, collection and region.",
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/accountNameParameter"
+          },
+          {
+            "$ref": "#/parameters/regionParameter"
+          },
+          {
+            "$ref": "#/parameters/databaseRidParameter"
+          },
+          {
+            "$ref": "#/parameters/collectionRidParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "#/parameters/filterParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The metrics for the database account were retrieved successfully.",
+            "schema": {
+              "$ref": "#/definitions/MetricListResult"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{accountName}/region/{region}/metrics": {
+      "get": {
+        "operationId": "DatabaseAccountRegion_ListMetrics",
+        "x-ms-examples": {
+          "CosmosDBDatabaseAccountRegionGetMetrics": {
+            "$ref": "./examples/CosmosDBDatabaseAccountRegionGetMetrics.json"
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": null
+        },
+        "description": "Retrieves the metrics determined by the given filter for the given database account and region.",
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/accountNameParameter"
+          },
+          {
+            "$ref": "#/parameters/regionParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "#/parameters/filterParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The metrics for the database account were retrieved successfully.",
+            "schema": {
+              "$ref": "#/definitions/MetricListResult"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{accountName}/sourceRegion/{sourceRegion}/targetRegion/{targetRegion}/percentile/metrics": {
+      "get": {
+        "operationId": "PercentileSourceTarget_ListMetrics",
+        "x-ms-examples": {
+          "CosmosDBDatabaseAccountRegionGetMetrics": {
+            "$ref": "./examples/CosmosDBPercentileSourceTargetGetMetrics.json"
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": null
+        },
+        "description": "Retrieves the metrics determined by the given filter for the given account, source and target region. This url is only for PBS and Replication Latency data",
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/accountNameParameter"
+          },
+          {
+            "$ref": "#/parameters/sourceRegionParameter"
+          },
+          {
+            "$ref": "#/parameters/targetRegionParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "#/parameters/filterParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The percentile metrics for the account, source and target regions were retrieved successfully.",
+            "schema": {
+              "$ref": "#/definitions/PercentileMetricListResult"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{accountName}/targetRegion/{targetRegion}/percentile/metrics": {
+      "get": {
+        "operationId": "PercentileTarget_ListMetrics",
+        "x-ms-examples": {
+          "CosmosDBDatabaseAccountRegionGetMetrics": {
+            "$ref": "./examples/CosmosDBPercentileTargetGetMetrics.json"
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": null
+        },
+        "description": "Retrieves the metrics determined by the given filter for the given account target region. This url is only for PBS and Replication Latency data",
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/accountNameParameter"
+          },
+          {
+            "$ref": "#/parameters/targetRegionParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "#/parameters/filterParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The percentile metrics for the account and target regions were retrieved successfully.",
+            "schema": {
+              "$ref": "#/definitions/PercentileMetricListResult"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{accountName}/percentile/metrics": {
+      "get": {
+        "operationId": "Percentile_ListMetrics",
+        "x-ms-examples": {
+          "CosmosDBDatabaseAccountRegionGetMetrics": {
+            "$ref": "./examples/CosmosDBPercentileGetMetrics.json"
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": null
+        },
+        "description": "Retrieves the metrics determined by the given filter for the given database account. This url is only for PBS and Replication Latency data",
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/accountNameParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "#/parameters/filterParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The percentile metrics for the account were retrieved successfully.",
+            "schema": {
+              "$ref": "#/definitions/PercentileMetricListResult"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{accountName}/region/{region}/databases/{databaseRid}/collections/{collectionRid}/partitions/metrics": {
+      "get": {
+        "operationId": "CollectionPartitionRegion_ListMetrics",
+        "x-ms-examples": {
+          "CosmosDBDatabaseAccountRegionGetMetrics": {
+            "$ref": "./examples/CosmosDBCollectionPartitionRegionGetMetrics.json"
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": null
+        },
+        "description": "Retrieves the metrics determined by the given filter for the given collection and region, split by partition.",
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/accountNameParameter"
+          },
+          {
+            "$ref": "#/parameters/regionParameter"
+          },
+          {
+            "$ref": "#/parameters/databaseRidParameter"
+          },
+          {
+            "$ref": "#/parameters/collectionRidParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "#/parameters/filterParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The partition-level metrics for the collection and region were retrieved successfully.",
+            "schema": {
+              "$ref": "#/definitions/PartitionMetricListResult"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{accountName}/databases/{databaseRid}/collections/{collectionRid}/partitions/metrics": {
+      "get": {
+        "operationId": "CollectionPartition_ListMetrics",
+        "x-ms-examples": {
+          "CosmosDBDatabaseAccountRegionGetMetrics": {
+            "$ref": "./examples/CosmosDBCollectionPartitionGetMetrics.json"
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": null
+        },
+        "description": "Retrieves the metrics determined by the given filter for the given collection, split by partition.",
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/accountNameParameter"
+          },
+          {
+            "$ref": "#/parameters/databaseRidParameter"
+          },
+          {
+            "$ref": "#/parameters/collectionRidParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "#/parameters/filterParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The partition-level metrics for the collection were retrieved successfully.",
+            "schema": {
+              "$ref": "#/definitions/PartitionMetricListResult"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{accountName}/databases/{databaseRid}/collections/{collectionRid}/partitionKeyRangeId/{partitionKeyRangeId}/metrics": {
+      "get": {
+        "operationId": "PartitionKeyRangeId_ListMetrics",
+        "x-ms-examples": {
+          "CosmosDBDatabaseAccountRegionGetMetrics": {
+            "$ref": "./examples/CosmosDBPKeyRangeIdGetMetrics.json"
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": null
+        },
+        "description": "Retrieves the metrics determined by the given filter for the given partition key range id.",
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/accountNameParameter"
+          },
+          {
+            "$ref": "#/parameters/databaseRidParameter"
+          },
+          {
+            "$ref": "#/parameters/collectionRidParameter"
+          },
+          {
+            "$ref": "#/parameters/partitionKeyRangeIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "#/parameters/filterParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The partition-level metrics for the partition key range id were retrieved successfully.",
+            "schema": {
+              "$ref": "#/definitions/PartitionMetricListResult"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{accountName}/region/{region}/databases/{databaseRid}/collections/{collectionRid}/partitionKeyRangeId/{partitionKeyRangeId}/metrics": {
+      "get": {
+        "operationId": "PartitionKeyRangeIdRegion_ListMetrics",
+        "x-ms-examples": {
+          "CosmosDBDatabaseAccountRegionGetMetrics": {
+            "$ref": "./examples/CosmosDBPKeyRangeIdRegionGetMetrics.json"
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": null
+        },
+        "description": "Retrieves the metrics determined by the given filter for the given partition key range id and region.",
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/accountNameParameter"
+          },
+          {
+            "$ref": "#/parameters/regionParameter"
+          },
+          {
+            "$ref": "#/parameters/databaseRidParameter"
+          },
+          {
+            "$ref": "#/parameters/collectionRidParameter"
+          },
+          {
+            "$ref": "#/parameters/partitionKeyRangeIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "#/parameters/filterParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The partition-level metrics for the partition key range id and region were retrieved successfully.",
+            "schema": {
+              "$ref": "#/definitions/PartitionMetricListResult"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{accountName}/usages": {
+      "get": {
+        "operationId": "DatabaseAccounts_ListUsages",
+        "x-ms-examples": {
+          "CosmosDBDatabaseAccountGetUsages": {
+            "$ref": "./examples/CosmosDBDatabaseAccountGetUsages.json"
+          }
+        },
+        "description": "Retrieves the usages (most recent data) for the given database account.",
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/accountNameParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "#/parameters/usageFilterParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The usages for the database account were retrieved successfully.",
+            "schema": {
+              "$ref": "#/definitions/UsagesResult"
+            }
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": null
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{accountName}/databases/{databaseRid}/usages": {
+      "get": {
+        "operationId": "Database_ListUsages",
+        "x-ms-examples": {
+          "CosmosDBDatabaseGetUsages": {
+            "$ref": "./examples/CosmosDBDatabaseGetUsages.json"
+          }
+        },
+        "description": "Retrieves the usages (most recent data) for the given database.",
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/accountNameParameter"
+          },
+          {
+            "$ref": "#/parameters/databaseRidParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "#/parameters/usageFilterParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The usages for the database were retrieved successfully.",
+            "schema": {
+              "$ref": "#/definitions/UsagesResult"
+            }
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": null
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{accountName}/databases/{databaseRid}/collections/{collectionRid}/usages": {
+      "get": {
+        "operationId": "Collection_ListUsages",
+        "x-ms-examples": {
+          "CosmosDBCollectionGetUsages": {
+            "$ref": "./examples/CosmosDBCollectionGetUsages.json"
+          }
+        },
+        "description": "Retrieves the usages (most recent storage data) for the given collection.",
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/accountNameParameter"
+          },
+          {
+            "$ref": "#/parameters/databaseRidParameter"
+          },
+          {
+            "$ref": "#/parameters/collectionRidParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "#/parameters/usageFilterParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The usages for the collection were retrieved successfully.",
+            "schema": {
+              "$ref": "#/definitions/UsagesResult"
+            }
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": null
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{accountName}/databases/{databaseRid}/collections/{collectionRid}/partitions/usages": {
+      "get": {
+        "operationId": "CollectionPartition_ListUsages",
+        "x-ms-examples": {
+          "CosmosDBCollectionGetUsages": {
+            "$ref": "./examples/CosmosDBCollectionPartitionGetUsages.json"
+          }
+        },
+        "description": "Retrieves the usages (most recent storage data) for the given collection, split by partition.",
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/accountNameParameter"
+          },
+          {
+            "$ref": "#/parameters/databaseRidParameter"
+          },
+          {
+            "$ref": "#/parameters/collectionRidParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "#/parameters/usageFilterParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The usages for the collection, per partition were retrieved successfully.",
+            "schema": {
+              "$ref": "#/definitions/PartitionUsagesResult"
+            }
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": null
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{accountName}/databases/{databaseRid}/metricDefinitions": {
+      "get": {
+        "operationId": "Database_ListMetricDefinitions",
+        "x-ms-examples": {
+          "CosmosDBDatabaseGetMetricDefinitions": {
+            "$ref": "./examples/CosmosDBDatabaseGetMetricDefinitions.json"
+          }
+        },
+        "description": "Retrieves metric definitions for the given database.",
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/accountNameParameter"
+          },
+          {
+            "$ref": "#/parameters/databaseRidParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The metric definitions for the database were retrieved successfully.",
+            "schema": {
+              "$ref": "#/definitions/MetricDefinitionsListResult"
+            }
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": null
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{accountName}/databases/{databaseRid}/collections/{collectionRid}/metricDefinitions": {
+      "get": {
+        "operationId": "Collection_ListMetricDefinitions",
+        "x-ms-examples": {
+          "CosmosDBCollectionGetMetricDefinitions": {
+            "$ref": "./examples/CosmosDBCollectionGetMetricDefinitions.json"
+          }
+        },
+        "description": "Retrieves metric definitions for the given collection.",
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/accountNameParameter"
+          },
+          {
+            "$ref": "#/parameters/databaseRidParameter"
+          },
+          {
+            "$ref": "#/parameters/collectionRidParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The metric definitions for the collection were retrieved successfully.",
+            "schema": {
+              "$ref": "#/definitions/MetricDefinitionsListResult"
+            }
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": null
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{accountName}/metricDefinitions": {
+      "get": {
+        "operationId": "DatabaseAccounts_ListMetricDefinitions",
+        "x-ms-examples": {
+          "CosmosDBDatabaseAccountGetMetricDefinitions": {
+            "$ref": "./examples/CosmosDBDatabaseAccountGetMetricDefinitions.json"
+          }
+        },
+        "description": "Retrieves metric definitions for the given database account.",
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/accountNameParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The metric definitions for the database account were retrieved successfully.",
+            "schema": {
+              "$ref": "#/definitions/MetricDefinitionsListResult"
+            }
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": null
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{accountName}/sqlDatabases": {
+      "get": {
+        "operationId": "SqlResources_ListSqlDatabases",
+        "x-ms-examples": {
+          "CosmosDBSqlDatabaseList": {
+            "$ref": "./examples/CosmosDBSqlDatabaseList.json"
+          }
+        },
+        "description": "Lists the SQL databases under an existing Azure Cosmos DB database account.",
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/accountNameParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The SQL database properties were retrieved successfully.",
+            "schema": {
+              "$ref": "#/definitions/SqlDatabaseListResult"
+            }
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": null
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{accountName}/sqlDatabases/{databaseName}": {
+      "get": {
+        "operationId": "SqlResources_GetSqlDatabase",
+        "x-ms-examples": {
+          "CosmosDBSqlDatabaseGet": {
+            "$ref": "./examples/CosmosDBSqlDatabaseGet.json"
+          }
+        },
+        "description": "Gets the SQL database under an existing Azure Cosmos DB database account with the provided name.",
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/accountNameParameter"
+          },
+          {
+            "$ref": "#/parameters/databaseNameParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The SQL database property was retrieved successfully.",
+            "schema": {
+              "$ref": "#/definitions/SqlDatabaseGetResults"
+            }
+          }
+        }
+      },
+      "put": {
+        "operationId": "SqlResources_CreateUpdateSqlDatabase",
+        "x-ms-examples": {
+          "CosmosDBSqlDatabaseCreateUpdate": {
+            "$ref": "./examples/CosmosDBSqlDatabaseCreateUpdate.json"
+          }
+        },
+        "description": "Create or update an Azure Cosmos DB SQL database",
+        "x-ms-long-running-operation": true,
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/accountNameParameter"
+          },
+          {
+            "$ref": "#/parameters/databaseNameParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "name": "createUpdateSqlDatabaseParameters",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/SqlDatabaseCreateUpdateParameters"
+            },
+            "description": "The parameters to provide for the current SQL database."
+          }
+        ],
+        "responses": {
+          "202": {
+            "description": "The SQL database create or update operation will complete asynchronously."
+          },
+          "200": {
+            "description": "The SQL database create or update operation was completed successfully.",
+            "schema": {
+              "$ref": "#/definitions/SqlDatabaseGetResults"
+            }
+          }
+        }
+      },
+      "delete": {
+        "operationId": "SqlResources_DeleteSqlDatabase",
+        "x-ms-examples": {
+          "CosmosDBSqlDatabaseDelete": {
+            "$ref": "./examples/CosmosDBSqlDatabaseDelete.json"
+          }
+        },
+        "description": "Deletes an existing Azure Cosmos DB SQL database.",
+        "x-ms-long-running-operation": true,
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/accountNameParameter"
+          },
+          {
+            "$ref": "#/parameters/databaseNameParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          }
+        ],
+        "responses": {
+          "202": {
+            "description": "The SQL database delete operation will complete asynchronously."
+          },
+          "204": {
+            "description": "The SQL database delete operation was completed successfully."
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{accountName}/sqlDatabases/{databaseName}/throughputSettings/default": {
+      "get": {
+        "operationId": "SqlResources_GetSqlDatabaseThroughput",
+        "x-ms-examples": {
+          "CosmosDBSqlDatabaseThroughputGet": {
+            "$ref": "./examples/CosmosDBSqlDatabaseThroughputGet.json"
+          }
+        },
+        "description": "Gets the RUs per second of the SQL database under an existing Azure Cosmos DB database account with the provided name.",
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/accountNameParameter"
+          },
+          {
+            "$ref": "#/parameters/databaseNameParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The RUs per second of the SQL database was retrieved successfully.",
+            "schema": {
+              "$ref": "#/definitions/ThroughputSettingsGetResults"
+            }
+          }
+        }
+      },
+      "put": {
+        "operationId": "SqlResources_UpdateSqlDatabaseThroughput",
+        "x-ms-examples": {
+          "CosmosDBSqlDatabaseThroughputUpdate": {
+            "$ref": "./examples/CosmosDBSqlDatabaseThroughputUpdate.json"
+          }
+        },
+        "description": "Update RUs per second of an Azure Cosmos DB SQL database",
+        "x-ms-long-running-operation": true,
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/accountNameParameter"
+          },
+          {
+            "$ref": "#/parameters/databaseNameParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "name": "updateThroughputParameters",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/ThroughputSettingsUpdateParameters"
+            },
+            "description": "The parameters to provide for the RUs per second of the current SQL database."
+          }
+        ],
+        "responses": {
+          "202": {
+            "description": "The RUs per second of the SQL database update operation will complete asynchronously."
+          },
+          "200": {
+            "description": "The RUs per second of the SQL database update operation was completed successfully.",
+            "schema": {
+              "$ref": "#/definitions/ThroughputSettingsGetResults"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{accountName}/sqlDatabases/{databaseName}/throughputSettings/default/migrateToAutoscale": {
+      "post": {
+        "operationId": "SqlResources_MigrateSqlDatabaseToAutoscale",
+        "x-ms-examples": {
+          "CosmosDBSqlDatabaseMigrateToAutoscale": {
+            "$ref": "./examples/CosmosDBSqlDatabaseMigrateToAutoscale.json"
+          }
+        },
+        "description": "Migrate an Azure Cosmos DB SQL database from manual throughput to autoscale",
+        "x-ms-long-running-operation": true,
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/accountNameParameter"
+          },
+          {
+            "$ref": "#/parameters/databaseNameParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          }
+        ],
+        "responses": {
+          "202": {
+            "description": "The SQL database migrate operation will complete asynchronously."
+          },
+          "200": {
+            "description": "The SQL database migrate operation was completed successfully.",
+            "schema": {
+              "$ref": "#/definitions/ThroughputSettingsGetResults"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponseUpdatedFormat"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{accountName}/sqlDatabases/{databaseName}/throughputSettings/default/migrateToManualThroughput": {
+      "post": {
+        "operationId": "SqlResources_MigrateSqlDatabaseToManualThroughput",
+        "x-ms-examples": {
+          "CosmosDBSqlDatabaseMigrateToManualThroughput": {
+            "$ref": "./examples/CosmosDBSqlDatabaseMigrateToManualThroughput.json"
+          }
+        },
+        "description": "Migrate an Azure Cosmos DB SQL database from autoscale to manual throughput",
+        "x-ms-long-running-operation": true,
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/accountNameParameter"
+          },
+          {
+            "$ref": "#/parameters/databaseNameParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          }
+        ],
+        "responses": {
+          "202": {
+            "description": "The SQL database migrate operation will complete asynchronously."
+          },
+          "200": {
+            "description": "The SQL database migrate operation was completed successfully.",
+            "schema": {
+              "$ref": "#/definitions/ThroughputSettingsGetResults"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponseUpdatedFormat"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{accountName}/sqlDatabases/{databaseName}/containers": {
+      "get": {
+        "operationId": "SqlResources_ListSqlContainers",
+        "x-ms-examples": {
+          "CosmosDBSqlContainerList": {
+            "$ref": "./examples/CosmosDBSqlContainerList.json"
+          }
+        },
+        "description": "Lists the SQL container under an existing Azure Cosmos DB database account.",
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/accountNameParameter"
+          },
+          {
+            "$ref": "#/parameters/databaseNameParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The SQL container properties were retrieved successfully.",
+            "schema": {
+              "$ref": "#/definitions/SqlContainerListResult"
+            }
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": null
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{accountName}/sqlDatabases/{databaseName}/containers/{containerName}": {
+      "get": {
+        "operationId": "SqlResources_GetSqlContainer",
+        "x-ms-examples": {
+          "CosmosDBSqlContainerGet": {
+            "$ref": "./examples/CosmosDBSqlContainerGet.json"
+          }
+        },
+        "description": "Gets the SQL container under an existing Azure Cosmos DB database account.",
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/accountNameParameter"
+          },
+          {
+            "$ref": "#/parameters/databaseNameParameter"
+          },
+          {
+            "$ref": "#/parameters/containerNameParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The SQL container property was retrieved successfully.",
+            "schema": {
+              "$ref": "#/definitions/SqlContainerGetResults"
+            }
+          }
+        }
+      },
+      "put": {
+        "operationId": "SqlResources_CreateUpdateSqlContainer",
+        "x-ms-examples": {
+          "CosmosDBSqlContainerCreateUpdate": {
+            "$ref": "./examples/CosmosDBSqlContainerCreateUpdate.json"
+          }
+        },
+        "description": "Create or update an Azure Cosmos DB SQL container",
+        "x-ms-long-running-operation": true,
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/accountNameParameter"
+          },
+          {
+            "$ref": "#/parameters/databaseNameParameter"
+          },
+          {
+            "$ref": "#/parameters/containerNameParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "name": "createUpdateSqlContainerParameters",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/SqlContainerCreateUpdateParameters"
+            },
+            "description": "The parameters to provide for the current SQL container."
+          }
+        ],
+        "responses": {
+          "202": {
+            "description": "The SQL container create or update operation will complete asynchronously."
+          },
+          "200": {
+            "description": "The SQL container create or update operation was completed successfully.",
+            "schema": {
+              "$ref": "#/definitions/SqlContainerGetResults"
+            }
+          }
+        }
+      },
+      "delete": {
+        "operationId": "SqlResources_DeleteSqlContainer",
+        "x-ms-examples": {
+          "CosmosDBSqlContainerDelete": {
+            "$ref": "./examples/CosmosDBSqlContainerDelete.json"
+          }
+        },
+        "description": "Deletes an existing Azure Cosmos DB SQL container.",
+        "x-ms-long-running-operation": true,
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/accountNameParameter"
+          },
+          {
+            "$ref": "#/parameters/databaseNameParameter"
+          },
+          {
+            "$ref": "#/parameters/containerNameParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          }
+        ],
+        "responses": {
+          "202": {
+            "description": "The SQL container delete operation will complete asynchronously."
+          },
+          "204": {
+            "description": "The SQL container delete operation was completed successfully."
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{accountName}/sqlDatabases/{databaseName}/containers/{containerName}/throughputSettings/default": {
+      "get": {
+        "operationId": "SqlResources_GetSqlContainerThroughput",
+        "x-ms-examples": {
+          "CosmosDBSqlContainerThroughputGet": {
+            "$ref": "./examples/CosmosDBSqlContainerThroughputGet.json"
+          }
+        },
+        "description": "Gets the RUs per second of the SQL container under an existing Azure Cosmos DB database account.",
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/accountNameParameter"
+          },
+          {
+            "$ref": "#/parameters/databaseNameParameter"
+          },
+          {
+            "$ref": "#/parameters/containerNameParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The RUs per second of the SQL container was retrieved successfully.",
+            "schema": {
+              "$ref": "#/definitions/ThroughputSettingsGetResults"
+            }
+          }
+        }
+      },
+      "put": {
+        "operationId": "SqlResources_UpdateSqlContainerThroughput",
+        "x-ms-examples": {
+          "CosmosDBSqlContainerThroughputUpdate": {
+            "$ref": "./examples/CosmosDBSqlContainerThroughputUpdate.json"
+          }
+        },
+        "description": "Update RUs per second of an Azure Cosmos DB SQL container",
+        "x-ms-long-running-operation": true,
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/accountNameParameter"
+          },
+          {
+            "$ref": "#/parameters/databaseNameParameter"
+          },
+          {
+            "$ref": "#/parameters/containerNameParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "name": "updateThroughputParameters",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/ThroughputSettingsUpdateParameters"
+            },
+            "description": "The parameters to provide for the RUs per second of the current SQL container."
+          }
+        ],
+        "responses": {
+          "202": {
+            "description": "The RUs per second of the SQL container update operation will complete asynchronously."
+          },
+          "200": {
+            "description": "The RUs per second of the SQL container update operation was completed successfully.",
+            "schema": {
+              "$ref": "#/definitions/ThroughputSettingsGetResults"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{accountName}/sqlDatabases/{databaseName}/containers/{containerName}/throughputSettings/default/migrateToAutoscale": {
+      "post": {
+        "operationId": "SqlResources_MigrateSqlContainerToAutoscale",
+        "x-ms-examples": {
+          "CosmosDBSqlContainerMigrateToAutoscale": {
+            "$ref": "./examples/CosmosDBSqlContainerMigrateToAutoscale.json"
+          }
+        },
+        "description": "Migrate an Azure Cosmos DB SQL container from manual throughput to autoscale",
+        "x-ms-long-running-operation": true,
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/accountNameParameter"
+          },
+          {
+            "$ref": "#/parameters/databaseNameParameter"
+          },
+          {
+            "$ref": "#/parameters/containerNameParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          }
+        ],
+        "responses": {
+          "202": {
+            "description": "The SQL container migrate operation will complete asynchronously."
+          },
+          "200": {
+            "description": "The SQL container migrate operation was completed successfully.",
+            "schema": {
+              "$ref": "#/definitions/ThroughputSettingsGetResults"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponseUpdatedFormat"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{accountName}/sqlDatabases/{databaseName}/containers/{containerName}/throughputSettings/default/migrateToManualThroughput": {
+      "post": {
+        "operationId": "SqlResources_MigrateSqlContainerToManualThroughput",
+        "x-ms-examples": {
+          "CosmosDBSqlContainerMigrateToManualThroughput": {
+            "$ref": "./examples/CosmosDBSqlContainerMigrateToManualThroughput.json"
+          }
+        },
+        "description": "Migrate an Azure Cosmos DB SQL container from autoscale to manual throughput",
+        "x-ms-long-running-operation": true,
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/accountNameParameter"
+          },
+          {
+            "$ref": "#/parameters/databaseNameParameter"
+          },
+          {
+            "$ref": "#/parameters/containerNameParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          }
+        ],
+        "responses": {
+          "202": {
+            "description": "The SQL container migrate operation will complete asynchronously."
+          },
+          "200": {
+            "description": "The SQL container migrate operation was completed successfully.",
+            "schema": {
+              "$ref": "#/definitions/ThroughputSettingsGetResults"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponseUpdatedFormat"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{accountName}/sqlDatabases/{databaseName}/containers/{containerName}/storedProcedures": {
+      "get": {
+        "operationId": "SqlResources_ListSqlStoredProcedures",
+        "x-ms-examples": {
+          "CosmosDBSqlStoredProcedureList": {
+            "$ref": "./examples/CosmosDBSqlStoredProcedureList.json"
+          }
+        },
+        "description": "Lists the SQL storedProcedure under an existing Azure Cosmos DB database account.",
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/accountNameParameter"
+          },
+          {
+            "$ref": "#/parameters/databaseNameParameter"
+          },
+          {
+            "$ref": "#/parameters/containerNameParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The SQL stored procedure properties were retrieved successfully.",
+            "schema": {
+              "$ref": "#/definitions/SqlStoredProcedureListResult"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponseUpdatedFormat"
+            }
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": null
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{accountName}/sqlDatabases/{databaseName}/containers/{containerName}/storedProcedures/{storedProcedureName}": {
+      "get": {
+        "operationId": "SqlResources_GetSqlStoredProcedure",
+        "x-ms-examples": {
+          "CosmosDBSqlStoredProcedureGet": {
+            "$ref": "./examples/CosmosDBSqlStoredProcedureGet.json"
+          }
+        },
+        "description": "Gets the SQL storedProcedure under an existing Azure Cosmos DB database account.",
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/accountNameParameter"
+          },
+          {
+            "$ref": "#/parameters/databaseNameParameter"
+          },
+          {
+            "$ref": "#/parameters/containerNameParameter"
+          },
+          {
+            "$ref": "#/parameters/storedProcedureNameParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The SQL storedProcedure property was retrieved successfully.",
+            "schema": {
+              "$ref": "#/definitions/SqlStoredProcedureGetResults"
+            }
+          }
+        }
+      },
+      "put": {
+        "operationId": "SqlResources_CreateUpdateSqlStoredProcedure",
+        "x-ms-examples": {
+          "CosmosDBSqlStoredProcedureCreateUpdate": {
+            "$ref": "./examples/CosmosDBSqlStoredProcedureCreateUpdate.json"
+          }
+        },
+        "description": "Create or update an Azure Cosmos DB SQL storedProcedure",
+        "x-ms-long-running-operation": true,
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/accountNameParameter"
+          },
+          {
+            "$ref": "#/parameters/databaseNameParameter"
+          },
+          {
+            "$ref": "#/parameters/containerNameParameter"
+          },
+          {
+            "$ref": "#/parameters/storedProcedureNameParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "name": "createUpdateSqlStoredProcedureParameters",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/SqlStoredProcedureCreateUpdateParameters"
+            },
+            "description": "The parameters to provide for the current SQL storedProcedure."
+          }
+        ],
+        "responses": {
+          "202": {
+            "description": "The SQL storedProcedure create or update operation will complete asynchronously."
+          },
+          "200": {
+            "description": "The SQL storedProcedure create or update operation was completed successfully.",
+            "schema": {
+              "$ref": "#/definitions/SqlStoredProcedureGetResults"
+            }
+          }
+        }
+      },
+      "delete": {
+        "operationId": "SqlResources_DeleteSqlStoredProcedure",
+        "x-ms-examples": {
+          "CosmosDBSqlStoredProcedureDelete": {
+            "$ref": "./examples/CosmosDBSqlStoredProcedureDelete.json"
+          }
+        },
+        "description": "Deletes an existing Azure Cosmos DB SQL storedProcedure.",
+        "x-ms-long-running-operation": true,
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/accountNameParameter"
+          },
+          {
+            "$ref": "#/parameters/databaseNameParameter"
+          },
+          {
+            "$ref": "#/parameters/containerNameParameter"
+          },
+          {
+            "$ref": "#/parameters/storedProcedureNameParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          }
+        ],
+        "responses": {
+          "202": {
+            "description": "The SQL storedProcedure delete operation will complete asynchronously."
+          },
+          "204": {
+            "description": "The SQL storedProcedure delete operation was completed successfully."
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{accountName}/sqlDatabases/{databaseName}/containers/{containerName}/userDefinedFunctions": {
+      "get": {
+        "operationId": "SqlResources_ListSqlUserDefinedFunctions",
+        "x-ms-examples": {
+          "CosmosDBSqlUserDefinedFunctionList": {
+            "$ref": "./examples/CosmosDBSqlUserDefinedFunctionList.json"
+          }
+        },
+        "description": "Lists the SQL userDefinedFunction under an existing Azure Cosmos DB database account.",
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/accountNameParameter"
+          },
+          {
+            "$ref": "#/parameters/databaseNameParameter"
+          },
+          {
+            "$ref": "#/parameters/containerNameParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The SQL userDefinedFunction properties were retrieved successfully.",
+            "schema": {
+              "$ref": "#/definitions/SqlUserDefinedFunctionListResult"
+            }
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": null
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{accountName}/sqlDatabases/{databaseName}/containers/{containerName}/userDefinedFunctions/{userDefinedFunctionName}": {
+      "get": {
+        "operationId": "SqlResources_GetSqlUserDefinedFunction",
+        "x-ms-examples": {
+          "CosmosDBSqlUserDefinedFunctionGet": {
+            "$ref": "./examples/CosmosDBSqlUserDefinedFunctionGet.json"
+          }
+        },
+        "description": "Gets the SQL userDefinedFunction under an existing Azure Cosmos DB database account.",
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/accountNameParameter"
+          },
+          {
+            "$ref": "#/parameters/databaseNameParameter"
+          },
+          {
+            "$ref": "#/parameters/containerNameParameter"
+          },
+          {
+            "$ref": "#/parameters/userDefinedFunctionNameParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The SQL userDefinedFunction property was retrieved successfully.",
+            "schema": {
+              "$ref": "#/definitions/SqlUserDefinedFunctionGetResults"
+            }
+          }
+        }
+      },
+      "put": {
+        "operationId": "SqlResources_CreateUpdateSqlUserDefinedFunction",
+        "x-ms-examples": {
+          "CosmosDBSqlUserDefinedFunctionCreateUpdate": {
+            "$ref": "./examples/CosmosDBSqlUserDefinedFunctionCreateUpdate.json"
+          }
+        },
+        "description": "Create or update an Azure Cosmos DB SQL userDefinedFunction",
+        "x-ms-long-running-operation": true,
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/accountNameParameter"
+          },
+          {
+            "$ref": "#/parameters/databaseNameParameter"
+          },
+          {
+            "$ref": "#/parameters/containerNameParameter"
+          },
+          {
+            "$ref": "#/parameters/userDefinedFunctionNameParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "name": "createUpdateSqlUserDefinedFunctionParameters",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/SqlUserDefinedFunctionCreateUpdateParameters"
+            },
+            "description": "The parameters to provide for the current SQL userDefinedFunction."
+          }
+        ],
+        "responses": {
+          "202": {
+            "description": "The SQL userDefinedFunction create or update operation will complete asynchronously."
+          },
+          "200": {
+            "description": "The SQL userDefinedFunction create or update operation was completed successfully.",
+            "schema": {
+              "$ref": "#/definitions/SqlUserDefinedFunctionGetResults"
+            }
+          }
+        }
+      },
+      "delete": {
+        "operationId": "SqlResources_DeleteSqlUserDefinedFunction",
+        "x-ms-examples": {
+          "CosmosDBSqlUserDefinedFunctionDelete": {
+            "$ref": "./examples/CosmosDBSqlUserDefinedFunctionDelete.json"
+          }
+        },
+        "description": "Deletes an existing Azure Cosmos DB SQL userDefinedFunction.",
+        "x-ms-long-running-operation": true,
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/accountNameParameter"
+          },
+          {
+            "$ref": "#/parameters/databaseNameParameter"
+          },
+          {
+            "$ref": "#/parameters/containerNameParameter"
+          },
+          {
+            "$ref": "#/parameters/userDefinedFunctionNameParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          }
+        ],
+        "responses": {
+          "202": {
+            "description": "The SQL userDefinedFunction delete operation will complete asynchronously."
+          },
+          "204": {
+            "description": "The SQL userDefinedFunction delete operation was completed successfully."
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{accountName}/sqlDatabases/{databaseName}/containers/{containerName}/triggers": {
+      "get": {
+        "operationId": "SqlResources_ListSqlTriggers",
+        "x-ms-examples": {
+          "CosmosDBSqlTriggerList": {
+            "$ref": "./examples/CosmosDBSqlTriggerList.json"
+          }
+        },
+        "description": "Lists the SQL trigger under an existing Azure Cosmos DB database account.",
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/accountNameParameter"
+          },
+          {
+            "$ref": "#/parameters/databaseNameParameter"
+          },
+          {
+            "$ref": "#/parameters/containerNameParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The SQL trigger properties were retrieved successfully.",
+            "schema": {
+              "$ref": "#/definitions/SqlTriggerListResult"
+            }
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": null
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{accountName}/sqlDatabases/{databaseName}/containers/{containerName}/triggers/{triggerName}": {
+      "get": {
+        "operationId": "SqlResources_GetSqlTrigger",
+        "x-ms-examples": {
+          "CosmosDBSqlTriggerGet": {
+            "$ref": "./examples/CosmosDBSqlTriggerGet.json"
+          }
+        },
+        "description": "Gets the SQL trigger under an existing Azure Cosmos DB database account.",
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/accountNameParameter"
+          },
+          {
+            "$ref": "#/parameters/databaseNameParameter"
+          },
+          {
+            "$ref": "#/parameters/containerNameParameter"
+          },
+          {
+            "$ref": "#/parameters/triggerNameParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The SQL trigger property was retrieved successfully.",
+            "schema": {
+              "$ref": "#/definitions/SqlTriggerGetResults"
+            }
+          }
+        }
+      },
+      "put": {
+        "operationId": "SqlResources_CreateUpdateSqlTrigger",
+        "x-ms-examples": {
+          "CosmosDBSqlTriggerCreateUpdate": {
+            "$ref": "./examples/CosmosDBSqlTriggerCreateUpdate.json"
+          }
+        },
+        "description": "Create or update an Azure Cosmos DB SQL trigger",
+        "x-ms-long-running-operation": true,
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/accountNameParameter"
+          },
+          {
+            "$ref": "#/parameters/databaseNameParameter"
+          },
+          {
+            "$ref": "#/parameters/containerNameParameter"
+          },
+          {
+            "$ref": "#/parameters/triggerNameParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "name": "createUpdateSqlTriggerParameters",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/SqlTriggerCreateUpdateParameters"
+            },
+            "description": "The parameters to provide for the current SQL trigger."
+          }
+        ],
+        "responses": {
+          "202": {
+            "description": "The SQL trigger create or update operation will complete asynchronously."
+          },
+          "200": {
+            "description": "The SQL trigger create or update operation was completed successfully.",
+            "schema": {
+              "$ref": "#/definitions/SqlTriggerGetResults"
+            }
+          }
+        }
+      },
+      "delete": {
+        "operationId": "SqlResources_DeleteSqlTrigger",
+        "x-ms-examples": {
+          "CosmosDBSqlTriggerDelete": {
+            "$ref": "./examples/CosmosDBSqlTriggerDelete.json"
+          }
+        },
+        "description": "Deletes an existing Azure Cosmos DB SQL trigger.",
+        "x-ms-long-running-operation": true,
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/accountNameParameter"
+          },
+          {
+            "$ref": "#/parameters/databaseNameParameter"
+          },
+          {
+            "$ref": "#/parameters/containerNameParameter"
+          },
+          {
+            "$ref": "#/parameters/triggerNameParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          }
+        ],
+        "responses": {
+          "202": {
+            "description": "The SQL trigger delete operation will complete asynchronously."
+          },
+          "204": {
+            "description": "The SQL trigger delete operation was completed successfully."
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{accountName}/mongodbDatabases": {
+      "get": {
+        "operationId": "MongoDBResources_ListMongoDBDatabases",
+        "x-ms-examples": {
+          "CosmosDBMongoDBDatabaseList": {
+            "$ref": "./examples/CosmosDBMongoDBDatabaseList.json"
+          }
+        },
+        "description": "Lists the MongoDB databases under an existing Azure Cosmos DB database account.",
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/accountNameParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The MongoDB database properties were retrieved successfully.",
+            "schema": {
+              "$ref": "#/definitions/MongoDBDatabaseListResult"
+            }
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": null
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{accountName}/mongodbDatabases/{databaseName}": {
+      "get": {
+        "operationId": "MongoDBResources_GetMongoDBDatabase",
+        "x-ms-examples": {
+          "CosmosDBMongoDBDatabaseGet": {
+            "$ref": "./examples/CosmosDBMongoDBDatabaseGet.json"
+          }
+        },
+        "description": "Gets the MongoDB databases under an existing Azure Cosmos DB database account with the provided name.",
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/accountNameParameter"
+          },
+          {
+            "$ref": "#/parameters/databaseNameParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The MongoDB database property was retrieved successfully.",
+            "schema": {
+              "$ref": "#/definitions/MongoDBDatabaseGetResults"
+            }
+          }
+        }
+      },
+      "put": {
+        "operationId": "MongoDBResources_CreateUpdateMongoDBDatabase",
+        "x-ms-examples": {
+          "CosmosDBMongoDBDatabaseCreateUpdate": {
+            "$ref": "./examples/CosmosDBMongoDBDatabaseCreateUpdate.json"
+          }
+        },
+        "description": "Create or updates Azure Cosmos DB MongoDB database",
+        "x-ms-long-running-operation": true,
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/accountNameParameter"
+          },
+          {
+            "$ref": "#/parameters/databaseNameParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "name": "createUpdateMongoDBDatabaseParameters",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/MongoDBDatabaseCreateUpdateParameters"
+            },
+            "description": "The parameters to provide for the current MongoDB database."
+          }
+        ],
+        "responses": {
+          "202": {
+            "description": "The MongoDB database create or update operation will complete asynchronously."
+          },
+          "200": {
+            "description": "The MongoDB database create or update operation was completed successfully.",
+            "schema": {
+              "$ref": "#/definitions/MongoDBDatabaseGetResults"
+            }
+          }
+        }
+      },
+      "delete": {
+        "operationId": "MongoDBResources_DeleteMongoDBDatabase",
+        "x-ms-examples": {
+          "CosmosDBMongoDBDatabaseDelete": {
+            "$ref": "./examples/CosmosDBMongoDBDatabaseDelete.json"
+          }
+        },
+        "description": "Deletes an existing Azure Cosmos DB MongoDB database.",
+        "x-ms-long-running-operation": true,
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/accountNameParameter"
+          },
+          {
+            "$ref": "#/parameters/databaseNameParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          }
+        ],
+        "responses": {
+          "202": {
+            "description": "The MongoDB database delete operation will complete asynchronously."
+          },
+          "204": {
+            "description": "The MongoDB database delete operation was completed successfully."
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{accountName}/mongodbDatabases/{databaseName}/throughputSettings/default": {
+      "get": {
+        "operationId": "MongoDBResources_GetMongoDBDatabaseThroughput",
+        "x-ms-examples": {
+          "CosmosDBMongoDBDatabaseThroughputGet": {
+            "$ref": "./examples/CosmosDBMongoDBDatabaseThroughputGet.json"
+          }
+        },
+        "description": "Gets the RUs per second of the MongoDB database under an existing Azure Cosmos DB database account with the provided name.",
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/accountNameParameter"
+          },
+          {
+            "$ref": "#/parameters/databaseNameParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The RUs per second of the MongoDB database was retrieved successfully.",
+            "schema": {
+              "$ref": "#/definitions/ThroughputSettingsGetResults"
+            }
+          }
+        }
+      },
+      "put": {
+        "operationId": "MongoDBResources_UpdateMongoDBDatabaseThroughput",
+        "x-ms-examples": {
+          "CosmosDBMongoDBDatabaseThroughputUpdate": {
+            "$ref": "./examples/CosmosDBMongoDBDatabaseThroughputUpdate.json"
+          }
+        },
+        "description": "Update RUs per second of the an Azure Cosmos DB MongoDB database",
+        "x-ms-long-running-operation": true,
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/accountNameParameter"
+          },
+          {
+            "$ref": "#/parameters/databaseNameParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "name": "updateThroughputParameters",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/ThroughputSettingsUpdateParameters"
+            },
+            "description": "The RUs per second of the parameters to provide for the current MongoDB database."
+          }
+        ],
+        "responses": {
+          "202": {
+            "description": "The RUs per second of the MongoDB database update operation will complete asynchronously."
+          },
+          "200": {
+            "description": "The RUs per second of the MongoDB database update operation was completed successfully.",
+            "schema": {
+              "$ref": "#/definitions/ThroughputSettingsGetResults"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponseUpdatedFormat"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{accountName}/mongodbDatabases/{databaseName}/throughputSettings/default/migrateToAutoscale": {
+      "post": {
+        "operationId": "MongoDBResources_MigrateMongoDBDatabaseToAutoscale",
+        "x-ms-examples": {
+          "CosmosDBMongoDBDatabaseMigrateToAutoscale": {
+            "$ref": "./examples/CosmosDBMongoDBDatabaseMigrateToAutoscale.json"
+          }
+        },
+        "description": "Migrate an Azure Cosmos DB MongoDB database from manual throughput to autoscale",
+        "x-ms-long-running-operation": true,
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/accountNameParameter"
+          },
+          {
+            "$ref": "#/parameters/databaseNameParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          }
+        ],
+        "responses": {
+          "202": {
+            "description": "The MongoDB database migrate operation will complete asynchronously."
+          },
+          "200": {
+            "description": "The MongoDB database migrate operation was completed successfully.",
+            "schema": {
+              "$ref": "#/definitions/ThroughputSettingsGetResults"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponseUpdatedFormat"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{accountName}/mongodbDatabases/{databaseName}/throughputSettings/default/migrateToManualThroughput": {
+      "post": {
+        "operationId": "MongoDBResources_MigrateMongoDBDatabaseToManualThroughput",
+        "x-ms-examples": {
+          "CosmosDBMongoDBDatabaseMigrateToManualThroughput": {
+            "$ref": "./examples/CosmosDBMongoDBDatabaseMigrateToManualThroughput.json"
+          }
+        },
+        "description": "Migrate an Azure Cosmos DB MongoDB database from autoscale to manual throughput",
+        "x-ms-long-running-operation": true,
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/accountNameParameter"
+          },
+          {
+            "$ref": "#/parameters/databaseNameParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          }
+        ],
+        "responses": {
+          "202": {
+            "description": "The MongoDB database migrate operation will complete asynchronously."
+          },
+          "200": {
+            "description": "The MongoDB database migrate operation was completed successfully.",
+            "schema": {
+              "$ref": "#/definitions/ThroughputSettingsGetResults"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponseUpdatedFormat"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{accountName}/mongodbDatabases/{databaseName}/collections": {
+      "get": {
+        "operationId": "MongoDBResources_ListMongoDBCollections",
+        "x-ms-examples": {
+          "CosmosDBMongoDBCollectionList": {
+            "$ref": "./examples/CosmosDBMongoDBCollectionList.json"
+          }
+        },
+        "description": "Lists the MongoDB collection under an existing Azure Cosmos DB database account.",
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/accountNameParameter"
+          },
+          {
+            "$ref": "#/parameters/databaseNameParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The MongoDB collection properties were retrieved successfully.",
+            "schema": {
+              "$ref": "#/definitions/MongoDBCollectionListResult"
+            }
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": null
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{accountName}/mongodbDatabases/{databaseName}/collections/{collectionName}": {
+      "get": {
+        "operationId": "MongoDBResources_GetMongoDBCollection",
+        "x-ms-examples": {
+          "CosmosDBMongoDBCollectionGet": {
+            "$ref": "./examples/CosmosDBMongoDBCollectionGet.json"
+          }
+        },
+        "description": "Gets the MongoDB collection under an existing Azure Cosmos DB database account.",
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/accountNameParameter"
+          },
+          {
+            "$ref": "#/parameters/databaseNameParameter"
+          },
+          {
+            "$ref": "#/parameters/collectionNameParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The MongoDB collection property was retrieved successfully.",
+            "schema": {
+              "$ref": "#/definitions/MongoDBCollectionGetResults"
+            }
+          }
+        }
+      },
+      "put": {
+        "operationId": "MongoDBResources_CreateUpdateMongoDBCollection",
+        "x-ms-examples": {
+          "CosmosDBMongoDBCollectionCreateUpdate": {
+            "$ref": "./examples/CosmosDBMongoDBCollectionCreateUpdate.json"
+          }
+        },
+        "description": "Create or update an Azure Cosmos DB MongoDB Collection",
+        "x-ms-long-running-operation": true,
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/accountNameParameter"
+          },
+          {
+            "$ref": "#/parameters/databaseNameParameter"
+          },
+          {
+            "$ref": "#/parameters/collectionNameParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "name": "createUpdateMongoDBCollectionParameters",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/MongoDBCollectionCreateUpdateParameters"
+            },
+            "description": "The parameters to provide for the current MongoDB Collection."
+          }
+        ],
+        "responses": {
+          "202": {
+            "description": "The MongoDB Collection create or update operation will complete asynchronously."
+          },
+          "200": {
+            "description": "The MongoDB Collection create or update operation was completed successfully.",
+            "schema": {
+              "$ref": "#/definitions/MongoDBCollectionGetResults"
+            }
+          }
+        }
+      },
+      "delete": {
+        "operationId": "MongoDBResources_DeleteMongoDBCollection",
+        "x-ms-examples": {
+          "CosmosDBMongoDBCollectionDelete": {
+            "$ref": "./examples/CosmosDBMongoDBCollectionDelete.json"
+          }
+        },
+        "description": "Deletes an existing Azure Cosmos DB MongoDB Collection.",
+        "x-ms-long-running-operation": true,
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/accountNameParameter"
+          },
+          {
+            "$ref": "#/parameters/databaseNameParameter"
+          },
+          {
+            "$ref": "#/parameters/collectionNameParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          }
+        ],
+        "responses": {
+          "202": {
+            "description": "The MongoDB collection delete operation will complete asynchronously."
+          },
+          "204": {
+            "description": "The MongoDB collection delete operation was completed successfully."
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{accountName}/mongodbDatabases/{databaseName}/collections/{collectionName}/throughputSettings/default": {
+      "get": {
+        "operationId": "MongoDBResources_GetMongoDBCollectionThroughput",
+        "x-ms-examples": {
+          "CosmosDBMongoDBCollectionThroughputGet": {
+            "$ref": "./examples/CosmosDBMongoDBCollectionThroughputGet.json"
+          }
+        },
+        "description": "Gets the RUs per second of the MongoDB collection under an existing Azure Cosmos DB database account with the provided name.",
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/accountNameParameter"
+          },
+          {
+            "$ref": "#/parameters/databaseNameParameter"
+          },
+          {
+            "$ref": "#/parameters/collectionNameParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The RUs per second of the MongoDB collection was retrieved successfully.",
+            "schema": {
+              "$ref": "#/definitions/ThroughputSettingsGetResults"
+            }
+          }
+        }
+      },
+      "put": {
+        "operationId": "MongoDBResources_UpdateMongoDBCollectionThroughput",
+        "x-ms-examples": {
+          "CosmosDBMongoDBCollectionThroughputUpdate": {
+            "$ref": "./examples/CosmosDBMongoDBCollectionThroughputUpdate.json"
+          }
+        },
+        "description": "Update the RUs per second of an Azure Cosmos DB MongoDB collection",
+        "x-ms-long-running-operation": true,
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/accountNameParameter"
+          },
+          {
+            "$ref": "#/parameters/databaseNameParameter"
+          },
+          {
+            "$ref": "#/parameters/collectionNameParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "name": "updateThroughputParameters",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/ThroughputSettingsUpdateParameters"
+            },
+            "description": "The RUs per second of the parameters to provide for the current MongoDB collection."
+          }
+        ],
+        "responses": {
+          "202": {
+            "description": "The RUs per second of the MongoDB collection update operation will complete asynchronously."
+          },
+          "200": {
+            "description": "The RUs per second of the MongoDB collection update operation was completed successfully.",
+            "schema": {
+              "$ref": "#/definitions/ThroughputSettingsGetResults"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{accountName}/mongodbDatabases/{databaseName}/collections/{collectionName}/throughputSettings/default/migrateToAutoscale": {
+      "post": {
+        "operationId": "MongoDBResources_MigrateMongoDBCollectionToAutoscale",
+        "x-ms-examples": {
+          "CosmosDBMongoDBCollectionMigrateToAutoscale": {
+            "$ref": "./examples/CosmosDBMongoDBCollectionMigrateToAutoscale.json"
+          }
+        },
+        "description": "Migrate an Azure Cosmos DB MongoDB collection from manual throughput to autoscale",
+        "x-ms-long-running-operation": true,
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/accountNameParameter"
+          },
+          {
+            "$ref": "#/parameters/databaseNameParameter"
+          },
+          {
+            "$ref": "#/parameters/collectionNameParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          }
+        ],
+        "responses": {
+          "202": {
+            "description": "The MongoDB collection migrate operation will complete asynchronously."
+          },
+          "200": {
+            "description": "The MongoDB collection migrate operation was completed successfully.",
+            "schema": {
+              "$ref": "#/definitions/ThroughputSettingsGetResults"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponseUpdatedFormat"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{accountName}/mongodbDatabases/{databaseName}/collections/{collectionName}/throughputSettings/default/migrateToManualThroughput": {
+      "post": {
+        "operationId": "MongoDBResources_MigrateMongoDBCollectionToManualThroughput",
+        "x-ms-examples": {
+          "CosmosDBMongoDBCollectionMigrateToManualThroughput": {
+            "$ref": "./examples/CosmosDBMongoDBCollectionMigrateToManualThroughput.json"
+          }
+        },
+        "description": "Migrate an Azure Cosmos DB MongoDB collection from autoscale to manual throughput",
+        "x-ms-long-running-operation": true,
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/accountNameParameter"
+          },
+          {
+            "$ref": "#/parameters/databaseNameParameter"
+          },
+          {
+            "$ref": "#/parameters/collectionNameParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          }
+        ],
+        "responses": {
+          "202": {
+            "description": "The MongoDB collection migrate operation will complete asynchronously."
+          },
+          "200": {
+            "description": "The MongoDB collection migrate operation was completed successfully.",
+            "schema": {
+              "$ref": "#/definitions/ThroughputSettingsGetResults"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponseUpdatedFormat"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{accountName}/tables": {
+      "get": {
+        "operationId": "TableResources_ListTables",
+        "x-ms-examples": {
+          "CosmosDBTableList": {
+            "$ref": "./examples/CosmosDBTableList.json"
+          }
+        },
+        "description": "Lists the Tables under an existing Azure Cosmos DB database account.",
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/accountNameParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The Table properties were retrieved successfully.",
+            "schema": {
+              "$ref": "#/definitions/TableListResult"
+            }
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": null
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{accountName}/tables/{tableName}": {
+      "get": {
+        "operationId": "TableResources_GetTable",
+        "x-ms-examples": {
+          "CosmosDBTableGet": {
+            "$ref": "./examples/CosmosDBTableGet.json"
+          }
+        },
+        "description": "Gets the Tables under an existing Azure Cosmos DB database account with the provided name.",
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/accountNameParameter"
+          },
+          {
+            "$ref": "#/parameters/tableNameParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The Table property was retrieved successfully.",
+            "schema": {
+              "$ref": "#/definitions/TableGetResults"
+            }
+          }
+        }
+      },
+      "put": {
+        "operationId": "TableResources_CreateUpdateTable",
+        "x-ms-examples": {
+          "CosmosDBTableReplace": {
+            "$ref": "./examples/CosmosDBTableCreateUpdate.json"
+          }
+        },
+        "description": "Create or update an Azure Cosmos DB Table",
+        "x-ms-long-running-operation": true,
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/accountNameParameter"
+          },
+          {
+            "$ref": "#/parameters/tableNameParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "name": "createUpdateTableParameters",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/TableCreateUpdateParameters"
+            },
+            "description": "The parameters to provide for the current Table."
+          }
+        ],
+        "responses": {
+          "202": {
+            "description": "The Table create or update operation will complete asynchronously."
+          },
+          "200": {
+            "description": "The Table create or update operation was completed successfully.",
+            "schema": {
+              "$ref": "#/definitions/TableGetResults"
+            }
+          }
+        }
+      },
+      "delete": {
+        "operationId": "TableResources_DeleteTable",
+        "x-ms-examples": {
+          "CosmosDBTableDelete": {
+            "$ref": "./examples/CosmosDBTableDelete.json"
+          }
+        },
+        "description": "Deletes an existing Azure Cosmos DB Table.",
+        "x-ms-long-running-operation": true,
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/accountNameParameter"
+          },
+          {
+            "$ref": "#/parameters/tableNameParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          }
+        ],
+        "responses": {
+          "202": {
+            "description": "The Table delete operation will complete asynchronously."
+          },
+          "204": {
+            "description": "The Table delete operation was completed successfully."
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{accountName}/tables/{tableName}/throughputSettings/default": {
+      "get": {
+        "operationId": "TableResources_GetTableThroughput",
+        "x-ms-examples": {
+          "CosmosDBTableThroughputGet": {
+            "$ref": "./examples/CosmosDBTableThroughputGet.json"
+          }
+        },
+        "description": "Gets the RUs per second of the Table under an existing Azure Cosmos DB database account with the provided name.",
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/accountNameParameter"
+          },
+          {
+            "$ref": "#/parameters/tableNameParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The RUs per second of the Table was retrieved successfully.",
+            "schema": {
+              "$ref": "#/definitions/ThroughputSettingsGetResults"
+            }
+          }
+        }
+      },
+      "put": {
+        "operationId": "TableResources_UpdateTableThroughput",
+        "x-ms-examples": {
+          "CosmosDBTableThroughputUpdate": {
+            "$ref": "./examples/CosmosDBTableThroughputUpdate.json"
+          }
+        },
+        "description": "Update RUs per second of an Azure Cosmos DB Table",
+        "x-ms-long-running-operation": true,
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/accountNameParameter"
+          },
+          {
+            "$ref": "#/parameters/tableNameParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "name": "updateThroughputParameters",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/ThroughputSettingsUpdateParameters"
+            },
+            "description": "The parameters to provide for the RUs per second of the current Table."
+          }
+        ],
+        "responses": {
+          "202": {
+            "description": "The RUs per second of the Table update operation will complete asynchronously."
+          },
+          "200": {
+            "description": "The RUs per second of the Table update operation was completed successfully.",
+            "schema": {
+              "$ref": "#/definitions/ThroughputSettingsGetResults"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{accountName}/tables/{tableName}/throughputSettings/default/migrateToAutoscale": {
+      "post": {
+        "operationId": "TableResources_MigrateTableToAutoscale",
+        "x-ms-examples": {
+          "CosmosDBTableMigrateToAutoscale": {
+            "$ref": "./examples/CosmosDBTableMigrateToAutoscale.json"
+          }
+        },
+        "description": "Migrate an Azure Cosmos DB Table from manual throughput to autoscale",
+        "x-ms-long-running-operation": true,
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/accountNameParameter"
+          },
+          {
+            "$ref": "#/parameters/tableNameParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          }
+        ],
+        "responses": {
+          "202": {
+            "description": "The Table migrate operation will complete asynchronously."
+          },
+          "200": {
+            "description": "The Table migrate operation was completed successfully.",
+            "schema": {
+              "$ref": "#/definitions/ThroughputSettingsGetResults"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponseUpdatedFormat"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{accountName}/tables/{tableName}/throughputSettings/default/migrateToManualThroughput": {
+      "post": {
+        "operationId": "TableResources_MigrateTableToManualThroughput",
+        "x-ms-examples": {
+          "CosmosDBTableMigrateToManualThroughput": {
+            "$ref": "./examples/CosmosDBTableMigrateToManualThroughput.json"
+          }
+        },
+        "description": "Migrate an Azure Cosmos DB Table from autoscale to manual throughput",
+        "x-ms-long-running-operation": true,
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/accountNameParameter"
+          },
+          {
+            "$ref": "#/parameters/tableNameParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          }
+        ],
+        "responses": {
+          "202": {
+            "description": "The Table migrate operation will complete asynchronously."
+          },
+          "200": {
+            "description": "The Table migrate operation was completed successfully.",
+            "schema": {
+              "$ref": "#/definitions/ThroughputSettingsGetResults"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponseUpdatedFormat"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{accountName}/cassandraKeyspaces": {
+      "get": {
+        "operationId": "CassandraResources_ListCassandraKeyspaces",
+        "x-ms-examples": {
+          "CosmosDBCassandraKeyspaceList": {
+            "$ref": "./examples/CosmosDBCassandraKeyspaceList.json"
+          }
+        },
+        "description": "Lists the Cassandra keyspaces under an existing Azure Cosmos DB database account.",
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/accountNameParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The Cassandra keyspace properties were retrieved successfully.",
+            "schema": {
+              "$ref": "#/definitions/CassandraKeyspaceListResult"
+            }
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": null
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{accountName}/cassandraKeyspaces/{keyspaceName}": {
+      "get": {
+        "operationId": "CassandraResources_GetCassandraKeyspace",
+        "x-ms-examples": {
+          "CosmosDBCassandraKeyspaceGet": {
+            "$ref": "./examples/CosmosDBCassandraKeyspaceGet.json"
+          }
+        },
+        "description": "Gets the Cassandra keyspaces under an existing Azure Cosmos DB database account with the provided name.",
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/accountNameParameter"
+          },
+          {
+            "$ref": "#/parameters/keyspaceNameParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The Cassandra keyspace property was retrieved successfully.",
+            "schema": {
+              "$ref": "#/definitions/CassandraKeyspaceGetResults"
+            }
+          }
+        }
+      },
+      "put": {
+        "operationId": "CassandraResources_CreateUpdateCassandraKeyspace",
+        "x-ms-examples": {
+          "CosmosDBCassandraKeyspaceCreateUpdate": {
+            "$ref": "./examples/CosmosDBCassandraKeyspaceCreateUpdate.json"
+          }
+        },
+        "description": "Create or update an Azure Cosmos DB Cassandra keyspace",
+        "x-ms-long-running-operation": true,
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/accountNameParameter"
+          },
+          {
+            "$ref": "#/parameters/keyspaceNameParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "name": "createUpdateCassandraKeyspaceParameters",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/CassandraKeyspaceCreateUpdateParameters"
+            },
+            "description": "The parameters to provide for the current Cassandra keyspace."
+          }
+        ],
+        "responses": {
+          "202": {
+            "description": "The Cassandra keyspace create or update operation will complete asynchronously."
+          },
+          "200": {
+            "description": "The Cassandra keyspace create or update operation was completed successfully.",
+            "schema": {
+              "$ref": "#/definitions/CassandraKeyspaceGetResults"
+            }
+          }
+        }
+      },
+      "delete": {
+        "operationId": "CassandraResources_DeleteCassandraKeyspace",
+        "x-ms-examples": {
+          "CosmosDBCassandraKeyspaceDelete": {
+            "$ref": "./examples/CosmosDBCassandraKeyspaceDelete.json"
+          }
+        },
+        "description": "Deletes an existing Azure Cosmos DB Cassandra keyspace.",
+        "x-ms-long-running-operation": true,
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/accountNameParameter"
+          },
+          {
+            "$ref": "#/parameters/keyspaceNameParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          }
+        ],
+        "responses": {
+          "202": {
+            "description": "The Cassandra keyspace delete operation will complete asynchronously."
+          },
+          "204": {
+            "description": "The Cassandra keyspace delete operation was completed successfully."
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{accountName}/cassandraKeyspaces/{keyspaceName}/throughputSettings/default": {
+      "get": {
+        "operationId": "CassandraResources_GetCassandraKeyspaceThroughput",
+        "x-ms-examples": {
+          "CosmosDBCassandraKeyspaceThroughputGet": {
+            "$ref": "./examples/CosmosDBCassandraKeyspaceThroughputGet.json"
+          }
+        },
+        "description": "Gets the RUs per second of the Cassandra Keyspace under an existing Azure Cosmos DB database account with the provided name.",
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/accountNameParameter"
+          },
+          {
+            "$ref": "#/parameters/keyspaceNameParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The RUs per second of the Cassandra Keyspace was retrieved successfully.",
+            "schema": {
+              "$ref": "#/definitions/ThroughputSettingsGetResults"
+            }
+          }
+        }
+      },
+      "put": {
+        "operationId": "CassandraResources_UpdateCassandraKeyspaceThroughput",
+        "x-ms-examples": {
+          "CosmosDBCassandraKeyspaceThroughputUpdate": {
+            "$ref": "./examples/CosmosDBCassandraKeyspaceThroughputUpdate.json"
+          }
+        },
+        "description": "Update RUs per second of an Azure Cosmos DB Cassandra Keyspace",
+        "x-ms-long-running-operation": true,
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/accountNameParameter"
+          },
+          {
+            "$ref": "#/parameters/keyspaceNameParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "name": "updateThroughputParameters",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/ThroughputSettingsUpdateParameters"
+            },
+            "description": "The RUs per second of the parameters to provide for the current Cassandra Keyspace."
+          }
+        ],
+        "responses": {
+          "202": {
+            "description": "The RUs per second of the Cassandra Keyspace update operation will complete asynchronously."
+          },
+          "200": {
+            "description": "The RUs per second of the Cassandra Keyspace update operation was completed successfully.",
+            "schema": {
+              "$ref": "#/definitions/ThroughputSettingsGetResults"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{accountName}/cassandraKeyspaces/{keyspaceName}/throughputSettings/default/migrateToAutoscale": {
+      "post": {
+        "operationId": "CassandraResources_MigrateCassandraKeyspaceToAutoscale",
+        "x-ms-examples": {
+          "CosmosDBCassandraKeyspaceMigrateToAutoscale": {
+            "$ref": "./examples/CosmosDBCassandraKeyspaceMigrateToAutoscale.json"
+          }
+        },
+        "description": "Migrate an Azure Cosmos DB Cassandra Keyspace from manual throughput to autoscale",
+        "x-ms-long-running-operation": true,
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/accountNameParameter"
+          },
+          {
+            "$ref": "#/parameters/keyspaceNameParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          }
+        ],
+        "responses": {
+          "202": {
+            "description": "The Cassandra Keyspace migrate operation will complete asynchronously."
+          },
+          "200": {
+            "description": "The Cassandra Keyspace migrate operation was completed successfully.",
+            "schema": {
+              "$ref": "#/definitions/ThroughputSettingsGetResults"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponseUpdatedFormat"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{accountName}/cassandraKeyspaces/{keyspaceName}/throughputSettings/default/migrateToManualThroughput": {
+      "post": {
+        "operationId": "CassandraResources_MigrateCassandraKeyspaceToManualThroughput",
+        "x-ms-examples": {
+          "CosmosDBCassandraKeyspaceMigrateToManualThroughput": {
+            "$ref": "./examples/CosmosDBCassandraKeyspaceMigrateToManualThroughput.json"
+          }
+        },
+        "description": "Migrate an Azure Cosmos DB Cassandra Keyspace from autoscale to manual throughput",
+        "x-ms-long-running-operation": true,
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/accountNameParameter"
+          },
+          {
+            "$ref": "#/parameters/keyspaceNameParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          }
+        ],
+        "responses": {
+          "202": {
+            "description": "The Cassandra Keyspace migrate operation will complete asynchronously."
+          },
+          "200": {
+            "description": "The Cassandra Keyspace migrate operation was completed successfully.",
+            "schema": {
+              "$ref": "#/definitions/ThroughputSettingsGetResults"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponseUpdatedFormat"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{accountName}/cassandraKeyspaces/{keyspaceName}/tables": {
+      "get": {
+        "operationId": "CassandraResources_ListCassandraTables",
+        "x-ms-examples": {
+          "CosmosDBCassandraTableList": {
+            "$ref": "./examples/CosmosDBCassandraTableList.json"
+          }
+        },
+        "description": "Lists the Cassandra table under an existing Azure Cosmos DB database account.",
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/accountNameParameter"
+          },
+          {
+            "$ref": "#/parameters/keyspaceNameParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The Cassandra table properties were retrieved successfully.",
+            "schema": {
+              "$ref": "#/definitions/CassandraTableListResult"
+            }
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": null
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{accountName}/cassandraKeyspaces/{keyspaceName}/tables/{tableName}": {
+      "get": {
+        "operationId": "CassandraResources_GetCassandraTable",
+        "x-ms-examples": {
+          "CosmosDBCassandraTableGet": {
+            "$ref": "./examples/CosmosDBCassandraTableGet.json"
+          }
+        },
+        "description": "Gets the Cassandra table under an existing Azure Cosmos DB database account.",
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/accountNameParameter"
+          },
+          {
+            "$ref": "#/parameters/keyspaceNameParameter"
+          },
+          {
+            "$ref": "#/parameters/tableNameParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The Cassandra table property was retrieved successfully.",
+            "schema": {
+              "$ref": "#/definitions/CassandraTableGetResults"
+            }
+          }
+        }
+      },
+      "put": {
+        "operationId": "CassandraResources_CreateUpdateCassandraTable",
+        "x-ms-examples": {
+          "CosmosDBCassandraTableCreateUpdate": {
+            "$ref": "./examples/CosmosDBCassandraTableCreateUpdate.json"
+          }
+        },
+        "description": "Create or update an Azure Cosmos DB Cassandra Table",
+        "x-ms-long-running-operation": true,
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/accountNameParameter"
+          },
+          {
+            "$ref": "#/parameters/keyspaceNameParameter"
+          },
+          {
+            "$ref": "#/parameters/tableNameParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "name": "createUpdateCassandraTableParameters",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/CassandraTableCreateUpdateParameters"
+            },
+            "description": "The parameters to provide for the current Cassandra Table."
+          }
+        ],
+        "responses": {
+          "202": {
+            "description": "The Cassandra Table create or update operation will complete asynchronously."
+          },
+          "200": {
+            "description": "The Cassandra Table create or update operation was completed successfully.",
+            "schema": {
+              "$ref": "#/definitions/CassandraTableGetResults"
+            }
+          }
+        }
+      },
+      "delete": {
+        "operationId": "CassandraResources_DeleteCassandraTable",
+        "x-ms-examples": {
+          "CosmosDBCassandraTableDelete": {
+            "$ref": "./examples/CosmosDBCassandraTableDelete.json"
+          }
+        },
+        "description": "Deletes an existing Azure Cosmos DB Cassandra table.",
+        "x-ms-long-running-operation": true,
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/accountNameParameter"
+          },
+          {
+            "$ref": "#/parameters/keyspaceNameParameter"
+          },
+          {
+            "$ref": "#/parameters/tableNameParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          }
+        ],
+        "responses": {
+          "202": {
+            "description": "The Cassandra table delete operation will complete asynchronously."
+          },
+          "204": {
+            "description": "The Cassandra table delete operation was completed successfully."
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{accountName}/cassandraKeyspaces/{keyspaceName}/tables/{tableName}/throughputSettings/default": {
+      "get": {
+        "operationId": "CassandraResources_GetCassandraTableThroughput",
+        "x-ms-examples": {
+          "CosmosDBCassandraTableThroughputGet": {
+            "$ref": "./examples/CosmosDBCassandraTableThroughputGet.json"
+          }
+        },
+        "description": "Gets the RUs per second of the Cassandra table under an existing Azure Cosmos DB database account with the provided name.",
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/accountNameParameter"
+          },
+          {
+            "$ref": "#/parameters/keyspaceNameParameter"
+          },
+          {
+            "$ref": "#/parameters/tableNameParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The RUs per second of the Cassandra table was retrieved successfully.",
+            "schema": {
+              "$ref": "#/definitions/ThroughputSettingsGetResults"
+            }
+          }
+        }
+      },
+      "put": {
+        "operationId": "CassandraResources_UpdateCassandraTableThroughput",
+        "x-ms-examples": {
+          "CosmosDBCassandraTableThroughputUpdate": {
+            "$ref": "./examples/CosmosDBCassandraTableThroughputUpdate.json"
+          }
+        },
+        "description": "Update RUs per second of an Azure Cosmos DB Cassandra table",
+        "x-ms-long-running-operation": true,
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/accountNameParameter"
+          },
+          {
+            "$ref": "#/parameters/keyspaceNameParameter"
+          },
+          {
+            "$ref": "#/parameters/tableNameParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "name": "updateThroughputParameters",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/ThroughputSettingsUpdateParameters"
+            },
+            "description": "The RUs per second of the parameters to provide for the current Cassandra table."
+          }
+        ],
+        "responses": {
+          "202": {
+            "description": "The RUs per second of the Cassandra table update operation will complete asynchronously."
+          },
+          "200": {
+            "description": "The RUs per second of the Cassandra table update operation was completed successfully.",
+            "schema": {
+              "$ref": "#/definitions/ThroughputSettingsGetResults"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{accountName}/cassandraKeyspaces/{keyspaceName}/tables/{tableName}/throughputSettings/default/migrateToAutoscale": {
+      "post": {
+        "operationId": "CassandraResources_MigrateCassandraTableToAutoscale",
+        "x-ms-examples": {
+          "CosmosDBCassandraTableMigrateToAutoscale": {
+            "$ref": "./examples/CosmosDBCassandraTableMigrateToAutoscale.json"
+          }
+        },
+        "description": "Migrate an Azure Cosmos DB Cassandra table from manual throughput to autoscale",
+        "x-ms-long-running-operation": true,
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/accountNameParameter"
+          },
+          {
+            "$ref": "#/parameters/keyspaceNameParameter"
+          },
+          {
+            "$ref": "#/parameters/tableNameParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          }
+        ],
+        "responses": {
+          "202": {
+            "description": "The Cassandra table migrate operation will complete asynchronously."
+          },
+          "200": {
+            "description": "The Cassandra table migrate operation was completed successfully.",
+            "schema": {
+              "$ref": "#/definitions/ThroughputSettingsGetResults"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponseUpdatedFormat"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{accountName}/cassandraKeyspaces/{keyspaceName}/tables/{tableName}/throughputSettings/default/migrateToManualThroughput": {
+      "post": {
+        "operationId": "CassandraResources_MigrateCassandraTableToManualThroughput",
+        "x-ms-examples": {
+          "CosmosDBCassandraTableMigrateToManualThroughput": {
+            "$ref": "./examples/CosmosDBCassandraTableMigrateToManualThroughput.json"
+          }
+        },
+        "description": "Migrate an Azure Cosmos DB Cassandra table from autoscale to manual throughput",
+        "x-ms-long-running-operation": true,
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/accountNameParameter"
+          },
+          {
+            "$ref": "#/parameters/keyspaceNameParameter"
+          },
+          {
+            "$ref": "#/parameters/tableNameParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          }
+        ],
+        "responses": {
+          "202": {
+            "description": "The Cassandra table migrate operation will complete asynchronously."
+          },
+          "200": {
+            "description": "The Cassandra table migrate operation was completed successfully.",
+            "schema": {
+              "$ref": "#/definitions/ThroughputSettingsGetResults"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponseUpdatedFormat"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{accountName}/gremlinDatabases": {
+      "get": {
+        "operationId": "GremlinResources_ListGremlinDatabases",
+        "x-ms-examples": {
+          "CosmosDBGremlinDatabaseList": {
+            "$ref": "./examples/CosmosDBGremlinDatabaseList.json"
+          }
+        },
+        "description": "Lists the Gremlin databases under an existing Azure Cosmos DB database account.",
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/accountNameParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The Gremlin database properties were retrieved successfully.",
+            "schema": {
+              "$ref": "#/definitions/GremlinDatabaseListResult"
+            }
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": null
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{accountName}/gremlinDatabases/{databaseName}": {
+      "get": {
+        "operationId": "GremlinResources_GetGremlinDatabase",
+        "x-ms-examples": {
+          "CosmosDBGremlinDatabaseGet": {
+            "$ref": "./examples/CosmosDBGremlinDatabaseGet.json"
+          }
+        },
+        "description": "Gets the Gremlin databases under an existing Azure Cosmos DB database account with the provided name.",
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/accountNameParameter"
+          },
+          {
+            "$ref": "#/parameters/databaseNameParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The Gremlin database property was retrieved successfully.",
+            "schema": {
+              "$ref": "#/definitions/GremlinDatabaseGetResults"
+            }
+          }
+        }
+      },
+      "put": {
+        "operationId": "GremlinResources_CreateUpdateGremlinDatabase",
+        "x-ms-examples": {
+          "CosmosDBGremlinDatabaseCreateUpdate": {
+            "$ref": "./examples/CosmosDBGremlinDatabaseCreateUpdate.json"
+          }
+        },
+        "description": "Create or update an Azure Cosmos DB Gremlin database",
+        "x-ms-long-running-operation": true,
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/accountNameParameter"
+          },
+          {
+            "$ref": "#/parameters/databaseNameParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "name": "createUpdateGremlinDatabaseParameters",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/GremlinDatabaseCreateUpdateParameters"
+            },
+            "description": "The parameters to provide for the current Gremlin database."
+          }
+        ],
+        "responses": {
+          "202": {
+            "description": "The Gremlin database create or update operation will complete asynchronously."
+          },
+          "200": {
+            "description": "The Gremlin database create or update operation was completed successfully.",
+            "schema": {
+              "$ref": "#/definitions/GremlinDatabaseGetResults"
+            }
+          }
+        }
+      },
+      "delete": {
+        "operationId": "GremlinResources_DeleteGremlinDatabase",
+        "x-ms-examples": {
+          "CosmosDBGremlinDatabaseDelete": {
+            "$ref": "./examples/CosmosDBGremlinDatabaseDelete.json"
+          }
+        },
+        "description": "Deletes an existing Azure Cosmos DB Gremlin database.",
+        "x-ms-long-running-operation": true,
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/accountNameParameter"
+          },
+          {
+            "$ref": "#/parameters/databaseNameParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          }
+        ],
+        "responses": {
+          "202": {
+            "description": "The Gremlin database delete operation will complete asynchronously."
+          },
+          "204": {
+            "description": "The Gremlin database delete operation was completed successfully."
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{accountName}/gremlinDatabases/{databaseName}/throughputSettings/default": {
+      "get": {
+        "operationId": "GremlinResources_GetGremlinDatabaseThroughput",
+        "x-ms-examples": {
+          "CosmosDBGremlinDatabaseThroughputGet": {
+            "$ref": "./examples/CosmosDBGremlinDatabaseThroughputGet.json"
+          }
+        },
+        "description": "Gets the RUs per second of the Gremlin database under an existing Azure Cosmos DB database account with the provided name.",
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/accountNameParameter"
+          },
+          {
+            "$ref": "#/parameters/databaseNameParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The RUs per second of the Gremlin database was retrieved successfully.",
+            "schema": {
+              "$ref": "#/definitions/ThroughputSettingsGetResults"
+            }
+          }
+        }
+      },
+      "put": {
+        "operationId": "GremlinResources_UpdateGremlinDatabaseThroughput",
+        "x-ms-examples": {
+          "CosmosDBGremlinDatabaseThroughputUpdate": {
+            "$ref": "./examples/CosmosDBGremlinDatabaseThroughputUpdate.json"
+          }
+        },
+        "description": "Update RUs per second of an Azure Cosmos DB Gremlin database",
+        "x-ms-long-running-operation": true,
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/accountNameParameter"
+          },
+          {
+            "$ref": "#/parameters/databaseNameParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "name": "updateThroughputParameters",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/ThroughputSettingsUpdateParameters"
+            },
+            "description": "The RUs per second of the parameters to provide for the current Gremlin database."
+          }
+        ],
+        "responses": {
+          "202": {
+            "description": "The RUs per second of the Gremlin database update operation will complete asynchronously."
+          },
+          "200": {
+            "description": "The RUs per second of the Gremlin database update operation was completed successfully.",
+            "schema": {
+              "$ref": "#/definitions/ThroughputSettingsGetResults"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{accountName}/gremlinDatabases/{databaseName}/throughputSettings/default/migrateToAutoscale": {
+      "post": {
+        "operationId": "GremlinResources_MigrateGremlinDatabaseToAutoscale",
+        "x-ms-examples": {
+          "CosmosDBGremlinDatabaseMigrateToAutoscale": {
+            "$ref": "./examples/CosmosDBGremlinDatabaseMigrateToAutoscale.json"
+          }
+        },
+        "description": "Migrate an Azure Cosmos DB Gremlin database from manual throughput to autoscale",
+        "x-ms-long-running-operation": true,
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/accountNameParameter"
+          },
+          {
+            "$ref": "#/parameters/databaseNameParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          }
+        ],
+        "responses": {
+          "202": {
+            "description": "The Gremlin database migrate operation will complete asynchronously."
+          },
+          "200": {
+            "description": "The Gremlin database migrate operation was completed successfully.",
+            "schema": {
+              "$ref": "#/definitions/ThroughputSettingsGetResults"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponseUpdatedFormat"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{accountName}/gremlinDatabases/{databaseName}/throughputSettings/default/migrateToManualThroughput": {
+      "post": {
+        "operationId": "GremlinResources_MigrateGremlinDatabaseToManualThroughput",
+        "x-ms-examples": {
+          "CosmosDBGremlinDatabaseMigrateToManualThroughput": {
+            "$ref": "./examples/CosmosDBGremlinDatabaseMigrateToManualThroughput.json"
+          }
+        },
+        "description": "Migrate an Azure Cosmos DB Gremlin database from autoscale to manual throughput",
+        "x-ms-long-running-operation": true,
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/accountNameParameter"
+          },
+          {
+            "$ref": "#/parameters/databaseNameParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          }
+        ],
+        "responses": {
+          "202": {
+            "description": "The Gremlin database migrate operation will complete asynchronously."
+          },
+          "200": {
+            "description": "The Gremlin database migrate operation was completed successfully.",
+            "schema": {
+              "$ref": "#/definitions/ThroughputSettingsGetResults"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponseUpdatedFormat"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{accountName}/gremlinDatabases/{databaseName}/graphs": {
+      "get": {
+        "operationId": "GremlinResources_ListGremlinGraphs",
+        "x-ms-examples": {
+          "CosmosDBGremlinGraphList": {
+            "$ref": "./examples/CosmosDBGremlinGraphList.json"
+          }
+        },
+        "description": "Lists the Gremlin graph under an existing Azure Cosmos DB database account.",
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/accountNameParameter"
+          },
+          {
+            "$ref": "#/parameters/databaseNameParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The Gremlin graph properties were retrieved successfully.",
+            "schema": {
+              "$ref": "#/definitions/GremlinGraphListResult"
+            }
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": null
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{accountName}/gremlinDatabases/{databaseName}/graphs/{graphName}": {
+      "get": {
+        "operationId": "GremlinResources_GetGremlinGraph",
+        "x-ms-examples": {
+          "CosmosDBGremlinGraphGet": {
+            "$ref": "./examples/CosmosDBGremlinGraphGet.json"
+          }
+        },
+        "description": "Gets the Gremlin graph under an existing Azure Cosmos DB database account.",
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/accountNameParameter"
+          },
+          {
+            "$ref": "#/parameters/databaseNameParameter"
+          },
+          {
+            "$ref": "#/parameters/graphNameParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The Gremlin graph property was retrieved successfully.",
+            "schema": {
+              "$ref": "#/definitions/GremlinGraphGetResults"
+            }
+          }
+        }
+      },
+      "put": {
+        "operationId": "GremlinResources_CreateUpdateGremlinGraph",
+        "x-ms-examples": {
+          "CosmosDBGremlinGraphCreateUpdate": {
+            "$ref": "./examples/CosmosDBGremlinGraphCreateUpdate.json"
+          }
+        },
+        "description": "Create or update an Azure Cosmos DB Gremlin graph",
+        "x-ms-long-running-operation": true,
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/accountNameParameter"
+          },
+          {
+            "$ref": "#/parameters/databaseNameParameter"
+          },
+          {
+            "$ref": "#/parameters/graphNameParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "name": "createUpdateGremlinGraphParameters",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/GremlinGraphCreateUpdateParameters"
+            },
+            "description": "The parameters to provide for the current Gremlin graph."
+          }
+        ],
+        "responses": {
+          "202": {
+            "description": "The Gremlin graph create or update operation will complete asynchronously."
+          },
+          "200": {
+            "description": "The Gremlin graph create or update operation was completed successfully.",
+            "schema": {
+              "$ref": "#/definitions/GremlinGraphGetResults"
+            }
+          }
+        }
+      },
+      "delete": {
+        "operationId": "GremlinResources_DeleteGremlinGraph",
+        "x-ms-examples": {
+          "CosmosDBGremlinGraphDelete": {
+            "$ref": "./examples/CosmosDBGremlinGraphDelete.json"
+          }
+        },
+        "description": "Deletes an existing Azure Cosmos DB Gremlin graph.",
+        "x-ms-long-running-operation": true,
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/accountNameParameter"
+          },
+          {
+            "$ref": "#/parameters/databaseNameParameter"
+          },
+          {
+            "$ref": "#/parameters/graphNameParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          }
+        ],
+        "responses": {
+          "202": {
+            "description": "The Gremlin graph delete operation will complete asynchronously."
+          },
+          "204": {
+            "description": "The Gremlin graph delete operation was completed successfully."
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{accountName}/gremlinDatabases/{databaseName}/graphs/{graphName}/throughputSettings/default": {
+      "get": {
+        "operationId": "GremlinResources_GetGremlinGraphThroughput",
+        "x-ms-examples": {
+          "CosmosDBGremlinGraphThroughputGet": {
+            "$ref": "./examples/CosmosDBGremlinGraphThroughputGet.json"
+          }
+        },
+        "description": "Gets the Gremlin graph throughput under an existing Azure Cosmos DB database account with the provided name.",
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/accountNameParameter"
+          },
+          {
+            "$ref": "#/parameters/databaseNameParameter"
+          },
+          {
+            "$ref": "#/parameters/graphNameParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The RUs per second of the Gremlin graph was retrieved successfully.",
+            "schema": {
+              "$ref": "#/definitions/ThroughputSettingsGetResults"
+            }
+          }
+        }
+      },
+      "put": {
+        "operationId": "GremlinResources_UpdateGremlinGraphThroughput",
+        "x-ms-examples": {
+          "CosmosDBGremlinGraphThroughputUpdate": {
+            "$ref": "./examples/CosmosDBGremlinGraphThroughputUpdate.json"
+          }
+        },
+        "description": "Update RUs per second of an Azure Cosmos DB Gremlin graph",
+        "x-ms-long-running-operation": true,
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/accountNameParameter"
+          },
+          {
+            "$ref": "#/parameters/databaseNameParameter"
+          },
+          {
+            "$ref": "#/parameters/graphNameParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "name": "updateThroughputParameters",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/ThroughputSettingsUpdateParameters"
+            },
+            "description": "The RUs per second of the parameters to provide for the current Gremlin graph."
+          }
+        ],
+        "responses": {
+          "202": {
+            "description": "The RUs per second of the Gremlin graph update operation will complete asynchronously."
+          },
+          "200": {
+            "description": "The RUs per second of the Gremlin graph update operation was completed successfully.",
+            "schema": {
+              "$ref": "#/definitions/ThroughputSettingsGetResults"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{accountName}/gremlinDatabases/{databaseName}/graphs/{graphName}/throughputSettings/default/migrateToAutoscale": {
+      "post": {
+        "operationId": "GremlinResources_MigrateGremlinGraphToAutoscale",
+        "x-ms-examples": {
+          "CosmosDBGremlinGraphMigrateToAutoscale": {
+            "$ref": "./examples/CosmosDBGremlinGraphMigrateToAutoscale.json"
+          }
+        },
+        "description": "Migrate an Azure Cosmos DB Gremlin graph from manual throughput to autoscale",
+        "x-ms-long-running-operation": true,
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/accountNameParameter"
+          },
+          {
+            "$ref": "#/parameters/databaseNameParameter"
+          },
+          {
+            "$ref": "#/parameters/graphNameParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          }
+        ],
+        "responses": {
+          "202": {
+            "description": "The Gremlin graph migrate operation will complete asynchronously."
+          },
+          "200": {
+            "description": "The Gremlin graph migrate operation was completed successfully.",
+            "schema": {
+              "$ref": "#/definitions/ThroughputSettingsGetResults"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponseUpdatedFormat"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{accountName}/gremlinDatabases/{databaseName}/graphs/{graphName}/throughputSettings/default/migrateToManualThroughput": {
+      "post": {
+        "operationId": "GremlinResources_MigrateGremlinGraphToManualThroughput",
+        "x-ms-examples": {
+          "CosmosDBGremlinGraphMigrateToManualThroughput": {
+            "$ref": "./examples/CosmosDBGremlinGraphMigrateToManualThroughput.json"
+          }
+        },
+        "description": "Migrate an Azure Cosmos DB Gremlin graph from autoscale to manual throughput",
+        "x-ms-long-running-operation": true,
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "#/parameters/accountNameParameter"
+          },
+          {
+            "$ref": "#/parameters/databaseNameParameter"
+          },
+          {
+            "$ref": "#/parameters/graphNameParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          }
+        ],
+        "responses": {
+          "202": {
+            "description": "The Gremlin graph migrate operation will complete asynchronously."
+          },
+          "200": {
+            "description": "The Gremlin graph migrate operation was completed successfully.",
+            "schema": {
+              "$ref": "#/definitions/ThroughputSettingsGetResults"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponseUpdatedFormat"
+            }
+          }
+        }
+      }
+    }
+  },
+  "definitions": {
+    "DatabaseAccountsListResult": {
+      "properties": {
+        "value": {
+          "readOnly": true,
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/DatabaseAccountGetResults"
+          },
+          "description": "List of database account and their properties."
+        }
+      },
+      "description": "The List operation response, that contains the database accounts and their properties."
+    },
+    "SqlDatabaseListResult": {
+      "properties": {
+        "value": {
+          "readOnly": true,
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/SqlDatabaseGetResults"
+          },
+          "description": "List of SQL databases and their properties."
+        }
+      },
+      "description": "The List operation response, that contains the SQL databases and their properties."
+    },
+    "SqlContainerListResult": {
+      "properties": {
+        "value": {
+          "readOnly": true,
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/SqlContainerGetResults"
+          },
+          "description": "List of containers and their properties."
+        }
+      },
+      "description": "The List operation response, that contains the containers and their properties."
+    },
+    "SqlStoredProcedureListResult": {
+      "properties": {
+        "value": {
+          "readOnly": true,
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/SqlStoredProcedureGetResults"
+          },
+          "description": "List of storedProcedures and their properties."
+        }
+      },
+      "description": "The List operation response, that contains the storedProcedures and their properties."
+    },
+    "SqlUserDefinedFunctionListResult": {
+      "properties": {
+        "value": {
+          "readOnly": true,
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/SqlUserDefinedFunctionGetResults"
+          },
+          "description": "List of userDefinedFunctions and their properties."
+        }
+      },
+      "description": "The List operation response, that contains the userDefinedFunctions and their properties."
+    },
+    "SqlTriggerListResult": {
+      "properties": {
+        "value": {
+          "readOnly": true,
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/SqlTriggerGetResults"
+          },
+          "description": "List of triggers and their properties."
+        }
+      },
+      "description": "The List operation response, that contains the triggers and their properties."
+    },
+    "MongoDBDatabaseListResult": {
+      "properties": {
+        "value": {
+          "readOnly": true,
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/MongoDBDatabaseGetResults"
+          },
+          "description": "List of MongoDB databases and their properties."
+        }
+      },
+      "description": "The List operation response, that contains the MongoDB databases and their properties."
+    },
+    "MongoDBCollectionListResult": {
+      "properties": {
+        "value": {
+          "readOnly": true,
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/MongoDBCollectionGetResults"
+          },
+          "description": "List of MongoDB collections and their properties."
+        }
+      },
+      "description": "The List operation response, that contains the MongoDB collections and their properties."
+    },
+    "TableListResult": {
+      "properties": {
+        "value": {
+          "readOnly": true,
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/TableGetResults"
+          },
+          "description": "List of Table and their properties."
+        }
+      },
+      "description": "The List operation response, that contains the Table and their properties."
+    },
+    "CassandraKeyspaceListResult": {
+      "properties": {
+        "value": {
+          "readOnly": true,
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/CassandraKeyspaceGetResults"
+          },
+          "description": "List of Cassandra keyspaces and their properties."
+        }
+      },
+      "description": "The List operation response, that contains the Cassandra keyspaces and their properties."
+    },
+    "CassandraTableListResult": {
+      "properties": {
+        "value": {
+          "readOnly": true,
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/CassandraTableGetResults"
+          },
+          "description": "List of Cassandra tables and their properties."
+        }
+      },
+      "description": "The List operation response, that contains the Cassandra tables and their properties."
+    },
+    "GremlinDatabaseListResult": {
+      "properties": {
+        "value": {
+          "readOnly": true,
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/GremlinDatabaseGetResults"
+          },
+          "description": "List of Gremlin databases and their properties."
+        }
+      },
+      "description": "The List operation response, that contains the Gremlin databases and their properties."
+    },
+    "GremlinGraphListResult": {
+      "properties": {
+        "value": {
+          "readOnly": true,
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/GremlinGraphGetResults"
+          },
+          "description": "List of graphs and their properties."
+        }
+      },
+      "description": "The List operation response, that contains the graphs and their properties."
+    },
+    "ErrorResponse": {
+      "properties": {
+        "code": {
+          "description": "Error code.",
+          "type": "string"
+        },
+        "message": {
+          "description": "Error message indicating why the operation failed.",
+          "type": "string"
+        }
+      },
+      "description": "Error Response."
+    },
+    "ErrorResponseUpdatedFormat": {
+      "description": "An error response from the service.",
+      "properties": {
+        "error": {
+          "$ref": "../../../../../common-types/resource-management/v1/types.json#/definitions/ErrorResponse"
+        }
+      }
+    },
+    "FailoverPolicies": {
+      "properties": {
+        "failoverPolicies": {
+          "type": "array",
+          "description": "List of failover policies.",
+          "items": {
+            "$ref": "#/definitions/FailoverPolicy"
+          }
+        }
+      },
+      "required": [
+        "failoverPolicies"
+      ],
+      "description": "The list of new failover policies for the failover priority change."
+    },
+    "FailoverPolicy": {
+      "type": "object",
+      "description": "The failover policy for a given region of a database account.",
+      "properties": {
+        "id": {
+          "type": "string",
+          "readOnly": true,
+          "description": "The unique identifier of the region in which the database account replicates to. Example: &lt;accountName&gt;-&lt;locationName&gt;."
+        },
+        "locationName": {
+          "type": "string",
+          "description": "The name of the region in which the database account exists."
+        },
+        "failoverPriority": {
+          "type": "integer",
+          "minimum": 0,
+          "format": "int32",
+          "description": "The failover priority of the region. A failover priority of 0 indicates a write region. The maximum value for a failover priority = (total number of regions - 1). Failover priority values must be unique for each of the regions in which the database account exists."
+        }
+      }
+    },
+    "RegionForOnlineOffline": {
+      "properties": {
+        "region": {
+          "type": "string",
+          "description": "Cosmos DB region, with spaces between words and each word capitalized."
+        }
+      },
+      "required": [
+        "region"
+      ],
+      "description": "Cosmos DB region to online or offline."
+    },
+    "Location": {
+      "description": "A region in which the Azure Cosmos DB database account is deployed.",
+      "type": "object",
+      "properties": {
+        "id": {
+          "type": "string",
+          "readOnly": true,
+          "description": "The unique identifier of the region within the database account. Example: &lt;accountName&gt;-&lt;locationName&gt;."
+        },
+        "locationName": {
+          "type": "string",
+          "description": "The name of the region."
+        },
+        "documentEndpoint": {
+          "type": "string",
+          "readOnly": true,
+          "description": "The connection endpoint for the specific region. Example: https://&lt;accountName&gt;-&lt;locationName&gt;.documents.azure.com:443/"
+        },
+        "provisioningState": {
+          "$ref": "#/definitions/ProvisioningState"
+        },
+        "failoverPriority": {
+          "description": "The failover priority of the region. A failover priority of 0 indicates a write region. The maximum value for a failover priority = (total number of regions - 1). Failover priority values must be unique for each of the regions in which the database account exists.",
+          "format": "int32",
+          "type": "integer",
+          "minimum": 0
+        },
+        "isZoneRedundant": {
+          "type": "boolean",
+          "description": "Flag to indicate whether or not this region is an AvailabilityZone region"
+        }
+      }
+    },
+    "ARMResourceProperties": {
+      "type": "object",
+      "description": "The core properties of ARM resources.",
+      "properties": {
+        "id": {
+          "readOnly": true,
+          "type": "string",
+          "description": "The unique resource identifier of the ARM resource."
+        },
+        "name": {
+          "readOnly": true,
+          "type": "string",
+          "description": "The name of the ARM resource."
+        },
+        "type": {
+          "readOnly": true,
+          "type": "string",
+          "description": "The type of Azure resource."
+        },
+        "location": {
+          "type": "string",
+          "description": "The location of the resource group to which the resource belongs."
+        },
+        "tags": {
+          "$ref": "#/definitions/Tags"
+        }
+      },
+      "x-ms-azure-resource": true
+    },
+    "ARMProxyResource": {
+      "type": "object",
+      "description": "The resource model definition for a ARM proxy resource. It will have everything other than required location and tags",
+      "properties": {
+        "id": {
+          "readOnly": true,
+          "type": "string",
+          "description": "The unique resource identifier of the database account."
+        },
+        "name": {
+          "readOnly": true,
+          "type": "string",
+          "description": "The name of the database account."
+        },
+        "type": {
+          "readOnly": true,
+          "type": "string",
+          "description": "The type of Azure resource."
+        }
+      },
+      "x-ms-azure-resource": true
+    },
+    "DatabaseAccountGetResults": {
+      "description": "An Azure Cosmos DB database account.",
+      "type": "object",
+      "properties": {
+        "kind": {
+          "description": "Indicates the type of database account. This can only be set at database account creation.",
+          "type": "string",
+          "default": "GlobalDocumentDB",
+          "enum": [
+            "GlobalDocumentDB",
+            "MongoDB",
+            "Parse"
+          ],
+          "x-ms-enum": {
+            "name": "DatabaseAccountKind",
+            "modelAsString": true
+          }
+        },
+        "properties": {
+          "x-ms-client-flatten": true,
+          "$ref": "#/definitions/DatabaseAccountGetProperties"
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "#/definitions/ARMResourceProperties"
+        }
+      ]
+    },
+    "ExtendedResourceProperties": {
+      "description": "The system generated resource properties associated with SQL databases, SQL containers, Gremlin databases and Gremlin graphs.",
+      "type": "object",
+      "properties": {
+        "_rid": {
+          "type": "string",
+          "description": "A system generated property. A unique identifier.",
+          "readOnly": true
+        },
+        "_ts": {
+          "type": "number",
+          "description": "A system generated property that denotes the last updated timestamp of the resource.",
+          "readOnly": true
+        },
+        "_etag": {
+          "type": "string",
+          "description": "A system generated property representing the resource etag required for optimistic concurrency control.",
+          "readOnly": true
+        }
+      }
+    },
+    "ThroughputSettingsGetResults": {
+      "description": "An Azure Cosmos DB resource throughput.",
+      "type": "object",
+      "properties": {
+        "properties": {
+          "x-ms-client-flatten": true,
+          "description": "The properties of an Azure Cosmos DB resource throughput",
+          "$ref": "#/definitions/ThroughputSettingsGetProperties"
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "#/definitions/ARMResourceProperties"
+        }
+      ]
+    },
+    "ThroughputSettingsGetProperties": {
+      "description": "The properties of an Azure Cosmos DB resource throughput",
+      "type": "object",
+      "properties": {
+        "resource": {
+          "allOf": [
+            {
+              "$ref": "#/definitions/ThroughputSettingsResource"
+            },
+            {
+              "$ref": "#/definitions/ExtendedResourceProperties"
+            }
+          ]
+        }
+      }
+    },
+    "SqlDatabaseGetResults": {
+      "description": "An Azure Cosmos DB SQL database.",
+      "type": "object",
+      "properties": {
+        "properties": {
+          "x-ms-client-flatten": true,
+          "description": "The properties of an Azure Cosmos DB SQL database",
+          "$ref": "#/definitions/SqlDatabaseGetProperties"
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "#/definitions/ARMResourceProperties"
+        }
+      ]
+    },
+    "SqlDatabaseGetProperties": {
+      "description": "The properties of an Azure Cosmos DB SQL database",
+      "type": "object",
+      "properties": {
+        "resource": {
+          "properties": {
+            "_colls": {
+              "type": "string",
+              "description": "A system generated property that specified the addressable path of the collections resource."
+            },
+            "_users": {
+              "type": "string",
+              "description": "A system generated property that specifies the addressable path of the users resource."
+            }
+          },
+          "allOf": [
+            {
+              "$ref": "#/definitions/SqlDatabaseResource"
+            },
+            {
+              "$ref": "#/definitions/ExtendedResourceProperties"
+            }
+          ]
+        },
+        "options": {
+          "allOf": [
+            {
+              "$ref": "#/definitions/OptionsResource"
+            }
+          ]
+        }
+      }
+    },
+    "SqlContainerGetResults": {
+      "description": "An Azure Cosmos DB container.",
+      "type": "object",
+      "properties": {
+        "properties": {
+          "x-ms-client-flatten": true,
+          "description": "The properties of an Azure Cosmos DB container",
+          "$ref": "#/definitions/SqlContainerGetProperties"
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "#/definitions/ARMResourceProperties"
+        }
+      ]
+    },
+    "SqlContainerGetProperties": {
+      "description": "The properties of an Azure Cosmos DB container",
+      "type": "object",
+      "properties": {
+        "resource": {
+          "allOf": [
+            {
+              "$ref": "#/definitions/SqlContainerResource"
+            },
+            {
+              "$ref": "#/definitions/ExtendedResourceProperties"
+            }
+          ]
+        },
+        "options": {
+          "allOf": [
+            {
+              "$ref": "#/definitions/OptionsResource"
+            }
+          ]
+        }
+      }
+    },
+    "SqlStoredProcedureGetResults": {
+      "description": "An Azure Cosmos DB storedProcedure.",
+      "type": "object",
+      "properties": {
+        "properties": {
+          "x-ms-client-flatten": true,
+          "description": "The properties of an Azure Cosmos DB storedProcedure",
+          "$ref": "#/definitions/SqlStoredProcedureGetProperties"
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "#/definitions/ARMResourceProperties"
+        }
+      ]
+    },
+    "SqlStoredProcedureGetProperties": {
+      "description": "The properties of an Azure Cosmos DB StoredProcedure",
+      "type": "object",
+      "properties": {
+        "resource": {
+          "allOf": [
+            {
+              "$ref": "#/definitions/SqlStoredProcedureResource"
+            },
+            {
+              "$ref": "#/definitions/ExtendedResourceProperties"
+            }
+          ]
+        }
+      }
+    },
+    "SqlUserDefinedFunctionGetResults": {
+      "description": "An Azure Cosmos DB userDefinedFunction.",
+      "type": "object",
+      "properties": {
+        "properties": {
+          "x-ms-client-flatten": true,
+          "description": "The properties of an Azure Cosmos DB userDefinedFunction",
+          "$ref": "#/definitions/SqlUserDefinedFunctionGetProperties"
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "#/definitions/ARMResourceProperties"
+        }
+      ]
+    },
+    "SqlUserDefinedFunctionGetProperties": {
+      "description": "The properties of an Azure Cosmos DB userDefinedFunction",
+      "type": "object",
+      "properties": {
+        "resource": {
+          "allOf": [
+            {
+              "$ref": "#/definitions/SqlUserDefinedFunctionResource"
+            },
+            {
+              "$ref": "#/definitions/ExtendedResourceProperties"
+            }
+          ]
+        }
+      }
+    },
+    "SqlTriggerGetResults": {
+      "description": "An Azure Cosmos DB trigger.",
+      "type": "object",
+      "properties": {
+        "properties": {
+          "x-ms-client-flatten": true,
+          "description": "The properties of an Azure Cosmos DB trigger",
+          "$ref": "#/definitions/SqlTriggerGetProperties"
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "#/definitions/ARMResourceProperties"
+        }
+      ]
+    },
+    "SqlTriggerGetProperties": {
+      "description": "The properties of an Azure Cosmos DB trigger",
+      "type": "object",
+      "properties": {
+        "resource": {
+          "allOf": [
+            {
+              "$ref": "#/definitions/SqlTriggerResource"
+            },
+            {
+              "$ref": "#/definitions/ExtendedResourceProperties"
+            }
+          ]
+        }
+      }
+    },
+    "MongoDBDatabaseGetResults": {
+      "description": "An Azure Cosmos DB MongoDB database.",
+      "type": "object",
+      "properties": {
+        "properties": {
+          "x-ms-client-flatten": true,
+          "description": "The properties of an Azure Cosmos DB MongoDB database",
+          "$ref": "#/definitions/MongoDBDatabaseGetProperties"
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "#/definitions/ARMResourceProperties"
+        }
+      ]
+    },
+    "MongoDBDatabaseGetProperties": {
+      "description": "The properties of an Azure Cosmos DB MongoDB database",
+      "type": "object",
+      "properties": {
+        "resource": {
+          "allOf": [
+            {
+              "$ref": "#/definitions/MongoDBDatabaseResource"
+            },
+            {
+              "$ref": "#/definitions/ExtendedResourceProperties"
+            }
+          ]
+        },
+        "options": {
+          "allOf": [
+            {
+              "$ref": "#/definitions/OptionsResource"
+            }
+          ]
+        }
+      }
+    },
+    "MongoDBCollectionGetResults": {
+      "description": "An Azure Cosmos DB MongoDB collection.",
+      "type": "object",
+      "properties": {
+        "properties": {
+          "x-ms-client-flatten": true,
+          "description": "The properties of an Azure Cosmos DB MongoDB collection",
+          "$ref": "#/definitions/MongoDBCollectionGetProperties"
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "#/definitions/ARMResourceProperties"
+        }
+      ]
+    },
+    "MongoDBCollectionGetProperties": {
+      "description": "The properties of an Azure Cosmos DB MongoDB collection",
+      "type": "object",
+      "properties": {
+        "resource": {
+          "allOf": [
+            {
+              "$ref": "#/definitions/MongoDBCollectionResource"
+            },
+            {
+              "$ref": "#/definitions/ExtendedResourceProperties"
+            }
+          ]
+        },
+        "options": {
+          "allOf": [
+            {
+              "$ref": "#/definitions/OptionsResource"
+            }
+          ]
+        }
+      }
+    },
+    "TableGetResults": {
+      "description": "An Azure Cosmos DB Table.",
+      "type": "object",
+      "properties": {
+        "properties": {
+          "x-ms-client-flatten": true,
+          "description": "The properties of an Azure Cosmos DB Table",
+          "$ref": "#/definitions/TableGetProperties"
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "#/definitions/ARMResourceProperties"
+        }
+      ]
+    },
+    "TableGetProperties": {
+      "description": "The properties of an Azure Cosmos Table",
+      "type": "object",
+      "properties": {
+        "resource": {
+          "allOf": [
+            {
+              "$ref": "#/definitions/TableResource"
+            },
+            {
+              "$ref": "#/definitions/ExtendedResourceProperties"
+            }
+          ]
+        },
+        "options": {
+          "allOf": [
+            {
+              "$ref": "#/definitions/OptionsResource"
+            }
+          ]
+        }
+      }
+    },
+    "CassandraKeyspaceGetResults": {
+      "description": "An Azure Cosmos DB Cassandra keyspace.",
+      "type": "object",
+      "properties": {
+        "properties": {
+          "x-ms-client-flatten": true,
+          "description": "The properties of an Azure Cosmos DB Cassandra keyspace",
+          "$ref": "#/definitions/CassandraKeyspaceGetProperties"
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "#/definitions/ARMResourceProperties"
+        }
+      ]
+    },
+    "CassandraKeyspaceGetProperties": {
+      "description": "The properties of an Azure Cosmos DB Cassandra keyspace",
+      "type": "object",
+      "properties": {
+        "resource": {
+          "allOf": [
+            {
+              "$ref": "#/definitions/CassandraKeyspaceResource"
+            },
+            {
+              "$ref": "#/definitions/ExtendedResourceProperties"
+            }
+          ]
+        },
+        "options": {
+          "allOf": [
+            {
+              "$ref": "#/definitions/OptionsResource"
+            }
+          ]
+        }
+      }
+    },
+    "CassandraTableGetResults": {
+      "description": "An Azure Cosmos DB Cassandra table.",
+      "type": "object",
+      "properties": {
+        "properties": {
+          "x-ms-client-flatten": true,
+          "description": "The properties of an Azure Cosmos DB Cassandra table",
+          "$ref": "#/definitions/CassandraTableGetProperties"
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "#/definitions/ARMResourceProperties"
+        }
+      ]
+    },
+    "CassandraTableGetProperties": {
+      "description": "The properties of an Azure Cosmos DB Cassandra table",
+      "type": "object",
+      "properties": {
+        "resource": {
+          "allOf": [
+            {
+              "$ref": "#/definitions/CassandraTableResource"
+            },
+            {
+              "$ref": "#/definitions/ExtendedResourceProperties"
+            }
+          ]
+        },
+        "options": {
+          "allOf": [
+            {
+              "$ref": "#/definitions/OptionsResource"
+            }
+          ]
+        }
+      }
+    },
+    "GremlinDatabaseGetResults": {
+      "description": "An Azure Cosmos DB Gremlin database.",
+      "type": "object",
+      "properties": {
+        "properties": {
+          "x-ms-client-flatten": true,
+          "description": "The properties of an Azure Cosmos DB SQL database",
+          "$ref": "#/definitions/GremlinDatabaseGetProperties"
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "#/definitions/ARMResourceProperties"
+        }
+      ]
+    },
+    "GremlinDatabaseGetProperties": {
+      "description": "The properties of an Azure Cosmos DB SQL database",
+      "type": "object",
+      "properties": {
+        "resource": {
+          "allOf": [
+            {
+              "$ref": "#/definitions/GremlinDatabaseResource"
+            },
+            {
+              "$ref": "#/definitions/ExtendedResourceProperties"
+            }
+          ]
+        },
+        "options": {
+          "allOf": [
+            {
+              "$ref": "#/definitions/OptionsResource"
+            }
+          ]
+        }
+      }
+    },
+    "GremlinGraphGetResults": {
+      "description": "An Azure Cosmos DB Gremlin graph.",
+      "type": "object",
+      "properties": {
+        "properties": {
+          "x-ms-client-flatten": true,
+          "description": "The properties of an Azure Cosmos DB Gremlin graph",
+          "$ref": "#/definitions/GremlinGraphGetProperties"
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "#/definitions/ARMResourceProperties"
+        }
+      ]
+    },
+    "GremlinGraphGetProperties": {
+      "description": "The properties of an Azure Cosmos DB Gremlin graph",
+      "type": "object",
+      "properties": {
+        "resource": {
+          "allOf": [
+            {
+              "$ref": "#/definitions/GremlinGraphResource"
+            },
+            {
+              "$ref": "#/definitions/ExtendedResourceProperties"
+            }
+          ]
+        },
+        "options": {
+          "allOf": [
+            {
+              "$ref": "#/definitions/OptionsResource"
+            }
+          ]
+        }
+      }
+    },
+    "ConsistencyPolicy": {
+      "type": "object",
+      "description": "The consistency policy for the Cosmos DB database account.",
+      "properties": {
+        "defaultConsistencyLevel": {
+          "description": "The default consistency level and configuration settings of the Cosmos DB account.",
+          "type": "string",
+          "enum": [
+            "Eventual",
+            "Session",
+            "BoundedStaleness",
+            "Strong",
+            "ConsistentPrefix"
+          ],
+          "x-ms-enum": {
+            "name": "DefaultConsistencyLevel",
+            "modelAsString": false
+          }
+        },
+        "maxStalenessPrefix": {
+          "description": "When used with the Bounded Staleness consistency level, this value represents the number of stale requests tolerated. Accepted range for this value is 1 – 2,147,483,647. Required when defaultConsistencyPolicy is set to 'BoundedStaleness'.",
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 2147483647,
+          "format": "int64"
+        },
+        "maxIntervalInSeconds": {
+          "description": "When used with the Bounded Staleness consistency level, this value represents the time amount of staleness (in seconds) tolerated. Accepted range for this value is 5 - 86400. Required when defaultConsistencyPolicy is set to 'BoundedStaleness'.",
+          "type": "integer",
+          "minimum": 5,
+          "maximum": 86400,
+          "format": "int32"
+        }
+      },
+      "required": [
+        "defaultConsistencyLevel"
+      ]
+    },
+    "CorsPolicy": {
+      "type": "object",
+      "description": "The CORS policy for the Cosmos DB database account.",
+      "properties": {
+        "allowedOrigins": {
+          "description": "The origin domains that are permitted to make a request against the service via CORS.",
+          "type": "string"
+        },
+        "allowedMethods": {
+          "description": "The methods (HTTP request verbs) that the origin domain may use for a CORS request.",
+          "type": "string"
+        },
+        "allowedHeaders": {
+          "description": "The request headers that the origin domain may specify on the CORS request.",
+          "type": "string"
+        },
+        "exposedHeaders": {
+          "description": "The response headers that may be sent in the response to the CORS request and exposed by the browser to the request issuer.",
+          "type": "string"
+        },
+        "maxAgeInSeconds": {
+          "description": "The maximum amount time that a browser should cache the preflight OPTIONS request.",
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 2147483647,
+          "format": "int64"
+        }
+      },
+      "required": [
+        "allowedOrigins"
+      ]
+    },
+    "DatabaseAccountGetProperties": {
+      "description": "Properties for the database account.",
+      "type": "object",
+      "properties": {
+        "provisioningState": {
+          "$ref": "#/definitions/ProvisioningState"
+        },
+        "documentEndpoint": {
+          "description": "The connection endpoint for the Cosmos DB database account.",
+          "type": "string",
+          "readOnly": true
+        },
+        "databaseAccountOfferType": {
+          "description": "The offer type for the Cosmos DB database account. Default value: Standard.",
+          "readOnly": true,
+          "$ref": "#/definitions/DatabaseAccountOfferType"
+        },
+        "ipRules": {
+          "description": "List of IpRules.",
+          "$ref": "#/definitions/IPRules"
+        },
+        "isVirtualNetworkFilterEnabled": {
+          "description": "Flag to indicate whether to enable/disable Virtual Network ACL rules.",
+          "type": "boolean"
+        },
+        "enableAutomaticFailover": {
+          "description": "Enables automatic failover of the write region in the rare event that the region is unavailable due to an outage. Automatic failover will result in a new write region for the account and is chosen based on the failover priorities configured for the account.",
+          "type": "boolean"
+        },
+        "consistencyPolicy": {
+          "description": "The consistency policy for the Cosmos DB database account.",
+          "$ref": "#/definitions/ConsistencyPolicy"
+        },
+        "capabilities": {
+          "type": "array",
+          "description": "List of Cosmos DB capabilities for the account",
+          "items": {
+            "$ref": "#/definitions/Capability"
+          }
+        },
+        "writeLocations": {
+          "type": "array",
+          "readOnly": true,
+          "description": "An array that contains the write location for the Cosmos DB account.",
+          "items": {
+            "$ref": "#/definitions/Location"
+          }
+        },
+        "readLocations": {
+          "type": "array",
+          "readOnly": true,
+          "description": "An array that contains of the read locations enabled for the Cosmos DB account.",
+          "items": {
+            "$ref": "#/definitions/Location"
+          }
+        },
+        "locations": {
+          "type": "array",
+          "readOnly": true,
+          "description": "An array that contains all of the locations enabled for the Cosmos DB account.",
+          "items": {
+            "$ref": "#/definitions/Location"
+          }
+        },
+        "failoverPolicies": {
+          "type": "array",
+          "readOnly": true,
+          "description": "An array that contains the regions ordered by their failover priorities.",
+          "items": {
+            "$ref": "#/definitions/FailoverPolicy"
+          }
+        },
+        "virtualNetworkRules": {
+          "type": "array",
+          "description": "List of Virtual Network ACL rules configured for the Cosmos DB account.",
+          "items": {
+            "$ref": "#/definitions/VirtualNetworkRule"
+          }
+        },
+        "privateEndpointConnections": {
+          "type": "array",
+          "readOnly": true,
+          "description": "List of Private Endpoint Connections configured for the Cosmos DB account.",
+          "items": {
+            "$ref": "#/definitions/PrivateEndpointConnection"
+          }
+        },
+        "enableMultipleWriteLocations": {
+          "description": "Enables the account to write in multiple locations",
+          "type": "boolean"
+        },
+        "enableCassandraConnector": {
+          "description": "Enables the cassandra connector on the Cosmos DB C* account",
+          "type": "boolean"
+        },
+        "connectorOffer": {
+          "description": "The cassandra connector offer type for the Cosmos DB database C* account.",
+          "$ref": "#/definitions/ConnectorOffer"
+        },
+        "disableKeyBasedMetadataWriteAccess": {
+          "description": "Disable write operations on metadata resources (databases, containers, throughput) via account keys",
+          "type": "boolean"
+        },
+        "keyVaultKeyUri": {
+          "description": "The URI of the key vault",
+          "type": "string"
+        },
+        "publicNetworkAccess": {
+          "description": "Whether requests from Public Network are allowed",
+          "$ref": "#/definitions/PublicNetworkAccess"
+        },
+        "enableFreeTier": {
+          "description": "Flag to indicate whether Free Tier is enabled.",
+          "type": "boolean"
+        },
+        "apiProperties": {
+          "description": "API specific properties.",
+          "type": "object",
+          "$ref": "#/definitions/ApiProperties"
+        },
+        "enableAnalyticalStorage": {
+          "description": "Flag to indicate whether to enable storage analytics.",
+          "type": "boolean"
+        },
+        "backupPolicy": {
+          "description": "The object representing the policy for taking backups on an account.",
+          "type": "object",
+          "$ref": "#/definitions/BackupPolicy"
+        },
+        "cors": {
+          "type": "array",
+          "description": "The CORS policy for the Cosmos DB database account.",
+          "items": {
+            "$ref": "#/definitions/CorsPolicy"
+          }
+        }
+      }
+    },
+    "DatabaseAccountCreateUpdateProperties": {
+      "description": "Properties to create and update Azure Cosmos DB database accounts.",
+      "type": "object",
+      "properties": {
+        "consistencyPolicy": {
+          "description": "The consistency policy for the Cosmos DB account.",
+          "$ref": "#/definitions/ConsistencyPolicy"
+        },
+        "locations": {
+          "type": "array",
+          "description": "An array that contains the georeplication locations enabled for the Cosmos DB account.",
+          "items": {
+            "$ref": "#/definitions/Location"
+          }
+        },
+        "databaseAccountOfferType": {
+          "description": "The offer type for the database",
+          "$ref": "#/definitions/DatabaseAccountOfferType"
+        },
+        "ipRules": {
+          "description": "List of IpRules.",
+          "$ref": "#/definitions/IPRules"
+        },
+        "isVirtualNetworkFilterEnabled": {
+          "description": "Flag to indicate whether to enable/disable Virtual Network ACL rules.",
+          "type": "boolean"
+        },
+        "enableAutomaticFailover": {
+          "description": "Enables automatic failover of the write region in the rare event that the region is unavailable due to an outage. Automatic failover will result in a new write region for the account and is chosen based on the failover priorities configured for the account.",
+          "type": "boolean"
+        },
+        "capabilities": {
+          "type": "array",
+          "description": "List of Cosmos DB capabilities for the account",
+          "items": {
+            "$ref": "#/definitions/Capability"
+          }
+        },
+        "virtualNetworkRules": {
+          "type": "array",
+          "description": "List of Virtual Network ACL rules configured for the Cosmos DB account.",
+          "items": {
+            "$ref": "#/definitions/VirtualNetworkRule"
+          }
+        },
+        "enableMultipleWriteLocations": {
+          "description": "Enables the account to write in multiple locations",
+          "type": "boolean"
+        },
+        "enableCassandraConnector": {
+          "description": "Enables the cassandra connector on the Cosmos DB C* account",
+          "type": "boolean"
+        },
+        "connectorOffer": {
+          "description": "The cassandra connector offer type for the Cosmos DB database C* account.",
+          "$ref": "#/definitions/ConnectorOffer"
+        },
+        "disableKeyBasedMetadataWriteAccess": {
+          "description": "Disable write operations on metadata resources (databases, containers, throughput) via account keys",
+          "type": "boolean"
+        },
+        "keyVaultKeyUri": {
+          "description": "The URI of the key vault",
+          "type": "string"
+        },
+        "publicNetworkAccess": {
+          "description": "Whether requests from Public Network are allowed",
+          "$ref": "#/definitions/PublicNetworkAccess"
+        },
+        "enableFreeTier": {
+          "description": "Flag to indicate whether Free Tier is enabled.",
+          "type": "boolean"
+        },
+        "apiProperties": {
+          "description": "API specific properties. Currently, supported only for MongoDB API.",
+          "type": "object",
+          "$ref": "#/definitions/ApiProperties"
+        },
+        "enableAnalyticalStorage": {
+          "description": "Flag to indicate whether to enable storage analytics.",
+          "type": "boolean"
+        },
+        "backupPolicy": {
+          "description": "The object representing the policy for taking backups on an account.",
+          "type": "object",
+          "$ref": "#/definitions/BackupPolicy"
+        },
+        "cors": {
+          "type": "array",
+          "description": "The CORS policy for the Cosmos DB database account.",
+          "items": {
+            "$ref": "#/definitions/CorsPolicy"
+          }
+        }
+      },
+      "required": [
+        "locations",
+        "databaseAccountOfferType"
+      ]
+    },
+    "DatabaseAccountCreateUpdateParameters": {
+      "description": "Parameters to create and update Cosmos DB database accounts.",
+      "type": "object",
+      "properties": {
+        "kind": {
+          "description": "Indicates the type of database account. This can only be set at database account creation.",
+          "type": "string",
+          "default": "GlobalDocumentDB",
+          "enum": [
+            "GlobalDocumentDB",
+            "MongoDB",
+            "Parse"
+          ],
+          "x-ms-enum": {
+            "name": "DatabaseAccountKind",
+            "modelAsString": true
+          }
+        },
+        "properties": {
+          "x-ms-client-flatten": true,
+          "$ref": "#/definitions/DatabaseAccountCreateUpdateProperties"
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "#/definitions/ARMResourceProperties"
+        }
+      ],
+      "required": [
+        "properties"
+      ]
+    },
+    "DatabaseAccountUpdateProperties": {
+      "description": "Properties to update Azure Cosmos DB database accounts.",
+      "type": "object",
+      "properties": {
+        "consistencyPolicy": {
+          "description": "The consistency policy for the Cosmos DB account.",
+          "$ref": "#/definitions/ConsistencyPolicy"
+        },
+        "locations": {
+          "type": "array",
+          "description": "An array that contains the georeplication locations enabled for the Cosmos DB account.",
+          "items": {
+            "$ref": "#/definitions/Location"
+          }
+        },
+        "ipRules": {
+          "description": "List of IpRules.",
+          "$ref": "#/definitions/IPRules"
+        },
+        "isVirtualNetworkFilterEnabled": {
+          "description": "Flag to indicate whether to enable/disable Virtual Network ACL rules.",
+          "type": "boolean"
+        },
+        "enableAutomaticFailover": {
+          "description": "Enables automatic failover of the write region in the rare event that the region is unavailable due to an outage. Automatic failover will result in a new write region for the account and is chosen based on the failover priorities configured for the account.",
+          "type": "boolean"
+        },
+        "capabilities": {
+          "type": "array",
+          "description": "List of Cosmos DB capabilities for the account",
+          "items": {
+            "$ref": "#/definitions/Capability"
+          }
+        },
+        "virtualNetworkRules": {
+          "type": "array",
+          "description": "List of Virtual Network ACL rules configured for the Cosmos DB account.",
+          "items": {
+            "$ref": "#/definitions/VirtualNetworkRule"
+          }
+        },
+        "enableMultipleWriteLocations": {
+          "description": "Enables the account to write in multiple locations",
+          "type": "boolean"
+        },
+        "enableCassandraConnector": {
+          "description": "Enables the cassandra connector on the Cosmos DB C* account",
+          "type": "boolean"
+        },
+        "connectorOffer": {
+          "description": "The cassandra connector offer type for the Cosmos DB database C* account.",
+          "$ref": "#/definitions/ConnectorOffer"
+        },
+        "disableKeyBasedMetadataWriteAccess": {
+          "description": "Disable write operations on metadata resources (databases, containers, throughput) via account keys",
+          "type": "boolean"
+        },
+        "keyVaultKeyUri": {
+          "description": "The URI of the key vault",
+          "type": "string"
+        },
+        "publicNetworkAccess": {
+          "description": "Whether requests from Public Network are allowed",
+          "$ref": "#/definitions/PublicNetworkAccess"
+        },
+        "enableFreeTier": {
+          "description": "Flag to indicate whether Free Tier is enabled.",
+          "type": "boolean"
+        },
+        "apiProperties": {
+          "description": "API specific properties. Currently, supported only for MongoDB API.",
+          "type": "object",
+          "$ref": "#/definitions/ApiProperties"
+        },
+        "enableAnalyticalStorage": {
+          "description": "Flag to indicate whether to enable storage analytics.",
+          "type": "boolean"
+        },
+        "backupPolicy": {
+          "description": "The object representing the policy for taking backups on an account.",
+          "type": "object",
+          "$ref": "#/definitions/BackupPolicy"
+        },
+        "cors": {
+          "type": "array",
+          "description": "The CORS policy for the Cosmos DB database account.",
+          "items": {
+            "$ref": "#/definitions/CorsPolicy"
+          }
+        }
+      }
+    },
+    "DatabaseAccountUpdateParameters": {
+      "description": "Parameters for patching Azure Cosmos DB database account properties.",
+      "type": "object",
+      "properties": {
+        "tags": {
+          "$ref": "#/definitions/Tags"
+        },
+        "location": {
+          "type": "string",
+          "description": "The location of the resource group to which the resource belongs."
+        },
+        "properties": {
+          "x-ms-client-flatten": true,
+          "$ref": "#/definitions/DatabaseAccountUpdateProperties"
+        }
+      }
+    },
+    "DatabaseAccountListReadOnlyKeysResult": {
+      "description": "The read-only access keys for the given database account.",
+      "properties": {
+        "primaryReadonlyMasterKey": {
+          "readOnly": true,
+          "type": "string",
+          "description": "Base 64 encoded value of the primary read-only key."
+        },
+        "secondaryReadonlyMasterKey": {
+          "readOnly": true,
+          "type": "string",
+          "description": "Base 64 encoded value of the secondary read-only key."
+        }
+      }
+    },
+    "DatabaseAccountListKeysResult": {
+      "description": "The access keys for the given database account.",
+      "properties": {
+        "primaryMasterKey": {
+          "readOnly": true,
+          "type": "string",
+          "description": "Base 64 encoded value of the primary read-write key."
+        },
+        "secondaryMasterKey": {
+          "readOnly": true,
+          "type": "string",
+          "description": "Base 64 encoded value of the secondary read-write key."
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "#/definitions/DatabaseAccountListReadOnlyKeysResult"
+        }
+      ]
+    },
+    "DatabaseAccountConnectionString": {
+      "description": "Connection string for the Cosmos DB account",
+      "properties": {
+        "connectionString": {
+          "readOnly": true,
+          "type": "string",
+          "description": "Value of the connection string"
+        },
+        "description": {
+          "readOnly": true,
+          "type": "string",
+          "description": "Description of the connection string"
+        }
+      }
+    },
+    "DatabaseAccountListConnectionStringsResult": {
+      "description": "The connection strings for the given database account.",
+      "properties": {
+        "connectionStrings": {
+          "type": "array",
+          "description": "An array that contains the connection strings for the Cosmos DB account.",
+          "items": {
+            "$ref": "#/definitions/DatabaseAccountConnectionString"
+          }
+        }
+      }
+    },
+    "DatabaseAccountRegenerateKeyParameters": {
+      "type": "object",
+      "description": "Parameters to regenerate the keys within the database account.",
+      "properties": {
+        "keyKind": {
+          "type": "string",
+          "description": "The access key to regenerate.",
+          "enum": [
+            "primary",
+            "secondary",
+            "primaryReadonly",
+            "secondaryReadonly"
+          ],
+          "x-ms-enum": {
+            "name": "KeyKind",
+            "modelAsString": true
+          }
+        }
+      },
+      "required": [
+        "keyKind"
+      ]
+    },
+    "DatabaseAccountOfferType": {
+      "description": "The offer type for the Cosmos DB database account.",
+      "type": "string",
+      "enum": [
+        "Standard"
+      ],
+      "x-ms-enum": {
+        "name": "DatabaseAccountOfferType",
+        "modelAsString": false
+      }
+    },
+    "ThroughputSettingsUpdateParameters": {
+      "description": "Parameters to update Cosmos DB resource throughput.",
+      "type": "object",
+      "properties": {
+        "properties": {
+          "x-ms-client-flatten": true,
+          "description": "Properties to update Azure Cosmos DB resource throughput.",
+          "$ref": "#/definitions/ThroughputSettingsUpdateProperties"
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "#/definitions/ARMResourceProperties"
+        }
+      ],
+      "required": [
+        "properties"
+      ]
+    },
+    "ThroughputSettingsUpdateProperties": {
+      "description": "Properties to update Azure Cosmos DB resource throughput.",
+      "type": "object",
+      "properties": {
+        "resource": {
+          "description": "The standard JSON format of a resource throughput",
+          "$ref": "#/definitions/ThroughputSettingsResource"
+        }
+      },
+      "required": [
+        "resource"
+      ]
+    },
+    "SqlDatabaseCreateUpdateParameters": {
+      "description": "Parameters to create and update Cosmos DB SQL database.",
+      "type": "object",
+      "properties": {
+        "properties": {
+          "x-ms-client-flatten": true,
+          "description": "Properties to create and update Azure Cosmos DB SQL database.",
+          "$ref": "#/definitions/SqlDatabaseCreateUpdateProperties"
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "#/definitions/ARMResourceProperties"
+        }
+      ],
+      "required": [
+        "properties"
+      ]
+    },
+    "SqlDatabaseCreateUpdateProperties": {
+      "description": "Properties to create and update Azure Cosmos DB SQL database.",
+      "type": "object",
+      "properties": {
+        "resource": {
+          "description": "The standard JSON format of a SQL database",
+          "$ref": "#/definitions/SqlDatabaseResource"
+        },
+        "options": {
+          "description": "A key-value pair of options to be applied for the request. This corresponds to the headers sent with the request.",
+          "$ref": "#/definitions/CreateUpdateOptions"
+        }
+      },
+      "required": [
+        "resource"
+      ]
+    },
+    "SqlContainerCreateUpdateParameters": {
+      "description": "Parameters to create and update Cosmos DB container.",
+      "type": "object",
+      "properties": {
+        "properties": {
+          "x-ms-client-flatten": true,
+          "description": "Properties to create and update Azure Cosmos DB container.",
+          "$ref": "#/definitions/SqlContainerCreateUpdateProperties"
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "#/definitions/ARMResourceProperties"
+        }
+      ],
+      "required": [
+        "properties"
+      ]
+    },
+    "SqlContainerCreateUpdateProperties": {
+      "description": "Properties to create and update Azure Cosmos DB container.",
+      "type": "object",
+      "properties": {
+        "resource": {
+          "description": "The standard JSON format of a container",
+          "$ref": "#/definitions/SqlContainerResource"
+        },
+        "options": {
+          "description": "A key-value pair of options to be applied for the request. This corresponds to the headers sent with the request.",
+          "$ref": "#/definitions/CreateUpdateOptions"
+        }
+      },
+      "required": [
+        "resource"
+      ]
+    },
+    "SqlStoredProcedureCreateUpdateParameters": {
+      "description": "Parameters to create and update Cosmos DB storedProcedure.",
+      "type": "object",
+      "properties": {
+        "properties": {
+          "x-ms-client-flatten": true,
+          "description": "Properties to create and update Azure Cosmos DB storedProcedure.",
+          "$ref": "#/definitions/SqlStoredProcedureCreateUpdateProperties"
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "#/definitions/ARMResourceProperties"
+        }
+      ],
+      "required": [
+        "properties"
+      ]
+    },
+    "SqlStoredProcedureCreateUpdateProperties": {
+      "description": "Properties to create and update Azure Cosmos DB storedProcedure.",
+      "type": "object",
+      "properties": {
+        "resource": {
+          "description": "The standard JSON format of a storedProcedure",
+          "$ref": "#/definitions/SqlStoredProcedureResource"
+        },
+        "options": {
+          "description": "A key-value pair of options to be applied for the request. This corresponds to the headers sent with the request.",
+          "$ref": "#/definitions/CreateUpdateOptions"
+        }
+      },
+      "required": [
+        "resource"
+      ]
+    },
+    "SqlUserDefinedFunctionCreateUpdateParameters": {
+      "description": "Parameters to create and update Cosmos DB userDefinedFunction.",
+      "type": "object",
+      "properties": {
+        "properties": {
+          "x-ms-client-flatten": true,
+          "description": "Properties to create and update Azure Cosmos DB userDefinedFunction.",
+          "$ref": "#/definitions/SqlUserDefinedFunctionCreateUpdateProperties"
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "#/definitions/ARMResourceProperties"
+        }
+      ],
+      "required": [
+        "properties"
+      ]
+    },
+    "SqlUserDefinedFunctionCreateUpdateProperties": {
+      "description": "Properties to create and update Azure Cosmos DB userDefinedFunction.",
+      "type": "object",
+      "properties": {
+        "resource": {
+          "description": "The standard JSON format of a userDefinedFunction",
+          "$ref": "#/definitions/SqlUserDefinedFunctionResource"
+        },
+        "options": {
+          "description": "A key-value pair of options to be applied for the request. This corresponds to the headers sent with the request.",
+          "$ref": "#/definitions/CreateUpdateOptions"
+        }
+      },
+      "required": [
+        "resource"
+      ]
+    },
+    "SqlTriggerCreateUpdateParameters": {
+      "description": "Parameters to create and update Cosmos DB trigger.",
+      "type": "object",
+      "properties": {
+        "properties": {
+          "x-ms-client-flatten": true,
+          "description": "Properties to create and update Azure Cosmos DB trigger.",
+          "$ref": "#/definitions/SqlTriggerCreateUpdateProperties"
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "#/definitions/ARMResourceProperties"
+        }
+      ],
+      "required": [
+        "properties"
+      ]
+    },
+    "SqlTriggerCreateUpdateProperties": {
+      "description": "Properties to create and update Azure Cosmos DB trigger.",
+      "type": "object",
+      "properties": {
+        "resource": {
+          "description": "The standard JSON format of a trigger",
+          "$ref": "#/definitions/SqlTriggerResource"
+        },
+        "options": {
+          "description": "A key-value pair of options to be applied for the request. This corresponds to the headers sent with the request.",
+          "$ref": "#/definitions/CreateUpdateOptions"
+        }
+      },
+      "required": [
+        "resource"
+      ]
+    },
+    "MongoDBDatabaseCreateUpdateParameters": {
+      "description": "Parameters to create and update Cosmos DB MongoDB database.",
+      "type": "object",
+      "properties": {
+        "properties": {
+          "x-ms-client-flatten": true,
+          "description": "Properties to create and update Azure Cosmos DB MongoDB database.",
+          "$ref": "#/definitions/MongoDBDatabaseCreateUpdateProperties"
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "#/definitions/ARMResourceProperties"
+        }
+      ],
+      "required": [
+        "properties"
+      ]
+    },
+    "MongoDBDatabaseCreateUpdateProperties": {
+      "description": "Properties to create and update Azure Cosmos DB MongoDB database.",
+      "type": "object",
+      "properties": {
+        "resource": {
+          "description": "The standard JSON format of a MongoDB database",
+          "$ref": "#/definitions/MongoDBDatabaseResource"
+        },
+        "options": {
+          "description": "A key-value pair of options to be applied for the request. This corresponds to the headers sent with the request.",
+          "$ref": "#/definitions/CreateUpdateOptions"
+        }
+      },
+      "required": [
+        "resource"
+      ]
+    },
+    "MongoDBCollectionCreateUpdateParameters": {
+      "description": "Parameters to create and update Cosmos DB MongoDB collection.",
+      "type": "object",
+      "properties": {
+        "properties": {
+          "x-ms-client-flatten": true,
+          "description": "Properties to create and update Azure Cosmos DB MongoDB collection.",
+          "$ref": "#/definitions/MongoDBCollectionCreateUpdateProperties"
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "#/definitions/ARMResourceProperties"
+        }
+      ],
+      "required": [
+        "properties"
+      ]
+    },
+    "MongoDBCollectionCreateUpdateProperties": {
+      "description": "Properties to create and update Azure Cosmos DB MongoDB collection.",
+      "type": "object",
+      "properties": {
+        "resource": {
+          "description": "The standard JSON format of a MongoDB collection",
+          "$ref": "#/definitions/MongoDBCollectionResource"
+        },
+        "options": {
+          "description": "A key-value pair of options to be applied for the request. This corresponds to the headers sent with the request.",
+          "$ref": "#/definitions/CreateUpdateOptions"
+        }
+      },
+      "required": [
+        "resource"
+      ]
+    },
+    "TableCreateUpdateParameters": {
+      "description": "Parameters to create and update Cosmos DB Table.",
+      "type": "object",
+      "properties": {
+        "properties": {
+          "x-ms-client-flatten": true,
+          "description": "Properties to create and update Azure Cosmos DB Table.",
+          "$ref": "#/definitions/TableCreateUpdateProperties"
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "#/definitions/ARMResourceProperties"
+        }
+      ],
+      "required": [
+        "properties"
+      ]
+    },
+    "TableCreateUpdateProperties": {
+      "description": "Properties to create and update Azure Cosmos DB Table.",
+      "type": "object",
+      "properties": {
+        "resource": {
+          "description": "The standard JSON format of a Table",
+          "$ref": "#/definitions/TableResource"
+        },
+        "options": {
+          "description": "A key-value pair of options to be applied for the request. This corresponds to the headers sent with the request.",
+          "$ref": "#/definitions/CreateUpdateOptions"
+        }
+      },
+      "required": [
+        "resource"
+      ]
+    },
+    "CassandraKeyspaceCreateUpdateParameters": {
+      "description": "Parameters to create and update Cosmos DB Cassandra keyspace.",
+      "type": "object",
+      "properties": {
+        "properties": {
+          "x-ms-client-flatten": true,
+          "description": "Properties to create and update Azure Cosmos DB Cassandra keyspace.",
+          "$ref": "#/definitions/CassandraKeyspaceCreateUpdateProperties"
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "#/definitions/ARMResourceProperties"
+        }
+      ],
+      "required": [
+        "properties"
+      ]
+    },
+    "CassandraKeyspaceCreateUpdateProperties": {
+      "description": "Properties to create and update Azure Cosmos DB Cassandra keyspace.",
+      "type": "object",
+      "properties": {
+        "resource": {
+          "description": "The standard JSON format of a Cassandra keyspace",
+          "$ref": "#/definitions/CassandraKeyspaceResource"
+        },
+        "options": {
+          "description": "A key-value pair of options to be applied for the request. This corresponds to the headers sent with the request.",
+          "$ref": "#/definitions/CreateUpdateOptions"
+        }
+      },
+      "required": [
+        "resource"
+      ]
+    },
+    "CassandraTableCreateUpdateParameters": {
+      "description": "Parameters to create and update Cosmos DB Cassandra table.",
+      "type": "object",
+      "properties": {
+        "properties": {
+          "x-ms-client-flatten": true,
+          "description": "Properties to create and update Azure Cosmos DB Cassandra table.",
+          "$ref": "#/definitions/CassandraTableCreateUpdateProperties"
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "#/definitions/ARMResourceProperties"
+        }
+      ],
+      "required": [
+        "properties"
+      ]
+    },
+    "CassandraTableCreateUpdateProperties": {
+      "description": "Properties to create and update Azure Cosmos DB Cassandra table.",
+      "type": "object",
+      "properties": {
+        "resource": {
+          "description": "The standard JSON format of a Cassandra table",
+          "$ref": "#/definitions/CassandraTableResource"
+        },
+        "options": {
+          "description": "A key-value pair of options to be applied for the request. This corresponds to the headers sent with the request.",
+          "$ref": "#/definitions/CreateUpdateOptions"
+        }
+      },
+      "required": [
+        "resource"
+      ]
+    },
+    "GremlinDatabaseCreateUpdateParameters": {
+      "description": "Parameters to create and update Cosmos DB Gremlin database.",
+      "type": "object",
+      "properties": {
+        "properties": {
+          "x-ms-client-flatten": true,
+          "description": "Properties to create and update Azure Cosmos DB Gremlin database.",
+          "$ref": "#/definitions/GremlinDatabaseCreateUpdateProperties"
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "#/definitions/ARMResourceProperties"
+        }
+      ],
+      "required": [
+        "properties"
+      ]
+    },
+    "GremlinDatabaseCreateUpdateProperties": {
+      "description": "Properties to create and update Azure Cosmos DB Gremlin database.",
+      "type": "object",
+      "properties": {
+        "resource": {
+          "description": "The standard JSON format of a Gremlin database",
+          "$ref": "#/definitions/GremlinDatabaseResource"
+        },
+        "options": {
+          "description": "A key-value pair of options to be applied for the request. This corresponds to the headers sent with the request.",
+          "$ref": "#/definitions/CreateUpdateOptions"
+        }
+      },
+      "required": [
+        "resource"
+      ]
+    },
+    "GremlinGraphCreateUpdateParameters": {
+      "description": "Parameters to create and update Cosmos DB Gremlin graph.",
+      "type": "object",
+      "properties": {
+        "properties": {
+          "x-ms-client-flatten": true,
+          "description": "Properties to create and update Azure Cosmos DB Gremlin graph.",
+          "$ref": "#/definitions/GremlinGraphCreateUpdateProperties"
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "#/definitions/ARMResourceProperties"
+        }
+      ],
+      "required": [
+        "properties"
+      ]
+    },
+    "GremlinGraphCreateUpdateProperties": {
+      "description": "Properties to create and update Azure Cosmos DB Gremlin graph.",
+      "type": "object",
+      "properties": {
+        "resource": {
+          "description": "The standard JSON format of a Gremlin graph",
+          "$ref": "#/definitions/GremlinGraphResource"
+        },
+        "options": {
+          "description": "A key-value pair of options to be applied for the request. This corresponds to the headers sent with the request.",
+          "$ref": "#/definitions/CreateUpdateOptions"
+        }
+      },
+      "required": [
+        "resource"
+      ]
+    },
+    "ThroughputSettingsResource": {
+      "type": "object",
+      "description": "Cosmos DB resource throughput object. Either throughput is required or autoscaleSettings is required, but not both.",
+      "properties": {
+        "throughput": {
+          "type": "integer",
+          "description": "Value of the Cosmos DB resource throughput. Either throughput is required or autoscaleSettings is required, but not both."
+        },
+        "autoscaleSettings": {
+          "description": "Cosmos DB resource for autoscale settings. Either throughput is required or autoscaleSettings is required, but not both.",
+          "$ref": "#/definitions/AutoscaleSettingsResource"
+        },
+        "minimumThroughput": {
+          "type": "string",
+          "description": "The minimum throughput of the resource",
+          "readOnly": true
+        },
+        "offerReplacePending": {
+          "type": "string",
+          "description": "The throughput replace is pending",
+          "readOnly": true
+        }
+      }
+    },
+    "AutoscaleSettingsResource": {
+      "type": "object",
+      "description": "Cosmos DB provisioned throughput settings object",
+      "properties": {
+        "maxThroughput": {
+          "type": "integer",
+          "description": "Represents maximum throughput container can scale up to."
+        },
+        "autoUpgradePolicy": {
+          "description": "Cosmos DB resource auto-upgrade policy",
+          "$ref": "#/definitions/AutoUpgradePolicyResource"
+        },
+        "targetMaxThroughput": {
+          "type": "integer",
+          "description": "Represents target maximum throughput container can scale up to once offer is no longer in pending state.",
+          "readOnly": true
+        }
+      },
+      "required": [
+        "maxThroughput"
+      ]
+    },
+    "AutoUpgradePolicyResource": {
+      "type": "object",
+      "description": "Cosmos DB resource auto-upgrade policy",
+      "properties": {
+        "throughputPolicy": {
+          "description": "Represents throughput policy which service must adhere to for auto-upgrade",
+          "$ref": "#/definitions/ThroughputPolicyResource"
+        }
+      }
+    },
+    "ThroughputPolicyResource": {
+      "type": "object",
+      "description": "Cosmos DB resource throughput policy",
+      "properties": {
+        "isEnabled": {
+          "type": "boolean",
+          "description": "Determines whether the ThroughputPolicy is active or not"
+        },
+        "incrementPercent": {
+          "type": "integer",
+          "description": "Represents the percentage by which throughput can increase every time throughput policy kicks in."
+        }
+      }
+    },
+    "OptionsResource": {
+      "type": "object",
+      "description": "Cosmos DB options resource object",
+      "readOnly": true,
+      "properties": {
+        "throughput": {
+          "type": "integer",
+          "description": "Value of the Cosmos DB resource throughput or autoscaleSettings. Use the ThroughputSetting resource when retrieving offer details."
+        },
+        "autoscaleSettings": {
+          "type": "object",
+          "$ref": "#/definitions/AutoscaleSettings",
+          "description": "Specifies the Autoscale settings."
+        }
+      }
+    },
+    "SqlDatabaseResource": {
+      "type": "object",
+      "description": "Cosmos DB SQL database resource object",
+      "properties": {
+        "id": {
+          "type": "string",
+          "description": "Name of the Cosmos DB SQL database"
+        }
+      },
+      "required": [
+        "id"
+      ]
+    },
+    "SqlContainerResource": {
+      "type": "object",
+      "description": "Cosmos DB SQL container resource object",
+      "properties": {
+        "id": {
+          "type": "string",
+          "description": "Name of the Cosmos DB SQL container"
+        },
+        "indexingPolicy": {
+          "$ref": "#/definitions/IndexingPolicy",
+          "description": "The configuration of the indexing policy. By default, the indexing is automatic for all document paths within the container"
+        },
+        "partitionKey": {
+          "$ref": "#/definitions/ContainerPartitionKey",
+          "description": "The configuration of the partition key to be used for partitioning data into multiple partitions"
+        },
+        "defaultTtl": {
+          "type": "integer",
+          "description": "Default time to live"
+        },
+        "uniqueKeyPolicy": {
+          "$ref": "#/definitions/UniqueKeyPolicy",
+          "description": "The unique key policy configuration for specifying uniqueness constraints on documents in the collection in the Azure Cosmos DB service."
+        },
+        "conflictResolutionPolicy": {
+          "$ref": "#/definitions/ConflictResolutionPolicy",
+          "description": "The conflict resolution policy for the container."
+        },
+        "analyticalStorageTtl": {
+          "type": "integer",
+          "format": "int64",
+          "description": "Analytical TTL."
+        }
+      },
+      "required": [
+        "id"
+      ]
+    },
+    "IndexingPolicy": {
+      "type": "object",
+      "description": "Cosmos DB indexing policy",
+      "properties": {
+        "automatic": {
+          "type": "boolean",
+          "description": "Indicates if the indexing policy is automatic"
+        },
+        "indexingMode": {
+          "description": "Indicates the indexing mode.",
+          "type": "string",
+          "default": "Consistent",
+          "enum": [
+            "Consistent",
+            "Lazy",
+            "None"
+          ],
+          "x-ms-enum": {
+            "name": "IndexingMode",
+            "modelAsString": true
+          }
+        },
+        "includedPaths": {
+          "description": "List of paths to include in the indexing",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/IncludedPath"
+          }
+        },
+        "excludedPaths": {
+          "description": "List of paths to exclude from indexing",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/ExcludedPath"
+          }
+        },
+        "compositeIndexes": {
+          "description": "List of composite path list",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/CompositePathList"
+          }
+        },
+        "spatialIndexes": {
+          "description": "List of spatial specifics",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/SpatialSpec"
+          }
+        }
+      }
+    },
+    "ExcludedPath": {
+      "type": "object",
+      "properties": {
+        "path": {
+          "type": "string",
+          "description": "The path for which the indexing behavior applies to. Index paths typically start with root and end with wildcard (/path/*)"
+        }
+      }
+    },
+    "IncludedPath": {
+      "type": "object",
+      "description": "The paths that are included in indexing",
+      "properties": {
+        "path": {
+          "type": "string",
+          "description": "The path for which the indexing behavior applies to. Index paths typically start with root and end with wildcard (/path/*)"
+        },
+        "indexes": {
+          "description": "List of indexes for this path",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/Indexes"
+          }
+        }
+      }
+    },
+    "Indexes": {
+      "type": "object",
+      "description": "The indexes for the path.",
+      "properties": {
+        "dataType": {
+          "description": "The datatype for which the indexing behavior is applied to.",
+          "type": "string",
+          "default": "String",
+          "enum": [
+            "String",
+            "Number",
+            "Point",
+            "Polygon",
+            "LineString",
+            "MultiPolygon"
+          ],
+          "x-ms-enum": {
+            "name": "DataType",
+            "modelAsString": true
+          }
+        },
+        "precision": {
+          "description": "The precision of the index. -1 is maximum precision.",
+          "type": "integer"
+        },
+        "kind": {
+          "description": "Indicates the type of index.",
+          "type": "string",
+          "default": "Hash",
+          "enum": [
+            "Hash",
+            "Range",
+            "Spatial"
+          ],
+          "x-ms-enum": {
+            "name": "IndexKind",
+            "modelAsString": true
+          }
+        }
+      }
+    },
+    "CompositePathList": {
+      "description": "List of composite path",
+      "type": "array",
+      "items": {
+        "$ref": "#/definitions/CompositePath"
+      }
+    },
+    "CompositePath": {
+      "type": "object",
+      "properties": {
+        "path": {
+          "type": "string",
+          "description": "The path for which the indexing behavior applies to. Index paths typically start with root and end with wildcard (/path/*)"
+        },
+        "order": {
+          "description": "Sort order for composite paths.",
+          "type": "string",
+          "enum": [
+            "Ascending",
+            "Descending"
+          ],
+          "x-ms-enum": {
+            "name": "CompositePathSortOrder",
+            "modelAsString": true
+          }
+        }
+      }
+    },
+    "SpatialSpec": {
+      "type": "object",
+      "properties": {
+        "path": {
+          "type": "string",
+          "description": "The path for which the indexing behavior applies to. Index paths typically start with root and end with wildcard (/path/*)"
+        },
+        "types": {
+          "description": "List of path's spatial type",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/SpatialType"
+          }
+        }
+      }
+    },
+    "SpatialType": {
+      "description": "Indicates the spatial type of index.",
+      "type": "string",
+      "enum": [
+        "Point",
+        "LineString",
+        "Polygon",
+        "MultiPolygon"
+      ],
+      "x-ms-enum": {
+        "name": "SpatialType",
+        "modelAsString": true
+      }
+    },
+    "ContainerPartitionKey": {
+      "type": "object",
+      "description": "The configuration of the partition key to be used for partitioning data into multiple partitions",
+      "properties": {
+        "paths": {
+          "description": "List of paths using which data within the container can be partitioned",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/Path"
+          }
+        },
+        "kind": {
+          "description": "Indicates the kind of algorithm used for partitioning",
+          "type": "string",
+          "default": "Hash",
+          "enum": [
+            "Hash",
+            "Range"
+          ],
+          "x-ms-enum": {
+            "name": "PartitionKind",
+            "modelAsString": true
+          }
+        },
+        "version": {
+          "description": "Indicates the version of the partition key definition",
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 2,
+          "format": "int32"
+        }
+      }
+    },
+    "Path": {
+      "type": "string",
+      "description": "A path. These typically start with root (/path)"
+    },
+    "UniqueKeyPolicy": {
+      "type": "object",
+      "description": "The unique key policy configuration for specifying uniqueness constraints on documents in the collection in the Azure Cosmos DB service.",
+      "properties": {
+        "uniqueKeys": {
+          "description": "List of unique keys on that enforces uniqueness constraint on documents in the collection in the Azure Cosmos DB service.",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/UniqueKey"
+          }
+        }
+      }
+    },
+    "UniqueKey": {
+      "type": "object",
+      "description": "The unique key on that enforces uniqueness constraint on documents in the collection in the Azure Cosmos DB service.",
+      "properties": {
+        "paths": {
+          "description": "List of paths must be unique for each document in the Azure Cosmos DB service",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/Path"
+          }
+        }
+      }
+    },
+    "ConflictResolutionPolicy": {
+      "type": "object",
+      "description": "The conflict resolution policy for the container.",
+      "properties": {
+        "mode": {
+          "description": "Indicates the conflict resolution mode.",
+          "type": "string",
+          "default": "LastWriterWins",
+          "enum": [
+            "LastWriterWins",
+            "Custom"
+          ],
+          "x-ms-enum": {
+            "name": "ConflictResolutionMode",
+            "modelAsString": true
+          }
+        },
+        "conflictResolutionPath": {
+          "type": "string",
+          "description": "The conflict resolution path in the case of LastWriterWins mode."
+        },
+        "conflictResolutionProcedure": {
+          "type": "string",
+          "description": "The procedure to resolve conflicts in the case of custom mode."
+        }
+      }
+    },
+    "SqlStoredProcedureResource": {
+      "type": "object",
+      "description": "Cosmos DB SQL storedProcedure resource object",
+      "properties": {
+        "id": {
+          "type": "string",
+          "description": "Name of the Cosmos DB SQL storedProcedure"
+        },
+        "body": {
+          "type": "string",
+          "description": "Body of the Stored Procedure"
+        }
+      },
+      "required": [
+        "id"
+      ]
+    },
+    "SqlUserDefinedFunctionResource": {
+      "type": "object",
+      "description": "Cosmos DB SQL userDefinedFunction resource object",
+      "properties": {
+        "id": {
+          "type": "string",
+          "description": "Name of the Cosmos DB SQL userDefinedFunction"
+        },
+        "body": {
+          "type": "string",
+          "description": "Body of the User Defined Function"
+        }
+      },
+      "required": [
+        "id"
+      ]
+    },
+    "SqlTriggerResource": {
+      "type": "object",
+      "description": "Cosmos DB SQL trigger resource object",
+      "properties": {
+        "id": {
+          "type": "string",
+          "description": "Name of the Cosmos DB SQL trigger"
+        },
+        "body": {
+          "type": "string",
+          "description": "Body of the Trigger"
+        },
+        "triggerType": {
+          "type": "string",
+          "enum": [
+            "Pre",
+            "Post"
+          ],
+          "description": "Type of the Trigger",
+          "x-ms-enum": {
+            "name": "triggerType",
+            "modelAsString": true
+          }
+        },
+        "triggerOperation": {
+          "type": "string",
+          "enum": [
+            "All",
+            "Create",
+            "Update",
+            "Delete",
+            "Replace"
+          ],
+          "description": "The operation the trigger is associated with",
+          "x-ms-enum": {
+            "name": "triggerOperation",
+            "modelAsString": true
+          }
+        }
+      },
+      "required": [
+        "id"
+      ]
+    },
+    "MongoDBDatabaseResource": {
+      "type": "object",
+      "description": "Cosmos DB MongoDB database resource object",
+      "properties": {
+        "id": {
+          "type": "string",
+          "description": "Name of the Cosmos DB MongoDB database"
+        }
+      },
+      "required": [
+        "id"
+      ]
+    },
+    "MongoDBCollectionResource": {
+      "type": "object",
+      "description": "Cosmos DB MongoDB collection resource object",
+      "properties": {
+        "id": {
+          "type": "string",
+          "description": "Name of the Cosmos DB MongoDB collection"
+        },
+        "shardKey": {
+          "description": "A key-value pair of shard keys to be applied for the request.",
+          "$ref": "#/definitions/ShardKeys"
+        },
+        "indexes": {
+          "description": "List of index keys",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/MongoIndex"
+          }
+        },
+        "analyticalStorageTtl": {
+          "type": "integer",
+          "description": "Analytical TTL."
+        }
+      },
+      "required": [
+        "id"
+      ]
+    },
+    "ShardKeys": {
+      "type": "object",
+      "additionalProperties": {
+        "type": "string"
+      },
+      "description": "The shard key and partition kind pair, only support \"Hash\" partition kind"
+    },
+    "MongoIndex": {
+      "type": "object",
+      "description": "Cosmos DB MongoDB collection index key",
+      "properties": {
+        "key": {
+          "description": "Cosmos DB MongoDB collection index keys",
+          "$ref": "#/definitions/MongoIndexKeys"
+        },
+        "options": {
+          "description": "Cosmos DB MongoDB collection index key options",
+          "$ref": "#/definitions/MongoIndexOptions"
+        }
+      }
+    },
+    "MongoIndexKeys": {
+      "type": "object",
+      "description": "Cosmos DB MongoDB collection resource object",
+      "properties": {
+        "keys": {
+          "description": "List of keys for each MongoDB collection in the Azure Cosmos DB service",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/Key"
+          }
+        }
+      }
+    },
+    "Key": {
+      "type": "string",
+      "description": "A Key."
+    },
+    "MongoIndexOptions": {
+      "type": "object",
+      "description": "Cosmos DB MongoDB collection index options",
+      "properties": {
+        "expireAfterSeconds": {
+          "description": "Expire after seconds",
+          "type": "integer"
+        },
+        "unique": {
+          "description": "Is unique or not",
+          "type": "boolean"
+        }
+      }
+    },
+    "TableResource": {
+      "type": "object",
+      "description": "Cosmos DB table resource object",
+      "properties": {
+        "id": {
+          "type": "string",
+          "description": "Name of the Cosmos DB table"
+        }
+      },
+      "required": [
+        "id"
+      ]
+    },
+    "CassandraKeyspaceResource": {
+      "type": "object",
+      "description": "Cosmos DB Cassandra keyspace resource object",
+      "properties": {
+        "id": {
+          "type": "string",
+          "description": "Name of the Cosmos DB Cassandra keyspace"
+        }
+      },
+      "required": [
+        "id"
+      ]
+    },
+    "CassandraTableResource": {
+      "type": "object",
+      "description": "Cosmos DB Cassandra table resource object",
+      "properties": {
+        "id": {
+          "type": "string",
+          "description": "Name of the Cosmos DB Cassandra table"
+        },
+        "defaultTtl": {
+          "type": "integer",
+          "description": "Time to live of the Cosmos DB Cassandra table"
+        },
+        "schema": {
+          "description": "Schema of the Cosmos DB Cassandra table",
+          "$ref": "#/definitions/CassandraSchema"
+        },
+        "analyticalStorageTtl": {
+          "type": "integer",
+          "description": "Analytical TTL."
+        }
+      },
+      "required": [
+        "id"
+      ]
+    },
+    "CassandraSchema": {
+      "type": "object",
+      "description": "Cosmos DB Cassandra table schema",
+      "properties": {
+        "columns": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/Column"
+          },
+          "description": "List of Cassandra table columns."
+        },
+        "partitionKeys": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/CassandraPartitionKey"
+          },
+          "description": "List of partition key."
+        },
+        "clusterKeys": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/ClusterKey"
+          },
+          "description": "List of cluster key."
+        }
+      }
+    },
+    "Column": {
+      "type": "object",
+      "description": "Cosmos DB Cassandra table column",
+      "properties": {
+        "name": {
+          "type": "string",
+          "description": "Name of the Cosmos DB Cassandra table column"
+        },
+        "type": {
+          "type": "string",
+          "description": "Type of the Cosmos DB Cassandra table column"
+        }
+      }
+    },
+    "CassandraPartitionKey": {
+      "type": "object",
+      "description": "Cosmos DB Cassandra table partition key",
+      "properties": {
+        "name": {
+          "type": "string",
+          "description": "Name of the Cosmos DB Cassandra table partition key"
+        }
+      }
+    },
+    "ClusterKey": {
+      "type": "object",
+      "description": "Cosmos DB Cassandra table cluster key",
+      "properties": {
+        "name": {
+          "type": "string",
+          "description": "Name of the Cosmos DB Cassandra table cluster key"
+        },
+        "orderBy": {
+          "type": "string",
+          "description": "Order of the Cosmos DB Cassandra table cluster key, only support \"Asc\" and \"Desc\""
+        }
+      }
+    },
+    "GremlinDatabaseResource": {
+      "type": "object",
+      "description": "Cosmos DB Gremlin database resource object",
+      "properties": {
+        "id": {
+          "type": "string",
+          "description": "Name of the Cosmos DB Gremlin database"
+        }
+      },
+      "required": [
+        "id"
+      ]
+    },
+    "GremlinGraphResource": {
+      "type": "object",
+      "description": "Cosmos DB Gremlin graph resource object",
+      "properties": {
+        "id": {
+          "type": "string",
+          "description": "Name of the Cosmos DB Gremlin graph"
+        },
+        "indexingPolicy": {
+          "$ref": "#/definitions/IndexingPolicy",
+          "description": "The configuration of the indexing policy. By default, the indexing is automatic for all document paths within the graph"
+        },
+        "partitionKey": {
+          "$ref": "#/definitions/ContainerPartitionKey",
+          "description": "The configuration of the partition key to be used for partitioning data into multiple partitions"
+        },
+        "defaultTtl": {
+          "type": "integer",
+          "description": "Default time to live"
+        },
+        "uniqueKeyPolicy": {
+          "$ref": "#/definitions/UniqueKeyPolicy",
+          "description": "The unique key policy configuration for specifying uniqueness constraints on documents in the collection in the Azure Cosmos DB service."
+        },
+        "conflictResolutionPolicy": {
+          "$ref": "#/definitions/ConflictResolutionPolicy",
+          "description": "The conflict resolution policy for the graph."
+        }
+      },
+      "required": [
+        "id"
+      ]
+    },
+    "CreateUpdateOptions": {
+      "type": "object",
+      "properties": {
+        "throughput": {
+          "type": "integer",
+          "description": "Request Units per second. For example, \"throughput\": 10000."
+        },
+        "autoscaleSettings": {
+          "$ref": "#/definitions/AutoscaleSettings",
+          "description": "Specifies the Autoscale settings."
+        }
+      },
+      "description": "CreateUpdateOptions are a list of key-value pairs that describe the resource. Supported keys are \"If-Match\", \"If-None-Match\", \"Session-Token\" and \"Throughput\""
+    },
+    "AutoscaleSettings": {
+      "type": "object",
+      "properties": {
+        "maxThroughput": {
+          "type": "integer",
+          "description": "Represents maximum throughput, the resource can scale up to."
+        }
+      }
+    },
+    "Capability": {
+      "type": "object",
+      "description": "Cosmos DB capability object",
+      "properties": {
+        "name": {
+          "type": "string",
+          "description": "Name of the Cosmos DB capability. For example, \"name\": \"EnableCassandra\". Current values also include \"EnableTable\" and \"EnableGremlin\"."
+        }
+      }
+    },
+    "Tags": {
+      "type": "object",
+      "additionalProperties": {
+        "type": "string"
+      },
+      "description": "Tags are a list of key-value pairs that describe the resource. These tags can be used in viewing and grouping this resource (across resource groups). A maximum of 15 tags can be provided for a resource. Each tag must have a key no greater than 128 characters and value no greater than 256 characters. For example, the default experience for a template type is set with \"defaultExperience\": \"Cassandra\". Current \"defaultExperience\" values also include \"Table\", \"Graph\", \"DocumentDB\", and \"MongoDB\"."
+    },
+    "ProvisioningState": {
+      "type": "string",
+      "readOnly": true,
+      "description": "The status of the Cosmos DB account at the time the operation was called. The status can be one of following. 'Creating' – the Cosmos DB account is being created. When an account is in Creating state, only properties that are specified as input for the Create Cosmos DB account operation are returned. 'Succeeded' – the Cosmos DB account is active for use. 'Updating' – the Cosmos DB account is being updated. 'Deleting' – the Cosmos DB account is being deleted. 'Failed' – the Cosmos DB account failed creation. 'DeletionFailed' – the Cosmos DB account deletion failed."
+    },
+    "IPRules": {
+      "type": "array",
+      "description": "Array of IpAddressOrRange objects.",
+      "items": {
+        "$ref": "#/definitions/IpAddressOrRange"
+      }
+    },
+    "IpAddressOrRange": {
+      "type": "object",
+      "description": "IpAddressOrRange object",
+      "properties": {
+        "ipAddressOrRange": {
+          "type": "string",
+          "description": "A single IPv4 address or a single IPv4 address range in CIDR format. Provided IPs must be well-formatted and cannot be contained in one of the following ranges: 10.0.0.0/8, 100.64.0.0/10, 172.16.0.0/12, 192.168.0.0/16, since these are not enforceable by the IP address filter. Example of valid inputs: “23.40.210.245” or “23.40.210.0/8”."
+        }
+      }
+    },
+    "VirtualNetworkRule": {
+      "type": "object",
+      "description": "Virtual Network ACL Rule object",
+      "properties": {
+        "id": {
+          "type": "string",
+          "description": "Resource ID of a subnet, for example: /subscriptions/{subscriptionId}/resourceGroups/{groupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName}."
+        },
+        "ignoreMissingVNetServiceEndpoint": {
+          "type": "boolean",
+          "description": "Create firewall rule before the virtual network has vnet service endpoint enabled."
+        }
+      }
+    },
+    "PrivateEndpointConnection": {
+      "description": "A private endpoint connection",
+      "type": "object",
+      "properties": {
+        "properties": {
+          "$ref": "#/definitions/PrivateEndpointConnectionProperties",
+          "description": "Resource properties.",
+          "x-ms-client-flatten": true
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "../../../../../common-types/resource-management/v1/types.json#/definitions/ProxyResource"
+        }
+      ]
+    },
+    "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."
+        }
+      }
+    },
+    "PrivateEndpointProperty": {
+      "type": "object",
+      "description": "Private endpoint which the connection belongs to.",
+      "properties": {
+        "id": {
+          "type": "string",
+          "description": "Resource id of the private endpoint."
+        }
+      }
+    },
+    "PrivateLinkServiceConnectionStateProperty": {
+      "type": "object",
+      "description": "Connection State of the Private Endpoint Connection.",
+      "properties": {
+        "status": {
+          "type": "string",
+          "description": "The private link service connection status."
+        },
+        "actionsRequired": {
+          "type": "string",
+          "description": "Any action that is required beyond basic workflow (approve/ reject/ disconnect)",
+          "readOnly": true
+        }
+      }
+    },
+    "Operation": {
+      "description": "REST API 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.ResourceProvider",
+              "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 operation",
+              "type": "string"
+            }
+          }
+        }
+      }
+    },
+    "OperationListResult": {
+      "description": "Result of the request to list Resource Provider 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 operations supported by the Resource Provider."
+        },
+        "nextLink": {
+          "type": "string",
+          "description": "URL to get the next set of operation list results if there are any."
+        }
+      }
+    },
+    "UsagesResult": {
+      "properties": {
+        "value": {
+          "type": "array",
+          "readOnly": true,
+          "items": {
+            "$ref": "#/definitions/Usage"
+          },
+          "description": "The list of usages for the database. A usage is a point in time metric"
+        }
+      },
+      "description": "The response to a list usage request."
+    },
+    "Usage": {
+      "properties": {
+        "unit": {
+          "description": "The unit of the metric.",
+          "$ref": "#/definitions/UnitType"
+        },
+        "name": {
+          "$ref": "#/definitions/MetricName",
+          "readOnly": true,
+          "description": "The name information for the metric."
+        },
+        "quotaPeriod": {
+          "type": "string",
+          "readOnly": true,
+          "description": "The quota period used to summarize the usage values."
+        },
+        "limit": {
+          "type": "integer",
+          "format": "int64",
+          "readOnly": true,
+          "description": "Maximum value for this metric"
+        },
+        "currentValue": {
+          "type": "integer",
+          "format": "int64",
+          "readOnly": true,
+          "description": "Current value for this metric"
+        }
+      },
+      "description": "The usage data for a usage request."
+    },
+    "PartitionUsagesResult": {
+      "properties": {
+        "value": {
+          "type": "array",
+          "readOnly": true,
+          "items": {
+            "$ref": "#/definitions/PartitionUsage"
+          },
+          "description": "The list of partition-level usages for the database. A usage is a point in time metric"
+        }
+      },
+      "description": "The response to a list partition level usage request."
+    },
+    "PartitionUsage": {
+      "allOf": [
+        {
+          "$ref": "#/definitions/Usage"
+        }
+      ],
+      "properties": {
+        "partitionId": {
+          "readOnly": true,
+          "type": "string",
+          "description": "The partition id (GUID identifier) of the usages."
+        },
+        "partitionKeyRangeId": {
+          "readOnly": true,
+          "type": "string",
+          "description": "The partition key range id (integer identifier) of the usages."
+        }
+      },
+      "description": "The partition level usage data for a usage request."
+    },
+    "MetricDefinitionsListResult": {
+      "properties": {
+        "value": {
+          "type": "array",
+          "readOnly": true,
+          "items": {
+            "$ref": "#/definitions/MetricDefinition"
+          },
+          "description": "The list of metric definitions for the account."
+        }
+      },
+      "description": "The response to a list metric definitions request."
+    },
+    "MetricDefinition": {
+      "properties": {
+        "metricAvailabilities": {
+          "type": "array",
+          "readOnly": true,
+          "items": {
+            "$ref": "#/definitions/MetricAvailability"
+          },
+          "description": "The list of metric availabilities for the account."
+        },
+        "primaryAggregationType": {
+          "readOnly": true,
+          "type": "string",
+          "description": "The primary aggregation type of the metric.",
+          "enum": [
+            "None",
+            "Average",
+            "Total",
+            "Minimum",
+            "Maximum",
+            "Last"
+          ],
+          "x-ms-enum": {
+            "modelAsString": true,
+            "name": "PrimaryAggregationType"
+          }
+        },
+        "unit": {
+          "description": "The unit of the metric.",
+          "$ref": "#/definitions/UnitType"
+        },
+        "resourceUri": {
+          "readOnly": true,
+          "type": "string",
+          "description": "The resource uri of the database."
+        },
+        "name": {
+          "readOnly": true,
+          "$ref": "#/definitions/MetricName",
+          "description": "The name information for the metric."
+        }
+      },
+      "description": "The definition of a metric."
+    },
+    "MetricAvailability": {
+      "properties": {
+        "timeGrain": {
+          "readOnly": true,
+          "type": "string",
+          "description": "The time grain to be used to summarize the metric values."
+        },
+        "retention": {
+          "readOnly": true,
+          "type": "string",
+          "description": "The retention for the metric values."
+        }
+      },
+      "description": "The availability of the metric."
+    },
+    "MetricListResult": {
+      "properties": {
+        "value": {
+          "readOnly": true,
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/Metric"
+          },
+          "description": "The list of metrics for the account."
+        }
+      },
+      "description": "The response to a list metrics request."
+    },
+    "Metric": {
+      "properties": {
+        "startTime": {
+          "readOnly": true,
+          "type": "string",
+          "format": "date-time",
+          "description": "The start time for the metric (ISO-8601 format)."
+        },
+        "endTime": {
+          "readOnly": true,
+          "type": "string",
+          "format": "date-time",
+          "description": "The end time for the metric (ISO-8601 format)."
+        },
+        "timeGrain": {
+          "readOnly": true,
+          "type": "string",
+          "description": "The time grain to be used to summarize the metric values."
+        },
+        "unit": {
+          "$ref": "#/definitions/UnitType",
+          "description": "The unit of the metric."
+        },
+        "name": {
+          "readOnly": true,
+          "$ref": "#/definitions/MetricName",
+          "description": "The name information for the metric."
+        },
+        "metricValues": {
+          "readOnly": true,
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/MetricValue"
+          },
+          "description": "The metric values for the specified time window and timestep."
+        }
+      },
+      "description": "Metric data"
+    },
+    "MetricName": {
+      "properties": {
+        "value": {
+          "readOnly": true,
+          "type": "string",
+          "description": "The name of the metric."
+        },
+        "localizedValue": {
+          "readOnly": true,
+          "type": "string",
+          "description": "The friendly name of the metric."
+        }
+      },
+      "description": "A metric name."
+    },
+    "MetricValue": {
+      "properties": {
+        "_count": {
+          "readOnly": true,
+          "type": "number",
+          "format": "int32",
+          "description": "The number of values for the metric."
+        },
+        "average": {
+          "readOnly": true,
+          "type": "number",
+          "format": "double",
+          "description": "The average value of the metric."
+        },
+        "maximum": {
+          "readOnly": true,
+          "type": "number",
+          "format": "double",
+          "description": "The max value of the metric."
+        },
+        "minimum": {
+          "readOnly": true,
+          "type": "number",
+          "format": "double",
+          "description": "The min value of the metric."
+        },
+        "timestamp": {
+          "readOnly": true,
+          "type": "string",
+          "format": "date-time",
+          "description": "The metric timestamp (ISO-8601 format)."
+        },
+        "total": {
+          "readOnly": true,
+          "type": "number",
+          "format": "double",
+          "description": "The total value of the metric."
+        }
+      },
+      "description": "Represents metrics values."
+    },
+    "PercentileMetricListResult": {
+      "properties": {
+        "value": {
+          "readOnly": true,
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/PercentileMetric"
+          },
+          "description": "The list of percentile metrics for the account."
+        }
+      },
+      "description": "The response to a list percentile metrics request."
+    },
+    "PercentileMetric": {
+      "properties": {
+        "startTime": {
+          "readOnly": true,
+          "type": "string",
+          "format": "date-time",
+          "description": "The start time for the metric (ISO-8601 format)."
+        },
+        "endTime": {
+          "readOnly": true,
+          "type": "string",
+          "format": "date-time",
+          "description": "The end time for the metric (ISO-8601 format)."
+        },
+        "timeGrain": {
+          "readOnly": true,
+          "type": "string",
+          "description": "The time grain to be used to summarize the metric values."
+        },
+        "unit": {
+          "$ref": "#/definitions/UnitType",
+          "description": "The unit of the metric."
+        },
+        "name": {
+          "readOnly": true,
+          "$ref": "#/definitions/MetricName",
+          "description": "The name information for the metric."
+        },
+        "metricValues": {
+          "readOnly": true,
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/PercentileMetricValue"
+          },
+          "description": "The percentile metric values for the specified time window and timestep."
+        }
+      },
+      "description": "Percentile Metric data"
+    },
+    "PercentileMetricValue": {
+      "allOf": [
+        {
+          "$ref": "#/definitions/MetricValue"
+        }
+      ],
+      "properties": {
+        "P10": {
+          "readOnly": true,
+          "type": "number",
+          "format": "double",
+          "description": "The 10th percentile value for the metric."
+        },
+        "P25": {
+          "readOnly": true,
+          "type": "number",
+          "format": "double",
+          "description": "The 25th percentile value for the metric."
+        },
+        "P50": {
+          "readOnly": true,
+          "type": "number",
+          "format": "double",
+          "description": "The 50th percentile value for the metric."
+        },
+        "P75": {
+          "readOnly": true,
+          "type": "number",
+          "format": "double",
+          "description": "The 75th percentile value for the metric."
+        },
+        "P90": {
+          "readOnly": true,
+          "type": "number",
+          "format": "double",
+          "description": "The 90th percentile value for the metric."
+        },
+        "P95": {
+          "readOnly": true,
+          "type": "number",
+          "format": "double",
+          "description": "The 95th percentile value for the metric."
+        },
+        "P99": {
+          "readOnly": true,
+          "type": "number",
+          "format": "double",
+          "description": "The 99th percentile value for the metric."
+        }
+      },
+      "description": "Represents percentile metrics values."
+    },
+    "PartitionMetricListResult": {
+      "properties": {
+        "value": {
+          "readOnly": true,
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/PartitionMetric"
+          },
+          "description": "The list of partition-level metrics for the account."
+        }
+      },
+      "description": "The response to a list partition metrics request."
+    },
+    "PartitionMetric": {
+      "allOf": [
+        {
+          "$ref": "#/definitions/Metric"
+        }
+      ],
+      "properties": {
+        "partitionId": {
+          "readOnly": true,
+          "type": "string",
+          "description": "The partition id (GUID identifier) of the metric values."
+        },
+        "partitionKeyRangeId": {
+          "readOnly": true,
+          "type": "string",
+          "description": "The partition key range id (integer identifier) of the metric values."
+        }
+      },
+      "description": "The metric values for a single partition."
+    },
+    "UnitType": {
+      "type": "string",
+      "readOnly": true,
+      "description": "The unit of the metric.",
+      "enum": [
+        "Count",
+        "Bytes",
+        "Seconds",
+        "Percent",
+        "CountPerSecond",
+        "BytesPerSecond",
+        "Milliseconds"
+      ],
+      "x-ms-enum": {
+        "modelAsString": true,
+        "name": "UnitType"
+      }
+    },
+    "ConnectorOffer": {
+      "description": "The cassandra connector offer type for the Cosmos DB C* database account.",
+      "type": "string",
+      "enum": [
+        "Small"
+      ],
+      "x-ms-enum": {
+        "name": "ConnectorOffer",
+        "modelAsString": true
+      }
+    },
+    "PublicNetworkAccess": {
+      "type": "string",
+      "readOnly": true,
+      "description": "Whether requests from Public Network are allowed",
+      "enum": [
+        "Enabled",
+        "Disabled"
+      ],
+      "x-ms-enum": {
+        "modelAsString": true,
+        "name": "PublicNetworkAccess"
+      }
+    },
+    "ApiProperties": {
+      "type": "object",
+      "properties": {
+        "serverVersion": {
+          "type": "string",
+          "enum": [
+            "3.2",
+            "3.6"
+          ],
+          "description": "Describes the ServerVersion of an a MongoDB account.",
+          "x-ms-enum": {
+            "modelAsString": true,
+            "name": "ServerVersion"
+          }
+        }
+      }
+    },
+    "BackupPolicy": {
+      "type": "object",
+      "description": "The object representing the policy for taking backups on an account.",
+      "discriminator": "type",
+      "properties": {
+        "type": {
+          "type": "string",
+          "$ref": "#/definitions/BackupPolicyType"
+        }
+      },
+      "required": [
+        "type"
+      ]
+    },
+    "BackupPolicyType": {
+      "description": "Describes the mode of backups.",
+      "type": "string",
+      "enum": [
+        "Periodic",
+        "Continuous"
+      ],
+      "x-ms-enum": {
+        "modelAsString": true,
+        "name": "BackupPolicyType"
+      }
+    },
+    "PeriodicModeBackupPolicy": {
+      "description": "The object representing periodic mode backup policy.",
+      "type": "object",
+      "allOf": [
+        {
+          "$ref": "#/definitions/BackupPolicy"
+        }
+      ],
+      "properties": {
+        "periodicModeProperties": {
+          "type": "object",
+          "description": "Configuration values for periodic mode backup",
+          "$ref": "#/definitions/PeriodicModeProperties"
+        }
+      },
+      "x-ms-discriminator-value": "Periodic"
+    },
+    "ContinuousModeBackupPolicy": {
+      "description": "The object representing continuous mode backup policy.",
+      "type": "object",
+      "allOf": [
+        {
+          "$ref": "#/definitions/BackupPolicy"
+        }
+      ],
+      "x-ms-discriminator-value": "Continuous"
+    },
+    "PeriodicModeProperties": {
+      "type": "object",
+      "description": "Configuration values for periodic mode backup",
+      "properties": {
+        "backupIntervalInMinutes": {
+          "type": "integer",
+          "format": "int32",
+          "minimum": 0,
+          "description": "An integer representing the interval in minutes between two backups"
+        },
+        "backupRetentionIntervalInHours": {
+          "type": "integer",
+          "format": "int32",
+          "minimum": 0,
+          "description": "An integer representing the time (in hours) that each backup is retained"
+        }
+      }
+    }
+  },
+  "parameters": {
+    "resourceGroupNameParameter": {
+      "name": "resourceGroupName",
+      "in": "path",
+      "required": true,
+      "type": "string",
+      "pattern": "^[-\\w\\._\\(\\)]+$",
+      "minLength": 1,
+      "maxLength": 90,
+      "x-ms-parameter-location": "method",
+      "description": "Name of an Azure resource group."
+    },
+    "accountNameParameter": {
+      "name": "accountName",
+      "in": "path",
+      "required": true,
+      "type": "string",
+      "x-ms-parameter-location": "method",
+      "description": "Cosmos DB database account name.",
+      "minLength": 3,
+      "maxLength": 50,
+      "pattern": "^[a-z0-9]+(-[a-z0-9]+)*"
+    },
+    "filterParameter": {
+      "name": "$filter",
+      "in": "query",
+      "required": true,
+      "type": "string",
+      "x-ms-parameter-location": "method",
+      "description": "An OData filter expression that describes a subset of metrics to return. The parameters that can be filtered are name.value (name of the metric, can have an or of multiple names), startTime, endTime, and timeGrain. The supported operator is eq."
+    },
+    "usageFilterParameter": {
+      "name": "$filter",
+      "in": "query",
+      "required": false,
+      "type": "string",
+      "x-ms-parameter-location": "method",
+      "description": "An OData filter expression that describes a subset of usages to return. The supported parameter is name.value (name of the metric, can have an or of multiple names)."
+    },
+    "databaseRidParameter": {
+      "name": "databaseRid",
+      "in": "path",
+      "required": true,
+      "type": "string",
+      "x-ms-parameter-location": "method",
+      "description": "Cosmos DB database rid."
+    },
+    "collectionRidParameter": {
+      "name": "collectionRid",
+      "in": "path",
+      "required": true,
+      "type": "string",
+      "x-ms-parameter-location": "method",
+      "description": "Cosmos DB collection rid."
+    },
+    "databaseNameParameter": {
+      "name": "databaseName",
+      "in": "path",
+      "required": true,
+      "type": "string",
+      "x-ms-parameter-location": "method",
+      "description": "Cosmos DB database name."
+    },
+    "containerNameParameter": {
+      "name": "containerName",
+      "in": "path",
+      "required": true,
+      "type": "string",
+      "x-ms-parameter-location": "method",
+      "description": "Cosmos DB container name."
+    },
+    "storedProcedureNameParameter": {
+      "name": "storedProcedureName",
+      "in": "path",
+      "required": true,
+      "type": "string",
+      "x-ms-parameter-location": "method",
+      "description": "Cosmos DB storedProcedure name."
+    },
+    "userDefinedFunctionNameParameter": {
+      "name": "userDefinedFunctionName",
+      "in": "path",
+      "required": true,
+      "type": "string",
+      "x-ms-parameter-location": "method",
+      "description": "Cosmos DB userDefinedFunction name."
+    },
+    "triggerNameParameter": {
+      "name": "triggerName",
+      "in": "path",
+      "required": true,
+      "type": "string",
+      "x-ms-parameter-location": "method",
+      "description": "Cosmos DB trigger name."
+    },
+    "tableNameParameter": {
+      "name": "tableName",
+      "in": "path",
+      "required": true,
+      "type": "string",
+      "x-ms-parameter-location": "method",
+      "description": "Cosmos DB table name."
+    },
+    "collectionNameParameter": {
+      "name": "collectionName",
+      "in": "path",
+      "required": true,
+      "type": "string",
+      "x-ms-parameter-location": "method",
+      "description": "Cosmos DB collection name."
+    },
+    "keyspaceNameParameter": {
+      "name": "keyspaceName",
+      "in": "path",
+      "required": true,
+      "type": "string",
+      "x-ms-parameter-location": "method",
+      "description": "Cosmos DB keyspace name."
+    },
+    "graphNameParameter": {
+      "name": "graphName",
+      "in": "path",
+      "required": true,
+      "type": "string",
+      "x-ms-parameter-location": "method",
+      "description": "Cosmos DB graph name."
+    },
+    "regionParameter": {
+      "name": "region",
+      "in": "path",
+      "required": true,
+      "type": "string",
+      "x-ms-parameter-location": "method",
+      "description": "Cosmos DB region, with spaces between words and each word capitalized."
+    },
+    "sourceRegionParameter": {
+      "name": "sourceRegion",
+      "in": "path",
+      "required": true,
+      "type": "string",
+      "x-ms-parameter-location": "method",
+      "description": "Source region from which data is written. Cosmos DB region, with spaces between words and each word capitalized."
+    },
+    "targetRegionParameter": {
+      "name": "targetRegion",
+      "in": "path",
+      "required": true,
+      "type": "string",
+      "x-ms-parameter-location": "method",
+      "description": "Target region to which data is written. Cosmos DB region, with spaces between words and each word capitalized."
+    },
+    "partitionKeyRangeIdParameter": {
+      "name": "partitionKeyRangeId",
+      "in": "path",
+      "required": true,
+      "type": "string",
+      "x-ms-parameter-location": "method",
+      "description": "Partition Key Range Id for which to get data."
+    }
+  }
+}
diff --git a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBCassandraKeyspaceCreateUpdate.json b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBCassandraKeyspaceCreateUpdate.json
new file mode 100644
index 000000000000..47fb08d20401
--- /dev/null
+++ b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBCassandraKeyspaceCreateUpdate.json
@@ -0,0 +1,36 @@
+{
+  "parameters": {
+    "accountName": "ddb1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-09-01",
+    "subscriptionId": "subid",
+    "keyspaceName": "keyspaceName",
+    "createUpdateCassandraKeyspaceParameters": {
+      "location": "West US",
+      "tags": {},
+      "properties": {
+        "resource": {
+          "id": "keyspaceName"
+        },
+        "options": {}
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.DocumentDB/databaseAccounts/ddb1/cassandraKeyspaces/keyspaceName",
+        "name": "keyspaceName",
+        "type": "Microsoft.DocumentDB/databaseAccounts/cassandraKeyspaces",
+        "location": "West US",
+        "tags": {},
+        "properties": {
+          "resource": {
+            "id": "keyspaceName"
+          }
+        }
+      }
+    },
+    "202": {}
+  }
+}
diff --git a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBCassandraKeyspaceDelete.json b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBCassandraKeyspaceDelete.json
new file mode 100644
index 000000000000..d8f70b74b7a0
--- /dev/null
+++ b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBCassandraKeyspaceDelete.json
@@ -0,0 +1,13 @@
+{
+  "parameters": {
+    "accountName": "ddb1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-09-01",
+    "subscriptionId": "subid",
+    "keyspaceName": "keyspaceName"
+  },
+  "responses": {
+    "204": {},
+    "202": {}
+  }
+}
diff --git a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBCassandraKeyspaceGet.json b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBCassandraKeyspaceGet.json
new file mode 100644
index 000000000000..95864475fb90
--- /dev/null
+++ b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBCassandraKeyspaceGet.json
@@ -0,0 +1,28 @@
+{
+  "parameters": {
+    "accountName": "ddb1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-09-01",
+    "subscriptionId": "subid",
+    "keyspaceName": "keyspaceName"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.DocumentDB/databaseAccounts/ddb1/cassandraKeyspaces/keyspaceName",
+        "name": "keyspaceName",
+        "type": "Microsoft.DocumentDB/databaseAccounts/cassandraKeyspaces",
+        "location": "West US",
+        "tags": {},
+        "properties": {
+          "resource": {
+            "id": "keyspaceName",
+            "_rid": "PD5DALigDgw=",
+            "_ts": 1459200611,
+            "_etag": "\"00005900-0000-0000-0000-56f9a2630000\""
+          }
+        }
+      }
+    }
+  }
+}
diff --git a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBCassandraKeyspaceList.json b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBCassandraKeyspaceList.json
new file mode 100644
index 000000000000..d7cb043566b9
--- /dev/null
+++ b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBCassandraKeyspaceList.json
@@ -0,0 +1,28 @@
+{
+  "parameters": {
+    "api-version": "2020-09-01",
+    "subscriptionId": "subid",
+    "resourceGroupName": "rgName",
+    "accountName": "ddb1"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.DocumentDB/databaseAccounts/ddb1/cassandraKeyspaces/keyspaceName",
+            "name": "keyspaceName",
+            "type": "Microsoft.DocumentDB/databaseAccounts/cassandraKeyspaces",
+            "location": "West US",
+            "tags": {},
+            "properties": {
+              "resource": {
+                "id": "keyspaceName"
+              }
+            }
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBCassandraKeyspaceMigrateToAutoscale.json b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBCassandraKeyspaceMigrateToAutoscale.json
new file mode 100644
index 000000000000..a55d232ca2e4
--- /dev/null
+++ b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBCassandraKeyspaceMigrateToAutoscale.json
@@ -0,0 +1,29 @@
+{
+  "parameters": {
+    "accountName": "ddb1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-09-01",
+    "subscriptionId": "subid",
+    "keyspaceName": "keyspaceName"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "properties": {
+          "resource": {
+            "throughput": 400,
+            "autoscaleSettings": {
+              "maxThroughput": 4000
+            },
+            "minimumThroughput": "4000",
+            "offerReplacePending": "false",
+            "_rid": "PD5DALigDgw=",
+            "_ts": 1459200611,
+            "_etag": "\"00005900-0000-0000-0000-56f9a2630000\""
+          }
+        }
+      }
+    },
+    "202": {}
+  }
+}
diff --git a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBCassandraKeyspaceMigrateToManualThroughput.json b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBCassandraKeyspaceMigrateToManualThroughput.json
new file mode 100644
index 000000000000..ffbd3024654b
--- /dev/null
+++ b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBCassandraKeyspaceMigrateToManualThroughput.json
@@ -0,0 +1,26 @@
+{
+  "parameters": {
+    "accountName": "ddb1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-09-01",
+    "subscriptionId": "subid",
+    "keyspaceName": "keyspaceName"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "properties": {
+          "resource": {
+            "throughput": 400,
+            "minimumThroughput": "400",
+            "offerReplacePending": "false",
+            "_rid": "PD5DALigDgw=",
+            "_ts": 1459200611,
+            "_etag": "\"00005900-0000-0000-0000-56f9a2630000\""
+          }
+        }
+      }
+    },
+    "202": {}
+  }
+}
diff --git a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBCassandraKeyspaceThroughputGet.json b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBCassandraKeyspaceThroughputGet.json
new file mode 100644
index 000000000000..76eac069b31c
--- /dev/null
+++ b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBCassandraKeyspaceThroughputGet.json
@@ -0,0 +1,30 @@
+{
+  "parameters": {
+    "accountName": "ddb1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-09-01",
+    "subscriptionId": "subid",
+    "keyspaceName": "keyspaceName"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.DocumentDB/databaseAccounts/ddb1/cassandraKeyspaces/keyspaceName/throughputSettings/default",
+        "name": "default",
+        "type": "Microsoft.DocumentDB/databaseAccounts/cassandraKeyspaces/throughputSettings",
+        "location": "West US",
+        "tags": {},
+        "properties": {
+          "resource": {
+            "throughput": 400,
+            "minimumThroughput": "400",
+            "offerReplacePending": "true",
+            "_rid": "PD5DALigDgw=",
+            "_ts": 1459200611,
+            "_etag": "\"00005900-0000-0000-0000-56f9a2630000\""
+          }
+        }
+      }
+    }
+  }
+}
diff --git a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBCassandraKeyspaceThroughputUpdate.json b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBCassandraKeyspaceThroughputUpdate.json
new file mode 100644
index 000000000000..4354443f15ac
--- /dev/null
+++ b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBCassandraKeyspaceThroughputUpdate.json
@@ -0,0 +1,40 @@
+{
+  "parameters": {
+    "accountName": "ddb1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-09-01",
+    "subscriptionId": "subid",
+    "keyspaceName": "keyspaceName",
+    "updateThroughputParameters": {
+      "location": "West US",
+      "tags": {},
+      "properties": {
+        "resource": {
+          "throughput": 400
+        }
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.DocumentDB/databaseAccounts/ddb1/cassandraKeyspaces/keyspaceName/throughputSettings/default",
+        "name": "default",
+        "type": "Microsoft.DocumentDB/databaseAccounts/cassandraKeyspaces/throughputSettings",
+        "location": "West US",
+        "tags": {},
+        "properties": {
+          "resource": {
+            "throughput": 400,
+            "minimumThroughput": "400",
+            "offerReplacePending": "true",
+            "_rid": "PD5DALigDgw=",
+            "_ts": 1459200611,
+            "_etag": "\"00005900-0000-0000-0000-56f9a2630000\""
+          }
+        }
+      }
+    },
+    "202": {}
+  }
+}
diff --git a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBCassandraTableCreateUpdate.json b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBCassandraTableCreateUpdate.json
new file mode 100644
index 000000000000..05aed0225afe
--- /dev/null
+++ b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBCassandraTableCreateUpdate.json
@@ -0,0 +1,77 @@
+{
+  "parameters": {
+    "accountName": "ddb1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-09-01",
+    "subscriptionId": "subid",
+    "keyspaceName": "keyspaceName",
+    "tableName": "tableName",
+    "createUpdateCassandraTableParameters": {
+      "location": "West US",
+      "tags": {},
+      "properties": {
+        "resource": {
+          "id": "tableName",
+          "defaultTtl": 100,
+          "schema": {
+            "columns": [
+              {
+                "name": "columnA",
+                "type": "Ascii"
+              }
+            ],
+            "partitionKeys": [
+              {
+                "name": "columnA"
+              }
+            ],
+            "clusterKeys": [
+              {
+                "name": "columnA",
+                "orderBy": "Asc"
+              }
+            ]
+          }
+        },
+        "options": {}
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.DocumentDB/databaseAccounts/ddb1/cassandraKeyspaces/keyspaceName/cassandraTables/tableName",
+        "name": "tableName",
+        "type": "Microsoft.DocumentDB/databaseAccounts/cassandraKeyspaces/cassandraTables",
+        "location": "West US",
+        "tags": {},
+        "properties": {
+          "resource": {
+            "id": "tableName",
+            "defaultTtl": 100,
+            "schema": {
+              "columns": [
+                {
+                  "name": "columnA",
+                  "type": "Ascii"
+                }
+              ],
+              "partitionKeys": [
+                {
+                  "name": "columnA"
+                }
+              ],
+              "clusterKeys": [
+                {
+                  "name": "columnA",
+                  "orderBy": "Asc"
+                }
+              ]
+            }
+          }
+        }
+      }
+    },
+    "202": {}
+  }
+}
diff --git a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBCassandraTableDelete.json b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBCassandraTableDelete.json
new file mode 100644
index 000000000000..338259d8b9f4
--- /dev/null
+++ b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBCassandraTableDelete.json
@@ -0,0 +1,14 @@
+{
+  "parameters": {
+    "accountName": "ddb1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-09-01",
+    "subscriptionId": "subid",
+    "keyspaceName": "keyspaceName",
+    "tableName": "tableName"
+  },
+  "responses": {
+    "204": {},
+    "202": {}
+  }
+}
diff --git a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBCassandraTableGet.json b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBCassandraTableGet.json
new file mode 100644
index 000000000000..72e0f81ad5de
--- /dev/null
+++ b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBCassandraTableGet.json
@@ -0,0 +1,49 @@
+{
+  "parameters": {
+    "accountName": "ddb1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-09-01",
+    "subscriptionId": "subid",
+    "keyspaceName": "keyspaceName",
+    "tableName": "tableName"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.DocumentDB/databaseAccounts/ddb1/cassandraKeyspaces/keyspaceName/cassandraTables/tableName",
+        "name": "tableName",
+        "type": "Microsoft.DocumentDB/databaseAccounts/cassandraKeyspaces/cassandraTables",
+        "location": "West US",
+        "tags": {},
+        "properties": {
+          "resource": {
+            "id": "tableName",
+            "defaultTtl": 100,
+            "schema": {
+              "columns": [
+                {
+                  "name": "columnA",
+                  "type": "Ascii"
+                }
+              ],
+              "partitionKeys": [
+                {
+                  "name": "columnA"
+                }
+              ],
+              "clusterKeys": [
+                {
+                  "name": "columnA",
+                  "orderBy": "Asc"
+                }
+              ]
+            },
+            "_rid": "PD5DALigDgw=",
+            "_ts": 1459200611,
+            "_etag": "\"00005900-0000-0000-0000-56f9a2630000\""
+          }
+        }
+      }
+    }
+  }
+}
diff --git a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBCassandraTableList.json b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBCassandraTableList.json
new file mode 100644
index 000000000000..27073d47d041
--- /dev/null
+++ b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBCassandraTableList.json
@@ -0,0 +1,49 @@
+{
+  "parameters": {
+    "api-version": "2020-09-01",
+    "subscriptionId": "subid",
+    "resourceGroupName": "rgName",
+    "accountName": "ddb1",
+    "keyspaceName": "keyspaceName"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.DocumentDB/databaseAccounts/ddb1/cassandraKeyspaces/keyspaceName/cassandraTables/tableName",
+            "name": "tableName",
+            "type": "Microsoft.DocumentDB/databaseAccounts/cassandraKeyspaces/cassandraTables",
+            "location": "West US",
+            "tags": {},
+            "properties": {
+              "resource": {
+                "id": "tableName",
+                "defaultTtl": 100,
+                "schema": {
+                  "columns": [
+                    {
+                      "name": "columnA",
+                      "type": "Ascii"
+                    }
+                  ],
+                  "partitionKeys": [
+                    {
+                      "name": "columnA"
+                    }
+                  ],
+                  "clusterKeys": [
+                    {
+                      "name": "columnA",
+                      "orderBy": "Asc"
+                    }
+                  ]
+                }
+              }
+            }
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBCassandraTableMigrateToAutoscale.json b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBCassandraTableMigrateToAutoscale.json
new file mode 100644
index 000000000000..f15c72d9d182
--- /dev/null
+++ b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBCassandraTableMigrateToAutoscale.json
@@ -0,0 +1,30 @@
+{
+  "parameters": {
+    "accountName": "ddb1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-09-01",
+    "subscriptionId": "subid",
+    "keyspaceName": "keyspaceName",
+    "tableName": "tableName"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "properties": {
+          "resource": {
+            "throughput": 400,
+            "autoscaleSettings": {
+              "maxThroughput": 4000
+            },
+            "minimumThroughput": "4000",
+            "offerReplacePending": "false",
+            "_rid": "PD5DALigDgw=",
+            "_ts": 1459200611,
+            "_etag": "\"00005900-0000-0000-0000-56f9a2630000\""
+          }
+        }
+      }
+    },
+    "202": {}
+  }
+}
diff --git a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBCassandraTableMigrateToManualThroughput.json b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBCassandraTableMigrateToManualThroughput.json
new file mode 100644
index 000000000000..ae5b827c638a
--- /dev/null
+++ b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBCassandraTableMigrateToManualThroughput.json
@@ -0,0 +1,27 @@
+{
+  "parameters": {
+    "accountName": "ddb1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-09-01",
+    "subscriptionId": "subid",
+    "keyspaceName": "keyspaceName",
+    "tableName": "tableName"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "properties": {
+          "resource": {
+            "throughput": 400,
+            "minimumThroughput": "400",
+            "offerReplacePending": "false",
+            "_rid": "PD5DALigDgw=",
+            "_ts": 1459200611,
+            "_etag": "\"00005900-0000-0000-0000-56f9a2630000\""
+          }
+        }
+      }
+    },
+    "202": {}
+  }
+}
diff --git a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBCassandraTableThroughputGet.json b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBCassandraTableThroughputGet.json
new file mode 100644
index 000000000000..4613befe65bf
--- /dev/null
+++ b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBCassandraTableThroughputGet.json
@@ -0,0 +1,31 @@
+{
+  "parameters": {
+    "accountName": "ddb1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-09-01",
+    "subscriptionId": "subid",
+    "keyspaceName": "keyspaceName",
+    "tableName": "tableName"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.DocumentDB/databaseAccounts/ddb1/cassandraKeyspaces/keyspaceName/cassandraTables/tableName/throughputSettings/default",
+        "name": "default",
+        "type": "Microsoft.DocumentDB/databaseAccounts/cassandraKeyspaces/cassandraTables/throughputSettings",
+        "location": "West US",
+        "tags": {},
+        "properties": {
+          "resource": {
+            "throughput": 400,
+            "minimumThroughput": "400",
+            "offerReplacePending": "true",
+            "_rid": "PD5DALigDgw=",
+            "_ts": 1459200611,
+            "_etag": "\"00005900-0000-0000-0000-56f9a2630000\""
+          }
+        }
+      }
+    }
+  }
+}
diff --git a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBCassandraTableThroughputUpdate.json b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBCassandraTableThroughputUpdate.json
new file mode 100644
index 000000000000..a9efe7818fa3
--- /dev/null
+++ b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBCassandraTableThroughputUpdate.json
@@ -0,0 +1,39 @@
+{
+  "parameters": {
+    "accountName": "ddb1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-09-01",
+    "subscriptionId": "subid",
+    "keyspaceName": "keyspaceName",
+    "tableName": "tableName",
+    "updateThroughputParameters": {
+      "location": "West US",
+      "tags": {},
+      "properties": {
+        "resource": {
+          "throughput": 400
+        }
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.DocumentDB/databaseAccounts/ddb1/cassandraKeyspaces/keyspaceName/cassandraTables/tableName/throughputSettings/default",
+        "name": "default",
+        "type": "Microsoft.DocumentDB/databaseAccounts/cassandraKeyspaces/cassandraTables/throughputSettings",
+        "properties": {
+          "resource": {
+            "throughput": 400,
+            "minimumThroughput": "400",
+            "offerReplacePending": "true",
+            "_rid": "PD5DALigDgw=",
+            "_ts": 1459200611,
+            "_etag": "\"00005900-0000-0000-0000-56f9a2630000\""
+          }
+        }
+      }
+    },
+    "202": {}
+  }
+}
diff --git a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBCollectionGetMetricDefinitions.json b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBCollectionGetMetricDefinitions.json
new file mode 100644
index 000000000000..24bfa2f06287
--- /dev/null
+++ b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBCollectionGetMetricDefinitions.json
@@ -0,0 +1,41 @@
+{
+  "parameters": {
+    "accountName": "ddb1",
+    "resourceGroupName": "rg1",
+    "subscriptionId": "subid",
+    "api-version": "2020-09-01",
+    "databaseRid": "databaseRid",
+    "collectionRid": "collectionRid"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "metricAvailabilities": [
+              {
+                "timeGrain": "PT5M",
+                "retention": "P2D"
+              },
+              {
+                "timeGrain": "PT1H",
+                "retention": "P14D"
+              },
+              {
+                "timeGrain": "P1D",
+                "retention": "P60D"
+              }
+            ],
+            "primaryAggregationType": "Total",
+            "unit": "Count",
+            "resourceUri": "/subscriptions/subId/resourceGroups/rg1/providers/Microsoft.DocumentDB/databaseAccounts/ddb1",
+            "name": {
+              "value": "Total Requests",
+              "localizedValue": "Total Requests"
+            }
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBCollectionGetMetrics.json b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBCollectionGetMetrics.json
new file mode 100644
index 000000000000..ce429f69dc9b
--- /dev/null
+++ b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBCollectionGetMetrics.json
@@ -0,0 +1,55 @@
+{
+  "parameters": {
+    "accountName": "ddb1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-09-01",
+    "subscriptionId": "subid",
+    "databaseRid": "databaseRid",
+    "collectionRid": "collectionRid",
+    "$filter": "$filter=(name.value eq 'Total Requests') and timeGrain eq duration'PT5M' and startTime eq '2017-11-19T23:53:55.2780000Z' and endTime eq '2017-11-20T00:13:55.2780000Z"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "timeGrain": "PT5M",
+            "startTime": "2017-11-19T23:53:55.2780000Z",
+            "endTime": "2017-11-20T00:13:55.2780000Z",
+            "unit": "Count",
+            "metricValues": [
+              {
+                "timestamp": "2017-11-19T23:53:55.2780000Z",
+                "total": 0,
+                "_count": 0,
+                "average": 0
+              },
+              {
+                "timestamp": "2017-11-19T23:58:55.2780000Z",
+                "total": 0,
+                "_count": 0,
+                "average": 0
+              },
+              {
+                "timestamp": "2017-11-20T00:03:55.2780000Z",
+                "total": 0,
+                "_count": 0,
+                "average": 0
+              },
+              {
+                "timestamp": "2017-11-20T00:08:55.2780000Z",
+                "total": 0,
+                "_count": 0,
+                "average": 0
+              }
+            ],
+            "name": {
+              "value": "Total Requests",
+              "localizedValue": "Total Requests"
+            }
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBCollectionGetUsages.json b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBCollectionGetUsages.json
new file mode 100644
index 000000000000..4fb2fe2935c6
--- /dev/null
+++ b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBCollectionGetUsages.json
@@ -0,0 +1,29 @@
+{
+  "parameters": {
+    "accountName": "ddb1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-09-01",
+    "databaseRid": "databaseRid",
+    "collectionRid": "collectionRid",
+    "subscriptionId": "subid",
+    "$filter": "$filter=name.value eq 'Storage'"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "unit": "Bytes",
+            "quotaPeriod": "P1D",
+            "limit": 10737418240,
+            "currentValue": 0,
+            "name": {
+              "value": "Storage",
+              "localizedValue": "Storage"
+            }
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBCollectionPartitionGetMetrics.json b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBCollectionPartitionGetMetrics.json
new file mode 100644
index 000000000000..d561cfff9401
--- /dev/null
+++ b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBCollectionPartitionGetMetrics.json
@@ -0,0 +1,57 @@
+{
+  "parameters": {
+    "accountName": "ddb1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-09-01",
+    "subscriptionId": "subid",
+    "databaseRid": "databaseRid",
+    "collectionRid": "collectionRid",
+    "$filter": "$filter=(name.value eq 'Max RUs Per Second') and timeGrain eq duration'PT1M' and startTime eq '2017-11-19T23:53:55.2780000Z' and endTime eq '2017-11-20T23:58:55.2780000Z"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "timeGrain": "PT1M",
+            "startTime": "2017-11-19T23:53:55.2780000Z",
+            "endTime": "2017-11-20T23:58:55.2780000Z",
+            "unit": "Count",
+            "partitionId": "00000000-0000-0000-0000-000000000000",
+            "partitionKeyRangeId": "0",
+            "metricValues": [
+              {
+                "timestamp": "2017-11-19T23:53:55.2780000Z",
+                "maximum": 5
+              },
+              {
+                "timestamp": "2017-11-19T23:54:55.2780000Z",
+                "maximum": 5
+              },
+              {
+                "timestamp": "2017-11-19T23:55:55.2780000Z",
+                "maximum": 5
+              },
+              {
+                "timestamp": "2017-11-19T23:56:55.2780000Z",
+                "maximum": 5
+              },
+              {
+                "timestamp": "2017-11-19T23:57:55.2780000Z",
+                "maximum": 5
+              },
+              {
+                "timestamp": "2017-11-19T23:58:55.2780000Z",
+                "maximum": 5
+              }
+            ],
+            "name": {
+              "value": "Max RUs Per Second",
+              "localizedValue": "Max RUs Per Second"
+            }
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBCollectionPartitionGetUsages.json b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBCollectionPartitionGetUsages.json
new file mode 100644
index 000000000000..3bbc3b98f5eb
--- /dev/null
+++ b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBCollectionPartitionGetUsages.json
@@ -0,0 +1,31 @@
+{
+  "parameters": {
+    "accountName": "ddb1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-09-01",
+    "databaseRid": "databaseRid",
+    "collectionRid": "collectionRid",
+    "subscriptionId": "subid",
+    "$filter": "$filter=name.value eq 'Partition Storage'"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "unit": "Bytes",
+            "quotaPeriod": "P1D",
+            "limit": 10737418240,
+            "currentValue": 0,
+            "partitionId": "00000000-0000-0000-0000-000000000000",
+            "partitionKeyRangeId": "0",
+            "name": {
+              "value": "Storage",
+              "localizedValue": "Storage"
+            }
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBCollectionPartitionRegionGetMetrics.json b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBCollectionPartitionRegionGetMetrics.json
new file mode 100644
index 000000000000..96527de4c2a0
--- /dev/null
+++ b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBCollectionPartitionRegionGetMetrics.json
@@ -0,0 +1,58 @@
+{
+  "parameters": {
+    "accountName": "ddb1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-09-01",
+    "subscriptionId": "subid",
+    "databaseRid": "databaseRid",
+    "collectionRid": "collectionRid",
+    "region": "North Europe",
+    "$filter": "$filter=(name.value eq 'Max RUs Per Second') and timeGrain eq duration'PT1M' and startTime eq '2017-11-19T23:53:55.2780000Z' and endTime eq '2017-11-20T23:58:55.2780000Z"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "timeGrain": "PT1M",
+            "startTime": "2017-11-19T23:53:55.2780000Z",
+            "endTime": "2017-11-20T23:58:55.2780000Z",
+            "unit": "Count",
+            "partitionId": "00000000-0000-0000-0000-000000000000",
+            "partitionKeyRangeId": "0",
+            "metricValues": [
+              {
+                "timestamp": "2017-11-19T23:53:55.2780000Z",
+                "maximum": 5
+              },
+              {
+                "timestamp": "2017-11-19T23:54:55.2780000Z",
+                "maximum": 5
+              },
+              {
+                "timestamp": "2017-11-19T23:55:55.2780000Z",
+                "maximum": 5
+              },
+              {
+                "timestamp": "2017-11-19T23:56:55.2780000Z",
+                "maximum": 5
+              },
+              {
+                "timestamp": "2017-11-19T23:57:55.2780000Z",
+                "maximum": 5
+              },
+              {
+                "timestamp": "2017-11-19T23:58:55.2780000Z",
+                "maximum": 5
+              }
+            ],
+            "name": {
+              "value": "Max RUs Per Second",
+              "localizedValue": "Max RUs Per Second"
+            }
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBDatabaseAccountCheckNameExists.json b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBDatabaseAccountCheckNameExists.json
new file mode 100644
index 000000000000..f57283993261
--- /dev/null
+++ b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBDatabaseAccountCheckNameExists.json
@@ -0,0 +1,10 @@
+{
+  "parameters": {
+    "accountName": "ddb1",
+    "api-version": "2020-09-01"
+  },
+  "responses": {
+    "200": {},
+    "404": {}
+  }
+}
diff --git a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBDatabaseAccountCreateMax.json b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBDatabaseAccountCreateMax.json
new file mode 100644
index 000000000000..66941f61e922
--- /dev/null
+++ b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBDatabaseAccountCreateMax.json
@@ -0,0 +1,173 @@
+{
+  "parameters": {
+    "accountName": "ddb1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-09-01",
+    "subscriptionId": "subid",
+    "createUpdateParameters": {
+      "location": "westus",
+      "tags": {},
+      "kind": "MongoDB",
+      "properties": {
+        "databaseAccountOfferType": "Standard",
+        "ipRules": [
+          {
+            "ipAddressOrRange": "23.43.230.120"
+          },
+          {
+            "ipAddressOrRange": "110.12.240.0/12"
+          }
+        ],
+        "isVirtualNetworkFilterEnabled": true,
+        "virtualNetworkRules": [
+          {
+            "id": "/subscriptions/subId/resourceGroups/rg/providers/Microsoft.Network/virtualNetworks/vnet1/subnets/subnet1",
+            "ignoreMissingVNetServiceEndpoint": false
+          }
+        ],
+        "locations": [
+          {
+            "failoverPriority": 0,
+            "locationName": "southcentralus",
+            "isZoneRedundant": false
+          },
+          {
+            "failoverPriority": 1,
+            "locationName": "eastus",
+            "isZoneRedundant": false
+          }
+        ],
+        "consistencyPolicy": {
+          "defaultConsistencyLevel": "BoundedStaleness",
+          "maxIntervalInSeconds": 10,
+          "maxStalenessPrefix": 200
+        },
+        "keyVaultKeyUri": "https://myKeyVault.vault.azure.net",
+        "enableFreeTier": false,
+        "apiProperties": {
+          "serverVersion": "3.2"
+        },
+        "enableAnalyticalStorage": true,
+        "backupPolicy": {
+          "type": "Periodic",
+          "periodicModeProperties": {
+            "backupIntervalInMinutes": 240,
+            "backupRetentionIntervalInHours": 8
+          }
+        },
+        "cors": [
+          {
+            "allowedOrigins": "https://test"
+          }
+        ]
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.DocumentDB/databaseAccounts/ddb1",
+        "name": "ddb1",
+        "location": "West US",
+        "type": "Microsoft.DocumentDB/databaseAccounts",
+        "kind": "MongoDB",
+        "tags": {},
+        "properties": {
+          "provisioningState": "Initializing",
+          "isVirtualNetworkFilterEnabled": true,
+          "databaseAccountOfferType": "Standard",
+          "disableKeyBasedMetadataWriteAccess": false,
+          "consistencyPolicy": {
+            "defaultConsistencyLevel": "BoundedStaleness",
+            "maxIntervalInSeconds": 10,
+            "maxStalenessPrefix": 200
+          },
+          "writeLocations": [
+            {
+              "id": "ddb1-southcentralus",
+              "locationName": "South Central US",
+              "provisioningState": "Initializing",
+              "failoverPriority": 0,
+              "isZoneRedundant": false
+            }
+          ],
+          "readLocations": [
+            {
+              "id": "ddb1-southcentralus",
+              "locationName": "South Central US",
+              "provisioningState": "Initializing",
+              "failoverPriority": 0,
+              "isZoneRedundant": false
+            },
+            {
+              "id": "ddb1-eastus",
+              "locationName": "East US",
+              "provisioningState": "Initializing",
+              "failoverPriority": 1,
+              "isZoneRedundant": false
+            }
+          ],
+          "locations": [
+            {
+              "id": "ddb1-southcentralus",
+              "locationName": "South Central US",
+              "provisioningState": "Initializing",
+              "failoverPriority": 0,
+              "isZoneRedundant": false
+            },
+            {
+              "id": "ddb1-eastus",
+              "locationName": "East US",
+              "provisioningState": "Initializing",
+              "failoverPriority": 1,
+              "isZoneRedundant": false
+            }
+          ],
+          "failoverPolicies": [
+            {
+              "id": "ddb1-southcentralus",
+              "locationName": "South Central US",
+              "failoverPriority": 0
+            },
+            {
+              "id": "ddb1-eastus",
+              "locationName": "East US",
+              "failoverPriority": 1
+            }
+          ],
+          "virtualNetworkRules": [
+            {
+              "id": "/subscriptions/subId/resourceGroups/rg/providers/Microsoft.Network/virtualNetworks/vnet1/subnets/subnet1"
+            }
+          ],
+          "keyVaultKeyUri": "https://myKeyVault.vault.azure.net",
+          "enableFreeTier": false,
+          "ipRules": [
+            {
+              "ipAddressOrRange": "23.43.230.120"
+            },
+            {
+              "ipAddressOrRange": "110.12.240.0/12"
+            }
+          ],
+          "apiProperties": {
+            "serverVersion": "3.2"
+          },
+          "enableAnalyticalStorage": true,
+          "backupPolicy": {
+            "type": "Periodic",
+            "periodicModeProperties": {
+              "backupIntervalInMinutes": 240,
+              "backupRetentionIntervalInHours": 8
+            }
+          },
+          "cors": [
+            {
+              "allowedOrigins": "https://test"
+            }
+          ]
+        }
+      }
+    }
+  }
+}
diff --git a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBDatabaseAccountCreateMin.json b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBDatabaseAccountCreateMin.json
new file mode 100644
index 000000000000..2bd56832c535
--- /dev/null
+++ b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBDatabaseAccountCreateMin.json
@@ -0,0 +1,82 @@
+{
+  "parameters": {
+    "accountName": "ddb1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-09-01",
+    "subscriptionId": "subid",
+    "createUpdateParameters": {
+      "location": "westus",
+      "properties": {
+        "databaseAccountOfferType": "Standard",
+        "locations": [
+          {
+            "failoverPriority": 0,
+            "locationName": "southcentralus",
+            "isZoneRedundant": false
+          }
+        ]
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.DocumentDB/databaseAccounts/ddb1",
+        "name": "ddb1",
+        "location": "West US",
+        "type": "Microsoft.DocumentDB/databaseAccounts",
+        "kind": "GlobalDocumentDB",
+        "tags": {},
+        "properties": {
+          "provisioningState": "Initializing",
+          "ipRules": [],
+          "databaseAccountOfferType": "Standard",
+          "disableKeyBasedMetadataWriteAccess": false,
+          "consistencyPolicy": {
+            "defaultConsistencyLevel": "Session",
+            "maxIntervalInSeconds": 5,
+            "maxStalenessPrefix": 100
+          },
+          "writeLocations": [
+            {
+              "id": "ddb1-southcentralus",
+              "locationName": "South Central US",
+              "provisioningState": "Initializing",
+              "failoverPriority": 0,
+              "isZoneRedundant": false
+            }
+          ],
+          "readLocations": [
+            {
+              "id": "ddb1-southcentralus",
+              "locationName": "South Central US",
+              "provisioningState": "Initializing",
+              "failoverPriority": 0,
+              "isZoneRedundant": false
+            }
+          ],
+          "locations": [
+            {
+              "id": "ddb1-southcentralus",
+              "locationName": "South Central US",
+              "provisioningState": "Initializing",
+              "failoverPriority": 0,
+              "isZoneRedundant": false
+            }
+          ],
+          "failoverPolicies": [
+            {
+              "id": "ddb1-southcentralus",
+              "locationName": "South Central US",
+              "failoverPriority": 0
+            }
+          ],
+          "cors": [],
+          "enableFreeTier": false,
+          "apiProperties": {},
+          "enableAnalyticalStorage": false
+        }
+      }
+    }
+  }
+}
diff --git a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBDatabaseAccountDelete.json b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBDatabaseAccountDelete.json
new file mode 100644
index 000000000000..ec95b38afb2b
--- /dev/null
+++ b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBDatabaseAccountDelete.json
@@ -0,0 +1,12 @@
+{
+  "parameters": {
+    "accountName": "ddb1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-09-01",
+    "subscriptionId": "subid"
+  },
+  "responses": {
+    "202": {},
+    "204": {}
+  }
+}
diff --git a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBDatabaseAccountFailoverPriorityChange.json b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBDatabaseAccountFailoverPriorityChange.json
new file mode 100644
index 000000000000..1354b4e1da60
--- /dev/null
+++ b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBDatabaseAccountFailoverPriorityChange.json
@@ -0,0 +1,24 @@
+{
+  "parameters": {
+    "accountName": "ddb1-failover",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-09-01",
+    "subscriptionId": "subid",
+    "failoverParameters": {
+      "failoverPolicies": [
+        {
+          "locationName": "eastus",
+          "failoverPriority": 0
+        },
+        {
+          "locationName": "westus",
+          "failoverPriority": 1
+        }
+      ]
+    }
+  },
+  "responses": {
+    "202": {},
+    "204": {}
+  }
+}
diff --git a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBDatabaseAccountGet.json b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBDatabaseAccountGet.json
new file mode 100644
index 000000000000..d2fc55846856
--- /dev/null
+++ b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBDatabaseAccountGet.json
@@ -0,0 +1,93 @@
+{
+  "parameters": {
+    "accountName": "ddb1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-09-01",
+    "subscriptionId": "subid"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.DocumentDB/databaseAccounts/ddb1",
+        "name": "ddb1",
+        "location": "West US",
+        "type": "Microsoft.DocumentDB/databaseAccounts",
+        "kind": "GlobalDocumentDB",
+        "tags": {},
+        "properties": {
+          "provisioningState": "Succeeded",
+          "documentEndpoint": "https://ddb1.documents.azure.com:443/",
+          "ipRules": [],
+          "isVirtualNetworkFilterEnabled": false,
+          "virtualNetworkRules": [],
+          "databaseAccountOfferType": "Standard",
+          "disableKeyBasedMetadataWriteAccess": false,
+          "consistencyPolicy": {
+            "defaultConsistencyLevel": "Session",
+            "maxIntervalInSeconds": 5,
+            "maxStalenessPrefix": 100
+          },
+          "writeLocations": [
+            {
+              "id": "ddb1-eastus",
+              "locationName": "East US",
+              "documentEndpoint": "https://ddb1-eastus.documents.azure.com:443/",
+              "provisioningState": "Succeeded",
+              "failoverPriority": 0
+            }
+          ],
+          "readLocations": [
+            {
+              "id": "ddb1-eastus",
+              "locationName": "East US",
+              "documentEndpoint": "https://ddb1-eastus.documents.azure.com:443/",
+              "provisioningState": "Succeeded",
+              "failoverPriority": 0
+            }
+          ],
+          "locations": [
+            {
+              "id": "ddb1-eastus",
+              "locationName": "East US",
+              "documentEndpoint": "https://ddb1-eastus.documents.azure.com:443/",
+              "provisioningState": "Succeeded",
+              "failoverPriority": 0
+            }
+          ],
+          "failoverPolicies": [
+            {
+              "id": "ddb1-eastus",
+              "locationName": "East US",
+              "failoverPriority": 0
+            }
+          ],
+          "privateEndpointConnections": [
+            {
+              "id": "/subscriptions/subId/resourceGroups/rg/providers/Microsoft.DocumentDB/databaseAccounts/account1/privateEndpointConnections/pe1",
+              "properties": {
+                "privateEndpoint": {
+                  "id": "/subscriptions/subId/resourceGroups/rg/providers/Microsoft.Network/privateEndpoints/pe1"
+                },
+                "privateLinkServiceConnectionState": {
+                  "status": "Approved",
+                  "actionsRequired": "None"
+                }
+              }
+            }
+          ],
+          "cors": [],
+          "enableFreeTier": false,
+          "apiProperties": {},
+          "enableAnalyticalStorage": true,
+          "backupPolicy": {
+            "type": "Periodic",
+            "periodicModeProperties": {
+              "backupIntervalInMinutes": 240,
+              "backupRetentionIntervalInHours": 8
+            }
+          }
+        }
+      }
+    }
+  }
+}
diff --git a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBDatabaseAccountGetMetricDefinitions.json b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBDatabaseAccountGetMetricDefinitions.json
new file mode 100644
index 000000000000..7d8c635419d3
--- /dev/null
+++ b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBDatabaseAccountGetMetricDefinitions.json
@@ -0,0 +1,39 @@
+{
+  "parameters": {
+    "accountName": "ddb1",
+    "resourceGroupName": "rg1",
+    "subscriptionId": "subid",
+    "api-version": "2020-09-01"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "metricAvailabilities": [
+              {
+                "timeGrain": "PT5M",
+                "retention": "P2D"
+              },
+              {
+                "timeGrain": "PT1H",
+                "retention": "P14D"
+              },
+              {
+                "timeGrain": "P1D",
+                "retention": "P60D"
+              }
+            ],
+            "primaryAggregationType": "Total",
+            "unit": "Count",
+            "resourceUri": "/subscriptions/subId/resourceGroups/rg1/providers/Microsoft.DocumentDB/databaseAccounts/ddb1",
+            "name": {
+              "value": "Total Requests",
+              "localizedValue": "Total Requests"
+            }
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBDatabaseAccountGetMetrics.json b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBDatabaseAccountGetMetrics.json
new file mode 100644
index 000000000000..8055fa54f5ac
--- /dev/null
+++ b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBDatabaseAccountGetMetrics.json
@@ -0,0 +1,53 @@
+{
+  "parameters": {
+    "accountName": "ddb1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-09-01",
+    "subscriptionId": "subid",
+    "$filter": "$filter=(name.value eq 'Total Requests') and timeGrain eq duration'PT5M' and startTime eq '2017-11-19T23:53:55.2780000Z' and endTime eq '2017-11-20T00:13:55.2780000Z"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "timeGrain": "PT5M",
+            "startTime": "2017-11-19T23:53:55.2780000Z",
+            "endTime": "2017-11-20T00:13:55.2780000Z",
+            "unit": "Count",
+            "metricValues": [
+              {
+                "timestamp": "2017-11-19T23:53:55.2780000Z",
+                "total": 0,
+                "_count": 0,
+                "average": 0
+              },
+              {
+                "timestamp": "2017-11-19T23:58:55.2780000Z",
+                "total": 0,
+                "_count": 0,
+                "average": 0
+              },
+              {
+                "timestamp": "2017-11-20T00:03:55.2780000Z",
+                "total": 0,
+                "_count": 0,
+                "average": 0
+              },
+              {
+                "timestamp": "2017-11-20T00:08:55.2780000Z",
+                "total": 0,
+                "_count": 0,
+                "average": 0
+              }
+            ],
+            "name": {
+              "value": "Total Requests",
+              "localizedValue": "Total Requests"
+            }
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBDatabaseAccountGetUsages.json b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBDatabaseAccountGetUsages.json
new file mode 100644
index 000000000000..60d1c031ab81
--- /dev/null
+++ b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBDatabaseAccountGetUsages.json
@@ -0,0 +1,27 @@
+{
+  "parameters": {
+    "accountName": "ddb1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-09-01",
+    "subscriptionId": "subid",
+    "$filter": "$filter=name.value eq 'Storage'"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "unit": "Bytes",
+            "quotaPeriod": "P1D",
+            "limit": 10737418240,
+            "currentValue": 0,
+            "name": {
+              "value": "Storage",
+              "localizedValue": "Storage"
+            }
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBDatabaseAccountList.json b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBDatabaseAccountList.json
new file mode 100644
index 000000000000..bdf916d30a10
--- /dev/null
+++ b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBDatabaseAccountList.json
@@ -0,0 +1,86 @@
+{
+  "parameters": {
+    "api-version": "2020-09-01",
+    "subscriptionId": "subid"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.DocumentDB/databaseAccounts/ddb1",
+            "name": "ddb1",
+            "location": "West US",
+            "type": "Microsoft.DocumentDB/databaseAccounts",
+            "kind": "GlobalDocumentDB",
+            "tags": {},
+            "properties": {
+              "provisioningState": "Succeeded",
+              "documentEndpoint": "https://ddb1.documents.azure.com:443/",
+              "ipRules": [],
+              "databaseAccountOfferType": "Standard",
+              "disableKeyBasedMetadataWriteAccess": false,
+              "consistencyPolicy": {
+                "defaultConsistencyLevel": "Session",
+                "maxIntervalInSeconds": 5,
+                "maxStalenessPrefix": 100
+              },
+              "writeLocations": [
+                {
+                  "id": "ddb1-eastus",
+                  "locationName": "East US",
+                  "documentEndpoint": "https://ddb1-eastus.documents.azure.com:443/",
+                  "provisioningState": "Succeeded",
+                  "failoverPriority": 0
+                }
+              ],
+              "readLocations": [
+                {
+                  "id": "ddb1-eastus",
+                  "locationName": "East US",
+                  "documentEndpoint": "https://ddb1-eastus.documents.azure.com:443/",
+                  "provisioningState": "Succeeded",
+                  "failoverPriority": 0
+                }
+              ],
+              "locations": [
+                {
+                  "id": "ddb1-eastus",
+                  "locationName": "East US",
+                  "documentEndpoint": "https://ddb1-eastus.documents.azure.com:443/",
+                  "provisioningState": "Succeeded",
+                  "failoverPriority": 0
+                }
+              ],
+              "failoverPolicies": [
+                {
+                  "id": "ddb1-eastus",
+                  "locationName": "East US",
+                  "failoverPriority": 0
+                }
+              ],
+              "privateEndpointConnections": [
+                {
+                  "id": "/subscriptions/subId/resourceGroups/rg/providers/Microsoft.DocumentDB/databaseAccounts/account1/privateEndpointConnections/pe1",
+                  "properties": {
+                    "privateEndpoint": {
+                      "id": "/subscriptions/subId/resourceGroups/rg/providers/Microsoft.Network/privateEndpoints/pe1"
+                    },
+                    "privateLinkServiceConnectionState": {
+                      "status": "Approved",
+                      "actionsRequired": "None"
+                    }
+                  }
+                }
+              ],
+              "cors": [],
+              "enableFreeTier": false,
+              "apiProperties": {},
+              "enableAnalyticalStorage": true
+            }
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBDatabaseAccountListByResourceGroup.json b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBDatabaseAccountListByResourceGroup.json
new file mode 100644
index 000000000000..5a9a682d9b88
--- /dev/null
+++ b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBDatabaseAccountListByResourceGroup.json
@@ -0,0 +1,71 @@
+{
+  "parameters": {
+    "api-version": "2020-09-01",
+    "resourceGroupName": "rg1",
+    "subscriptionId": "subid"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.DocumentDB/databaseAccounts/ddb1",
+            "name": "ddb1",
+            "location": "West US",
+            "type": "Microsoft.DocumentDB/databaseAccounts",
+            "kind": "GlobalDocumentDB",
+            "tags": {},
+            "properties": {
+              "provisioningState": "Succeeded",
+              "documentEndpoint": "https://ddb1.documents.azure.com:443/",
+              "ipRules": [],
+              "databaseAccountOfferType": "Standard",
+              "disableKeyBasedMetadataWriteAccess": false,
+              "consistencyPolicy": {
+                "defaultConsistencyLevel": "Session",
+                "maxIntervalInSeconds": 5,
+                "maxStalenessPrefix": 100
+              },
+              "writeLocations": [
+                {
+                  "id": "ddb1-eastus",
+                  "locationName": "East US",
+                  "documentEndpoint": "https://ddb1-eastus.documents.azure.com:443/",
+                  "provisioningState": "Succeeded",
+                  "failoverPriority": 0
+                }
+              ],
+              "readLocations": [
+                {
+                  "id": "ddb1-eastus",
+                  "locationName": "East US",
+                  "documentEndpoint": "https://ddb1-eastus.documents.azure.com:443/",
+                  "provisioningState": "Succeeded",
+                  "failoverPriority": 0
+                }
+              ],
+              "locations": [
+                {
+                  "id": "ddb1-eastus",
+                  "locationName": "East US",
+                  "documentEndpoint": "https://ddb1-eastus.documents.azure.com:443/",
+                  "provisioningState": "Succeeded",
+                  "failoverPriority": 0
+                }
+              ],
+              "failoverPolicies": [
+                {
+                  "id": "ddb1-eastus",
+                  "locationName": "East US",
+                  "failoverPriority": 0
+                }
+              ],
+              "cors": [],
+              "enableFreeTier": false
+            }
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBDatabaseAccountListConnectionStrings.json b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBDatabaseAccountListConnectionStrings.json
new file mode 100644
index 000000000000..a7e19fb33847
--- /dev/null
+++ b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBDatabaseAccountListConnectionStrings.json
@@ -0,0 +1,13 @@
+{
+  "parameters": {
+    "accountName": "ddb1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-09-01",
+    "subscriptionId": "subid"
+  },
+  "responses": {
+    "200": {
+      "body": {}
+    }
+  }
+}
diff --git a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBDatabaseAccountListConnectionStringsMongo.json b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBDatabaseAccountListConnectionStringsMongo.json
new file mode 100644
index 000000000000..4c5b2510e63e
--- /dev/null
+++ b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBDatabaseAccountListConnectionStringsMongo.json
@@ -0,0 +1,20 @@
+{
+  "parameters": {
+    "accountName": "mongo-ddb1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-09-01",
+    "subscriptionId": "subid"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "connectionStrings": [
+          {
+            "connectionString": "connection-string",
+            "description": "Name of the connection string"
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBDatabaseAccountListKeys.json b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBDatabaseAccountListKeys.json
new file mode 100644
index 000000000000..e3f934716bb9
--- /dev/null
+++ b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBDatabaseAccountListKeys.json
@@ -0,0 +1,18 @@
+{
+  "parameters": {
+    "accountName": "ddb1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-09-01",
+    "subscriptionId": "subid"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "primaryMasterKey": "primaryMasterKey",
+        "secondaryMasterKey": "secondaryMasterKey",
+        "primaryReadonlyMasterKey": "primaryReadonlyMasterKey",
+        "secondaryReadonlyMasterKey": "secondaryReadonlyMasterKey"
+      }
+    }
+  }
+}
diff --git a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBDatabaseAccountListReadOnlyKeys.json b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBDatabaseAccountListReadOnlyKeys.json
new file mode 100644
index 000000000000..3acabc15beb7
--- /dev/null
+++ b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBDatabaseAccountListReadOnlyKeys.json
@@ -0,0 +1,16 @@
+{
+  "parameters": {
+    "accountName": "ddb1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-09-01",
+    "subscriptionId": "subid"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "primaryReadonlyMasterKey": "primaryReadonlyMasterKey",
+        "secondaryReadonlyMasterKey": "secondaryReadonlyMasterKey"
+      }
+    }
+  }
+}
diff --git a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBDatabaseAccountOfflineRegion.json b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBDatabaseAccountOfflineRegion.json
new file mode 100644
index 000000000000..39d179708fc6
--- /dev/null
+++ b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBDatabaseAccountOfflineRegion.json
@@ -0,0 +1,18 @@
+{
+  "parameters": {
+    "accountName": "ddb1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-09-01",
+    "subscriptionId": "subid",
+    "region": "North Europe",
+    "regionParameterForOffline": [
+      {
+        "region": "North Europe"
+      }
+    ]
+  },
+  "responses": {
+    "200": {},
+    "202": {}
+  }
+}
diff --git a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBDatabaseAccountOnlineRegion.json b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBDatabaseAccountOnlineRegion.json
new file mode 100644
index 000000000000..072a8c3be238
--- /dev/null
+++ b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBDatabaseAccountOnlineRegion.json
@@ -0,0 +1,18 @@
+{
+  "parameters": {
+    "accountName": "ddb1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-09-01",
+    "subscriptionId": "subid",
+    "region": "North Europe",
+    "regionParameterForOnline": [
+      {
+        "region": "North Europe"
+      }
+    ]
+  },
+  "responses": {
+    "200": {},
+    "202": {}
+  }
+}
diff --git a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBDatabaseAccountPatch.json b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBDatabaseAccountPatch.json
new file mode 100644
index 000000000000..55f31a5bfbb1
--- /dev/null
+++ b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBDatabaseAccountPatch.json
@@ -0,0 +1,144 @@
+{
+  "parameters": {
+    "accountName": "ddb1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-09-01",
+    "subscriptionId": "subid",
+    "updateParameters": {
+      "location": "westus",
+      "tags": {
+        "dept": "finance"
+      },
+      "properties": {
+        "ipRules": [
+          {
+            "ipAddressOrRange": "23.43.230.120"
+          },
+          {
+            "ipAddressOrRange": "110.12.240.0/12"
+          }
+        ],
+        "isVirtualNetworkFilterEnabled": true,
+        "virtualNetworkRules": [
+          {
+            "id": "/subscriptions/subId/resourceGroups/rg/providers/Microsoft.Network/virtualNetworks/vnet1/subnets/subnet1",
+            "ignoreMissingVNetServiceEndpoint": false
+          }
+        ],
+        "consistencyPolicy": {
+          "defaultConsistencyLevel": "BoundedStaleness",
+          "maxIntervalInSeconds": 10,
+          "maxStalenessPrefix": 200
+        },
+        "enableFreeTier": false,
+        "enableAnalyticalStorage": true,
+        "backupPolicy": {
+          "type": "Periodic",
+          "periodicModeProperties": {
+            "backupIntervalInMinutes": 240,
+            "backupRetentionIntervalInHours": 720
+          }
+        }
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.DocumentDB/databaseAccounts/ddb1",
+        "name": "ddb1",
+        "location": "West US",
+        "type": "Microsoft.DocumentDB/databaseAccounts",
+        "kind": "GlobalDocumentDB",
+        "tags": {
+          "dept": "finance"
+        },
+        "properties": {
+          "provisioningState": "Succeeded",
+          "documentEndpoint": "https://ddb1.documents.azure.com:443/",
+          "databaseAccountOfferType": "Standard",
+          "ipRules": [
+            {
+              "ipAddressOrRange": "23.43.230.120"
+            },
+            {
+              "ipAddressOrRange": "110.12.240.0/12"
+            }
+          ],
+          "isVirtualNetworkFilterEnabled": true,
+          "disableKeyBasedMetadataWriteAccess": false,
+          "consistencyPolicy": {
+            "defaultConsistencyLevel": "BoundedStaleness",
+            "maxIntervalInSeconds": 10,
+            "maxStalenessPrefix": 200
+          },
+          "writeLocations": [
+            {
+              "id": "ddb1-eastus",
+              "locationName": "East US",
+              "documentEndpoint": "https://ddb1-eastus.documents.azure.com:443/",
+              "provisioningState": "Succeeded",
+              "failoverPriority": 0
+            }
+          ],
+          "readLocations": [
+            {
+              "id": "ddb1-eastus",
+              "locationName": "East US",
+              "documentEndpoint": "https://ddb1-eastus.documents.azure.com:443/",
+              "provisioningState": "Succeeded",
+              "failoverPriority": 0
+            }
+          ],
+          "locations": [
+            {
+              "id": "ddb1-eastus",
+              "locationName": "East US",
+              "documentEndpoint": "https://ddb1-eastus.documents.azure.com:443/",
+              "provisioningState": "Succeeded",
+              "failoverPriority": 0
+            }
+          ],
+          "failoverPolicies": [
+            {
+              "id": "ddb1-eastus",
+              "locationName": "East US",
+              "failoverPriority": 0
+            }
+          ],
+          "virtualNetworkRules": [
+            {
+              "id": "/subscriptions/subId/resourceGroups/rg/providers/Microsoft.Network/virtualNetworks/vnet1/subnets/subnet1",
+              "ignoreMissingVNetServiceEndpoint": false
+            }
+          ],
+          "privateEndpointConnections": [
+            {
+              "id": "/subscriptions/subId/resourceGroups/rg/providers/Microsoft.DocumentDB/databaseAccounts/account1/privateEndpointConnections/pe1",
+              "properties": {
+                "privateEndpoint": {
+                  "id": "/subscriptions/subId/resourceGroups/rg/providers/Microsoft.Network/privateEndpoints/pe1"
+                },
+                "privateLinkServiceConnectionState": {
+                  "status": "Approved",
+                  "actionsRequired": "None"
+                }
+              }
+            }
+          ],
+          "cors": [],
+          "enableFreeTier": false,
+          "apiProperties": {},
+          "enableAnalyticalStorage": true,
+          "backupPolicy": {
+            "type": "Periodic",
+            "periodicModeProperties": {
+              "backupIntervalInMinutes": 240,
+              "backupRetentionIntervalInHours": 720
+            }
+          }
+        }
+      }
+    }
+  }
+}
diff --git a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBDatabaseAccountRegenerateKey.json b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBDatabaseAccountRegenerateKey.json
new file mode 100644
index 000000000000..5ec50750399d
--- /dev/null
+++ b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBDatabaseAccountRegenerateKey.json
@@ -0,0 +1,15 @@
+{
+  "parameters": {
+    "accountName": "ddb1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-09-01",
+    "subscriptionId": "subid",
+    "keyToRegenerate": {
+      "keyKind": "primary"
+    }
+  },
+  "responses": {
+    "200": {},
+    "202": {}
+  }
+}
diff --git a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBDatabaseAccountRegionGetMetrics.json b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBDatabaseAccountRegionGetMetrics.json
new file mode 100644
index 000000000000..6eaef53c3719
--- /dev/null
+++ b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBDatabaseAccountRegionGetMetrics.json
@@ -0,0 +1,54 @@
+{
+  "parameters": {
+    "accountName": "ddb1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-09-01",
+    "subscriptionId": "subid",
+    "region": "North Europe",
+    "$filter": "$filter=(name.value eq 'Total Requests') and timeGrain eq duration'PT5M' and startTime eq '2017-11-19T23:53:55.2780000Z' and endTime eq '2017-11-20T00:13:55.2780000Z"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "timeGrain": "PT5M",
+            "startTime": "2017-11-19T23:53:55.2780000Z",
+            "endTime": "2017-11-20T00:13:55.2780000Z",
+            "unit": "Count",
+            "metricValues": [
+              {
+                "timestamp": "2017-11-19T23:53:55.2780000Z",
+                "total": 0,
+                "_count": 0,
+                "average": 0
+              },
+              {
+                "timestamp": "2017-11-19T23:58:55.2780000Z",
+                "total": 0,
+                "_count": 0,
+                "average": 0
+              },
+              {
+                "timestamp": "2017-11-20T00:03:55.2780000Z",
+                "total": 0,
+                "_count": 0,
+                "average": 0
+              },
+              {
+                "timestamp": "2017-11-20T00:08:55.2780000Z",
+                "total": 0,
+                "_count": 0,
+                "average": 0
+              }
+            ],
+            "name": {
+              "value": "Total Requests",
+              "localizedValue": "Total Requests"
+            }
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBDatabaseGetMetricDefinitions.json b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBDatabaseGetMetricDefinitions.json
new file mode 100644
index 000000000000..5b773535de43
--- /dev/null
+++ b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBDatabaseGetMetricDefinitions.json
@@ -0,0 +1,40 @@
+{
+  "parameters": {
+    "accountName": "ddb1",
+    "resourceGroupName": "rg1",
+    "subscriptionId": "subid",
+    "api-version": "2020-09-01",
+    "databaseRid": "databaseRid"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "metricAvailabilities": [
+              {
+                "timeGrain": "PT5M",
+                "retention": "P2D"
+              },
+              {
+                "timeGrain": "PT1H",
+                "retention": "P14D"
+              },
+              {
+                "timeGrain": "P1D",
+                "retention": "P60D"
+              }
+            ],
+            "primaryAggregationType": "Total",
+            "unit": "Count",
+            "resourceUri": "/subscriptions/subId/resourceGroups/rg1/providers/Microsoft.DocumentDB/databaseAccounts/ddb1",
+            "name": {
+              "value": "Total Requests",
+              "localizedValue": "Total Requests"
+            }
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBDatabaseGetMetrics.json b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBDatabaseGetMetrics.json
new file mode 100644
index 000000000000..c1a4cc1a44e6
--- /dev/null
+++ b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBDatabaseGetMetrics.json
@@ -0,0 +1,54 @@
+{
+  "parameters": {
+    "accountName": "ddb1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-09-01",
+    "subscriptionId": "subid",
+    "databaseRid": "rid",
+    "$filter": "$filter=(name.value eq 'Total Requests') and timeGrain eq duration'PT5M' and startTime eq '2017-11-19T23:53:55.2780000Z' and endTime eq '2017-11-20T00:13:55.2780000Z"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "timeGrain": "PT5M",
+            "startTime": "2017-11-19T23:53:55.2780000Z",
+            "endTime": "2017-11-20T00:13:55.2780000Z",
+            "unit": "Count",
+            "metricValues": [
+              {
+                "timestamp": "2017-11-19T23:53:55.2780000Z",
+                "total": 0,
+                "_count": 0,
+                "average": 0
+              },
+              {
+                "timestamp": "2017-11-19T23:58:55.2780000Z",
+                "total": 0,
+                "_count": 0,
+                "average": 0
+              },
+              {
+                "timestamp": "2017-11-20T00:03:55.2780000Z",
+                "total": 0,
+                "_count": 0,
+                "average": 0
+              },
+              {
+                "timestamp": "2017-11-20T00:08:55.2780000Z",
+                "total": 0,
+                "_count": 0,
+                "average": 0
+              }
+            ],
+            "name": {
+              "value": "Total Requests",
+              "localizedValue": "Total Requests"
+            }
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBDatabaseGetUsages.json b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBDatabaseGetUsages.json
new file mode 100644
index 000000000000..26151ec23c66
--- /dev/null
+++ b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBDatabaseGetUsages.json
@@ -0,0 +1,28 @@
+{
+  "parameters": {
+    "accountName": "ddb1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-09-01",
+    "databaseRid": "databaseRid",
+    "subscriptionId": "subid",
+    "$filter": "$filter=name.value eq 'Storage'"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "unit": "Bytes",
+            "quotaPeriod": "P1D",
+            "limit": 10737418240,
+            "currentValue": 0,
+            "name": {
+              "value": "Storage",
+              "localizedValue": "Storage"
+            }
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBGremlinDatabaseCreateUpdate.json b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBGremlinDatabaseCreateUpdate.json
new file mode 100644
index 000000000000..be85c4cecfd0
--- /dev/null
+++ b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBGremlinDatabaseCreateUpdate.json
@@ -0,0 +1,39 @@
+{
+  "parameters": {
+    "accountName": "ddb1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-09-01",
+    "subscriptionId": "subid",
+    "databaseName": "databaseName",
+    "createUpdateGremlinDatabaseParameters": {
+      "location": "West US",
+      "tags": {},
+      "properties": {
+        "resource": {
+          "id": "databaseName"
+        },
+        "options": {}
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.DocumentDB/databaseAccounts/ddb1/gremlinDatabases/databaseName",
+        "name": "databaseName",
+        "type": "Microsoft.DocumentDB/databaseAccounts/gremlinDatabases",
+        "location": "West US",
+        "tags": {},
+        "properties": {
+          "resource": {
+            "id": "databaseName",
+            "_rid": "CqNBAA==",
+            "_ts": 1449602962,
+            "_etag": "\"00000a00-0000-0000-0000-56672f920000\""
+          }
+        }
+      }
+    },
+    "202": {}
+  }
+}
diff --git a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBGremlinDatabaseDelete.json b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBGremlinDatabaseDelete.json
new file mode 100644
index 000000000000..78b43c1f5037
--- /dev/null
+++ b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBGremlinDatabaseDelete.json
@@ -0,0 +1,13 @@
+{
+  "parameters": {
+    "accountName": "ddb1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-09-01",
+    "subscriptionId": "subid",
+    "databaseName": "databaseName"
+  },
+  "responses": {
+    "204": {},
+    "202": {}
+  }
+}
diff --git a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBGremlinDatabaseGet.json b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBGremlinDatabaseGet.json
new file mode 100644
index 000000000000..0bd7e872fd43
--- /dev/null
+++ b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBGremlinDatabaseGet.json
@@ -0,0 +1,28 @@
+{
+  "parameters": {
+    "accountName": "ddb1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-09-01",
+    "subscriptionId": "subid",
+    "databaseName": "databaseName"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.DocumentDB/databaseAccounts/ddb1/gremlinDatabases/databaseName",
+        "name": "databaseName",
+        "type": "Microsoft.DocumentDB/databaseAccounts/gremlinDatabases",
+        "location": "West US",
+        "tags": {},
+        "properties": {
+          "resource": {
+            "id": "databaseName",
+            "_rid": "CqNBAA==",
+            "_ts": 1449602962,
+            "_etag": "\"00000a00-0000-0000-0000-56672f920000\""
+          }
+        }
+      }
+    }
+  }
+}
diff --git a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBGremlinDatabaseList.json b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBGremlinDatabaseList.json
new file mode 100644
index 000000000000..f8e9fd62d3df
--- /dev/null
+++ b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBGremlinDatabaseList.json
@@ -0,0 +1,31 @@
+{
+  "parameters": {
+    "api-version": "2020-09-01",
+    "subscriptionId": "subid",
+    "resourceGroupName": "rgName",
+    "accountName": "ddb1"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.DocumentDB/databaseAccounts/ddb1/gremlinDatabases/databaseName",
+            "name": "databaseName",
+            "type": "Microsoft.DocumentDB/databaseAccounts/gremlinDatabases",
+            "location": "West US",
+            "tags": {},
+            "properties": {
+              "resource": {
+                "id": "databaseName",
+                "_rid": "CqNBAA==",
+                "_ts": 1449602962,
+                "_etag": "\"00000a00-0000-0000-0000-56672f920000\""
+              }
+            }
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBGremlinDatabaseMigrateToAutoscale.json b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBGremlinDatabaseMigrateToAutoscale.json
new file mode 100644
index 000000000000..9b8629c7c3bb
--- /dev/null
+++ b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBGremlinDatabaseMigrateToAutoscale.json
@@ -0,0 +1,29 @@
+{
+  "parameters": {
+    "accountName": "ddb1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-09-01",
+    "subscriptionId": "subid",
+    "databaseName": "databaseName"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "properties": {
+          "resource": {
+            "throughput": 400,
+            "autoscaleSettings": {
+              "maxThroughput": 4000
+            },
+            "minimumThroughput": "4000",
+            "offerReplacePending": "false",
+            "_rid": "PD5DALigDgw=",
+            "_ts": 1459200611,
+            "_etag": "\"00005900-0000-0000-0000-56f9a2630000\""
+          }
+        }
+      }
+    },
+    "202": {}
+  }
+}
diff --git a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBGremlinDatabaseMigrateToManualThroughput.json b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBGremlinDatabaseMigrateToManualThroughput.json
new file mode 100644
index 000000000000..8e8f2dc00ed2
--- /dev/null
+++ b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBGremlinDatabaseMigrateToManualThroughput.json
@@ -0,0 +1,26 @@
+{
+  "parameters": {
+    "accountName": "ddb1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-09-01",
+    "subscriptionId": "subid",
+    "databaseName": "databaseName"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "properties": {
+          "resource": {
+            "throughput": 400,
+            "minimumThroughput": "400",
+            "offerReplacePending": "true",
+            "_rid": "PD5DALigDgw=",
+            "_ts": 1459200611,
+            "_etag": "\"00005900-0000-0000-0000-56f9a2630000\""
+          }
+        }
+      }
+    },
+    "202": {}
+  }
+}
diff --git a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBGremlinDatabaseThroughputGet.json b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBGremlinDatabaseThroughputGet.json
new file mode 100644
index 000000000000..59ad4c7271c0
--- /dev/null
+++ b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBGremlinDatabaseThroughputGet.json
@@ -0,0 +1,30 @@
+{
+  "parameters": {
+    "accountName": "ddb1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-09-01",
+    "subscriptionId": "subid",
+    "databaseName": "databaseName"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.DocumentDB/databaseAccounts/ddb1/gremlinDatabases/databaseName/throughputSettings/default",
+        "name": "default",
+        "type": "Microsoft.DocumentDB/databaseAccounts/gremlinDatabases/throughputSettings",
+        "location": "West US",
+        "tags": {},
+        "properties": {
+          "resource": {
+            "throughput": 400,
+            "minimumThroughput": "400",
+            "offerReplacePending": "true",
+            "_rid": "PD5DALigDgw=",
+            "_ts": 1459200611,
+            "_etag": "\"00005900-0000-0000-0000-56f9a2630000\""
+          }
+        }
+      }
+    }
+  }
+}
diff --git a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBGremlinDatabaseThroughputUpdate.json b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBGremlinDatabaseThroughputUpdate.json
new file mode 100644
index 000000000000..e3d2b445cc40
--- /dev/null
+++ b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBGremlinDatabaseThroughputUpdate.json
@@ -0,0 +1,40 @@
+{
+  "parameters": {
+    "accountName": "ddb1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-09-01",
+    "subscriptionId": "subid",
+    "databaseName": "databaseName",
+    "updateThroughputParameters": {
+      "location": "West US",
+      "tags": {},
+      "properties": {
+        "resource": {
+          "throughput": 400
+        }
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.DocumentDB/databaseAccounts/ddb1/gremlinDatabases/databaseName/throughputSettings/default",
+        "name": "default",
+        "type": "Microsoft.DocumentDB/databaseAccounts/gremlinDatabases/throughputSettings",
+        "location": "West US",
+        "tags": {},
+        "properties": {
+          "resource": {
+            "throughput": 400,
+            "minimumThroughput": "400",
+            "offerReplacePending": "true",
+            "_rid": "PD5DALigDgw=",
+            "_ts": 1459200611,
+            "_etag": "\"00005900-0000-0000-0000-56f9a2630000\""
+          }
+        }
+      }
+    },
+    "202": {}
+  }
+}
diff --git a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBGremlinGraphCreateUpdate.json b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBGremlinGraphCreateUpdate.json
new file mode 100644
index 000000000000..861749b581f7
--- /dev/null
+++ b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBGremlinGraphCreateUpdate.json
@@ -0,0 +1,124 @@
+{
+  "parameters": {
+    "accountName": "ddb1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-09-01",
+    "subscriptionId": "subid",
+    "databaseName": "databaseName",
+    "graphName": "graphName",
+    "createUpdateGremlinGraphParameters": {
+      "location": "West US",
+      "tags": {},
+      "properties": {
+        "resource": {
+          "id": "graphName",
+          "indexingPolicy": {
+            "indexingMode": "Consistent",
+            "automatic": true,
+            "includedPaths": [
+              {
+                "path": "/*",
+                "indexes": [
+                  {
+                    "kind": "Range",
+                    "dataType": "String",
+                    "precision": -1
+                  },
+                  {
+                    "kind": "Range",
+                    "dataType": "Number",
+                    "precision": -1
+                  }
+                ]
+              }
+            ],
+            "excludedPaths": []
+          },
+          "partitionKey": {
+            "paths": [
+              "/AccountNumber"
+            ],
+            "kind": "Hash"
+          },
+          "defaultTtl": 100,
+          "uniqueKeyPolicy": {
+            "uniqueKeys": [
+              {
+                "paths": [
+                  "/testPath"
+                ]
+              }
+            ]
+          },
+          "conflictResolutionPolicy": {
+            "mode": "LastWriterWins",
+            "conflictResolutionPath": "/path"
+          }
+        },
+        "options": {}
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.DocumentDB/databaseAccounts/ddb1/gremlinDatabases/databaseName/gremlinGraphs/graphName",
+        "name": "graphName",
+        "type": "Microsoft.DocumentDB/databaseAccounts/gremlinDatabases/gremlinGraphs",
+        "location": "West US",
+        "tags": {},
+        "properties": {
+          "resource": {
+            "id": "graphName",
+            "indexingPolicy": {
+              "indexingMode": "Consistent",
+              "automatic": true,
+              "includedPaths": [
+                {
+                  "path": "/*",
+                  "indexes": [
+                    {
+                      "kind": "Range",
+                      "dataType": "String",
+                      "precision": -1
+                    },
+                    {
+                      "kind": "Range",
+                      "dataType": "Number",
+                      "precision": -1
+                    }
+                  ]
+                }
+              ],
+              "excludedPaths": []
+            },
+            "partitionKey": {
+              "paths": [
+                "/AccountNumber"
+              ],
+              "kind": "Hash"
+            },
+            "defaultTtl": 100,
+            "uniqueKeyPolicy": {
+              "uniqueKeys": [
+                {
+                  "paths": [
+                    "/testPath"
+                  ]
+                }
+              ]
+            },
+            "conflictResolutionPolicy": {
+              "mode": "LastWriterWins",
+              "conflictResolutionPath": "/path"
+            },
+            "_rid": "PD5DALigDgw=",
+            "_ts": 1459200611,
+            "_etag": "\"00005900-0000-0000-0000-56f9a2630000\""
+          }
+        }
+      }
+    },
+    "202": {}
+  }
+}
diff --git a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBGremlinGraphDelete.json b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBGremlinGraphDelete.json
new file mode 100644
index 000000000000..38aee05e394b
--- /dev/null
+++ b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBGremlinGraphDelete.json
@@ -0,0 +1,14 @@
+{
+  "parameters": {
+    "accountName": "ddb1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-09-01",
+    "subscriptionId": "subid",
+    "databaseName": "databaseName",
+    "graphName": "graphName"
+  },
+  "responses": {
+    "204": {},
+    "202": {}
+  }
+}
diff --git a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBGremlinGraphGet.json b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBGremlinGraphGet.json
new file mode 100644
index 000000000000..cec7a8b919ee
--- /dev/null
+++ b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBGremlinGraphGet.json
@@ -0,0 +1,69 @@
+{
+  "parameters": {
+    "api-version": "2020-09-01",
+    "subscriptionId": "subid",
+    "resourceGroupName": "rgName",
+    "accountName": "ddb1",
+    "databaseName": "databaseName",
+    "graphName": "graphName"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "graphName",
+        "name": "graphName",
+        "type": "Microsoft.DocumentDB/databaseAccounts/apis/databases/graphs",
+        "properties": {
+          "resource": {
+            "id": "graphName",
+            "indexingPolicy": {
+              "indexingMode": "Consistent",
+              "automatic": true,
+              "includedPaths": [
+                {
+                  "path": "/*",
+                  "indexes": [
+                    {
+                      "kind": "Range",
+                      "dataType": "String",
+                      "precision": -1
+                    },
+                    {
+                      "kind": "Range",
+                      "dataType": "Number",
+                      "precision": -1
+                    }
+                  ]
+                }
+              ],
+              "excludedPaths": []
+            },
+            "partitionKey": {
+              "paths": [
+                "/AccountNumber"
+              ],
+              "kind": "Hash"
+            },
+            "defaultTtl": 100,
+            "uniqueKeyPolicy": {
+              "uniqueKeys": [
+                {
+                  "paths": [
+                    "/testPath"
+                  ]
+                }
+              ]
+            },
+            "conflictResolutionPolicy": {
+              "mode": "LastWriterWins",
+              "conflictResolutionPath": "/path"
+            },
+            "_rid": "PD5DALigDgw=",
+            "_ts": 1459200611,
+            "_etag": "\"00005900-0000-0000-0000-56f9a2630000\""
+          }
+        }
+      }
+    }
+  }
+}
diff --git a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBGremlinGraphList.json b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBGremlinGraphList.json
new file mode 100644
index 000000000000..e4ed25496984
--- /dev/null
+++ b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBGremlinGraphList.json
@@ -0,0 +1,72 @@
+{
+  "parameters": {
+    "api-version": "2020-09-01",
+    "subscriptionId": "subid",
+    "resourceGroupName": "rgName",
+    "accountName": "ddb1",
+    "databaseName": "databaseName"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "id": "testgrf",
+            "name": "testgrf",
+            "type": "Microsoft.DocumentDB/databaseAccounts/apis/databases/graphs",
+            "properties": {
+              "resource": {
+                "id": "testgrf",
+                "indexingPolicy": {
+                  "indexingMode": "Consistent",
+                  "automatic": true,
+                  "includedPaths": [
+                    {
+                      "path": "/*",
+                      "indexes": [
+                        {
+                          "kind": "Range",
+                          "dataType": "String",
+                          "precision": -1
+                        },
+                        {
+                          "kind": "Range",
+                          "dataType": "Number",
+                          "precision": -1
+                        }
+                      ]
+                    }
+                  ],
+                  "excludedPaths": []
+                },
+                "partitionKey": {
+                  "paths": [
+                    "/AccountNumber"
+                  ],
+                  "kind": "Hash"
+                },
+                "defaultTtl": 100,
+                "uniqueKeyPolicy": {
+                  "uniqueKeys": [
+                    {
+                      "paths": [
+                        "/testPath"
+                      ]
+                    }
+                  ]
+                },
+                "conflictResolutionPolicy": {
+                  "mode": "LastWriterWins",
+                  "conflictResolutionPath": "/path"
+                },
+                "_rid": "PD5DALigDgw=",
+                "_ts": 1459200611,
+                "_etag": "\"00005900-0000-0000-0000-56f9a2630000\""
+              }
+            }
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBGremlinGraphMigrateToAutoscale.json b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBGremlinGraphMigrateToAutoscale.json
new file mode 100644
index 000000000000..8e2f96514595
--- /dev/null
+++ b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBGremlinGraphMigrateToAutoscale.json
@@ -0,0 +1,30 @@
+{
+  "parameters": {
+    "accountName": "ddb1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-09-01",
+    "subscriptionId": "subid",
+    "databaseName": "databaseName",
+    "graphName": "graphName"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "properties": {
+          "resource": {
+            "throughput": 400,
+            "autoscaleSettings": {
+              "maxThroughput": 4000
+            },
+            "minimumThroughput": "4000",
+            "offerReplacePending": "false",
+            "_rid": "PD5DALigDgw=",
+            "_ts": 1459200611,
+            "_etag": "\"00005900-0000-0000-0000-56f9a2630000\""
+          }
+        }
+      }
+    },
+    "202": {}
+  }
+}
diff --git a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBGremlinGraphMigrateToManualThroughput.json b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBGremlinGraphMigrateToManualThroughput.json
new file mode 100644
index 000000000000..89c1024958a0
--- /dev/null
+++ b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBGremlinGraphMigrateToManualThroughput.json
@@ -0,0 +1,27 @@
+{
+  "parameters": {
+    "accountName": "ddb1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-09-01",
+    "subscriptionId": "subid",
+    "databaseName": "databaseName",
+    "graphName": "graphName"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "properties": {
+          "resource": {
+            "throughput": 400,
+            "minimumThroughput": "400",
+            "offerReplacePending": "true",
+            "_rid": "PD5DALigDgw=",
+            "_ts": 1459200611,
+            "_etag": "\"00005900-0000-0000-0000-56f9a2630000\""
+          }
+        }
+      }
+    },
+    "202": {}
+  }
+}
diff --git a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBGremlinGraphThroughputGet.json b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBGremlinGraphThroughputGet.json
new file mode 100644
index 000000000000..0177c5d510a2
--- /dev/null
+++ b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBGremlinGraphThroughputGet.json
@@ -0,0 +1,31 @@
+{
+  "parameters": {
+    "accountName": "ddb1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-09-01",
+    "subscriptionId": "subid",
+    "databaseName": "databaseName",
+    "graphName": "graphName"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.DocumentDB/databaseAccounts/ddb1/gremlinDatabases/databaseName/gremlinGraphs/graphName/throughputSettings/default",
+        "name": "default",
+        "type": "Microsoft.DocumentDB/databaseAccounts/gremlinDatabases/throughputSettings",
+        "location": "West US",
+        "tags": {},
+        "properties": {
+          "resource": {
+            "throughput": 400,
+            "minimumThroughput": "400",
+            "offerReplacePending": "true",
+            "_rid": "PD5DALigDgw=",
+            "_ts": 1459200611,
+            "_etag": "\"00005900-0000-0000-0000-56f9a2630000\""
+          }
+        }
+      }
+    }
+  }
+}
diff --git a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBGremlinGraphThroughputUpdate.json b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBGremlinGraphThroughputUpdate.json
new file mode 100644
index 000000000000..8359ae790bff
--- /dev/null
+++ b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBGremlinGraphThroughputUpdate.json
@@ -0,0 +1,41 @@
+{
+  "parameters": {
+    "accountName": "ddb1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-09-01",
+    "subscriptionId": "subid",
+    "databaseName": "databaseName",
+    "graphName": "graphName",
+    "updateThroughputParameters": {
+      "location": "West US",
+      "tags": {},
+      "properties": {
+        "resource": {
+          "throughput": 400
+        }
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.DocumentDB/databaseAccounts/ddb1/gremlinDatabases/databaseName/gremlinGraphs/graphName/throughputSettings/default",
+        "name": "default",
+        "type": "Microsoft.DocumentDB/databaseAccounts/gremlinDatabases/throughputSettings",
+        "location": "West US",
+        "tags": {},
+        "properties": {
+          "resource": {
+            "throughput": 400,
+            "minimumThroughput": "400",
+            "offerReplacePending": "true",
+            "_rid": "PD5DALigDgw=",
+            "_ts": 1459200611,
+            "_etag": "\"00005900-0000-0000-0000-56f9a2630000\""
+          }
+        }
+      }
+    },
+    "202": {}
+  }
+}
diff --git a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBMongoDBCollectionCreateUpdate.json b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBMongoDBCollectionCreateUpdate.json
new file mode 100644
index 000000000000..8bcce66487be
--- /dev/null
+++ b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBMongoDBCollectionCreateUpdate.json
@@ -0,0 +1,69 @@
+{
+  "parameters": {
+    "accountName": "ddb1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-09-01",
+    "subscriptionId": "subid",
+    "databaseName": "databaseName",
+    "collectionName": "collectionName",
+    "createUpdateMongoDBCollectionParameters": {
+      "location": "West US",
+      "tags": {},
+      "properties": {
+        "resource": {
+          "id": "collectionName",
+          "indexes": [
+            {
+              "key": {
+                "keys": [
+                  "testKey"
+                ]
+              },
+              "options": {
+                "expireAfterSeconds": 100,
+                "unique": true
+              }
+            }
+          ],
+          "shardKey": {
+            "testKey": "Hash"
+          }
+        },
+        "options": {}
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.DocumentDB/databaseAccounts/ddb1/mongodbDatabases/databaseName/mongodbCollections/collectionName",
+        "name": "collectionName",
+        "type": "Microsoft.DocumentDB/databaseAccounts/mongodbDatabases/mongodbCollections",
+        "location": "West US",
+        "tags": {},
+        "properties": {
+          "resource": {
+            "id": "collectionName",
+            "indexes": [
+              {
+                "key": {
+                  "keys": [
+                    "testKey"
+                  ]
+                },
+                "options": {
+                  "expireAfterSeconds": 100,
+                  "unique": true
+                }
+              }
+            ],
+            "shardKey": {
+              "testKey": "Hash"
+            }
+          }
+        }
+      }
+    },
+    "202": {}
+  }
+}
diff --git a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBMongoDBCollectionDelete.json b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBMongoDBCollectionDelete.json
new file mode 100644
index 000000000000..f999d821ab09
--- /dev/null
+++ b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBMongoDBCollectionDelete.json
@@ -0,0 +1,14 @@
+{
+  "parameters": {
+    "accountName": "ddb1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-09-01",
+    "subscriptionId": "subid",
+    "databaseName": "databaseName",
+    "collectionName": "collectionName"
+  },
+  "responses": {
+    "204": {},
+    "202": {}
+  }
+}
diff --git a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBMongoDBCollectionGet.json b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBMongoDBCollectionGet.json
new file mode 100644
index 000000000000..509872ec3e71
--- /dev/null
+++ b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBMongoDBCollectionGet.json
@@ -0,0 +1,45 @@
+{
+  "parameters": {
+    "api-version": "2020-09-01",
+    "subscriptionId": "subid",
+    "resourceGroupName": "rgName",
+    "accountName": "ddb1",
+    "databaseName": "databaseName",
+    "collectionName": "collectionName"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.DocumentDB/databaseAccounts/ddb1/mongodbDatabases/databaseName/mongodbCollections/collectionName",
+        "name": "collectionName",
+        "type": "Microsoft.DocumentDB/databaseAccounts/mongodbDatabases/mongodbCollections",
+        "location": "West US",
+        "tags": {},
+        "properties": {
+          "resource": {
+            "id": "testcoll",
+            "indexes": [
+              {
+                "key": {
+                  "keys": [
+                    "testKey"
+                  ]
+                },
+                "options": {
+                  "expireAfterSeconds": 100,
+                  "unique": true
+                }
+              }
+            ],
+            "shardKey": {
+              "testKey": "Hash"
+            },
+            "_rid": "PD5DALigDgw=",
+            "_ts": 1459200611,
+            "_etag": "\"00005900-0000-0000-0000-56f9a2630000\""
+          }
+        }
+      }
+    }
+  }
+}
diff --git a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBMongoDBCollectionList.json b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBMongoDBCollectionList.json
new file mode 100644
index 000000000000..c61b19bf719d
--- /dev/null
+++ b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBMongoDBCollectionList.json
@@ -0,0 +1,45 @@
+{
+  "parameters": {
+    "api-version": "2020-09-01",
+    "subscriptionId": "subid",
+    "resourceGroupName": "rgName",
+    "accountName": "ddb1",
+    "databaseName": "databaseName"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.DocumentDB/databaseAccounts/ddb1/mongodbDatabases/databaseName/mongodbCollections/collectionName",
+            "name": "collectionName",
+            "type": "Microsoft.DocumentDB/databaseAccounts/mongodbDatabases/mongodbCollections",
+            "location": "West US",
+            "tags": {},
+            "properties": {
+              "resource": {
+                "id": "testcoll",
+                "indexes": [
+                  {
+                    "key": {
+                      "keys": [
+                        "testKey"
+                      ]
+                    },
+                    "options": {
+                      "expireAfterSeconds": 100,
+                      "unique": true
+                    }
+                  }
+                ],
+                "shardKey": {
+                  "testKey": "Hash"
+                }
+              }
+            }
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBMongoDBCollectionMigrateToAutoscale.json b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBMongoDBCollectionMigrateToAutoscale.json
new file mode 100644
index 000000000000..0c40504d44c3
--- /dev/null
+++ b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBMongoDBCollectionMigrateToAutoscale.json
@@ -0,0 +1,30 @@
+{
+  "parameters": {
+    "accountName": "ddb1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-09-01",
+    "subscriptionId": "subid",
+    "databaseName": "databaseName",
+    "collectionName": "collectionName"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "properties": {
+          "resource": {
+            "throughput": 400,
+            "autoscaleSettings": {
+              "maxThroughput": 4000
+            },
+            "minimumThroughput": "4000",
+            "offerReplacePending": "false",
+            "_rid": "PD5DALigDgw=",
+            "_ts": 1459200611,
+            "_etag": "\"00005900-0000-0000-0000-56f9a2630000\""
+          }
+        }
+      }
+    },
+    "202": {}
+  }
+}
diff --git a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBMongoDBCollectionMigrateToManualThroughput.json b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBMongoDBCollectionMigrateToManualThroughput.json
new file mode 100644
index 000000000000..818e8af71f14
--- /dev/null
+++ b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBMongoDBCollectionMigrateToManualThroughput.json
@@ -0,0 +1,27 @@
+{
+  "parameters": {
+    "accountName": "ddb1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-09-01",
+    "subscriptionId": "subid",
+    "databaseName": "databaseName",
+    "collectionName": "collectionName"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "properties": {
+          "resource": {
+            "throughput": 400,
+            "minimumThroughput": "400",
+            "offerReplacePending": "true",
+            "_rid": "PD5DALigDgw=",
+            "_ts": 1459200611,
+            "_etag": "\"00005900-0000-0000-0000-56f9a2630000\""
+          }
+        }
+      }
+    },
+    "202": {}
+  }
+}
diff --git a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBMongoDBCollectionThroughputGet.json b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBMongoDBCollectionThroughputGet.json
new file mode 100644
index 000000000000..d9678d2d1639
--- /dev/null
+++ b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBMongoDBCollectionThroughputGet.json
@@ -0,0 +1,31 @@
+{
+  "parameters": {
+    "accountName": "ddb1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-09-01",
+    "subscriptionId": "subid",
+    "databaseName": "databaseName",
+    "collectionName": "collectionName"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.DocumentDB/databaseAccounts/ddb1/mongodbDatabases/databaseName/mongodbCollections/collectionName/throughputSettings/default",
+        "name": "default",
+        "type": "Microsoft.DocumentDB/databaseAccounts/mongodbDatabases/mongodbCollections/throughputSettings",
+        "location": "West US",
+        "tags": {},
+        "properties": {
+          "resource": {
+            "throughput": 400,
+            "minimumThroughput": "400",
+            "offerReplacePending": "true",
+            "_rid": "PD5DALigDgw=",
+            "_ts": 1459200611,
+            "_etag": "\"00005900-0000-0000-0000-56f9a2630000\""
+          }
+        }
+      }
+    }
+  }
+}
diff --git a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBMongoDBCollectionThroughputUpdate.json b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBMongoDBCollectionThroughputUpdate.json
new file mode 100644
index 000000000000..857057a3284a
--- /dev/null
+++ b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBMongoDBCollectionThroughputUpdate.json
@@ -0,0 +1,41 @@
+{
+  "parameters": {
+    "accountName": "ddb1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-09-01",
+    "subscriptionId": "subid",
+    "databaseName": "databaseName",
+    "collectionName": "collectionName",
+    "updateThroughputParameters": {
+      "location": "West US",
+      "tags": {},
+      "properties": {
+        "resource": {
+          "throughput": 400
+        }
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.DocumentDB/databaseAccounts/ddb1/mongodbDatabases/databaseName/mongodbCollections/collectionName/throughputSettings/default",
+        "name": "default",
+        "type": "Microsoft.DocumentDB/databaseAccounts/mongodbDatabases/mongodbCollections/throughputSettings",
+        "location": "West US",
+        "tags": {},
+        "properties": {
+          "resource": {
+            "throughput": 400,
+            "minimumThroughput": "400",
+            "offerReplacePending": "true",
+            "_rid": "PD5DALigDgw=",
+            "_ts": 1459200611,
+            "_etag": "\"00005900-0000-0000-0000-56f9a2630000\""
+          }
+        }
+      }
+    },
+    "202": {}
+  }
+}
diff --git a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBMongoDBDatabaseCreateUpdate.json b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBMongoDBDatabaseCreateUpdate.json
new file mode 100644
index 000000000000..ebc040006786
--- /dev/null
+++ b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBMongoDBDatabaseCreateUpdate.json
@@ -0,0 +1,36 @@
+{
+  "parameters": {
+    "accountName": "ddb1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-09-01",
+    "subscriptionId": "subid",
+    "databaseName": "databaseName",
+    "createUpdateMongoDBDatabaseParameters": {
+      "location": "West US",
+      "tags": {},
+      "properties": {
+        "resource": {
+          "id": "databaseName"
+        },
+        "options": {}
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.DocumentDB/databaseAccounts/ddb1/mongodbDatabases/databaseName",
+        "name": "databaseName",
+        "type": "Microsoft.DocumentDB/databaseAccounts/mongodbDatabases",
+        "location": "West US",
+        "tags": {},
+        "properties": {
+          "resource": {
+            "id": "updatedDatabaseName"
+          }
+        }
+      }
+    },
+    "202": {}
+  }
+}
diff --git a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBMongoDBDatabaseDelete.json b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBMongoDBDatabaseDelete.json
new file mode 100644
index 000000000000..78b43c1f5037
--- /dev/null
+++ b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBMongoDBDatabaseDelete.json
@@ -0,0 +1,13 @@
+{
+  "parameters": {
+    "accountName": "ddb1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-09-01",
+    "subscriptionId": "subid",
+    "databaseName": "databaseName"
+  },
+  "responses": {
+    "204": {},
+    "202": {}
+  }
+}
diff --git a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBMongoDBDatabaseGet.json b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBMongoDBDatabaseGet.json
new file mode 100644
index 000000000000..a3607909da37
--- /dev/null
+++ b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBMongoDBDatabaseGet.json
@@ -0,0 +1,28 @@
+{
+  "parameters": {
+    "accountName": "ddb1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-09-01",
+    "subscriptionId": "subid",
+    "databaseName": "databaseName"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.DocumentDB/databaseAccounts/ddb1/mongodbDatabases/databaseName",
+        "name": "databaseName",
+        "type": "Microsoft.DocumentDB/databaseAccounts/mongodbDatabases",
+        "location": "West US",
+        "tags": {},
+        "properties": {
+          "resource": {
+            "id": "databaseName",
+            "_rid": "PD5DALigDgw=",
+            "_ts": 1459200611,
+            "_etag": "\"00005900-0000-0000-0000-56f9a2630000\""
+          }
+        }
+      }
+    }
+  }
+}
diff --git a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBMongoDBDatabaseList.json b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBMongoDBDatabaseList.json
new file mode 100644
index 000000000000..37079493d3c9
--- /dev/null
+++ b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBMongoDBDatabaseList.json
@@ -0,0 +1,28 @@
+{
+  "parameters": {
+    "api-version": "2020-09-01",
+    "subscriptionId": "subid",
+    "resourceGroupName": "rgName",
+    "accountName": "ddb1"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.DocumentDB/databaseAccounts/ddb1/mongodbDatabases/databaseName",
+            "name": "databaseName",
+            "type": "Microsoft.DocumentDB/databaseAccounts/mongodbDatabases",
+            "location": "West US",
+            "tags": {},
+            "properties": {
+              "resource": {
+                "id": "databaseName"
+              }
+            }
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBMongoDBDatabaseMigrateToAutoscale.json b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBMongoDBDatabaseMigrateToAutoscale.json
new file mode 100644
index 000000000000..9b8629c7c3bb
--- /dev/null
+++ b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBMongoDBDatabaseMigrateToAutoscale.json
@@ -0,0 +1,29 @@
+{
+  "parameters": {
+    "accountName": "ddb1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-09-01",
+    "subscriptionId": "subid",
+    "databaseName": "databaseName"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "properties": {
+          "resource": {
+            "throughput": 400,
+            "autoscaleSettings": {
+              "maxThroughput": 4000
+            },
+            "minimumThroughput": "4000",
+            "offerReplacePending": "false",
+            "_rid": "PD5DALigDgw=",
+            "_ts": 1459200611,
+            "_etag": "\"00005900-0000-0000-0000-56f9a2630000\""
+          }
+        }
+      }
+    },
+    "202": {}
+  }
+}
diff --git a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBMongoDBDatabaseMigrateToManualThroughput.json b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBMongoDBDatabaseMigrateToManualThroughput.json
new file mode 100644
index 000000000000..8e8f2dc00ed2
--- /dev/null
+++ b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBMongoDBDatabaseMigrateToManualThroughput.json
@@ -0,0 +1,26 @@
+{
+  "parameters": {
+    "accountName": "ddb1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-09-01",
+    "subscriptionId": "subid",
+    "databaseName": "databaseName"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "properties": {
+          "resource": {
+            "throughput": 400,
+            "minimumThroughput": "400",
+            "offerReplacePending": "true",
+            "_rid": "PD5DALigDgw=",
+            "_ts": 1459200611,
+            "_etag": "\"00005900-0000-0000-0000-56f9a2630000\""
+          }
+        }
+      }
+    },
+    "202": {}
+  }
+}
diff --git a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBMongoDBDatabaseThroughputGet.json b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBMongoDBDatabaseThroughputGet.json
new file mode 100644
index 000000000000..3daf5421333f
--- /dev/null
+++ b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBMongoDBDatabaseThroughputGet.json
@@ -0,0 +1,30 @@
+{
+  "parameters": {
+    "accountName": "ddb1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-09-01",
+    "subscriptionId": "subid",
+    "databaseName": "databaseName"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.DocumentDB/databaseAccounts/ddb1/mongodbDatabases/databaseName/throughputSettings/default",
+        "name": "default",
+        "type": "Microsoft.DocumentDB/databaseAccounts/mongodbDatabases/throughputSettings",
+        "location": "West US",
+        "tags": {},
+        "properties": {
+          "resource": {
+            "throughput": 400,
+            "minimumThroughput": "400",
+            "offerReplacePending": "true",
+            "_rid": "PD5DALigDgw=",
+            "_ts": 1459200611,
+            "_etag": "\"00005900-0000-0000-0000-56f9a2630000\""
+          }
+        }
+      }
+    }
+  }
+}
diff --git a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBMongoDBDatabaseThroughputUpdate.json b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBMongoDBDatabaseThroughputUpdate.json
new file mode 100644
index 000000000000..7291a4ce7fda
--- /dev/null
+++ b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBMongoDBDatabaseThroughputUpdate.json
@@ -0,0 +1,40 @@
+{
+  "parameters": {
+    "accountName": "ddb1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-09-01",
+    "subscriptionId": "subid",
+    "databaseName": "databaseName",
+    "updateThroughputParameters": {
+      "location": "West US",
+      "tags": {},
+      "properties": {
+        "resource": {
+          "throughput": 400
+        }
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.DocumentDB/databaseAccounts/ddb1/mongodbDatabases/databaseName/throughputSettings/default",
+        "name": "default",
+        "type": "Microsoft.DocumentDB/databaseAccounts/mongodbDatabases/throughputSettings",
+        "location": "West US",
+        "tags": {},
+        "properties": {
+          "resource": {
+            "throughput": 400,
+            "minimumThroughput": "400",
+            "offerReplacePending": "true",
+            "_rid": "PD5DALigDgw=",
+            "_ts": 1459200611,
+            "_etag": "\"00005900-0000-0000-0000-56f9a2630000\""
+          }
+        }
+      }
+    },
+    "202": {}
+  }
+}
diff --git a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBNotebookWorkspaceCreate.json b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBNotebookWorkspaceCreate.json
new file mode 100644
index 000000000000..227f40b9db11
--- /dev/null
+++ b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBNotebookWorkspaceCreate.json
@@ -0,0 +1,23 @@
+{
+  "parameters": {
+    "api-version": "2020-09-01",
+    "subscriptionId": "subid",
+    "resourceGroupName": "rg1",
+    "accountName": "ddb1",
+    "notebookWorkspaceName": "default",
+    "notebookCreateUpdateParameters": {}
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.DocumentDB/databaseAccounts/ddb1/notebookWorkspaces/default",
+        "name": "default",
+        "type": "Microsoft.DocumentDB/databaseAccounts/notebookWorkspaces",
+        "properties": {
+          "notebookServerEndpoint": "endpoint",
+          "status": "Online"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBNotebookWorkspaceDelete.json b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBNotebookWorkspaceDelete.json
new file mode 100644
index 000000000000..ed11fcbb5890
--- /dev/null
+++ b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBNotebookWorkspaceDelete.json
@@ -0,0 +1,13 @@
+{
+  "parameters": {
+    "accountName": "ddb1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-09-01",
+    "subscriptionId": "subid",
+    "notebookWorkspaceName": "default"
+  },
+  "responses": {
+    "202": {},
+    "204": {}
+  }
+}
diff --git a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBNotebookWorkspaceGet.json b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBNotebookWorkspaceGet.json
new file mode 100644
index 000000000000..43414c379992
--- /dev/null
+++ b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBNotebookWorkspaceGet.json
@@ -0,0 +1,22 @@
+{
+  "parameters": {
+    "api-version": "2020-09-01",
+    "subscriptionId": "subid",
+    "resourceGroupName": "rg1",
+    "accountName": "ddb1",
+    "notebookWorkspaceName": "default"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.DocumentDB/databaseAccounts/ddb1/notebookWorkspaces/default",
+        "name": "default",
+        "type": "Microsoft.DocumentDB/databaseAccounts/notebookWorkspaces",
+        "properties": {
+          "notebookServerEndpoint": "endpoint",
+          "status": "Online"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBNotebookWorkspaceList.json b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBNotebookWorkspaceList.json
new file mode 100644
index 000000000000..03d895f81238
--- /dev/null
+++ b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBNotebookWorkspaceList.json
@@ -0,0 +1,25 @@
+{
+  "parameters": {
+    "api-version": "2020-09-01",
+    "subscriptionId": "subid",
+    "resourceGroupName": "rg1",
+    "accountName": "ddb1"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.DocumentDB/databaseAccounts/ddb1/notebookWorkspaces/default",
+            "name": "default",
+            "type": "Microsoft.DocumentDB/databaseAccounts/notebookWorkspaces",
+            "properties": {
+              "notebookServerEndpoint": "endpoint",
+              "status": "Online"
+            }
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBNotebookWorkspaceListConnectionInfo.json b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBNotebookWorkspaceListConnectionInfo.json
new file mode 100644
index 000000000000..3efb34d1e0bb
--- /dev/null
+++ b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBNotebookWorkspaceListConnectionInfo.json
@@ -0,0 +1,17 @@
+{
+  "parameters": {
+    "api-version": "2020-09-01",
+    "subscriptionId": "subid",
+    "resourceGroupName": "rg1",
+    "accountName": "ddb1",
+    "notebookWorkspaceName": "default"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "authToken": "auth-token",
+        "notebookServerEndpoint": "notebook endpoint"
+      }
+    }
+  }
+}
diff --git a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBNotebookWorkspaceRegenerateAuthToken.json b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBNotebookWorkspaceRegenerateAuthToken.json
new file mode 100644
index 000000000000..1e4e36f02986
--- /dev/null
+++ b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBNotebookWorkspaceRegenerateAuthToken.json
@@ -0,0 +1,13 @@
+{
+  "parameters": {
+    "api-version": "2020-09-01",
+    "subscriptionId": "subid",
+    "resourceGroupName": "rg1",
+    "accountName": "ddb1",
+    "notebookWorkspaceName": "default"
+  },
+  "responses": {
+    "200": {},
+    "202": {}
+  }
+}
diff --git a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBNotebookWorkspaceStart.json b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBNotebookWorkspaceStart.json
new file mode 100644
index 000000000000..1e4e36f02986
--- /dev/null
+++ b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBNotebookWorkspaceStart.json
@@ -0,0 +1,13 @@
+{
+  "parameters": {
+    "api-version": "2020-09-01",
+    "subscriptionId": "subid",
+    "resourceGroupName": "rg1",
+    "accountName": "ddb1",
+    "notebookWorkspaceName": "default"
+  },
+  "responses": {
+    "200": {},
+    "202": {}
+  }
+}
diff --git a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBOperationsList.json b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBOperationsList.json
new file mode 100644
index 000000000000..9f1793f396e5
--- /dev/null
+++ b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBOperationsList.json
@@ -0,0 +1,22 @@
+{
+  "parameters": {
+    "api-version": "2020-09-01"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "name": "operationName",
+            "display": {
+              "Provider": "providerName",
+              "Resource": "resourceName",
+              "Operation": "operationName",
+              "Description": "description"
+            }
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBPKeyRangeIdGetMetrics.json b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBPKeyRangeIdGetMetrics.json
new file mode 100644
index 000000000000..2a702179959a
--- /dev/null
+++ b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBPKeyRangeIdGetMetrics.json
@@ -0,0 +1,58 @@
+{
+  "parameters": {
+    "accountName": "ddb1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-09-01",
+    "subscriptionId": "subid",
+    "databaseRid": "databaseRid",
+    "collectionRid": "collectionRid",
+    "partitionKeyRangeId": "0",
+    "$filter": "$filter=(name.value eq 'Max RUs Per Second') and timeGrain eq duration'PT1M' and startTime eq '2017-11-19T23:53:55.2780000Z' and endTime eq '2017-11-20T23:58:55.2780000Z"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "timeGrain": "PT1M",
+            "startTime": "2017-11-19T23:53:55.2780000Z",
+            "endTime": "2017-11-20T23:58:55.2780000Z",
+            "unit": "Count",
+            "partitionId": "00000000-0000-0000-0000-000000000000",
+            "partitionKeyRangeId": "0",
+            "metricValues": [
+              {
+                "timestamp": "2017-11-19T23:53:55.2780000Z",
+                "maximum": 5
+              },
+              {
+                "timestamp": "2017-11-19T23:54:55.2780000Z",
+                "maximum": 5
+              },
+              {
+                "timestamp": "2017-11-19T23:55:55.2780000Z",
+                "maximum": 5
+              },
+              {
+                "timestamp": "2017-11-19T23:56:55.2780000Z",
+                "maximum": 5
+              },
+              {
+                "timestamp": "2017-11-19T23:57:55.2780000Z",
+                "maximum": 5
+              },
+              {
+                "timestamp": "2017-11-19T23:58:55.2780000Z",
+                "maximum": 5
+              }
+            ],
+            "name": {
+              "value": "Max RUs Per Second",
+              "localizedValue": "Max RUs Per Second"
+            }
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBPKeyRangeIdRegionGetMetrics.json b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBPKeyRangeIdRegionGetMetrics.json
new file mode 100644
index 000000000000..dfe736bf7561
--- /dev/null
+++ b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBPKeyRangeIdRegionGetMetrics.json
@@ -0,0 +1,59 @@
+{
+  "parameters": {
+    "accountName": "ddb1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-09-01",
+    "subscriptionId": "subid",
+    "databaseRid": "databaseRid",
+    "collectionRid": "collectionRid",
+    "partitionKeyRangeId": "0",
+    "region": "West US",
+    "$filter": "$filter=(name.value eq 'Max RUs Per Second') and timeGrain eq duration'PT1M' and startTime eq '2017-11-19T23:53:55.2780000Z' and endTime eq '2017-11-20T23:58:55.2780000Z"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "timeGrain": "PT1M",
+            "startTime": "2017-11-19T23:53:55.2780000Z",
+            "endTime": "2017-11-20T23:58:55.2780000Z",
+            "unit": "Count",
+            "partitionId": "00000000-0000-0000-0000-000000000000",
+            "partitionKeyRangeId": "0",
+            "metricValues": [
+              {
+                "timestamp": "2017-11-19T23:53:55.2780000Z",
+                "maximum": 5
+              },
+              {
+                "timestamp": "2017-11-19T23:54:55.2780000Z",
+                "maximum": 5
+              },
+              {
+                "timestamp": "2017-11-19T23:55:55.2780000Z",
+                "maximum": 5
+              },
+              {
+                "timestamp": "2017-11-19T23:56:55.2780000Z",
+                "maximum": 5
+              },
+              {
+                "timestamp": "2017-11-19T23:57:55.2780000Z",
+                "maximum": 5
+              },
+              {
+                "timestamp": "2017-11-19T23:58:55.2780000Z",
+                "maximum": 5
+              }
+            ],
+            "name": {
+              "value": "Max RUs Per Second",
+              "localizedValue": "Max RUs Per Second"
+            }
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBPercentileGetMetrics.json b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBPercentileGetMetrics.json
new file mode 100644
index 000000000000..97d7429da96c
--- /dev/null
+++ b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBPercentileGetMetrics.json
@@ -0,0 +1,61 @@
+{
+  "parameters": {
+    "accountName": "ddb1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-09-01",
+    "subscriptionId": "subid",
+    "$filter": "$filter=(name.value eq 'Probabilistic Bounded Staleness') and timeGrain eq duration'PT5M' and startTime eq '2017-11-19T23:53:55.2780000Z' and endTime eq '2017-11-20T00:13:55.2780000Z"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "timeGrain": "PT5M",
+            "startTime": "2017-11-19T23:53:55.2780000Z",
+            "endTime": "2017-11-20T00:13:55.2780000Z",
+            "unit": "Milliseconds",
+            "metricValues": [
+              {
+                "timestamp": "2017-11-19T23:53:55.2780000Z",
+                "P10": 1.11,
+                "P25": 2.5,
+                "P50": 4.34,
+                "P75": 5.2,
+                "P90": 6.77,
+                "P95": 7.1,
+                "P99": 8.3
+              }
+            ],
+            "name": {
+              "value": "Probabilistic Bounded Staleness-S-West Central US-T-East US",
+              "localizedValue": "Probabilistic Bounded Staleness-S-West Central US-T-East US"
+            }
+          },
+          {
+            "timeGrain": "PT5M",
+            "startTime": "2017-11-19T23:53:55.2780000Z",
+            "endTime": "2017-11-20T00:13:55.2780000Z",
+            "unit": "Milliseconds",
+            "metricValues": [
+              {
+                "timestamp": "2017-11-19T23:53:55.2780000Z",
+                "P10": 1.11,
+                "P25": 2.5,
+                "P50": 4.34,
+                "P75": 5.2,
+                "P90": 6.77,
+                "P95": 7.1,
+                "P99": 8.3
+              }
+            ],
+            "name": {
+              "value": "Probabilistic Bounded Staleness-S-West Central US-T-West US",
+              "localizedValue": "Probabilistic Bounded Staleness-S-West Central US-T-West US"
+            }
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBPercentileSourceTargetGetMetrics.json b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBPercentileSourceTargetGetMetrics.json
new file mode 100644
index 000000000000..d1665d4f2b19
--- /dev/null
+++ b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBPercentileSourceTargetGetMetrics.json
@@ -0,0 +1,41 @@
+{
+  "parameters": {
+    "accountName": "ddb1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-09-01",
+    "subscriptionId": "subid",
+    "sourceRegion": "West Central US",
+    "targetRegion": "East US",
+    "$filter": "$filter=(name.value eq 'Probabilistic Bounded Staleness') and timeGrain eq duration'PT5M' and startTime eq '2017-11-19T23:53:55.2780000Z' and endTime eq '2017-11-20T00:13:55.2780000Z"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "timeGrain": "PT5M",
+            "startTime": "2017-11-19T23:53:55.2780000Z",
+            "endTime": "2017-11-20T00:13:55.2780000Z",
+            "unit": "Milliseconds",
+            "metricValues": [
+              {
+                "timestamp": "2017-11-19T23:53:55.2780000Z",
+                "P10": 1.11,
+                "P25": 2.5,
+                "P50": 4.34,
+                "P75": 5.2,
+                "P90": 6.77,
+                "P95": 7.1,
+                "P99": 8.3
+              }
+            ],
+            "name": {
+              "value": "Probabilistic Bounded Staleness-S-West Central US-T-East US",
+              "localizedValue": "Probabilistic Bounded Staleness-S-West Central US-T-East US"
+            }
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBPercentileTargetGetMetrics.json b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBPercentileTargetGetMetrics.json
new file mode 100644
index 000000000000..b88a1f67b0a3
--- /dev/null
+++ b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBPercentileTargetGetMetrics.json
@@ -0,0 +1,62 @@
+{
+  "parameters": {
+    "accountName": "ddb1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-09-01",
+    "subscriptionId": "subid",
+    "targetRegion": "East US",
+    "$filter": "$filter=(name.value eq 'Probabilistic Bounded Staleness') and timeGrain eq duration'PT5M' and startTime eq '2017-11-19T23:53:55.2780000Z' and endTime eq '2017-11-20T00:13:55.2780000Z"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "timeGrain": "PT5M",
+            "startTime": "2017-11-19T23:53:55.2780000Z",
+            "endTime": "2017-11-20T00:13:55.2780000Z",
+            "unit": "Milliseconds",
+            "metricValues": [
+              {
+                "timestamp": "2017-11-19T23:53:55.2780000Z",
+                "P10": 1.11,
+                "P25": 2.5,
+                "P50": 4.34,
+                "P75": 5.2,
+                "P90": 6.77,
+                "P95": 7.1,
+                "P99": 8.3
+              }
+            ],
+            "name": {
+              "value": "Probabilistic Bounded Staleness-S-West Central US-T-East US",
+              "localizedValue": "Probabilistic Bounded Staleness-S-West Central US-T-East US"
+            }
+          },
+          {
+            "timeGrain": "PT5M",
+            "startTime": "2017-11-19T23:53:55.2780000Z",
+            "endTime": "2017-11-20T00:13:55.2780000Z",
+            "unit": "Milliseconds",
+            "metricValues": [
+              {
+                "timestamp": "2017-11-19T23:53:55.2780000Z",
+                "P10": 1.11,
+                "P25": 2.5,
+                "P50": 4.34,
+                "P75": 5.2,
+                "P90": 6.77,
+                "P95": 7.1,
+                "P99": 8.3
+              }
+            ],
+            "name": {
+              "value": "Probabilistic Bounded Staleness-S-West US-T-East US",
+              "localizedValue": "Probabilistic Bounded Staleness-S-West Central US-T-West US"
+            }
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBRegionCollectionGetMetrics.json b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBRegionCollectionGetMetrics.json
new file mode 100644
index 000000000000..f4558c9acff6
--- /dev/null
+++ b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBRegionCollectionGetMetrics.json
@@ -0,0 +1,56 @@
+{
+  "parameters": {
+    "accountName": "ddb1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-09-01",
+    "subscriptionId": "subid",
+    "databaseRid": "databaseRid",
+    "collectionRid": "collectionRid",
+    "region": "North Europe",
+    "$filter": "$filter=(name.value eq 'Total Requests') and timeGrain eq duration'PT5M' and startTime eq '2017-11-19T23:53:55.2780000Z' and endTime eq '2017-11-20T00:13:55.2780000Z"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "timeGrain": "PT5M",
+            "startTime": "2017-11-19T23:53:55.2780000Z",
+            "endTime": "2017-11-20T00:13:55.2780000Z",
+            "unit": "Count",
+            "metricValues": [
+              {
+                "timestamp": "2017-11-19T23:53:55.2780000Z",
+                "total": 0,
+                "_count": 0,
+                "average": 0
+              },
+              {
+                "timestamp": "2017-11-19T23:58:55.2780000Z",
+                "total": 0,
+                "_count": 0,
+                "average": 0
+              },
+              {
+                "timestamp": "2017-11-20T00:03:55.2780000Z",
+                "total": 0,
+                "_count": 0,
+                "average": 0
+              },
+              {
+                "timestamp": "2017-11-20T00:08:55.2780000Z",
+                "total": 0,
+                "_count": 0,
+                "average": 0
+              }
+            ],
+            "name": {
+              "value": "Total Requests",
+              "localizedValue": "Total Requests"
+            }
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBSqlContainerCreateUpdate.json b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBSqlContainerCreateUpdate.json
new file mode 100644
index 000000000000..d1fe235460ea
--- /dev/null
+++ b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBSqlContainerCreateUpdate.json
@@ -0,0 +1,124 @@
+{
+  "parameters": {
+    "accountName": "ddb1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-09-01",
+    "subscriptionId": "subid",
+    "databaseName": "databaseName",
+    "containerName": "containerName",
+    "createUpdateSqlContainerParameters": {
+      "location": "West US",
+      "tags": {},
+      "properties": {
+        "resource": {
+          "id": "containerName",
+          "indexingPolicy": {
+            "indexingMode": "Consistent",
+            "automatic": true,
+            "includedPaths": [
+              {
+                "path": "/*",
+                "indexes": [
+                  {
+                    "kind": "Range",
+                    "dataType": "String",
+                    "precision": -1
+                  },
+                  {
+                    "kind": "Range",
+                    "dataType": "Number",
+                    "precision": -1
+                  }
+                ]
+              }
+            ],
+            "excludedPaths": []
+          },
+          "partitionKey": {
+            "paths": [
+              "/AccountNumber"
+            ],
+            "kind": "Hash"
+          },
+          "defaultTtl": 100,
+          "uniqueKeyPolicy": {
+            "uniqueKeys": [
+              {
+                "paths": [
+                  "/testPath"
+                ]
+              }
+            ]
+          },
+          "conflictResolutionPolicy": {
+            "mode": "LastWriterWins",
+            "conflictResolutionPath": "/path"
+          }
+        },
+        "options": {}
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.DocumentDB/databaseAccounts/ddb1/sqlDatabases/databaseName/sqlContainers/containerName",
+        "name": "containerName",
+        "type": "Microsoft.DocumentDB/databaseAccounts/sqlDatabases/sqlContainers",
+        "location": "West US",
+        "tags": {},
+        "properties": {
+          "resource": {
+            "id": "containerName",
+            "indexingPolicy": {
+              "indexingMode": "Consistent",
+              "automatic": true,
+              "includedPaths": [
+                {
+                  "path": "/*",
+                  "indexes": [
+                    {
+                      "kind": "Range",
+                      "dataType": "String",
+                      "precision": -1
+                    },
+                    {
+                      "kind": "Range",
+                      "dataType": "Number",
+                      "precision": -1
+                    }
+                  ]
+                }
+              ],
+              "excludedPaths": []
+            },
+            "partitionKey": {
+              "paths": [
+                "/AccountNumber"
+              ],
+              "kind": "Hash"
+            },
+            "defaultTtl": 100,
+            "uniqueKeyPolicy": {
+              "uniqueKeys": [
+                {
+                  "paths": [
+                    "/testPath"
+                  ]
+                }
+              ]
+            },
+            "conflictResolutionPolicy": {
+              "mode": "LastWriterWins",
+              "conflictResolutionPath": "/path"
+            },
+            "_rid": "PD5DALigDgw=",
+            "_ts": 1459200611,
+            "_etag": "\"00005900-0000-0000-0000-56f9a2630000\""
+          }
+        }
+      }
+    },
+    "202": {}
+  }
+}
diff --git a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBSqlContainerDelete.json b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBSqlContainerDelete.json
new file mode 100644
index 000000000000..a40cebb07721
--- /dev/null
+++ b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBSqlContainerDelete.json
@@ -0,0 +1,14 @@
+{
+  "parameters": {
+    "accountName": "ddb1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-09-01",
+    "subscriptionId": "subid",
+    "databaseName": "databaseName",
+    "containerName": "containerName"
+  },
+  "responses": {
+    "204": {},
+    "202": {}
+  }
+}
diff --git a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBSqlContainerGet.json b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBSqlContainerGet.json
new file mode 100644
index 000000000000..719a0c2d5fa9
--- /dev/null
+++ b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBSqlContainerGet.json
@@ -0,0 +1,74 @@
+{
+  "parameters": {
+    "api-version": "2020-09-01",
+    "subscriptionId": "subid",
+    "resourceGroupName": "rgName",
+    "accountName": "ddb1",
+    "databaseName": "databaseName",
+    "containerName": "containerName"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.DocumentDB/databaseAccounts/ddb1/sqlDatabases/databaseName/sqlContainers/containerName",
+        "name": "containerName",
+        "type": "Microsoft.DocumentDB/databaseAccounts/sqlDatabases/sqlContainers",
+        "location": "West US",
+        "tags": {},
+        "properties": {
+          "resource": {
+            "id": "containerName",
+            "indexingPolicy": {
+              "indexingMode": "Consistent",
+              "automatic": true,
+              "includedPaths": [
+                {
+                  "path": "/*",
+                  "indexes": [
+                    {
+                      "kind": "Range",
+                      "dataType": "String",
+                      "precision": -1
+                    },
+                    {
+                      "kind": "Range",
+                      "dataType": "Number",
+                      "precision": -1
+                    }
+                  ]
+                }
+              ],
+              "excludedPaths": []
+            },
+            "partitionKey": {
+              "paths": [
+                "/AccountNumber"
+              ],
+              "kind": "Hash"
+            },
+            "defaultTtl": 100,
+            "uniqueKeyPolicy": {
+              "uniqueKeys": [
+                {
+                  "paths": [
+                    "/testPath"
+                  ]
+                }
+              ]
+            },
+            "conflictResolutionPolicy": {
+              "mode": "LastWriterWins",
+              "conflictResolutionPath": "/path"
+            },
+            "_rid": "PD5DALigDgw=",
+            "_ts": 1459200611,
+            "_etag": "\"00005900-0000-0000-0000-56f9a2630000\""
+          },
+          "options": {
+            "throughput": 400
+          }
+        }
+      }
+    }
+  }
+}
diff --git a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBSqlContainerList.json b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBSqlContainerList.json
new file mode 100644
index 000000000000..4f9ae9367955
--- /dev/null
+++ b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBSqlContainerList.json
@@ -0,0 +1,74 @@
+{
+  "parameters": {
+    "api-version": "2020-09-01",
+    "subscriptionId": "subid",
+    "resourceGroupName": "rgName",
+    "accountName": "ddb1",
+    "databaseName": "databaseName"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.DocumentDB/databaseAccounts/ddb1/sqlDatabases/databaseName/sqlContainers/containerName",
+            "name": "containerName",
+            "type": "Microsoft.DocumentDB/databaseAccounts/sqlDatabases/sqlContainers",
+            "location": "West US",
+            "tags": {},
+            "properties": {
+              "resource": {
+                "id": "testctn",
+                "indexingPolicy": {
+                  "indexingMode": "Consistent",
+                  "automatic": true,
+                  "includedPaths": [
+                    {
+                      "path": "/*",
+                      "indexes": [
+                        {
+                          "kind": "Range",
+                          "dataType": "String",
+                          "precision": -1
+                        },
+                        {
+                          "kind": "Range",
+                          "dataType": "Number",
+                          "precision": -1
+                        }
+                      ]
+                    }
+                  ],
+                  "excludedPaths": []
+                },
+                "partitionKey": {
+                  "paths": [
+                    "/AccountNumber"
+                  ],
+                  "kind": "Hash"
+                },
+                "defaultTtl": 100,
+                "uniqueKeyPolicy": {
+                  "uniqueKeys": [
+                    {
+                      "paths": [
+                        "/testPath"
+                      ]
+                    }
+                  ]
+                },
+                "conflictResolutionPolicy": {
+                  "mode": "LastWriterWins",
+                  "conflictResolutionPath": "/path"
+                },
+                "_rid": "PD5DALigDgw=",
+                "_ts": 1459200611,
+                "_etag": "\"00005900-0000-0000-0000-56f9a2630000\""
+              }
+            }
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBSqlContainerMigrateToAutoscale.json b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBSqlContainerMigrateToAutoscale.json
new file mode 100644
index 000000000000..5a012d36a437
--- /dev/null
+++ b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBSqlContainerMigrateToAutoscale.json
@@ -0,0 +1,30 @@
+{
+  "parameters": {
+    "accountName": "ddb1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-09-01",
+    "subscriptionId": "subid",
+    "databaseName": "databaseName",
+    "containerName": "containerName"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "properties": {
+          "resource": {
+            "throughput": 400,
+            "autoscaleSettings": {
+              "maxThroughput": 4000
+            },
+            "minimumThroughput": "4000",
+            "offerReplacePending": "false",
+            "_rid": "PD5DALigDgw=",
+            "_ts": 1459200611,
+            "_etag": "\"00005900-0000-0000-0000-56f9a2630000\""
+          }
+        }
+      }
+    },
+    "202": {}
+  }
+}
diff --git a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBSqlContainerMigrateToManualThroughput.json b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBSqlContainerMigrateToManualThroughput.json
new file mode 100644
index 000000000000..a3ea45c129a7
--- /dev/null
+++ b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBSqlContainerMigrateToManualThroughput.json
@@ -0,0 +1,27 @@
+{
+  "parameters": {
+    "accountName": "ddb1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-09-01",
+    "subscriptionId": "subid",
+    "databaseName": "databaseName",
+    "containerName": "containerName"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "properties": {
+          "resource": {
+            "throughput": 400,
+            "minimumThroughput": "400",
+            "offerReplacePending": "true",
+            "_rid": "PD5DALigDgw=",
+            "_ts": 1459200611,
+            "_etag": "\"00005900-0000-0000-0000-56f9a2630000\""
+          }
+        }
+      }
+    },
+    "202": {}
+  }
+}
diff --git a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBSqlContainerThroughputGet.json b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBSqlContainerThroughputGet.json
new file mode 100644
index 000000000000..a9ca1642de29
--- /dev/null
+++ b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBSqlContainerThroughputGet.json
@@ -0,0 +1,31 @@
+{
+  "parameters": {
+    "accountName": "ddb1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-09-01",
+    "subscriptionId": "subid",
+    "databaseName": "databaseName",
+    "containerName": "containerName"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.DocumentDB/databaseAccounts/ddb1/sqlDatabases/databaseName/sqlContainers/containerName/throughputSettings/default",
+        "name": "default",
+        "type": "Microsoft.DocumentDB/databaseAccounts/sqlDatabases/sqlContainers/throughputSettings",
+        "location": "West US",
+        "tags": {},
+        "properties": {
+          "resource": {
+            "throughput": 400,
+            "minimumThroughput": "400",
+            "offerReplacePending": "true",
+            "_rid": "PD5DALigDgw=",
+            "_ts": 1459200611,
+            "_etag": "\"00005900-0000-0000-0000-56f9a2630000\""
+          }
+        }
+      }
+    }
+  }
+}
diff --git a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBSqlContainerThroughputUpdate.json b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBSqlContainerThroughputUpdate.json
new file mode 100644
index 000000000000..ba611bf80397
--- /dev/null
+++ b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBSqlContainerThroughputUpdate.json
@@ -0,0 +1,41 @@
+{
+  "parameters": {
+    "accountName": "ddb1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-09-01",
+    "subscriptionId": "subid",
+    "databaseName": "databaseName",
+    "containerName": "containerName",
+    "updateThroughputParameters": {
+      "location": "West US",
+      "tags": {},
+      "properties": {
+        "resource": {
+          "throughput": 400
+        }
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.DocumentDB/databaseAccounts/ddb1/sqlDatabases/databaseName/sqlContainers/containerName/throughputSettings/default",
+        "name": "default",
+        "type": "Microsoft.DocumentDB/databaseAccounts/sqlDatabases/sqlContainers/throughputSettings",
+        "location": "West US",
+        "tags": {},
+        "properties": {
+          "resource": {
+            "throughput": 400,
+            "minimumThroughput": "400",
+            "offerReplacePending": "true",
+            "_rid": "PD5DALigDgw=",
+            "_ts": 1459200611,
+            "_etag": "\"00005900-0000-0000-0000-56f9a2630000\""
+          }
+        }
+      }
+    },
+    "202": {}
+  }
+}
diff --git a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBSqlDatabaseCreateUpdate.json b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBSqlDatabaseCreateUpdate.json
new file mode 100644
index 000000000000..0e8c76e1d932
--- /dev/null
+++ b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBSqlDatabaseCreateUpdate.json
@@ -0,0 +1,39 @@
+{
+  "parameters": {
+    "accountName": "ddb1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-09-01",
+    "subscriptionId": "subid",
+    "databaseName": "databaseName",
+    "createUpdateSqlDatabaseParameters": {
+      "location": "West US",
+      "tags": {},
+      "properties": {
+        "resource": {
+          "id": "databaseName"
+        },
+        "options": {}
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.DocumentDB/databaseAccounts/ddb1/sqlDatabases/databaseName",
+        "name": "databaseName",
+        "type": "Microsoft.DocumentDB/databaseAccounts/sqlDatabases",
+        "location": "West US",
+        "tags": {},
+        "properties": {
+          "resource": {
+            "id": "databaseName",
+            "_rid": "CqNBAA==",
+            "_ts": 1449602962,
+            "_etag": "\"00000a00-0000-0000-0000-56672f920000\""
+          }
+        }
+      }
+    },
+    "202": {}
+  }
+}
diff --git a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBSqlDatabaseDelete.json b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBSqlDatabaseDelete.json
new file mode 100644
index 000000000000..78b43c1f5037
--- /dev/null
+++ b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBSqlDatabaseDelete.json
@@ -0,0 +1,13 @@
+{
+  "parameters": {
+    "accountName": "ddb1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-09-01",
+    "subscriptionId": "subid",
+    "databaseName": "databaseName"
+  },
+  "responses": {
+    "204": {},
+    "202": {}
+  }
+}
diff --git a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBSqlDatabaseGet.json b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBSqlDatabaseGet.json
new file mode 100644
index 000000000000..c824a9db382e
--- /dev/null
+++ b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBSqlDatabaseGet.json
@@ -0,0 +1,30 @@
+{
+  "parameters": {
+    "accountName": "ddb1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-09-01",
+    "subscriptionId": "subid",
+    "databaseName": "databaseName"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.DocumentDB/databaseAccounts/ddb1/sqlDatabases/databaseName",
+        "name": "databaseName",
+        "type": "Microsoft.DocumentDB/databaseAccounts/sqlDatabases",
+        "location": "West US",
+        "tags": {},
+        "properties": {
+          "resource": {
+            "id": "databaseName",
+            "_rid": "CqNBAA==",
+            "_ts": 1449602962,
+            "_etag": "\"00000a00-0000-0000-0000-56672f920000\"",
+            "_colls": "colls/",
+            "_users": "users/"
+          }
+        }
+      }
+    }
+  }
+}
diff --git a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBSqlDatabaseList.json b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBSqlDatabaseList.json
new file mode 100644
index 000000000000..5ecd47ea4ea1
--- /dev/null
+++ b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBSqlDatabaseList.json
@@ -0,0 +1,33 @@
+{
+  "parameters": {
+    "api-version": "2020-09-01",
+    "subscriptionId": "subid",
+    "resourceGroupName": "rgName",
+    "accountName": "ddb1"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.DocumentDB/databaseAccounts/ddb1/sqlDatabases/databaseName",
+            "name": "databaseName",
+            "type": "Microsoft.DocumentDB/databaseAccounts/sqlDatabases",
+            "location": "West US",
+            "tags": {},
+            "properties": {
+              "resource": {
+                "id": "databaseName",
+                "_rid": "CqNBAA==",
+                "_ts": 1449602962,
+                "_etag": "\"00000a00-0000-0000-0000-56672f920000\"",
+                "_colls": "colls/",
+                "_users": "users/"
+              }
+            }
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBSqlDatabaseMigrateToAutoscale.json b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBSqlDatabaseMigrateToAutoscale.json
new file mode 100644
index 000000000000..9b8629c7c3bb
--- /dev/null
+++ b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBSqlDatabaseMigrateToAutoscale.json
@@ -0,0 +1,29 @@
+{
+  "parameters": {
+    "accountName": "ddb1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-09-01",
+    "subscriptionId": "subid",
+    "databaseName": "databaseName"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "properties": {
+          "resource": {
+            "throughput": 400,
+            "autoscaleSettings": {
+              "maxThroughput": 4000
+            },
+            "minimumThroughput": "4000",
+            "offerReplacePending": "false",
+            "_rid": "PD5DALigDgw=",
+            "_ts": 1459200611,
+            "_etag": "\"00005900-0000-0000-0000-56f9a2630000\""
+          }
+        }
+      }
+    },
+    "202": {}
+  }
+}
diff --git a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBSqlDatabaseMigrateToManualThroughput.json b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBSqlDatabaseMigrateToManualThroughput.json
new file mode 100644
index 000000000000..8e8f2dc00ed2
--- /dev/null
+++ b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBSqlDatabaseMigrateToManualThroughput.json
@@ -0,0 +1,26 @@
+{
+  "parameters": {
+    "accountName": "ddb1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-09-01",
+    "subscriptionId": "subid",
+    "databaseName": "databaseName"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "properties": {
+          "resource": {
+            "throughput": 400,
+            "minimumThroughput": "400",
+            "offerReplacePending": "true",
+            "_rid": "PD5DALigDgw=",
+            "_ts": 1459200611,
+            "_etag": "\"00005900-0000-0000-0000-56f9a2630000\""
+          }
+        }
+      }
+    },
+    "202": {}
+  }
+}
diff --git a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBSqlDatabaseThroughputGet.json b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBSqlDatabaseThroughputGet.json
new file mode 100644
index 000000000000..5710eb7386ba
--- /dev/null
+++ b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBSqlDatabaseThroughputGet.json
@@ -0,0 +1,30 @@
+{
+  "parameters": {
+    "accountName": "ddb1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-09-01",
+    "subscriptionId": "subid",
+    "databaseName": "databaseName"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.DocumentDB/databaseAccounts/ddb1/sqlDatabases/databaseName/throughputSettings/default",
+        "name": "default",
+        "type": "Microsoft.DocumentDB/databaseAccounts/sqlDatabases/throughputSettings",
+        "location": "West US",
+        "tags": {},
+        "properties": {
+          "resource": {
+            "throughput": 400,
+            "minimumThroughput": "400",
+            "offerReplacePending": "true",
+            "_rid": "PD5DALigDgw=",
+            "_ts": 1459200611,
+            "_etag": "\"00005900-0000-0000-0000-56f9a2630000\""
+          }
+        }
+      }
+    }
+  }
+}
diff --git a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBSqlDatabaseThroughputUpdate.json b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBSqlDatabaseThroughputUpdate.json
new file mode 100644
index 000000000000..08418ba9ce65
--- /dev/null
+++ b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBSqlDatabaseThroughputUpdate.json
@@ -0,0 +1,40 @@
+{
+  "parameters": {
+    "accountName": "ddb1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-09-01",
+    "subscriptionId": "subid",
+    "databaseName": "databaseName",
+    "updateThroughputParameters": {
+      "location": "West US",
+      "tags": {},
+      "properties": {
+        "resource": {
+          "throughput": 400
+        }
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.DocumentDB/databaseAccounts/ddb1/sqlDatabases/databaseName/throughputSettings/default",
+        "name": "default",
+        "type": "Microsoft.DocumentDB/databaseAccounts/sqlDatabases/throughputSettings",
+        "location": "West US",
+        "tags": {},
+        "properties": {
+          "resource": {
+            "throughput": 400,
+            "minimumThroughput": "400",
+            "offerReplacePending": "true",
+            "_rid": "PD5DALigDgw=",
+            "_ts": 1459200611,
+            "_etag": "\"00005900-0000-0000-0000-56f9a2630000\""
+          }
+        }
+      }
+    },
+    "202": {}
+  }
+}
diff --git a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBSqlStoredProcedureCreateUpdate.json b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBSqlStoredProcedureCreateUpdate.json
new file mode 100644
index 000000000000..64be1b03bdfb
--- /dev/null
+++ b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBSqlStoredProcedureCreateUpdate.json
@@ -0,0 +1,39 @@
+{
+  "parameters": {
+    "accountName": "ddb1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-09-01",
+    "subscriptionId": "subid",
+    "databaseName": "databaseName",
+    "containerName": "containerName",
+    "storedProcedureName": "storedProcedureName",
+    "createUpdateSqlStoredProcedureParameters": {
+      "properties": {
+        "resource": {
+          "id": "storedProcedureName",
+          "body": "body"
+        },
+        "options": {}
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.DocumentDB/databaseAccounts/ddb1/sqlDatabases/databaseName/sqlContainers/containerName/sqlStoredProcedures/storedProcedureName",
+        "name": "storedProcedureName",
+        "type": "Microsoft.DocumentDB/databaseAccounts/sqlDatabases/sqlContainers/sqlStoredProcedures",
+        "properties": {
+          "resource": {
+            "id": "storedProcedureName",
+            "body": "body",
+            "_rid": "PD5DALigDgw=",
+            "_ts": 1459200611,
+            "_etag": "\"00005900-0000-0000-0000-56f9a2630000\""
+          }
+        }
+      }
+    },
+    "202": {}
+  }
+}
diff --git a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBSqlStoredProcedureDelete.json b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBSqlStoredProcedureDelete.json
new file mode 100644
index 000000000000..d658c38fc1ad
--- /dev/null
+++ b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBSqlStoredProcedureDelete.json
@@ -0,0 +1,15 @@
+{
+  "parameters": {
+    "accountName": "ddb1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-09-01",
+    "subscriptionId": "subid",
+    "databaseName": "databaseName",
+    "containerName": "containerName",
+    "storedProcedureName": "storedProcedureName"
+  },
+  "responses": {
+    "204": {},
+    "202": {}
+  }
+}
diff --git a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBSqlStoredProcedureGet.json b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBSqlStoredProcedureGet.json
new file mode 100644
index 000000000000..0f712d8d1f5d
--- /dev/null
+++ b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBSqlStoredProcedureGet.json
@@ -0,0 +1,29 @@
+{
+  "parameters": {
+    "api-version": "2020-09-01",
+    "subscriptionId": "subid",
+    "resourceGroupName": "rgName",
+    "accountName": "ddb1",
+    "databaseName": "databaseName",
+    "containerName": "containerName",
+    "storedProcedureName": "storedProcedureName"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.DocumentDB/databaseAccounts/ddb1/sqlDatabases/databaseName/sqlContainers/containerName/sqlStoredProcedures/storedProcedureName",
+        "name": "storedProcedureName",
+        "type": "Microsoft.DocumentDB/databaseAccounts/sqlDatabases/sqlContainers/sqlStoredProcedures",
+        "properties": {
+          "resource": {
+            "id": "storedProcedureName",
+            "body": "body",
+            "_rid": "PD5DALigDgw=",
+            "_ts": 1459200611,
+            "_etag": "\"00005900-0000-0000-0000-56f9a2630000\""
+          }
+        }
+      }
+    }
+  }
+}
diff --git a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBSqlStoredProcedureList.json b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBSqlStoredProcedureList.json
new file mode 100644
index 000000000000..3d208df315d6
--- /dev/null
+++ b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBSqlStoredProcedureList.json
@@ -0,0 +1,32 @@
+{
+  "parameters": {
+    "api-version": "2020-09-01",
+    "subscriptionId": "subid",
+    "resourceGroupName": "rgName",
+    "accountName": "ddb1",
+    "databaseName": "databaseName",
+    "containerName": "containerName"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.DocumentDB/databaseAccounts/ddb1/sqlDatabases/databaseName/sqlContainers/containerName/sqlStoredProcedures/storedProcedureName",
+            "name": "testctn",
+            "type": "Microsoft.DocumentDB/databaseAccounts/sqlDatabases/sqlContainers/sqlStoredProcedures",
+            "properties": {
+              "resource": {
+                "id": "testctn",
+                "body": "body",
+                "_rid": "PD5DALigDgw=",
+                "_ts": 1459200611,
+                "_etag": "\"00005900-0000-0000-0000-56f9a2630000\""
+              }
+            }
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBSqlTriggerCreateUpdate.json b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBSqlTriggerCreateUpdate.json
new file mode 100644
index 000000000000..944215f97b06
--- /dev/null
+++ b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBSqlTriggerCreateUpdate.json
@@ -0,0 +1,43 @@
+{
+  "parameters": {
+    "accountName": "ddb1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-09-01",
+    "subscriptionId": "subid",
+    "databaseName": "databaseName",
+    "containerName": "containerName",
+    "triggerName": "triggerName",
+    "createUpdateSqlTriggerParameters": {
+      "properties": {
+        "resource": {
+          "id": "triggerName",
+          "body": "body",
+          "triggerType": "triggerType",
+          "triggerOperation": "triggerOperation"
+        },
+        "options": {}
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.DocumentDB/databaseAccounts/ddb1/sqlDatabases/databaseName/sqlContainers/containerName/sqlTriggers/triggerName",
+        "name": "triggerName",
+        "type": "Microsoft.DocumentDB/databaseAccounts/sqlDatabases/sqlContainers/sqlTriggers",
+        "properties": {
+          "resource": {
+            "id": "triggerName",
+            "body": "body",
+            "triggerType": "triggerType",
+            "triggerOperation": "triggerOperation",
+            "_rid": "PD5DALigDgw=",
+            "_ts": 1459200611,
+            "_etag": "\"00005900-0000-0000-0000-56f9a2630000\""
+          }
+        }
+      }
+    },
+    "202": {}
+  }
+}
diff --git a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBSqlTriggerDelete.json b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBSqlTriggerDelete.json
new file mode 100644
index 000000000000..6f94d01a816b
--- /dev/null
+++ b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBSqlTriggerDelete.json
@@ -0,0 +1,15 @@
+{
+  "parameters": {
+    "accountName": "ddb1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-09-01",
+    "subscriptionId": "subid",
+    "databaseName": "databaseName",
+    "containerName": "containerName",
+    "triggerName": "triggerName"
+  },
+  "responses": {
+    "204": {},
+    "202": {}
+  }
+}
diff --git a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBSqlTriggerGet.json b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBSqlTriggerGet.json
new file mode 100644
index 000000000000..253b0db56134
--- /dev/null
+++ b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBSqlTriggerGet.json
@@ -0,0 +1,31 @@
+{
+  "parameters": {
+    "api-version": "2020-09-01",
+    "subscriptionId": "subid",
+    "resourceGroupName": "rgName",
+    "accountName": "ddb1",
+    "databaseName": "databaseName",
+    "containerName": "containerName",
+    "triggerName": "triggerName"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.DocumentDB/databaseAccounts/ddb1/sqlDatabases/databaseName/sqlContainers/containerName/sqlTriggers/triggerName",
+        "name": "triggerName",
+        "type": "Microsoft.DocumentDB/databaseAccounts/sqlDatabases/sqlContainers/sqlTriggers",
+        "properties": {
+          "resource": {
+            "id": "triggerName",
+            "body": "body",
+            "triggerType": "triggerType",
+            "triggerOperation": "triggerOperation",
+            "_rid": "PD5DALigDgw=",
+            "_ts": 1459200611,
+            "_etag": "\"00005900-0000-0000-0000-56f9a2630000\""
+          }
+        }
+      }
+    }
+  }
+}
diff --git a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBSqlTriggerList.json b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBSqlTriggerList.json
new file mode 100644
index 000000000000..64927ab15cd9
--- /dev/null
+++ b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBSqlTriggerList.json
@@ -0,0 +1,34 @@
+{
+  "parameters": {
+    "api-version": "2020-09-01",
+    "subscriptionId": "subid",
+    "resourceGroupName": "rgName",
+    "accountName": "ddb1",
+    "databaseName": "databaseName",
+    "containerName": "containerName"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.DocumentDB/databaseAccounts/ddb1/sqlDatabases/databaseName/sqlContainers/containerName/sqlTriggers/triggerName",
+            "name": "testctn",
+            "type": "Microsoft.DocumentDB/databaseAccounts/sqlDatabases/sqlContainers/sqlTriggers",
+            "properties": {
+              "resource": {
+                "id": "testctn",
+                "body": "body",
+                "triggerType": "triggerType",
+                "triggerOperation": "triggerOperation",
+                "_rid": "PD5DALigDgw=",
+                "_ts": 1459200611,
+                "_etag": "\"00005900-0000-0000-0000-56f9a2630000\""
+              }
+            }
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBSqlUserDefinedFunctionCreateUpdate.json b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBSqlUserDefinedFunctionCreateUpdate.json
new file mode 100644
index 000000000000..199e413365cb
--- /dev/null
+++ b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBSqlUserDefinedFunctionCreateUpdate.json
@@ -0,0 +1,39 @@
+{
+  "parameters": {
+    "accountName": "ddb1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-09-01",
+    "subscriptionId": "subid",
+    "databaseName": "databaseName",
+    "containerName": "containerName",
+    "userDefinedFunctionName": "userDefinedFunctionName",
+    "createUpdateSqlUserDefinedFunctionParameters": {
+      "properties": {
+        "resource": {
+          "id": "userDefinedFunctionName",
+          "body": "body"
+        },
+        "options": {}
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.DocumentDB/databaseAccounts/ddb1/sqlDatabases/databaseName/sqlContainers/containerName/sqlUserDefinedFunctions/userDefinedFunctionName",
+        "name": "userDefinedFunctionName",
+        "type": "Microsoft.DocumentDB/databaseAccounts/sqlDatabases/sqlContainers/sqlUserDefinedFunctions",
+        "properties": {
+          "resource": {
+            "id": "userDefinedFunctionName",
+            "body": "body",
+            "_rid": "PD5DALigDgw=",
+            "_ts": 1459200611,
+            "_etag": "\"00005900-0000-0000-0000-56f9a2630000\""
+          }
+        }
+      }
+    },
+    "202": {}
+  }
+}
diff --git a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBSqlUserDefinedFunctionDelete.json b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBSqlUserDefinedFunctionDelete.json
new file mode 100644
index 000000000000..dd852f7d6e2e
--- /dev/null
+++ b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBSqlUserDefinedFunctionDelete.json
@@ -0,0 +1,15 @@
+{
+  "parameters": {
+    "accountName": "ddb1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-09-01",
+    "subscriptionId": "subid",
+    "databaseName": "databaseName",
+    "containerName": "containerName",
+    "userDefinedFunctionName": "userDefinedFunctionName"
+  },
+  "responses": {
+    "204": {},
+    "202": {}
+  }
+}
diff --git a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBSqlUserDefinedFunctionGet.json b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBSqlUserDefinedFunctionGet.json
new file mode 100644
index 000000000000..9cbf8ebf6595
--- /dev/null
+++ b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBSqlUserDefinedFunctionGet.json
@@ -0,0 +1,29 @@
+{
+  "parameters": {
+    "api-version": "2020-09-01",
+    "subscriptionId": "subid",
+    "resourceGroupName": "rgName",
+    "accountName": "ddb1",
+    "databaseName": "databaseName",
+    "containerName": "containerName",
+    "userDefinedFunctionName": "userDefinedFunctionName"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.DocumentDB/databaseAccounts/ddb1/sqlDatabases/databaseName/sqlContainers/containerName/sqlUserDefinedFunctions/userDefinedFunctionName",
+        "name": "userDefinedFunctionName",
+        "type": "Microsoft.DocumentDB/databaseAccounts/sqlDatabases/sqlContainers/sqlUserDefinedFunctions",
+        "properties": {
+          "resource": {
+            "id": "userDefinedFunctionName",
+            "body": "body",
+            "_rid": "PD5DALigDgw=",
+            "_ts": 1459200611,
+            "_etag": "\"00005900-0000-0000-0000-56f9a2630000\""
+          }
+        }
+      }
+    }
+  }
+}
diff --git a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBSqlUserDefinedFunctionList.json b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBSqlUserDefinedFunctionList.json
new file mode 100644
index 000000000000..1785789c9731
--- /dev/null
+++ b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBSqlUserDefinedFunctionList.json
@@ -0,0 +1,32 @@
+{
+  "parameters": {
+    "api-version": "2020-09-01",
+    "subscriptionId": "subid",
+    "resourceGroupName": "rgName",
+    "accountName": "ddb1",
+    "databaseName": "databaseName",
+    "containerName": "containerName"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.DocumentDB/databaseAccounts/ddb1/sqlDatabases/databaseName/sqlContainers/containerName/sqlUserDefinedFunctions/userDefinedFunctionName",
+            "name": "testctn",
+            "type": "Microsoft.DocumentDB/databaseAccounts/sqlDatabases/sqlContainers/sqlUserDefinedFunctions",
+            "properties": {
+              "resource": {
+                "id": "testctn",
+                "body": "body",
+                "_rid": "PD5DALigDgw=",
+                "_ts": 1459200611,
+                "_etag": "\"00005900-0000-0000-0000-56f9a2630000\""
+              }
+            }
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBTableCreateUpdate.json b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBTableCreateUpdate.json
new file mode 100644
index 000000000000..26a948590a98
--- /dev/null
+++ b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBTableCreateUpdate.json
@@ -0,0 +1,35 @@
+{
+  "parameters": {
+    "accountName": "ddb1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-09-01",
+    "subscriptionId": "subid",
+    "tableName": "tableName",
+    "createUpdateTableParameters": {
+      "location": "West US",
+      "tags": {},
+      "properties": {
+        "resource": {
+          "id": "tableName"
+        },
+        "options": {}
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.DocumentDB/databaseAccounts/ddb1/tables/tableName",
+        "name": "tableName",
+        "type": "Microsoft.DocumentDB/databaseAccounts/tables",
+        "location": "West US",
+        "properties": {
+          "resource": {
+            "id": "tableName"
+          }
+        }
+      }
+    },
+    "202": {}
+  }
+}
diff --git a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBTableDelete.json b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBTableDelete.json
new file mode 100644
index 000000000000..bb58b961da41
--- /dev/null
+++ b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBTableDelete.json
@@ -0,0 +1,13 @@
+{
+  "parameters": {
+    "accountName": "ddb1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-09-01",
+    "subscriptionId": "subid",
+    "tableName": "tableName"
+  },
+  "responses": {
+    "204": {},
+    "202": {}
+  }
+}
diff --git a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBTableGet.json b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBTableGet.json
new file mode 100644
index 000000000000..b0f1a0d20f35
--- /dev/null
+++ b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBTableGet.json
@@ -0,0 +1,28 @@
+{
+  "parameters": {
+    "accountName": "ddb1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-09-01",
+    "subscriptionId": "subid",
+    "tableName": "tableName"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.DocumentDB/databaseAccounts/ddb1/tables/tableName",
+        "name": "tableName",
+        "type": "Microsoft.DocumentDB/databaseAccounts/tables",
+        "location": "West US",
+        "tags": {},
+        "properties": {
+          "resource": {
+            "id": "tableName",
+            "_rid": "PD5DALigDgw=",
+            "_ts": 1459200611,
+            "_etag": "\"00005900-0000-0000-0000-56f9a2630000\""
+          }
+        }
+      }
+    }
+  }
+}
diff --git a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBTableList.json b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBTableList.json
new file mode 100644
index 000000000000..9e5f0e00fdb8
--- /dev/null
+++ b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBTableList.json
@@ -0,0 +1,28 @@
+{
+  "parameters": {
+    "api-version": "2020-09-01",
+    "subscriptionId": "subid",
+    "resourceGroupName": "rgName",
+    "accountName": "ddb1"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.DocumentDB/databaseAccounts/ddb1/tables/tableName",
+            "name": "tableName",
+            "type": "Microsoft.DocumentDB/databaseAccounts/tables",
+            "location": "West US",
+            "tags": {},
+            "properties": {
+              "resource": {
+                "id": "tableName"
+              }
+            }
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBTableMigrateToAutoscale.json b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBTableMigrateToAutoscale.json
new file mode 100644
index 000000000000..a5dfe1d16f50
--- /dev/null
+++ b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBTableMigrateToAutoscale.json
@@ -0,0 +1,29 @@
+{
+  "parameters": {
+    "accountName": "ddb1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-09-01",
+    "subscriptionId": "subid",
+    "tableName": "tableName"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "properties": {
+          "resource": {
+            "throughput": 400,
+            "autoscaleSettings": {
+              "maxThroughput": 4000
+            },
+            "minimumThroughput": "4000",
+            "offerReplacePending": "false",
+            "_rid": "PD5DALigDgw=",
+            "_ts": 1459200611,
+            "_etag": "\"00005900-0000-0000-0000-56f9a2630000\""
+          }
+        }
+      }
+    },
+    "202": {}
+  }
+}
diff --git a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBTableMigrateToManualThroughput.json b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBTableMigrateToManualThroughput.json
new file mode 100644
index 000000000000..d51de224f66f
--- /dev/null
+++ b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBTableMigrateToManualThroughput.json
@@ -0,0 +1,26 @@
+{
+  "parameters": {
+    "accountName": "ddb1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-09-01",
+    "subscriptionId": "subid",
+    "tableName": "tableName"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "properties": {
+          "resource": {
+            "throughput": 400,
+            "minimumThroughput": "400",
+            "offerReplacePending": "true",
+            "_rid": "PD5DALigDgw=",
+            "_ts": 1459200611,
+            "_etag": "\"00005900-0000-0000-0000-56f9a2630000\""
+          }
+        }
+      }
+    },
+    "202": {}
+  }
+}
diff --git a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBTableThroughputGet.json b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBTableThroughputGet.json
new file mode 100644
index 000000000000..d0da78e9f395
--- /dev/null
+++ b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBTableThroughputGet.json
@@ -0,0 +1,30 @@
+{
+  "parameters": {
+    "accountName": "ddb1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-09-01",
+    "subscriptionId": "subid",
+    "tableName": "tableName"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.DocumentDB/databaseAccounts/ddb1/tables/tableName/throughputSettings/default",
+        "name": "default",
+        "type": "Microsoft.DocumentDB/databaseAccounts/tables/throughputSettings",
+        "location": "West US",
+        "tags": {},
+        "properties": {
+          "resource": {
+            "throughput": 400,
+            "minimumThroughput": "400",
+            "offerReplacePending": "true",
+            "_rid": "PD5DALigDgw=",
+            "_ts": 1459200611,
+            "_etag": "\"00005900-0000-0000-0000-56f9a2630000\""
+          }
+        }
+      }
+    }
+  }
+}
diff --git a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBTableThroughputUpdate.json b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBTableThroughputUpdate.json
new file mode 100644
index 000000000000..c36da4fcc471
--- /dev/null
+++ b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/examples/CosmosDBTableThroughputUpdate.json
@@ -0,0 +1,40 @@
+{
+  "parameters": {
+    "accountName": "ddb1",
+    "resourceGroupName": "rg1",
+    "api-version": "2020-09-01",
+    "subscriptionId": "subid",
+    "tableName": "tableName",
+    "updateThroughputParameters": {
+      "location": "West US",
+      "tags": {},
+      "properties": {
+        "resource": {
+          "throughput": 400
+        }
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.DocumentDB/databaseAccounts/ddb1/tables/tableName/throughputSettings/default",
+        "name": "default",
+        "type": "Microsoft.DocumentDB/databaseAccounts/tables/throughputSettings",
+        "location": "West US",
+        "tags": {},
+        "properties": {
+          "resource": {
+            "throughput": 400,
+            "minimumThroughput": "400",
+            "offerReplacePending": "true",
+            "_rid": "PD5DALigDgw=",
+            "_ts": 1459200611,
+            "_etag": "\"00005900-0000-0000-0000-56f9a2630000\""
+          }
+        }
+      }
+    },
+    "202": {}
+  }
+}
diff --git a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/notebook.json b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/notebook.json
new file mode 100644
index 000000000000..f14254b45682
--- /dev/null
+++ b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/stable/2020-09-01/notebook.json
@@ -0,0 +1,461 @@
+{
+  "swagger": "2.0",
+  "info": {
+    "title": "Cosmos DB",
+    "description": "Azure Cosmos DB Database Service Resource Provider REST API",
+    "version": "2020-09-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.DocumentDB/databaseAccounts/{accountName}/notebookWorkspaces": {
+      "get": {
+        "tags": [
+          "NotebookWorkspacesResource"
+        ],
+        "description": "Gets the notebook workspace resources of an existing Cosmos DB account.",
+        "operationId": "NotebookWorkspaces_ListByDatabaseAccount",
+        "x-ms-pageable": {
+          "nextLinkName": null
+        },
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "#/parameters/accountNameParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Successfully retrieved notebook workspace resources.",
+            "schema": {
+              "$ref": "#/definitions/NotebookWorkspaceListResult"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "../../stable/2020-09-01/cosmos-db.json#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-examples": {
+          "CosmosDBNotebookWorkspaceList": {
+            "$ref": "./examples/CosmosDBNotebookWorkspaceList.json"
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{accountName}/notebookWorkspaces/{notebookWorkspaceName}": {
+      "get": {
+        "tags": [
+          "NotebookWorkspacesResource"
+        ],
+        "description": "Gets the notebook workspace for a Cosmos DB account.",
+        "operationId": "NotebookWorkspaces_Get",
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "#/parameters/accountNameParameter"
+          },
+          {
+            "$ref": "#/parameters/NotebookWorkspaceNameParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Successfully retrieved a specified notebook workspace resource.",
+            "schema": {
+              "$ref": "#/definitions/NotebookWorkspace"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "../../stable/2020-09-01/cosmos-db.json#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-examples": {
+          "CosmosDBNotebookWorkspaceGet": {
+            "$ref": "./examples/CosmosDBNotebookWorkspaceGet.json"
+          }
+        }
+      },
+      "put": {
+        "tags": [
+          "NotebookWorkspacesResource"
+        ],
+        "description": "Creates the notebook workspace for a Cosmos DB account.",
+        "operationId": "NotebookWorkspaces_CreateOrUpdate",
+        "x-ms-long-running-operation": true,
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "#/parameters/accountNameParameter"
+          },
+          {
+            "$ref": "#/parameters/NotebookWorkspaceNameParameter"
+          },
+          {
+            "name": "notebookCreateUpdateParameters",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/NotebookWorkspaceCreateUpdateParameters"
+            },
+            "description": "The notebook workspace to create for the current database account."
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Creation of notebook workspace will complete asynchronously.",
+            "schema": {
+              "$ref": "#/definitions/NotebookWorkspace"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "../../stable/2020-09-01/cosmos-db.json#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-examples": {
+          "CosmosDBNotebookWorkspaceCreate": {
+            "$ref": "./examples/CosmosDBNotebookWorkspaceCreate.json"
+          }
+        }
+      },
+      "delete": {
+        "tags": [
+          "NotebookWorkspacesResource"
+        ],
+        "description": "Deletes the notebook workspace for a Cosmos DB account.",
+        "operationId": "NotebookWorkspaces_Delete",
+        "x-ms-long-running-operation": true,
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "#/parameters/accountNameParameter"
+          },
+          {
+            "$ref": "#/parameters/NotebookWorkspaceNameParameter"
+          }
+        ],
+        "responses": {
+          "202": {
+            "description": "The notebook workspace delete operation will complete asynchronously."
+          },
+          "204": {
+            "description": "The specified notebook workspace does not exist in the database account."
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "../../stable/2020-09-01/cosmos-db.json#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-examples": {
+          "CosmosDBNotebookWorkspaceDelete": {
+            "$ref": "./examples/CosmosDBNotebookWorkspaceDelete.json"
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{accountName}/notebookWorkspaces/{notebookWorkspaceName}/listConnectionInfo": {
+      "post": {
+        "tags": [
+          "NotebookWorkspacesResource"
+        ],
+        "operationId": "NotebookWorkspaces_ListConnectionInfo",
+        "x-ms-examples": {
+          "CosmosDBNotebookWorkspaceListConnectionInfo": {
+            "$ref": "./examples/CosmosDBNotebookWorkspaceListConnectionInfo.json"
+          }
+        },
+        "description": "Retrieves the connection info for the notebook workspace",
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "#/parameters/accountNameParameter"
+          },
+          {
+            "$ref": "#/parameters/NotebookWorkspaceNameParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The operation completed successfully.",
+            "schema": {
+              "$ref": "#/definitions/NotebookWorkspaceConnectionInfoResult"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "../../stable/2020-09-01/cosmos-db.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{accountName}/notebookWorkspaces/{notebookWorkspaceName}/regenerateAuthToken": {
+      "post": {
+        "tags": [
+          "NotebookWorkspacesResource"
+        ],
+        "operationId": "NotebookWorkspaces_RegenerateAuthToken",
+        "x-ms-long-running-operation": true,
+        "x-ms-examples": {
+          "CosmosDBNotebookWorkspaceRegenerateAuthToken": {
+            "$ref": "./examples/CosmosDBNotebookWorkspaceRegenerateAuthToken.json"
+          }
+        },
+        "description": "Regenerates the auth token for the notebook workspace",
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "#/parameters/accountNameParameter"
+          },
+          {
+            "$ref": "#/parameters/NotebookWorkspaceNameParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK"
+          },
+          "202": {
+            "description": "Accepted. The regenerate auth token operation will complete asynchronously."
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "../../stable/2020-09-01/cosmos-db.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{accountName}/notebookWorkspaces/{notebookWorkspaceName}/start": {
+      "post": {
+        "tags": [
+          "NotebookWorkspacesResource"
+        ],
+        "operationId": "NotebookWorkspaces_Start",
+        "x-ms-long-running-operation": true,
+        "x-ms-examples": {
+          "CosmosDBNotebookWorkspaceStart": {
+            "$ref": "./examples/CosmosDBNotebookWorkspaceStart.json"
+          }
+        },
+        "description": "Starts the notebook workspace",
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "#/parameters/accountNameParameter"
+          },
+          {
+            "$ref": "#/parameters/NotebookWorkspaceNameParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK"
+          },
+          "202": {
+            "description": "Accepted. The start operation will complete asynchronously."
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "../../stable/2020-09-01/cosmos-db.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      }
+    }
+  },
+  "definitions": {
+    "NotebookWorkspaceCreateUpdateParameters": {
+      "description": "Parameters to create a notebook workspace resource",
+      "type": "object",
+      "allOf": [
+        {
+          "$ref": "../../stable/2020-09-01/cosmos-db.json#/definitions/ARMProxyResource"
+        }
+      ]
+    },
+    "NotebookWorkspaceListResult": {
+      "description": "A list of notebook workspace resources",
+      "type": "object",
+      "properties": {
+        "value": {
+          "type": "array",
+          "description": "Array of notebook workspace resources",
+          "items": {
+            "$ref": "#/definitions/NotebookWorkspace"
+          }
+        }
+      }
+    },
+    "NotebookWorkspace": {
+      "description": "A notebook workspace resource",
+      "type": "object",
+      "properties": {
+        "properties": {
+          "$ref": "#/definitions/NotebookWorkspaceProperties",
+          "description": "Resource properties.",
+          "x-ms-client-flatten": true
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "../../stable/2020-09-01/cosmos-db.json#/definitions/ARMProxyResource"
+        }
+      ]
+    },
+    "NotebookWorkspaceProperties": {
+      "description": "Properties of a notebook workspace resource.",
+      "type": "object",
+      "properties": {
+        "notebookServerEndpoint": {
+          "description": "Specifies the endpoint of Notebook server.",
+          "type": "string",
+          "readOnly": true
+        },
+        "status": {
+          "description": "Status of the notebook workspace. Possible values are: Creating, Online, Deleting, Failed, Updating.",
+          "type": "string",
+          "readOnly": true
+        }
+      }
+    },
+    "NotebookWorkspaceConnectionInfoResult": {
+      "description": "The connection info for the given notebook workspace",
+      "properties": {
+        "authToken": {
+          "type": "string",
+          "description": "Specifies auth token used for connecting to Notebook server (uses token-based auth).",
+          "readOnly": true
+        },
+        "notebookServerEndpoint": {
+          "type": "string",
+          "description": "Specifies the endpoint of Notebook server.",
+          "readOnly": true
+        }
+      }
+    }
+  },
+  "parameters": {
+    "accountNameParameter": {
+      "name": "accountName",
+      "in": "path",
+      "required": true,
+      "type": "string",
+      "x-ms-parameter-location": "method",
+      "description": "Cosmos DB database account name.",
+      "minLength": 3,
+      "maxLength": 50,
+      "pattern": "^[a-z0-9]+(-[a-z0-9]+)*"
+    },
+    "NotebookWorkspaceNameParameter": {
+      "name": "notebookWorkspaceName",
+      "in": "path",
+      "description": "The name of the notebook workspace resource.",
+      "required": true,
+      "x-ms-parameter-location": "method",
+      "type": "string",
+      "enum": [
+        "default"
+      ],
+      "x-ms-enum": {
+        "name": "NotebookWorkspaceName",
+        "modelAsString": true
+      }
+    }
+  }
+}
diff --git a/specification/cosmos-db/resource-manager/readme.md b/specification/cosmos-db/resource-manager/readme.md
index 80054f71a6e8..c499f9084d26 100644
--- a/specification/cosmos-db/resource-manager/readme.md
+++ b/specification/cosmos-db/resource-manager/readme.md
@@ -4,10 +4,10 @@
 
 This is the AutoRest configuration file for Cosmos-DB.
 
-
-
 ---
+
 ## Getting Started
+
 To build the SDK for Cosmos-DB, simply [Install AutoRest](https://aka.ms/autorest/install) and in this folder, run:
 
 > `autorest`
@@ -15,21 +15,31 @@ To build the SDK for Cosmos-DB, simply [Install AutoRest](https://aka.ms/autores
 To see additional help and options, run:
 
 > `autorest --help`
+
 ---
 
 ## Configuration
 
-
-
 ### Basic Information
+
 These are the global settings for the Cosmos-DB API.
 
 ``` yaml
 title: CosmosDBManagementClient
 openapi-type: arm
-tag: package-2020-04
+tag: package-2020-09
 ```
 
+
+### Tag: package-2020-09
+
+These settings apply only when `--tag=package-2020-09` is specified on the command line.
+
+```yaml $(tag) == 'package-2020-09'
+input-file:
+  - Microsoft.DocumentDB/stable/2020-09-01/cosmos-db.json
+  - Microsoft.DocumentDB/stable/2020-09-01/notebook.json
+```
 ### Tag: package-2020-06-preview
 
 These settings apply only when `--tag=package-2020-06-preview` is specified on the command line.
@@ -147,6 +157,7 @@ input-file:
 ```
 
 ## Suppression
+
 ``` yaml
 directive:
   - suppress: TrackedResourceGetOperation
@@ -227,8 +238,8 @@ directive:
 ```
 
 ---
-# Code Generation
 
+# Code Generation
 
 ## Swagger to SDK
 
@@ -247,7 +258,6 @@ swagger-to-sdk:
       - node sdkauto_afterscript.js cosmos-db/resource-manager
 ```
 
-
 ## C#
 
 These settings apply only when `--csharp` is specified on the command line.
@@ -273,6 +283,7 @@ See configuration in [readme.go.md](./readme.go.md)
 ## Java
 
 See configuration in [readme.java.md](./readme.java.md)
+
 ## AzureResourceSchema
 
 See configuration in [readme.azureresourceschema.md](./readme.azureresourceschema.md)
diff --git a/specification/cost-management/resource-manager/Microsoft.CostManagement/stable/2019-11-01/costmanagement.json b/specification/cost-management/resource-manager/Microsoft.CostManagement/stable/2019-11-01/costmanagement.json
index 16f9d8c22663..e7a9d2b5817e 100644
--- a/specification/cost-management/resource-manager/Microsoft.CostManagement/stable/2019-11-01/costmanagement.json
+++ b/specification/cost-management/resource-manager/Microsoft.CostManagement/stable/2019-11-01/costmanagement.json
@@ -1098,6 +1098,135 @@
         }
       }
     },
+    "/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/providers/Microsoft.CostManagement/generateReservationDetailsReport": {
+      "post": {
+        "tags": [
+          "ReservedInstances"
+        ],
+        "operationId": "GenerateReservationDetailsReport_ByBillingAccountId",
+        "description": "Generates the reservations details report for provided date range asynchronously based on enrollment id.",
+        "externalDocs": {
+          "url": "https://docs.microsoft.com/en-us/rest/api/costmanagement/"
+        },
+        "x-ms-examples": {
+          "ReservationDetails": {
+            "$ref": "./examples/GenerateReservationDetailsReportByBillingAccount.json"
+          }
+        },
+        "x-ms-long-running-operation": true,
+        "x-ms-long-running-operation-options": {
+          "final-state-via": "location"
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/enrollmentIdParameter"
+          },
+          {
+            "$ref": "#/parameters/startDateParameter"
+          },
+          {
+            "$ref": "#/parameters/endDateParameter"
+          },
+          {
+            "$ref": "#/parameters/apiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Request processing completed.",
+            "schema": {
+              "$ref": "#/definitions/OperationStatus"
+            }
+          },
+          "202": {
+            "description": "Accepted. Request will be processed. Use the location header to check the status.",
+            "headers": {
+              "Location": {
+                "description": "The URL to check the status of the asynchronous operation.",
+                "type": "string"
+              },
+              "Retry-After": {
+                "description": "The amount of delay to use while the status of the operation is checked. The value is expressed in seconds.",
+                "format": "int32",
+                "type": "integer"
+              }
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponse"
+            }
+          }
+        }
+      }
+    },
+    "/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}/providers/Microsoft.CostManagement/generateReservationDetailsReport": {
+      "post": {
+        "tags": [
+          "ReservedInstances"
+        ],
+        "operationId": "GenerateReservationDetailsReport_ByBillingProfileId",
+        "description": "Generates the reservations details report for provided date range asynchronously by billing profile.",
+        "externalDocs": {
+          "url": "https://docs.microsoft.com/en-us/rest/api/costmanagement/"
+        },
+        "x-ms-examples": {
+          "ReservationDetails": {
+            "$ref": "./examples/GenerateReservationDetailsReportByBillingProfile.json"
+          }
+        },
+        "x-ms-long-running-operation": true,
+        "x-ms-long-running-operation-options": {
+          "final-state-via": "location"
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/billingAccountIdParameter"
+          },
+          {
+            "$ref": "#/parameters/billingProfileIdParameter"
+          },
+          {
+            "$ref": "#/parameters/startDateParameter"
+          },
+          {
+            "$ref": "#/parameters/endDateParameter"
+          },
+          {
+            "$ref": "#/parameters/apiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Request processing completed.",
+            "schema": {
+              "$ref": "#/definitions/OperationStatus"
+            }
+          },
+          "202": {
+            "description": "Accepted. Request will be processed. Use the Location header to check the status.",
+            "headers": {
+              "Location": {
+                "description": "The URL to check the status of the asynchronous operation.",
+                "type": "string"
+              },
+              "Retry-After": {
+                "description": "The amount of delay to use while the status of the operation is checked. The value is expressed in seconds.",
+                "format": "int32",
+                "type": "integer"
+              }
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/ErrorResponse"
+            }
+          }
+        }
+      }
+    },
     "/providers/Microsoft.CostManagement/operations": {
       "get": {
         "tags": [
@@ -2267,6 +2396,53 @@
         }
       }
     },
+    "Status": {
+      "description": "The status of the long running operation.",
+      "properties": {
+        "status": {
+          "description": "The status of the long running operation.",
+          "type": "string",
+          "enum": [
+            "Running",
+            "Completed",
+            "Failed"
+          ],
+          "x-ms-enum": {
+            "name": "OperationStatusType",
+            "modelAsString": true
+          }
+        }
+      }
+    },
+    "OperationStatus": {
+      "description": "The status of the long running operation.",
+      "properties": {
+        "status": {
+          "description": "The status of the long running operation.",
+          "$ref": "#/definitions/Status"
+        },
+        "properties": {
+          "x-ms-client-flatten": true,
+          "type": "object",
+          "description": "The properties of the resource generated.",
+          "$ref": "#/definitions/ReportURL"
+        }
+      }
+    },
+    "ReportURL": {
+      "description": "The URL to download the generated report.",
+      "properties": {
+        "reportUrl": {
+          "description": "The URL to download the generated report.",
+          "type": "string"
+        },
+        "validUntil": {
+          "description": "The time at which report URL becomes invalid.",
+          "type": "string",
+          "format": "date-time"
+        }
+      }
+    },
     "QueryDatasetConfiguration": {
       "description": "The configuration of dataset in the query.",
       "properties": {
@@ -2474,6 +2650,30 @@
       "type": "string",
       "x-ms-parameter-location": "method"
     },
+    "startDateParameter": {
+      "name": "startDate",
+      "in": "query",
+      "description": "Start Date",
+      "required": true,
+      "type": "string",
+      "x-ms-parameter-location": "method"
+    },
+    "endDateParameter": {
+      "name": "endDate",
+      "in": "query",
+      "description": "End Date",
+      "required": true,
+      "type": "string",
+      "x-ms-parameter-location": "method"
+    },
+    "enrollmentIdParameter": {
+      "name": "billingAccountId",
+      "in": "path",
+      "description": "Enrollment ID (Legacy BillingAccount ID)",
+      "required": true,
+      "type": "string",
+      "x-ms-parameter-location": "method"
+    },
     "billingAccountIdParameter": {
       "name": "billingAccountId",
       "in": "path",
@@ -2482,6 +2682,14 @@
       "type": "string",
       "x-ms-parameter-location": "method"
     },
+    "billingProfileIdParameter": {
+      "name": "billingProfileId",
+      "in": "path",
+      "description": "BillingProfile ID",
+      "required": true,
+      "type": "string",
+      "x-ms-parameter-location": "method"
+    },
     "managementGroupIdParameter": {
       "name": "managementGroupId",
       "in": "path",
diff --git a/specification/cost-management/resource-manager/Microsoft.CostManagement/stable/2019-11-01/examples/GenerateReservationDetailsReportByBillingAccount.json b/specification/cost-management/resource-manager/Microsoft.CostManagement/stable/2019-11-01/examples/GenerateReservationDetailsReportByBillingAccount.json
new file mode 100644
index 000000000000..d8c8f0f40faf
--- /dev/null
+++ b/specification/cost-management/resource-manager/Microsoft.CostManagement/stable/2019-11-01/examples/GenerateReservationDetailsReportByBillingAccount.json
@@ -0,0 +1,25 @@
+{
+  "parameters": {
+    "billingAccountId": "9845612",
+    "startDate": "2020-01-01",
+    "endDate": "2020-01-30",
+    "api-version": "2019-11-01"
+  },
+  "responses": {
+    "202": {
+      "headers": {
+        "Location": "https://management.azure.com/providers/Microsoft.Billing/billingAccounts/9845612/providers/Microsoft.CostManagement/reservationDetailsOperationResults/cf9f95c9-af6b-41dd-a622-e6f4fc60c3ee?api-version=2019-11-01",
+        "Retry-After": "60"
+      }
+    },
+    "200": {
+      "body": {
+        "status": "Completed",
+        "properties": {
+          "reportUrl": "https://storage.blob.core.windows.net/details/20200911/00000000-0000-0000-0000-000000000000?sv=2016-05-31&sr=b&sig=jep8HT2aphfUkyERRZa5LRfd9RPzjXbzB%2F9TNiQ",
+          "validUntil": "2020-09-12T02:56:55.5021869Z"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/cost-management/resource-manager/Microsoft.CostManagement/stable/2019-11-01/examples/GenerateReservationDetailsReportByBillingProfile.json b/specification/cost-management/resource-manager/Microsoft.CostManagement/stable/2019-11-01/examples/GenerateReservationDetailsReportByBillingProfile.json
new file mode 100644
index 000000000000..a4bd203ef284
--- /dev/null
+++ b/specification/cost-management/resource-manager/Microsoft.CostManagement/stable/2019-11-01/examples/GenerateReservationDetailsReportByBillingProfile.json
@@ -0,0 +1,26 @@
+{
+  "parameters": {
+    "billingAccountId": "00000000-0000-0000-0000-000000000000",
+    "billingProfileId": "CZSFR-SDFXC-DSDF",
+    "startDate": "2020-01-01",
+    "endDate": "2020-01-30",
+    "api-version": "2019-11-01"
+  },
+  "responses": {
+    "202": {
+      "headers": {
+        "Location": "https://management.azure.com/providers/Microsoft.Billing/billingAccounts/00000000-0000-0000-0000-000000000000/billingProfiles/CZSFR-SDFXC-DSDF/providers/Microsoft.CostManagement/reservationDetailsOperationResults/cf9f95c9-af6b-41dd-a622-e6f4fc60c3ee?api-version=2019-11-01",
+        "Retry-After": "60"
+      }
+    },
+    "200": {
+      "body": {
+        "status": "Completed",
+        "properties": {
+          "reportUrl": "https://storage.blob.core.windows.net/details/20200911/00000000-0000-0000-0000-000000000000?sv=2016-05-31&sr=b&sig=jep8HT2aphfUkyERRZa5LRfd9RPzjXbzB%2F9TNiQ",
+          "validUntil": "2020-09-12T02:56:55.5021869Z"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/databoxedge/resource-manager/readme.java.md b/specification/databoxedge/resource-manager/readme.java.md
new file mode 100644
index 000000000000..d3c928f81c4e
--- /dev/null
+++ b/specification/databoxedge/resource-manager/readme.java.md
@@ -0,0 +1,75 @@
+## Java
+
+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)
+azure-arm: true
+fluent: true
+namespace: com.microsoft.azure.management.databoxedge
+license-header: MICROSOFT_MIT_NO_CODEGEN
+payload-flattening-threshold: 0
+output-folder: $(azure-libraries-for-java-folder)/azure-mgmt-databoxedge
+```
+
+### Java multi-api
+
+``` yaml $(java) && $(multiapi)
+batch:
+  - tag: package-2020-05-preview
+  - tag: package-2019-08
+  - tag: package-2019-07
+  - tag: package-2019-03  
+```
+
+### Tag: package-2020-05-preview and java
+
+These settings apply only when `--tag=package-2020-05-preview --java` is specified on the command line.
+Please also specify `--azure-libraries-for-java-folder=<path to the root directory of your azure-sdk-for-java clone>`.
+
+``` yaml $(tag) == 'package-2020-05-preview' && $(java) && $(multiapi)
+java:
+  namespace: com.microsoft.azure.management.databoxedge.v2020_05_01_preview
+  output-folder: $(azure-libraries-for-java-folder)/sdk/databoxedge/v2020_05_01_preview
+regenerate-manager: true
+generate-interface: true
+```
+
+### Tag: package-2019-08 and java
+
+These settings apply only when `--tag=package-2019-08 --java` is specified on the command line.
+Please also specify `--azure-libraries-for-java-folder=<path to the root directory of your azure-sdk-for-java clone>`.
+
+``` yaml $(tag) == 'package-2019-08' && $(java) && $(multiapi)
+java:
+  namespace: com.microsoft.azure.management.databoxedge.v2019_08_01
+  output-folder: $(azure-libraries-for-java-folder)/sdk/databoxedge/mgmt-v2019_08_01
+regenerate-manager: true
+generate-interface: true
+```
+
+### Tag: package-2019-07 and java
+
+These settings apply only when `--tag=package-2019-07 --java` is specified on the command line.
+Please also specify `--azure-libraries-for-java-folder=<path to the root directory of your azure-sdk-for-java clone>`.
+
+``` yaml $(tag) == 'package-2019-07' && $(java) && $(multiapi)
+java:
+  namespace: com.microsoft.azure.management.databoxedge.v2019_07_01
+  output-folder: $(azure-libraries-for-java-folder)/sdk/databoxedge/mgmt-v2019_07_01
+regenerate-manager: true
+generate-interface: true
+```
+
+### Tag: package-2019-03 and java
+
+These settings apply only when `--tag=package-2019-03 --java` is specified on the command line.
+Please also specify `--azure-libraries-for-java-folder=<path to the root directory of your azure-sdk-for-java clone>`.
+
+``` yaml $(tag) == 'package-2019-03' && $(java) && $(multiapi)
+java:
+  namespace: com.microsoft.azure.management.databoxedge.v2019_03_01
+  output-folder: $(azure-libraries-for-java-folder)/sdk/databoxedge/mgmt-v2019_03_01
+regenerate-manager: true
+generate-interface: true
+```
\ No newline at end of file
diff --git a/specification/databoxedge/resource-manager/readme.md b/specification/databoxedge/resource-manager/readme.md
index 94ad3a2423d2..6d750b3f2fd6 100644
--- a/specification/databoxedge/resource-manager/readme.md
+++ b/specification/databoxedge/resource-manager/readme.md
@@ -120,80 +120,7 @@ See configuration in [readme.go.md](./readme.go.md)
 
 ## Java
 
-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.databoxedge
-  license-header: MICROSOFT_MIT_NO_CODEGEN
-  payload-flattening-threshold: 0
-  output-folder: $(azure-libraries-for-java-folder)/azure-mgmt-databoxedge
-```
-
-### Java multi-api
-
-``` yaml $(java) && $(multiapi)
-batch:
-  - tag: package-2019-03
-  - tag: package-2019-07
-  - tag: package-2019-08
-  - tag: package-2020-05-preview
-```
-
-### Tag: package-2020-05-preview and java
-
-These settings apply only when `--tag=package-2020-05-preview --java` is specified on the command line.
-Please also specify `--azure-libraries-for-java-folder=<path to the root directory of your azure-sdk-for-java clone>`.
-
-``` yaml $(tag) == 'package-2020-05-preview' && $(java) && $(multiapi)
-java:
-  namespace: com.microsoft.azure.management.databoxedge.v2020_05_01_preview
-  output-folder: $(azure-libraries-for-java-folder)/databoxedge/resource-manager/v2020_05_01_preview
-regenerate-manager: true
-generate-interface: true
-```
-
-### Tag: package-2019-08 and java
-
-These settings apply only when `--tag=package-2019-08 --java` is specified on the command line.
-Please also specify `--azure-libraries-for-java-folder=<path to the root directory of your azure-sdk-for-java clone>`.
-
-``` yaml $(tag) == 'package-2019-08' && $(java) && $(multiapi)
-java:
-  namespace: com.microsoft.azure.management.databoxedge.v2019_08_01
-  output-folder: $(azure-libraries-for-java-folder)/databoxedge/resource-manager/v2019_08_01
-regenerate-manager: true
-generate-interface: true
-```
-
-### Tag: package-2019-07 and java
-
-These settings apply only when `--tag=package-2019-07 --java` is specified on the command line.
-Please also specify `--azure-libraries-for-java-folder=<path to the root directory of your azure-sdk-for-java clone>`.
-
-``` yaml $(tag) == 'package-2019-07' && $(java) && $(multiapi)
-java:
-  namespace: com.microsoft.azure.management.databoxedge.v2019_07_01
-  output-folder: $(azure-libraries-for-java-folder)/sdk/databoxedge/mgmt-v2019_07_01
-regenerate-manager: true
-generate-interface: true
-```
-
-### Tag: package-2019-03 and java
-
-These settings apply only when `--tag=package-2019-03 --java` is specified on the command line.
-Please also specify `--azure-libraries-for-java-folder=<path to the root directory of your azure-sdk-for-java clone>`.
-
-``` yaml $(tag) == 'package-2019-03' && $(java) && $(multiapi)
-java:
-  namespace: com.microsoft.azure.management.databoxedge.v2019_03_01
-  output-folder: $(azure-libraries-for-java-folder)/sdk/databoxedge/mgmt-v2019_03_01
-regenerate-manager: true
-generate-interface: true
-```
+See configuration in [readme.java.md](./readme.java.md)
 
 ## AzureResourceSchema
 
diff --git a/specification/databricks/resource-manager/readme.md b/specification/databricks/resource-manager/readme.md
index bcbfa7452f8f..738868fe3b76 100644
--- a/specification/databricks/resource-manager/readme.md
+++ b/specification/databricks/resource-manager/readme.md
@@ -61,6 +61,18 @@ input-file:
 - Microsoft.Databricks/stable/2018-04-01/databricks.json
 ```
 
+---
+# Suppressions
+
+``` yaml
+directive:
+  - suppress: R3016
+    from: databricks.json 
+    where: $.definitions.Encryption.properties.KeyName
+    reason: Response from service is not camel case
+```
+
+---
 # Code Generation
 
 ## Swagger to SDK
diff --git a/specification/datafactory/resource-manager/Microsoft.DataFactory/stable/2018-06-01/entityTypes/Trigger.json b/specification/datafactory/resource-manager/Microsoft.DataFactory/stable/2018-06-01/entityTypes/Trigger.json
index b9ff8cce6b89..fcc6219cd204 100644
--- a/specification/datafactory/resource-manager/Microsoft.DataFactory/stable/2018-06-01/entityTypes/Trigger.json
+++ b/specification/datafactory/resource-manager/Microsoft.DataFactory/stable/2018-06-01/entityTypes/Trigger.json
@@ -428,7 +428,8 @@
       "type": "string",
       "enum": [
         "Minute",
-        "Hour"
+        "Hour",
+        "Month"
       ],
       "x-ms-enum": {
         "name": "TumblingWindowFrequency",
diff --git a/specification/desktopvirtualization/resource-manager/readme.md b/specification/desktopvirtualization/resource-manager/readme.md
index 3824f31c9811..a367a2287c74 100644
--- a/specification/desktopvirtualization/resource-manager/readme.md
+++ b/specification/desktopvirtualization/resource-manager/readme.md
@@ -61,15 +61,6 @@ input-file:
 - Microsoft.DesktopVirtualization/preview/2019-09-24-preview/desktopvirtualization.json
 ```
 
-### Tag: package-2019-12-10-preview
-
-These settings apply only when `--tag=package-2019-12-10-preview` is specified on the command line.
-
-``` yaml $(tag) == 'package-2019-12-10-preview'
-input-file:
-- Microsoft.DesktopVirtualization/preview/2019-12-10-preview/desktopvirtualization.json
-```
-
 ---
 # Code Generation
 
diff --git a/specification/healthcareapis/resource-manager/readme.azureresourceschema.md b/specification/healthcareapis/resource-manager/readme.azureresourceschema.md
index 42e1803f9586..daa2dfcc9c7d 100644
--- a/specification/healthcareapis/resource-manager/readme.azureresourceschema.md
+++ b/specification/healthcareapis/resource-manager/readme.azureresourceschema.md
@@ -6,6 +6,7 @@ These settings apply only when `--azureresourceschema` is specified on the comma
 
 ``` yaml $(azureresourceschema) && $(multiapi)
 batch:
+  - tag: schema-healthcareapis-2020-03-30
   - tag: schema-healthcareapis-2020-03-15
   - tag: schema-healthcareapis-2019-09-16
   - tag: schema-healthcareapis-2018-08-20-preview
@@ -14,6 +15,17 @@ batch:
 
 Please also specify `--azureresourceschema-folder=<path to the root directory of your azure-resource-manager-schemas clone>`.
 
+### Tag: schema-healthcareapis-2020-03-30 and azureresourceschema
+
+``` yaml $(tag) == 'schema-healthcareapis-2020-03-30' && $(azureresourceschema)
+output-folder: $(azureresourceschema-folder)/schemas
+
+# all the input files in this apiVersion
+input-file:
+  - Microsoft.HealthcareApis/stable/2020-03-30/healthcare-apis.json
+
+```
+
 ### Tag: schema-healthcareapis-2020-03-15 and azureresourceschema
 
 ``` yaml $(tag) == 'schema-healthcareapis-2020-03-15' && $(azureresourceschema)
diff --git a/specification/healthcareapis/resource-manager/readme.go.md b/specification/healthcareapis/resource-manager/readme.go.md
index ddffe9a42ed7..b47d6f3e2d80 100644
--- a/specification/healthcareapis/resource-manager/readme.go.md
+++ b/specification/healthcareapis/resource-manager/readme.go.md
@@ -13,11 +13,21 @@ go:
 
 ``` yaml $(go) && $(multiapi)
 batch:
+  - tag: package-2020-03-30
   - tag: package-2020-03
   - tag: package-2019-09
   - tag: package-2018-08-preview
 ```
 
+### Tag: package-2020-03-30 and go
+
+These settings apply only when `--tag=package-2020-03-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-03-30' && $(go)
+output-folder: $(go-sdk-folder)/services/$(namespace)/mgmt/2020-03-30/$(namespace)
+```
+
 ### Tag: package-2020-03 and go
 
 These settings apply only when `--tag=package-2020-03 --go` is specified on the command line.
diff --git a/specification/healthcareapis/resource-manager/readme.java.md b/specification/healthcareapis/resource-manager/readme.java.md
index eab1f83bc940..18d1360da512 100644
--- a/specification/healthcareapis/resource-manager/readme.java.md
+++ b/specification/healthcareapis/resource-manager/readme.java.md
@@ -16,11 +16,25 @@ output-folder: $(azure-libraries-for-java-folder)/azure-mgmt-healthcareapis
 
 ``` yaml $(java) && $(multiapi)
 batch:
+  - tag: package-2020-03-30
   - tag: package-2020-03
   - tag: package-2019-09  
   - tag: package-2018-08-preview
 ```
 
+### Tag: package-2020-03-30 and java
+
+These settings apply only when `--tag=package-2020-03-30 --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-03-30' && $(java) && $(multiapi)
+java:
+  namespace: com.microsoft.azure.management.healthcareapis.v2020_03_30
+  output-folder: $(azure-libraries-for-java-folder)/sdk/healthcareapis/mgmt-v2020_03_30
+regenerate-manager: true
+generate-interface: true
+```
+
 ### Tag: package-2020-03 and java
 
 These settings apply only when `--tag=package-2020-03 --java` is specified on the command line.
diff --git a/specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/common.json b/specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/common.json
index be4e038ae09f..edc0cb615d2a 100644
--- a/specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/common.json
+++ b/specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/common.json
@@ -2,7 +2,7 @@
   "swagger": "2.0",
   "info": {
     "title": "HybridNetworkManagementClient",
-    "description": "The definitions in this swagger specification will be used to manage the hybrid network resources.",
+    "description": "The definitions in this swagger specification will be used to manage the Hybrid Network resources.",
     "version": "2020-01-01-preview"
   },
   "host": "management.azure.com",
@@ -35,64 +35,6 @@
   },
   "paths": {},
   "definitions": {
-    "ErrorDetails": {
-      "description": "The error response that indicates why an operation has failed.",
-      "type": "object",
-      "properties": {
-        "error": {
-          "$ref": "#/definitions/ErrorResponse"
-        }
-      }
-    },
-    "ErrorResponse": {
-      "description": "The error response details containing error code and error message",
-      "type": "object",
-      "additionalProperties": true,
-      "properties": {
-        "code": {
-          "description": "The error code.",
-          "type": "string",
-          "readOnly": true
-        },
-        "message": {
-          "description": "The error message.",
-          "type": "string",
-          "readOnly": true
-        }
-      }
-    },
-    "Resource": {
-      "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."
-        },
-        "tags": {
-          "type": "object",
-          "additionalProperties": {
-            "type": "string"
-          },
-          "description": "Resource tags."
-        }
-      },
-      "description": "Common resource representation.",
-      "x-ms-azure-resource": true
-    },
     "SubResource": {
       "properties": {
         "id": {
@@ -169,13 +111,12 @@
         },
         "vmSwitchType": {
           "type": "string",
-          "description": "The type of VM switch",
+          "description": "The type of the VM switch.",
           "enum": [
             "Unknown",
             "Management",
             "Wan",
-            "Lan",
-            "Internal"
+            "Lan"
           ],
           "x-ms-enum": {
             "name": "VMSwitchType",
@@ -247,32 +188,73 @@
     },
     "SkuType": {
       "type": "string",
-      "description": "Sku type",
+      "description": "Sku type.",
       "enum": [
         "Unknown",
         "EvolvedPacketCore",
-        "SDWAN"
+        "SDWAN",
+        "Firewall"
       ],
       "x-ms-enum": {
         "name": "SkuType",
         "modelAsString": true
       }
-    }
-  },
-  "parameters": {
-    "SubscriptionIdParameter": {
-      "name": "subscriptionId",
-      "in": "path",
-      "required": true,
-      "type": "string",
-      "description": "The subscription ID which uniquely identify the 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."
+    "OsProfile": {
+      "properties": {
+        "adminUsername": {
+          "type": "string",
+          "description": "Specifies the name of the administrator account. <br><br> **Windows-only restriction:** Cannot end in \".\" <br><br> **Disallowed values:** \"administrator\", \"admin\", \"user\", \"user1\", \"test\", \"user2\", \"test1\", \"user3\", \"admin1\", \"1\", \"123\", \"a\", \"actuser\", \"adm\", \"admin2\", \"aspnet\", \"backup\", \"console\", \"david\", \"guest\", \"john\", \"owner\", \"root\", \"server\", \"sql\", \"support\", \"support_388945a0\", \"sys\", \"test2\", \"test3\", \"user4\", \"user5\". <br><br> **Minimum-length (Linux):** 1  character <br><br> **Max-length (Linux):** 64 characters <br><br> **Max-length (Windows):** 20 characters  <br><br><li> For root access to the Linux VM, see [Using root privileges on Linux virtual machines in Azure](https://docs.microsoft.com/azure/virtual-machines/virtual-machines-linux-use-root-privileges?toc=%2fazure%2fvirtual-machines%2flinux%2ftoc.json)<br><li> For a list of built-in system users on Linux that should not be used in this field, see [Selecting User Names for Linux on Azure](https://docs.microsoft.com/azure/virtual-machines/virtual-machines-linux-usernames?toc=%2fazure%2fvirtual-machines%2flinux%2ftoc.json)."
+        },
+        "linuxConfiguration": {
+          "$ref": "#/definitions/LinuxConfiguration",
+          "description": "Specifies the Linux operating system settings on the virtual machine. <br><br>For a list of supported Linux distributions, see [Linux on Azure-Endorsed Distributions](https://docs.microsoft.com/azure/virtual-machines/virtual-machines-linux-endorsed-distros?toc=%2fazure%2fvirtual-machines%2flinux%2ftoc.json) <br><br> For running non-endorsed distributions, see [Information for Non-Endorsed Distributions](https://docs.microsoft.com/azure/virtual-machines/virtual-machines-linux-create-upload-generic?toc=%2fazure%2fvirtual-machines%2flinux%2ftoc.json)."
+        },
+        "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)"
+        },
+        "customDataRequired": {
+          "type": "boolean",
+          "default": true,
+          "description": "Indicates if custom data is required to deploy this role."
+        }
+      },
+      "description": "Specifies the operating system settings for the role instance."
+    },
+    "LinuxConfiguration": {
+      "properties": {
+        "ssh": {
+          "$ref": "#/definitions/SshConfiguration",
+          "description": "Specifies the ssh key configuration for a Linux OS."
+        }
+      },
+      "description": "Specifies the Linux operating system settings on the virtual machine."
+    },
+    "SshConfiguration": {
+      "properties": {
+        "publicKeys": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/SshPublicKey"
+          },
+          "description": "The list of SSH public keys used to authenticate with linux based VMs."
+        }
+      },
+      "description": "SSH configuration for Linux based VMs running on Azure"
+    },
+    "SshPublicKey": {
+      "properties": {
+        "path": {
+          "type": "string",
+          "description": "Specifies the full path on the created VM where ssh public key is stored. If the file already exists, the specified key is appended to the file. Example: /home/user/.ssh/authorized_keys"
+        },
+        "keyData": {
+          "type": "string",
+          "description": "SSH public key certificate used to authenticate with the VM through ssh. The key needs to be at least 2048-bit and in ssh-rsa format. <br><br> For creating ssh keys, see [Create SSH keys on Linux and Mac for Linux VMs in Azure](https://docs.microsoft.com/azure/virtual-machines/virtual-machines-linux-mac-create-ssh-keys?toc=%2fazure%2fvirtual-machines%2flinux%2ftoc.json)."
+        }
+      },
+      "description": "Contains information about SSH certificate public key and the path on the Linux VM where the public key is placed."
     }
   }
 }
diff --git a/specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/device.json b/specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/device.json
index 2e2b87d45439..06a57e4ef093 100644
--- a/specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/device.json
+++ b/specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/device.json
@@ -2,7 +2,7 @@
   "swagger": "2.0",
   "info": {
     "title": "HybridNetworkManagementClient",
-    "description": "The resources in this swagger specification will be used to manage the hybrid network device",
+    "description": "The resources in this swagger specification will be used to manage the Hybrid Network device.",
     "version": "2020-01-01-preview"
   },
   "host": "management.azure.com",
@@ -40,48 +40,44 @@
           "Devices"
         ],
         "operationId": "Devices_Delete",
-        "description": "Deletes the specified hybrid network device.",
+        "description": "Deletes the specified device.",
         "parameters": [
           {
-            "name": "resourceGroupName",
-            "in": "path",
-            "required": true,
-            "type": "string",
-            "description": "The name of the resource group."
+            "$ref": "../../../../../common-types/resource-management/v2/types.json#/parameters/ResourceGroupNameParameter"
           },
           {
             "name": "deviceName",
             "in": "path",
             "required": true,
             "type": "string",
-            "description": "The name of the hybrid network device."
+            "description": "The name of the device resource."
           },
           {
-            "$ref": "./common.json#/parameters/ApiVersionParameter"
+            "$ref": "../../../../../common-types/resource-management/v2/types.json#/parameters/ApiVersionParameter"
           },
           {
-            "$ref": "./common.json#/parameters/SubscriptionIdParameter"
+            "$ref": "../../../../../common-types/resource-management/v2/types.json#/parameters/SubscriptionIdParameter"
           }
         ],
         "responses": {
           "200": {
-            "description": "The operation was successful."
+            "description": "The operation is successful."
           },
           "202": {
-            "description": "Accepted. Sets the provisioningState to 'Deleting' until the operation is completed. Returns an operation Uri that can be queried to find the current state of the operation."
+            "description": "Accepted. Sets the provisioningState to 'Deleting' until the operation is completed. Returns an operation URI that can be queried to find the current state of the operation."
           },
           "204": {
-            "description": "Request successful. Resource with specified name does not exist."
+            "description": "Request is successful. Resource with the specified name does not exist."
           },
           "default": {
             "description": "Error response describing why the operation failed.",
             "schema": {
-              "$ref": "./common.json#/definitions/ErrorDetails"
+              "$ref": "../../../../../common-types/resource-management/v2/types.json#/definitions/ErrorResponse"
             }
           }
         },
         "x-ms-examples": {
-          "Delete hybrid network device resource": {
+          "Delete device resource": {
             "$ref": "./examples/DeviceDelete.json"
           }
         },
@@ -95,32 +91,28 @@
           "Devices"
         ],
         "operationId": "Devices_Get",
-        "description": "Gets information about the specified hybrid network device.",
+        "description": "Gets information about the specified device.",
         "parameters": [
           {
-            "name": "resourceGroupName",
-            "in": "path",
-            "required": true,
-            "type": "string",
-            "description": "The name of the resource group."
+            "$ref": "../../../../../common-types/resource-management/v2/types.json#/parameters/ResourceGroupNameParameter"
           },
           {
             "name": "deviceName",
             "in": "path",
             "required": true,
             "type": "string",
-            "description": "The name of hybrid network device."
+            "description": "The name of the device resource."
           },
           {
-            "$ref": "./common.json#/parameters/ApiVersionParameter"
+            "$ref": "../../../../../common-types/resource-management/v2/types.json#/parameters/ApiVersionParameter"
           },
           {
-            "$ref": "./common.json#/parameters/SubscriptionIdParameter"
+            "$ref": "../../../../../common-types/resource-management/v2/types.json#/parameters/SubscriptionIdParameter"
           }
         ],
         "responses": {
           "200": {
-            "description": "Request successful. The operation returns the resulting hybrid network device resource.",
+            "description": "Request is successful. The operation returns the resulting device resource.",
             "schema": {
               "$ref": "#/definitions/Device"
             }
@@ -128,12 +120,12 @@
           "default": {
             "description": "Error response describing why the operation failed.",
             "schema": {
-              "$ref": "./common.json#/definitions/ErrorDetails"
+              "$ref": "../../../../../common-types/resource-management/v2/types.json#/definitions/ErrorResponse"
             }
           }
         },
         "x-ms-examples": {
-          "Get hybrid network device": {
+          "Get  device resource": {
             "$ref": "./examples/DeviceGet.json"
           }
         }
@@ -143,14 +135,10 @@
           "Devices"
         ],
         "operationId": "Devices_CreateOrUpdate",
-        "description": "Creates or updates a hybrid network device.",
+        "description": "Creates or updates a device.",
         "parameters": [
           {
-            "name": "resourceGroupName",
-            "in": "path",
-            "required": true,
-            "type": "string",
-            "description": "The name of the resource group."
+            "$ref": "../../../../../common-types/resource-management/v2/types.json#/parameters/ResourceGroupNameParameter"
           },
           {
             "name": "deviceName",
@@ -166,24 +154,24 @@
             "schema": {
               "$ref": "#/definitions/Device"
             },
-            "description": "Parameters supplied to the create or update hybrid network device operation."
+            "description": "Parameters supplied to the create or update device operation."
           },
           {
-            "$ref": "./common.json#/parameters/ApiVersionParameter"
+            "$ref": "../../../../../common-types/resource-management/v2/types.json#/parameters/ApiVersionParameter"
           },
           {
-            "$ref": "./common.json#/parameters/SubscriptionIdParameter"
+            "$ref": "../../../../../common-types/resource-management/v2/types.json#/parameters/SubscriptionIdParameter"
           }
         ],
         "responses": {
           "200": {
-            "description": "Create or update successful.",
+            "description": "Creation or update is successful.",
             "schema": {
               "$ref": "#/definitions/Device"
             }
           },
           "201": {
-            "description": "Create or update successful. The header contains ‘Azure-AsyncOperation’ header pointing to an operations resource. The operation URI can be queried to find the current state of the operation.",
+            "description": "Creation or update is successful. The header contains 'Azure-AsyncOperation' header pointing to an operations resource. The operation URI can be queried to find the current state of the operation.",
             "schema": {
               "$ref": "#/definitions/Device"
             }
@@ -191,12 +179,12 @@
           "default": {
             "description": "Error response describing why the operation failed.",
             "schema": {
-              "$ref": "./common.json#/definitions/ErrorDetails"
+              "$ref": "../../../../../common-types/resource-management/v2/types.json#/definitions/ErrorResponse"
             }
           }
         },
         "x-ms-examples": {
-          "Create or update hybrid network device": {
+          "Create or update device": {
             "$ref": "./examples/DeviceCreate.json"
           }
         },
@@ -210,21 +198,17 @@
           "Devices"
         ],
         "operationId": "Devices_UpdateTags",
-        "description": "Updates a hybrid network device tags.",
+        "description": "Updates device tags.",
         "parameters": [
           {
-            "name": "resourceGroupName",
-            "in": "path",
-            "required": true,
-            "type": "string",
-            "description": "The name of the resource group."
+            "$ref": "../../../../../common-types/resource-management/v2/types.json#/parameters/ResourceGroupNameParameter"
           },
           {
             "name": "deviceName",
             "in": "path",
             "required": true,
             "type": "string",
-            "description": "The name of the hybrid network device."
+            "description": "The name of the device resource."
           },
           {
             "name": "parameters",
@@ -233,18 +217,18 @@
             "schema": {
               "$ref": "./common.json#/definitions/TagsObject"
             },
-            "description": "Parameters supplied to update hybrid network device tags."
+            "description": "Parameters supplied to the update device tags operation."
           },
           {
-            "$ref": "./common.json#/parameters/ApiVersionParameter"
+            "$ref": "../../../../../common-types/resource-management/v2/types.json#/parameters/ApiVersionParameter"
           },
           {
-            "$ref": "./common.json#/parameters/SubscriptionIdParameter"
+            "$ref": "../../../../../common-types/resource-management/v2/types.json#/parameters/SubscriptionIdParameter"
           }
         ],
         "responses": {
           "200": {
-            "description": "Update successful. The operation returns the resulting hybrid network device resource.",
+            "description": "Update is successful. The operation returns the resulting device resource.",
             "schema": {
               "$ref": "#/definitions/Device"
             }
@@ -252,7 +236,7 @@
           "default": {
             "description": "Error response describing why the operation failed.",
             "schema": {
-              "$ref": "./common.json#/definitions/ErrorDetails"
+              "$ref": "../../../../../common-types/resource-management/v2/types.json#/definitions/ErrorResponse"
             }
           }
         },
@@ -269,18 +253,18 @@
           "Devices"
         ],
         "operationId": "Devices_ListBySubscription",
-        "description": "Lists all the hybrid network devices in a subscription.",
+        "description": "Lists all the devices in a subscription.",
         "parameters": [
           {
-            "$ref": "./common.json#/parameters/ApiVersionParameter"
+            "$ref": "../../../../../common-types/resource-management/v2/types.json#/parameters/ApiVersionParameter"
           },
           {
-            "$ref": "./common.json#/parameters/SubscriptionIdParameter"
+            "$ref": "../../../../../common-types/resource-management/v2/types.json#/parameters/SubscriptionIdParameter"
           }
         ],
         "responses": {
           "200": {
-            "description": "Request successful. The operation returns a list of hybrid network device resources.",
+            "description": "Request is successful. The operation returns a list of device resources.",
             "schema": {
               "$ref": "#/definitions/DeviceListResult"
             }
@@ -288,13 +272,13 @@
           "default": {
             "description": "Error response describing why the operation failed.",
             "schema": {
-              "$ref": "./common.json#/definitions/ErrorDetails"
+              "$ref": "../../../../../common-types/resource-management/v2/types.json#/definitions/ErrorResponse"
             }
           }
         },
         "x-ms-examples": {
-          "List all hybrid network devices in a subscription.": {
-            "$ref": "./examples/DeviceListAll.json"
+          "List all devices in a subscription.": {
+            "$ref": "./examples/DeviceListBySubscription.json"
           }
         },
         "x-ms-pageable": {
@@ -308,25 +292,21 @@
           "Devices"
         ],
         "operationId": "Devices_ListByResourceGroup",
-        "description": "Lists all the hybrid network devices in a resource group.",
+        "description": "Lists all the device resource in a resource group.",
         "parameters": [
           {
-            "name": "resourceGroupName",
-            "in": "path",
-            "required": true,
-            "type": "string",
-            "description": "The name of the resource group."
+            "$ref": "../../../../../common-types/resource-management/v2/types.json#/parameters/ResourceGroupNameParameter"
           },
           {
-            "$ref": "./common.json#/parameters/ApiVersionParameter"
+            "$ref": "../../../../../common-types/resource-management/v2/types.json#/parameters/ApiVersionParameter"
           },
           {
-            "$ref": "./common.json#/parameters/SubscriptionIdParameter"
+            "$ref": "../../../../../common-types/resource-management/v2/types.json#/parameters/SubscriptionIdParameter"
           }
         ],
         "responses": {
           "200": {
-            "description": "Request successful. The operation returns a list of hybrid network device resources.",
+            "description": "Request is successful. The operation returns a list of device resources.",
             "schema": {
               "$ref": "#/definitions/DeviceListResult"
             }
@@ -334,13 +314,13 @@
           "default": {
             "description": "Error response describing why the operation failed.",
             "schema": {
-              "$ref": "./common.json#/definitions/ErrorDetails"
+              "$ref": "../../../../../common-types/resource-management/v2/types.json#/definitions/ErrorResponse"
             }
           }
         },
         "x-ms-examples": {
-          "List all hybrid network devices in resource group": {
-            "$ref": "./examples/DeviceListAllByResourceGroup.json"
+          "List all devices in resource group": {
+            "$ref": "./examples/DeviceListByResourceGroup.json"
           }
         },
         "x-ms-pageable": {
@@ -354,32 +334,28 @@
           "Devices"
         ],
         "operationId": "Devices_ListRegistrationKey",
-        "description": "List the registration key for the hybrid network device.",
+        "description": "List the registration key for the device.",
         "parameters": [
           {
-            "name": "resourceGroupName",
-            "in": "path",
-            "required": true,
-            "type": "string",
-            "description": "The name of the resource group."
+            "$ref": "../../../../../common-types/resource-management/v2/types.json#/parameters/ResourceGroupNameParameter"
           },
           {
             "name": "deviceName",
             "in": "path",
             "required": true,
             "type": "string",
-            "description": "The name of the hybrid network device."
+            "description": "The name of the device resource."
           },
           {
-            "$ref": "./common.json#/parameters/ApiVersionParameter"
+            "$ref": "../../../../../common-types/resource-management/v2/types.json#/parameters/ApiVersionParameter"
           },
           {
-            "$ref": "./common.json#/parameters/SubscriptionIdParameter"
+            "$ref": "../../../../../common-types/resource-management/v2/types.json#/parameters/SubscriptionIdParameter"
           }
         ],
         "responses": {
           "200": {
-            "description": "The registration key information for the hybrid network device.",
+            "description": "The registration key information for the device.",
             "schema": {
               "$ref": "#/definitions/DeviceRegistrationKey"
             }
@@ -387,12 +363,12 @@
           "default": {
             "description": "Error response describing why the operation failed.",
             "schema": {
-              "$ref": "./common.json#/definitions/ErrorDetails"
+              "$ref": "../../../../../common-types/resource-management/v2/types.json#/definitions/ErrorResponse"
             }
           }
         },
         "x-ms-examples": {
-          "Get hybrid network device registration key": {
+          "Get device registration key": {
             "$ref": "./examples/DeviceListRegistrationKey.json"
           }
         }
@@ -405,18 +381,18 @@
         "properties": {
           "x-ms-client-flatten": true,
           "$ref": "#/definitions/DevicePropertiesFormat",
-          "description": "Hybrid network device properties."
+          "description": "Device properties."
         }
       },
       "allOf": [
         {
-          "$ref": "./common.json#/definitions/Resource"
+          "$ref": "../../../../../common-types/resource-management/v2/types.json#/definitions/TrackedResource"
         }
       ],
-      "description": "Hybrid network device resource."
+      "description": "Device resource."
     },
     "DevicePropertiesFormat": {
-      "description": "Hybrid network device properties.",
+      "description": "Device properties.",
       "required": [
         "deviceType"
       ],
@@ -429,7 +405,8 @@
           "enum": [
             "Unknown",
             "NotRegistered",
-            "Registered"
+            "Registered",
+            "Deleted"
           ],
           "x-ms-enum": {
             "name": "Status",
@@ -439,11 +416,11 @@
         "provisioningState": {
           "readOnly": true,
           "$ref": "./common.json#/definitions/ProvisioningState",
-          "description": "The provisioning state of the hybrid network device resource."
+          "description": "The provisioning state of the device resource."
         },
         "deviceType": {
           "type": "string",
-          "description": "The type of the hybrid network device.",
+          "description": "The type of the device.",
           "enum": [
             "Unknown",
             "AzureStackEdge"
@@ -456,25 +433,25 @@
         "azureStackEdge": {
           "x-ms-discriminator-value": "AzureStackEdge",
           "$ref": "./common.json#/definitions/SubResource",
-          "description": "The reference to the azure stack edge device."
+          "description": "The reference to the Azure stack edge device."
         },
-        "virtualNetworkFunctions": {
+        "networkFunctions": {
           "readOnly": true,
           "type": "array",
           "items": {
             "$ref": "./common.json#/definitions/SubResource"
           },
-          "description": "The list of virtual network functions deployed on the hybrid network device."
+          "description": "The list of network functions deployed on the device."
         }
       }
     },
     "DeviceRegistrationKey": {
-      "description": "The hybrid network device registration key",
+      "description": "The device registration key.",
       "properties": {
         "registrationKey": {
           "readOnly": true,
           "type": "string",
-          "description": "The registration key for hybrid network device."
+          "description": "The registration key for the device."
         }
       }
     },
@@ -485,7 +462,7 @@
           "items": {
             "$ref": "#/definitions/Device"
           },
-          "description": "A list of hybrid network devices."
+          "description": "A list of devices."
         },
         "nextLink": {
           "type": "string",
@@ -493,7 +470,7 @@
           "description": "The URL to get the next set of results."
         }
       },
-      "description": "Response for hybrid network devices API service call."
+      "description": "Response for devices API service call."
     }
   }
 }
diff --git a/specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/examples/DeviceCreate.json b/specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/examples/DeviceCreate.json
index 3b4cabc40640..288cd948bdcf 100644
--- a/specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/examples/DeviceCreate.json
+++ b/specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/examples/DeviceCreate.json
@@ -28,7 +28,7 @@
           "azureStackEdge": {
             "id": "/subscriptions/subid1/resourcegroups/rg2/providers/Microsoft.DataboxEdge/DataboxEdgeDevices/TestDataboxEdgeDeviceName"
           },
-          "virtualNetworkFunctions": null
+          "networkFunctions": null
         }
       }
     },
@@ -45,7 +45,7 @@
           "azureStackEdge": {
             "id": "/subscriptions/subid1/resourcegroups/rg2/providers/Microsoft.DataboxEdge/DataboxEdgeDevices/TestDataboxEdgeDeviceName"
           },
-          "virtualNetworkFunctions": null
+          "networkFunctions": null
         }
       }
     }
diff --git a/specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/examples/DeviceGet.json b/specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/examples/DeviceGet.json
index 47df323a3673..4c5f246a2e4c 100644
--- a/specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/examples/DeviceGet.json
+++ b/specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/examples/DeviceGet.json
@@ -19,9 +19,9 @@
           "azureStackEdge": {
             "id": "/subscriptions/subid1/resourcegroups/rg2/providers/Microsoft.DataboxEdge/DataboxEdgeDevices/TestDataboxEdgeDeviceName"
           },
-          "virtualNetworkFunctions": [
+          "networkFunctions": [
             {
-              "id": "/subscriptions/subid/resourcegroups/rg1/providers/Microsoft.HybridNetwork/virtualNetworkFunctions/TestVirtualNetworkFunction"
+              "id": "/subscriptions/subid/resourcegroups/rg1/providers/Microsoft.HybridNetwork/networkFunctions/TestNetworkFunction"
             }
           ]
         }
diff --git a/specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/examples/DeviceListAllByResourceGroup.json b/specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/examples/DeviceListByResourceGroup.json
similarity index 88%
rename from specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/examples/DeviceListAllByResourceGroup.json
rename to specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/examples/DeviceListByResourceGroup.json
index 758b069ac135..8bf7479f30f5 100644
--- a/specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/examples/DeviceListAllByResourceGroup.json
+++ b/specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/examples/DeviceListByResourceGroup.json
@@ -20,9 +20,9 @@
               "azureStackEdge": {
                 "id": "/subscriptions/subid1/resourcegroups/rg2/providers/Microsoft.DataboxEdge/DataboxEdgeDevices/TestDataboxEdgeDeviceName"
               },
-              "virtualNetworkFunctions": [
+              "networkFunctions": [
                 {
-                  "id": "/subscriptions/subid/resourcegroups/rg1/providers/Microsoft.HybridNetwork/virtualNetworkFunctions/TestVirtualNetworkFunction"
+                  "id": "/subscriptions/subid/resourcegroups/rg1/providers/Microsoft.HybridNetwork/networkFunctions/TestVirtualNetworkFunction"
                 }
               ]
             }
diff --git a/specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/examples/DeviceListAll.json b/specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/examples/DeviceListBySubscription.json
similarity index 88%
rename from specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/examples/DeviceListAll.json
rename to specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/examples/DeviceListBySubscription.json
index 673abf63ec08..013a6d11f059 100644
--- a/specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/examples/DeviceListAll.json
+++ b/specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/examples/DeviceListBySubscription.json
@@ -19,9 +19,9 @@
               "azureStackEdge": {
                 "id": "/subscriptions/subid1/resourcegroups/rg2/providers/Microsoft.DataboxEdge/DataboxEdgeDevices/TestDataboxEdgeDeviceName"
               },
-              "virtualNetworkFunctions": [
+              "networkFunctions": [
                 {
-                  "id": "/subscriptions/subid/resourcegroups/rg1/providers/Microsoft.HybridNetwork/virtualNetworkFunctions/TestVirtualNetworkFunction"
+                  "id": "/subscriptions/subid/resourcegroups/rg1/providers/Microsoft.HybridNetwork/networkFunctions/TestNetworkFunction"
                 }
               ]
             }
diff --git a/specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/examples/DeviceUpdateTags.json b/specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/examples/DeviceUpdateTags.json
index ae7e1e586e9b..b2e9a82752a5 100644
--- a/specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/examples/DeviceUpdateTags.json
+++ b/specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/examples/DeviceUpdateTags.json
@@ -29,9 +29,9 @@
           "azureStackEdge": {
             "id": "/subscriptions/subid1/resourcegroups/rg2/providers/Microsoft.DataboxEdge/DataboxEdgeDevices/TestDataboxEdgeDeviceName"
           },
-          "virtualNetworkFunctions": [
+          "networkFunctions": [
             {
-              "id": "/subscriptions/subid/resourcegroups/rg1/providers/Microsoft.HybridNetwork/virtualNetworkFunctions/TestVirtualNetworkFunction"
+              "id": "/subscriptions/subid/resourcegroups/rg1/providers/Microsoft.HybridNetwork/networkFunctions/TestNetworkFunction"
             }
           ]
         }
diff --git a/specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/examples/GetOperations.json b/specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/examples/GetOperations.json
index 96a50bbecce7..53c216779283 100644
--- a/specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/examples/GetOperations.json
+++ b/specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/examples/GetOperations.json
@@ -9,12 +9,12 @@
       "body": {
         "value": [
           {
-            "name": "Microsoft.HybridNetwork/vnfs/read",
+            "name": "Microsoft.HybridNetwork/nfs/read",
             "display": {
               "provider": "Microsoft Hybrid Network",
-              "resource": "Vnf",
-              "operation": "Get Vnf",
-              "description": "Gets Vnf"
+              "resource": "Nf",
+              "operation": "Get Nf",
+              "description": "Gets Nf"
             }
           }
         ]
diff --git a/specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/examples/VirtualNetworkFunctionCreate.json b/specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/examples/NetworkFunctionCreate.json
similarity index 91%
rename from specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/examples/VirtualNetworkFunctionCreate.json
rename to specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/examples/NetworkFunctionCreate.json
index ff285e2c7263..28a73a2f56ac 100644
--- a/specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/examples/VirtualNetworkFunctionCreate.json
+++ b/specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/examples/NetworkFunctionCreate.json
@@ -3,7 +3,7 @@
     "api-version": "2020-01-01-preview",
     "subscriptionId": "subid",
     "resourceGroupName": "rg",
-    "virtualNetworkFunctionName": "testVnf",
+    "networkFunctionName": "testNf",
     "parameters": {
       "location": "eastus",
       "properties": {
@@ -14,7 +14,7 @@
         "skuType": "SDWAN",
         "vendorName": "testVendor",
         "managedApplicationParameters": {},
-        "virtualNetworkFunctionUserConfigurations": [
+        "networkFunctionUserConfigurations": [
           {
             "roleName": "testRole",
             "userDataParameters": {},
@@ -58,9 +58,9 @@
   "responses": {
     "200": {
       "body": {
-        "id": "/subscriptions/subid/resourcegroups/rg/providers/Microsoft.HybridNetwork/virtualNetworkFunctions/testVnf",
-        "name": "testVnf",
-        "type": "Microsoft.HybridNetwork/virtualNetworkFunctions",
+        "id": "/subscriptions/subid/resourcegroups/rg/providers/Microsoft.HybridNetwork/networkFunctions/testNf",
+        "name": "testNf",
+        "type": "Microsoft.HybridNetwork/networkFunctions",
         "location": "eastus",
         "properties": {
           "provisioningState": "Succeeded",
@@ -76,7 +76,7 @@
             "id": "/subscriptions/subid/resourceGroups/rg/providers/Microsoft.Solutions/applications/testServiceKey"
           },
           "managedApplicationParameters": {},
-          "virtualNetworkFunctionUserConfigurations": [
+          "networkFunctionUserConfigurations": [
             {
               "roleName": "testRole",
               "userDataParameters": {},
@@ -119,9 +119,9 @@
     },
     "201": {
       "body": {
-        "id": "/subscriptions/subid/resourcegroups/rg/providers/Microsoft.HybridNetwork/virtualNetworkFunctions/testVnf",
-        "name": "testVnf",
-        "type": "Microsoft.HybridNetwork/virtualNetworkFunctions",
+        "id": "/subscriptions/subid/resourcegroups/rg/providers/Microsoft.HybridNetwork/networkFunctions/testNf",
+        "name": "testNf",
+        "type": "Microsoft.HybridNetwork/networkFunctions",
         "location": "eastus",
         "properties": {
           "provisioningState": "Accepted",
@@ -137,7 +137,7 @@
             "id": "/subscriptions/subid/resourceGroups/rg/providers/Microsoft.Solutions/applications/testServiceKey"
           },
           "managedApplicationParameters": {},
-          "virtualNetworkFunctionUserConfigurations": [
+          "networkFunctionUserConfigurations": [
             {
               "roleName": "testRole",
               "userDataParameters": {},
diff --git a/specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/examples/VirtualNetworkFunctionDelete.json b/specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/examples/NetworkFunctionDelete.json
similarity index 81%
rename from specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/examples/VirtualNetworkFunctionDelete.json
rename to specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/examples/NetworkFunctionDelete.json
index a34ac019cda4..38eaf18e686d 100644
--- a/specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/examples/VirtualNetworkFunctionDelete.json
+++ b/specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/examples/NetworkFunctionDelete.json
@@ -3,7 +3,7 @@
     "api-version": "2020-01-01-preview",
     "subscriptionId": "subid",
     "resourceGroupName": "rg",
-    "virtualNetworkFunctionName": "testVnf"
+    "networkFunctionName": "testNf"
   },
   "responses": {
     "200": {},
diff --git a/specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/examples/VirtualNetworkFunctionGet.json b/specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/examples/NetworkFunctionGet.json
similarity index 89%
rename from specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/examples/VirtualNetworkFunctionGet.json
rename to specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/examples/NetworkFunctionGet.json
index 65dd38218b47..fa5e37a018b3 100644
--- a/specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/examples/VirtualNetworkFunctionGet.json
+++ b/specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/examples/NetworkFunctionGet.json
@@ -3,14 +3,14 @@
     "api-version": "2020-01-01-preview",
     "subscriptionId": "subid",
     "resourceGroupName": "rg",
-    "virtualNetworkFunctionName": "testVnf"
+    "networkFunctionName": "testNf"
   },
   "responses": {
     "200": {
       "body": {
-        "id": "/subscriptions/subid/resourcegroups/rg/providers/Microsoft.HybridNetwork/virtualNetworkFunctions/testVnf",
-        "name": "testVnf",
-        "type": "Microsoft.HybridNetwork/virtualNetworkFunctions",
+        "id": "/subscriptions/subid/resourcegroups/rg/providers/Microsoft.HybridNetwork/networkFunctions/testNf",
+        "name": "testNf",
+        "type": "Microsoft.HybridNetwork/networkFunctions",
         "location": "eastus",
         "properties": {
           "provisioningState": "Succeeded",
@@ -26,7 +26,7 @@
             "id": "/subscriptions/subid/resourceGroups/rg/providers/Microsoft.Solutions/applications/testServiceKey"
           },
           "managedApplicationParameters": {},
-          "virtualNetworkFunctionUserConfigurations": [
+          "networkFunctionUserConfigurations": [
             {
               "roleName": "testRole",
               "userDataParameters": {},
diff --git a/specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/examples/VirtualNetworkFunctionListByResourceGroup.json b/specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/examples/NetworkFunctionListByResourceGroup.json
similarity index 91%
rename from specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/examples/VirtualNetworkFunctionListByResourceGroup.json
rename to specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/examples/NetworkFunctionListByResourceGroup.json
index ec8b416242e0..dbecbbbf7ae9 100644
--- a/specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/examples/VirtualNetworkFunctionListByResourceGroup.json
+++ b/specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/examples/NetworkFunctionListByResourceGroup.json
@@ -9,9 +9,9 @@
       "body": {
         "value": [
           {
-            "id": "/subscriptions/subid/resourcegroups/rg/providers/Microsoft.HybridNetwork/virtualNetworkFunctions/testVnf",
-            "name": "testVnf",
-            "type": "Microsoft.HybridNetwork/virtualNetworkFunctions",
+            "id": "/subscriptions/subid/resourcegroups/rg/providers/Microsoft.HybridNetwork/networkFunctions/testNf",
+            "name": "testNf",
+            "type": "Microsoft.HybridNetwork/networkFunctions",
             "location": "eastus",
             "properties": {
               "provisioningState": "Succeeded",
@@ -27,7 +27,7 @@
                 "id": "/subscriptions/subid/resourceGroups/rg/providers/Microsoft.Solutions/applications/testServiceKey"
               },
               "managedApplicationParameters": {},
-              "virtualNetworkFunctionUserConfigurations": [
+              "networkFunctionUserConfigurations": [
                 {
                   "roleName": "testRole",
                   "userDataParameters": {},
diff --git a/specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/examples/VirtualNetworkFunctionListBySubscription.json b/specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/examples/NetworkFunctionListBySubscription.json
similarity index 91%
rename from specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/examples/VirtualNetworkFunctionListBySubscription.json
rename to specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/examples/NetworkFunctionListBySubscription.json
index 7d644952cf00..51542a9b7a7a 100644
--- a/specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/examples/VirtualNetworkFunctionListBySubscription.json
+++ b/specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/examples/NetworkFunctionListBySubscription.json
@@ -8,9 +8,9 @@
       "body": {
         "value": [
           {
-            "id": "/subscriptions/subid/resourcegroups/rg/providers/Microsoft.HybridNetwork/virtualNetworkFunctions/testVnf",
-            "name": "testVnf",
-            "type": "Microsoft.HybridNetwork/virtualNetworkFunctions",
+            "id": "/subscriptions/subid/resourcegroups/rg/providers/Microsoft.HybridNetwork/networkFunctions/testNf",
+            "name": "testNf",
+            "type": "Microsoft.HybridNetwork/networkFunctions",
             "location": "eastus",
             "properties": {
               "provisioningState": "Succeeded",
@@ -26,7 +26,7 @@
                 "id": "/subscriptions/subid/resourceGroups/rg/providers/Microsoft.Solutions/applications/testServiceKey"
               },
               "managedApplicationParameters": {},
-              "virtualNetworkFunctionUserConfigurations": [
+              "networkFunctionUserConfigurations": [
                 {
                   "roleName": "testRole",
                   "userDataParameters": {},
diff --git a/specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/examples/VirtualNetworkFunctionGetSkuDetails.json b/specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/examples/NetworkFunctionSkuDetailsGet.json
similarity index 100%
rename from specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/examples/VirtualNetworkFunctionGetSkuDetails.json
rename to specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/examples/NetworkFunctionSkuDetailsGet.json
diff --git a/specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/examples/VirtualNetworkFunctionSkuList.json b/specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/examples/NetworkFunctionSkuListByVendor.json
similarity index 100%
rename from specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/examples/VirtualNetworkFunctionSkuList.json
rename to specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/examples/NetworkFunctionSkuListByVendor.json
diff --git a/specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/examples/VirtualNetworkFunctionUpdateTags.json b/specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/examples/NetworkFunctionUpdateTags.json
similarity index 90%
rename from specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/examples/VirtualNetworkFunctionUpdateTags.json
rename to specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/examples/NetworkFunctionUpdateTags.json
index ce573d51b592..372cb0217215 100644
--- a/specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/examples/VirtualNetworkFunctionUpdateTags.json
+++ b/specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/examples/NetworkFunctionUpdateTags.json
@@ -3,7 +3,7 @@
     "api-version": "2020-01-01-preview",
     "subscriptionId": "subid",
     "resourceGroupName": "rg",
-    "virtualNetworkFunctionName": "testVnf",
+    "networkFunctionName": "testNf",
     "parameters": {
       "tags": {
         "tag1": "value1",
@@ -14,9 +14,9 @@
   "responses": {
     "200": {
       "body": {
-        "id": "/subscriptions/subid/resourcegroups/rg/providers/Microsoft.HybridNetwork/virtualNetworkFunctions/testVnf",
-        "name": "testVnf",
-        "type": "Microsoft.HybridNetwork/virtualNetworkFunctions",
+        "id": "/subscriptions/subid/resourcegroups/rg/providers/Microsoft.HybridNetwork/networkFunctions/testNf",
+        "name": "testNf",
+        "type": "Microsoft.HybridNetwork/networkFunctions",
         "location": "eastus",
         "tags": {
           "tag1": "value1",
@@ -36,7 +36,7 @@
             "id": "/subscriptions/subid/resourceGroups/rg/providers/Microsoft.Solutions/applications/testServiceKey"
           },
           "managedApplicationParameters": {},
-          "virtualNetworkFunctionUserConfigurations": [
+          "networkFunctionUserConfigurations": [
             {
               "roleName": "testRole",
               "userDataParameters": {},
diff --git a/specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/examples/VirtualNetworkFunctionVendorAndSkuList.json b/specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/examples/NetworkFunctionVendorAndSkuListBySubscription.json
similarity index 100%
rename from specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/examples/VirtualNetworkFunctionVendorAndSkuList.json
rename to specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/examples/NetworkFunctionVendorAndSkuListBySubscription.json
diff --git a/specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/examples/RoleInstanceGet.json b/specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/examples/RoleInstanceGet.json
new file mode 100644
index 000000000000..757311c81677
--- /dev/null
+++ b/specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/examples/RoleInstanceGet.json
@@ -0,0 +1,22 @@
+{
+  "parameters": {
+    "api-version": "2020-01-01-preview",
+    "subscriptionId": "subid",
+    "locationName": "eastus",
+    "vendorName": "testVendor",
+    "serviceKey": "testServiceKey",
+    "roleInstanceName": "mrm"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "name": "mrm",
+        "id": "/subscriptions/subid/providers/Microsoft.HybridNetwork/locations/eastus/vendors/testVendor/networkFunctions/testServiceKey/roleInstances/mrm",
+        "type": "Microsoft.HybridNetwork/locations/vendors/networkFunctions/roleInstances",
+        "properties": {
+          "operationalState": "Running"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/examples/RoleInstanceListByVendorNetworkFunction.json b/specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/examples/RoleInstanceListByVendorNetworkFunction.json
new file mode 100644
index 000000000000..fdfd450955a5
--- /dev/null
+++ b/specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/examples/RoleInstanceListByVendorNetworkFunction.json
@@ -0,0 +1,34 @@
+{
+  "parameters": {
+    "api-version": "2020-01-01-preview",
+    "subscriptionId": "subid",
+    "locationName": "eastus",
+    "vendorName": "testVendor",
+    "serviceKey": "testServiceKey"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "name": "mrm",
+            "id": "/subscriptions/subid/providers/Microsoft.HybridNetwork/locations/eastus/vendors/testVendor/networkFunctions/testServiceKey/roleInstances/mrm",
+            "type": "Microsoft.HybridNetwork/locations/vendors/networkFunctions/roleInstances",
+            "properties": {
+              "operationalState": "Running"
+            }
+          },
+          {
+            "name": "msm",
+            "id": "/subscriptions/subid/providers/Microsoft.HybridNetwork/locations/eastus/vendors/testVendor/networkFunctions/testServiceKey/roleInstances/msm",
+            "type": "Microsoft.HybridNetwork/locations/vendors/networkFunctions/roleInstances",
+            "properties": {
+              "operationalState": "Stopped"
+            }
+          }
+        ],
+        "nextLink": "string"
+      }
+    }
+  }
+}
diff --git a/specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/examples/RoleInstanceRestart.json b/specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/examples/RoleInstanceRestart.json
new file mode 100644
index 000000000000..1ab187f60a1f
--- /dev/null
+++ b/specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/examples/RoleInstanceRestart.json
@@ -0,0 +1,14 @@
+{
+  "parameters": {
+    "api-version": "2020-01-01-preview",
+    "subscriptionId": "subid",
+    "locationName": "eastus",
+    "vendorName": "testVendor",
+    "serviceKey": "testServiceKey",
+    "roleInstanceName": "mrm"
+  },
+  "responses": {
+    "200": {},
+    "202": {}
+  }
+}
diff --git a/specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/examples/RoleInstanceStart.json b/specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/examples/RoleInstanceStart.json
new file mode 100644
index 000000000000..1ab187f60a1f
--- /dev/null
+++ b/specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/examples/RoleInstanceStart.json
@@ -0,0 +1,14 @@
+{
+  "parameters": {
+    "api-version": "2020-01-01-preview",
+    "subscriptionId": "subid",
+    "locationName": "eastus",
+    "vendorName": "testVendor",
+    "serviceKey": "testServiceKey",
+    "roleInstanceName": "mrm"
+  },
+  "responses": {
+    "200": {},
+    "202": {}
+  }
+}
diff --git a/specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/examples/RoleInstanceStop.json b/specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/examples/RoleInstanceStop.json
new file mode 100644
index 000000000000..1ab187f60a1f
--- /dev/null
+++ b/specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/examples/RoleInstanceStop.json
@@ -0,0 +1,14 @@
+{
+  "parameters": {
+    "api-version": "2020-01-01-preview",
+    "subscriptionId": "subid",
+    "locationName": "eastus",
+    "vendorName": "testVendor",
+    "serviceKey": "testServiceKey",
+    "roleInstanceName": "mrm"
+  },
+  "responses": {
+    "200": {},
+    "202": {}
+  }
+}
diff --git a/specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/examples/VendorListAll.json b/specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/examples/VendorListBySubscription.json
similarity index 100%
rename from specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/examples/VendorListAll.json
rename to specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/examples/VendorListBySubscription.json
diff --git a/specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/examples/VendorVnfCreate.json b/specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/examples/VendorNfCreate.json
similarity index 71%
rename from specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/examples/VendorVnfCreate.json
rename to specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/examples/VendorNfCreate.json
index bb8d1ddd0c12..d81cd24f5aaf 100644
--- a/specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/examples/VendorVnfCreate.json
+++ b/specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/examples/VendorNfCreate.json
@@ -6,18 +6,25 @@
     "vendorName": "testVendor",
     "serviceKey": "testServiceKey",
     "parameters": {
-      "location": "eastus",
       "properties": {
         "skuType": "SDWAN",
         "vendorProvisioningState": "Provisioning",
-        "virtualNetworkFunctionVendorConfigurations": [
+        "networkFunctionVendorConfigurations": [
           {
             "roleName": "testRole",
-            "customData": "base-64 encoded string of custom data",
             "osProfile": {
               "adminUsername": "dummyuser",
-              "adminPassword": "dummypassword",
-              "sshPublicKey": null
+              "linuxConfiguration": {
+                "ssh": {
+                  "publicKeys": [
+                    {
+                      "path": "home/user/.ssh/authorized_keys",
+                      "keyData": "ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAgEAwrr66r8n6B8Y0zMF3dOpXEapIQD9DiYQ6D6/zwor9o39jSkHNiMMER/GETBbzP83LOcekm02aRjo55ArO7gPPVvCXbrirJu9pkm4AC4BBre5xSLS= user@constoso-DSH"
+                    }
+                  ]
+                }
+              },
+              "customData": "base-64 encoded string of custom data"
             },
             "userDataParameters": {},
             "networkInterfaces": [
@@ -60,22 +67,30 @@
   "responses": {
     "200": {
       "body": {
-        "id": "/subscriptions/subid/providers/Microsoft.HybridNetwork/locations/eastus/vendors/testVendor/virtualNetworkFunctions/testServiceKey",
+        "id": "/subscriptions/subid/providers/Microsoft.HybridNetwork/locations/eastus/vendors/testVendor/networkFunctions/testServiceKey",
         "name": "testServiceKey",
-        "type": "Microsoft.HybridNetwork/locations/vendors/virtualNetworkFunctions",
-        "location": "eastus",
+        "type": "Microsoft.HybridNetwork/locations/vendors/networkFunctions",
         "properties": {
           "provisioningState": "Succeeded",
           "vendorProvisioningState": "Provisioning",
           "skuName": "testSku",
           "skuType": "SDWAN",
-          "virtualNetworkFunctionVendorConfigurations": [
+          "networkFunctionVendorConfigurations": [
             {
               "roleName": "testRole",
-              "customData": "base-64 encoded string of custom data",
               "osProfile": {
                 "adminUsername": "dummyuser",
-                "sshPublicKey": null
+                "linuxConfiguration": {
+                  "ssh": {
+                    "publicKeys": [
+                      {
+                        "path": "home/user/.ssh/authorized_keys",
+                        "keyData": "ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAgEAwrr66r8n6B8Y0zMF3dOpXEapIQD9DiYQ6D6/zwor9o39jSkHNiMMER/GETBbzP83LOcekm02aRjo55ArO7gPPVvCXbrirJu9pkm4AC4BBre5xSLS= user@constoso-DSH"
+                      }
+                    ]
+                  }
+                },
+                "customData": "base-64 encoded string of custom data"
               },
               "userDataParameters": {},
               "networkInterfaces": [
@@ -117,22 +132,30 @@
     },
     "201": {
       "body": {
-        "id": "/subscriptions/subid/providers/Microsoft.HybridNetwork/locations/eastus/vendors/testVendor/virtualNetworkFunctions/testServiceKey",
+        "id": "/subscriptions/subid/providers/Microsoft.HybridNetwork/locations/eastus/vendors/testVendor/networkFunctions/testServiceKey",
         "name": "testServiceKey",
-        "type": "Microsoft.HybridNetwork/locations/vendors/virtualNetworkFunctions",
-        "location": "eastus",
+        "type": "Microsoft.HybridNetwork/locations/vendors/networkFunctions",
         "properties": {
           "provisioningState": "Accepted",
           "vendorProvisioningState": "Provisioning",
           "skuName": "testSku",
           "skuType": "SDWAN",
-          "virtualNetworkFunctionVendorConfigurations": [
+          "networkFunctionVendorConfigurations": [
             {
               "roleName": "testRole",
-              "customData": "base-64 encoded string of custom data",
               "osProfile": {
                 "adminUsername": "dummyuser",
-                "sshPublicKey": null
+                "linuxConfiguration": {
+                  "ssh": {
+                    "publicKeys": [
+                      {
+                        "path": "home/user/.ssh/authorized_keys",
+                        "keyData": "ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAgEAwrr66r8n6B8Y0zMF3dOpXEapIQD9DiYQ6D6/zwor9o39jSkHNiMMER/GETBbzP83LOcekm02aRjo55ArO7gPPVvCXbrirJu9pkm4AC4BBre5xSLS= user@constoso-DSH"
+                      }
+                    ]
+                  }
+                },
+                "customData": "base-64 encoded string of custom data"
               },
               "userDataParameters": {},
               "networkInterfaces": [
diff --git a/specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/examples/VendorVnfGet.json b/specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/examples/VendorNfGet.json
similarity index 71%
rename from specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/examples/VendorVnfGet.json
rename to specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/examples/VendorNfGet.json
index 942593ddc290..11c880a21d7c 100644
--- a/specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/examples/VendorVnfGet.json
+++ b/specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/examples/VendorNfGet.json
@@ -9,22 +9,30 @@
   "responses": {
     "200": {
       "body": {
-        "id": "/subscriptions/subid/providers/Microsoft.HybridNetwork/locations/eastus/vendors/testVendor/virtualNetworkFunctions/testServiceKey",
+        "id": "/subscriptions/subid/providers/Microsoft.HybridNetwork/locations/eastus/vendors/testVendor/networkFunctions/testServiceKey",
         "name": "testServiceKey",
-        "type": "Microsoft.HybridNetwork/locations/vendors/virtualNetworkFunctions",
-        "location": "eastus",
+        "type": "Microsoft.HybridNetwork/locations/vendors/networkFunctions",
         "properties": {
           "provisioningState": "Succeeded",
           "vendorProvisioningState": "Provisioning",
           "skuName": "testSku",
           "skuType": "SDWAN",
-          "virtualNetworkFunctionVendorConfigurations": [
+          "networkFunctionVendorConfigurations": [
             {
               "roleName": "testRole",
-              "customData": "base-64 encoded string of custom data",
               "osProfile": {
                 "adminUsername": "dummyuser",
-                "sshPublicKey": null
+                "linuxConfiguration": {
+                  "ssh": {
+                    "publicKeys": [
+                      {
+                        "path": "home/user/.ssh/authorized_keys",
+                        "keyData": "ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAgEAwrr66r8n6B8Y0zMF3dOpXEapIQD9DiYQ6D6/zwor9o39jSkHNiMMER/GETBbzP83LOcekm02aRjo55ArO7gPPVvCXbrirJu9pkm4AC4BBre5xSLS= user@constoso-DSH"
+                      }
+                    ]
+                  }
+                },
+                "customData": "base-64 encoded string of custom data"
               },
               "userDataParameters": {},
               "networkInterfaces": [
diff --git a/specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/examples/VendorVnfList.json b/specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/examples/VendorNfListByVendor.json
similarity index 72%
rename from specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/examples/VendorVnfList.json
rename to specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/examples/VendorNfListByVendor.json
index e28b4364bfd6..256130794742 100644
--- a/specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/examples/VendorVnfList.json
+++ b/specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/examples/VendorNfListByVendor.json
@@ -10,22 +10,30 @@
       "body": {
         "value": [
           {
-            "id": "/subscriptions/subid/providers/Microsoft.HybridNetwork/locations/eastus/vendors/testVendor/virtualNetworkFunctions/testServiceKey",
+            "id": "/subscriptions/subid/providers/Microsoft.HybridNetwork/locations/eastus/vendors/testVendor/networkFunctions/testServiceKey",
             "name": "TestServiceKey",
-            "type": "Microsoft.HybridNetwork/locations/vendors/virtualNetworkFunctions",
-            "location": "eastus",
+            "type": "Microsoft.HybridNetwork/locations/vendors/networkFunctions",
             "properties": {
               "provisioningState": "Succeeded",
               "vendorProvisioningState": "Provisioning",
               "skuName": "testSku",
               "skuType": "SDWAN",
-              "virtualNetworkFunctionVendorConfigurations": [
+              "networkFunctionVendorConfigurations": [
                 {
                   "roleName": "testRole",
-                  "customData": "base-64 encoded string of custom data",
                   "osProfile": {
                     "adminUsername": "dummyuser",
-                    "sshPublicKey": null
+                    "linuxConfiguration": {
+                      "ssh": {
+                        "publicKeys": [
+                          {
+                            "path": "home/user/.ssh/authorized_keys",
+                            "keyData": "ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAgEAwrr66r8n6B8Y0zMF3dOpXEapIQD9DiYQ6D6/zwor9o39jSkHNiMMER/GETBbzP83LOcekm02aRjo55ArO7gPPVvCXbrirJu9pkm4AC4BBre5xSLS= user@constoso-DSH"
+                          }
+                        ]
+                      }
+                    },
+                    "customData": "base-64 encoded string of custom data"
                   },
                   "userDataParameters": {},
                   "networkInterfaces": [
diff --git a/specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/examples/VendorSkuCreate.json b/specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/examples/VendorSkuCreate.json
index 1402c9d87fe5..70b4f0ddf3dd 100644
--- a/specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/examples/VendorSkuCreate.json
+++ b/specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/examples/VendorSkuCreate.json
@@ -9,22 +9,51 @@
         "deploymentMode": "PrivateEdgeZone",
         "preview": true,
         "managedApplicationTemplate": {},
-        "virtualNetworkFunctionTemplate": {
-          "virutalNetworkFunctionRoleConfigurations": [
+        "networkFunctionTemplate": {
+          "networkFunctionRoleConfigurations": [
             {
               "roleName": "test",
               "roleType": "VirtualMachine",
               "virtualMachineSize": "Standard_D3_v2",
-              "imageReference": {
-                "osType": "Linux",
-                "vhdName": "vhdName",
-                "vhdType": "VHD",
-                "sasUri": "https://<yourstorage>.blob.core.windows.net/<yourcontainer>/<yourfile>?sp=rl&st=st>Z&se=<se>Z&sv=<sv>&sr=b&sig=<signature>"
+              "storageProfile": {
+                "imageReference": {
+                  "publisher": "Canonical",
+                  "offer": "UbuntuServer",
+                  "sku": "18.04-LTS",
+                  "version": "18.04.201804262"
+                },
+                "osDisk": {
+                  "osType": "Linux",
+                  "name": "vhdName",
+                  "diskSizeGB": 30,
+                  "vhd": {
+                    "uri": "https://contoso.net/link/vnd.vhd?sp=rl&st=2020-10-08T20:38:19Z&se=2020-12-09T19:38:00Z&sv=2019-12-12&sr=b&sig=7BM2f4yOw%3D"
+                  }
+                },
+                "dataDisks": [
+                  {
+                    "createOption": "Empty",
+                    "name": "DataDisk1",
+                    "diskSizeGB": 10
+                  }
+                ]
               },
               "osProfile": {
                 "adminUsername": "dummyuser",
-                "adminPassword": "dummypassword",
-                "sshPublicKey": null
+                "linuxConfiguration": {
+                  "ssh": {
+                    "publicKeys": [
+                      {
+                        "path": "home/user/.ssh/authorized_keys",
+                        "keyData": "ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAgEAwrr66r8n6B8Y0zMF3dOpXEapIQD9DiYQ6D6/zwor9o39jSkHNiMMER/GETBbzP83LOcekm02aRjo55ArO7gPPVvCXbrirJu9pkm4AC4BBre5xSLS= user@constoso-DSH"
+                      }
+                    ]
+                  }
+                },
+                "customData": "base-64 encoded string of custom data"
+              },
+              "customProfile": {
+                "metadataConfigurationPath": "/var/logs/network.cfg"
               },
               "networkInterfaces": [
                 {
@@ -75,21 +104,49 @@
           "preview": true,
           "provisioningState": "Succeeded",
           "managedApplicationTemplate": {},
-          "virtualNetworkFunctionTemplate": {
-            "virutalNetworkFunctionRoleConfigurations": [
+          "networkFunctionTemplate": {
+            "networkFunctionRoleConfigurations": [
               {
                 "roleName": "test",
                 "roleType": "VirtualMachine",
                 "virtualMachineSize": "Standard_D3_v2",
-                "imageReference": {
-                  "osType": "Linux",
-                  "vhdName": "vhdName",
-                  "vhdType": "VHD",
-                  "sasUri": "https://<yourstorage>.blob.core.windows.net/<yourcontainer>/<yourfile>?sp=rl&st=st>Z&se=<se>Z&sv=<sv>&sr=b&sig=<signature>"
+                "storageProfile": {
+                  "imageReference": {
+                    "publisher": "Canonical",
+                    "offer": "UbuntuServer",
+                    "sku": "18.04-LTS",
+                    "version": "18.04.201804262"
+                  },
+                  "osDisk": {
+                    "osType": "Linux",
+                    "name": "vhdName",
+                    "diskSizeGB": 30,
+                    "vhd": {}
+                  },
+                  "dataDisks": [
+                    {
+                      "createOption": "Empty",
+                      "name": "DataDisk1",
+                      "diskSizeGB": 10
+                    }
+                  ]
                 },
                 "osProfile": {
                   "adminUsername": "dummyuser",
-                  "sshPublicKey": null
+                  "linuxConfiguration": {
+                    "ssh": {
+                      "publicKeys": [
+                        {
+                          "path": "home/user/.ssh/authorized_keys",
+                          "keyData": "ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAgEAwrr66r8n6B8Y0zMF3dOpXEapIQD9DiYQ6D6/zwor9o39jSkHNiMMER/GETBbzP83LOcekm02aRjo55ArO7gPPVvCXbrirJu9pkm4AC4BBre5xSLS= user@constoso-DSH"
+                        }
+                      ]
+                    }
+                  },
+                  "customData": "base-64 encoded string of custom data"
+                },
+                "customProfile": {
+                  "metadataConfigurationPath": "/var/logs/network.cfg"
                 },
                 "networkInterfaces": [
                   {
@@ -139,21 +196,49 @@
           "preview": true,
           "provisioningState": "Accepted",
           "managedApplicationTemplate": {},
-          "virtualNetworkFunctionTemplate": {
-            "virutalNetworkFunctionRoleConfigurations": [
+          "networkFunctionTemplate": {
+            "networkFunctionRoleConfigurations": [
               {
                 "roleName": "test",
                 "roleType": "VirtualMachine",
                 "virtualMachineSize": "Standard_D3_v2",
-                "imageReference": {
-                  "osType": "Linux",
-                  "vhdName": "vhdName",
-                  "vhdType": "VHD",
-                  "sasUri": "https://<yourstorage>.blob.core.windows.net/<yourcontainer>/<yourfile>?sp=rl&st=st>Z&se=<se>Z&sv=<sv>&sr=b&sig=<signature>"
+                "storageProfile": {
+                  "imageReference": {
+                    "publisher": "Canonical",
+                    "offer": "UbuntuServer",
+                    "sku": "18.04-LTS",
+                    "version": "18.04.201804262"
+                  },
+                  "osDisk": {
+                    "osType": "Linux",
+                    "name": "vhdName",
+                    "diskSizeGB": 30,
+                    "vhd": {}
+                  },
+                  "dataDisks": [
+                    {
+                      "createOption": "Empty",
+                      "name": "DataDisk1",
+                      "diskSizeGB": 10
+                    }
+                  ]
                 },
                 "osProfile": {
                   "adminUsername": "dummyuser",
-                  "sshPublicKey": null
+                  "linuxConfiguration": {
+                    "ssh": {
+                      "publicKeys": [
+                        {
+                          "path": "home/user/.ssh/authorized_keys",
+                          "keyData": "ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAgEAwrr66r8n6B8Y0zMF3dOpXEapIQD9DiYQ6D6/zwor9o39jSkHNiMMER/GETBbzP83LOcekm02aRjo55ArO7gPPVvCXbrirJu9pkm4AC4BBre5xSLS= user@constoso-DSH"
+                        }
+                      ]
+                    }
+                  },
+                  "customData": "base-64 encoded string of custom data"
+                },
+                "customProfile": {
+                  "metadataConfigurationPath": "/var/logs/network.cfg"
                 },
                 "networkInterfaces": [
                   {
diff --git a/specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/examples/VendorSkuGet.json b/specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/examples/VendorSkuGet.json
index 605cc22e53dd..61f27b3b13f0 100644
--- a/specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/examples/VendorSkuGet.json
+++ b/specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/examples/VendorSkuGet.json
@@ -16,21 +16,49 @@
           "preview": true,
           "provisioningState": "Succeeded",
           "managedApplicationTemplate": {},
-          "virtualNetworkFunctionTemplate": {
-            "virutalNetworkFunctionRoleConfigurations": [
+          "networkFunctionTemplate": {
+            "networkFunctionRoleConfigurations": [
               {
                 "roleName": "test",
                 "roleType": "VirtualMachine",
                 "virtualMachineSize": "Standard_D3_v2",
-                "imageReference": {
-                  "osType": "Linux",
-                  "vhdName": "vhdName",
-                  "vhdType": "VHD",
-                  "sasUri": "https://<yourstorage>.blob.core.windows.net/<yourcontainer>/<yourfile>?sp=rl&st=st>Z&se=<se>Z&sv=<sv>&sr=b&sig=<signature>"
+                "storageProfile": {
+                  "imageReference": {
+                    "publisher": "Canonical",
+                    "offer": "UbuntuServer",
+                    "sku": "18.04-LTS",
+                    "version": "18.04.201804262"
+                  },
+                  "osDisk": {
+                    "osType": "Linux",
+                    "name": "vhdName",
+                    "diskSizeGB": 30,
+                    "vhd": {}
+                  },
+                  "dataDisks": [
+                    {
+                      "createOption": "Empty",
+                      "name": "DataDisk1",
+                      "diskSizeGB": 10
+                    }
+                  ]
                 },
                 "osProfile": {
                   "adminUsername": "dummyuser",
-                  "sshPublicKey": null
+                  "linuxConfiguration": {
+                    "ssh": {
+                      "publicKeys": [
+                        {
+                          "path": "home/user/.ssh/authorized_keys",
+                          "keyData": "ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAgEAwrr66r8n6B8Y0zMF3dOpXEapIQD9DiYQ6D6/zwor9o39jSkHNiMMER/GETBbzP83LOcekm02aRjo55ArO7gPPVvCXbrirJu9pkm4AC4BBre5xSLS= user@constoso-DSH"
+                        }
+                      ]
+                    }
+                  },
+                  "customData": "base-64 encoded string of custom data"
+                },
+                "customProfile": {
+                  "metadataConfigurationPath": "/var/logs/network.cfg"
                 },
                 "networkInterfaces": [
                   {
diff --git a/specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/examples/VendorSkuListAll.json b/specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/examples/VendorSkuListByVendor.json
similarity index 57%
rename from specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/examples/VendorSkuListAll.json
rename to specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/examples/VendorSkuListByVendor.json
index 9d6161f86364..4f0f858ad8d0 100644
--- a/specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/examples/VendorSkuListAll.json
+++ b/specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/examples/VendorSkuListByVendor.json
@@ -17,21 +17,49 @@
               "preview": true,
               "provisioningState": "Succeeded",
               "managedApplicationTemplate": {},
-              "virtualNetworkFunctionTemplate": {
-                "virutalNetworkFunctionRoleConfigurations": [
+              "networkFunctionTemplate": {
+                "networkFunctionRoleConfigurations": [
                   {
                     "roleName": "test",
                     "roleType": "VirtualMachine",
                     "virtualMachineSize": "Standard_D3_v2",
-                    "imageReference": {
-                      "osType": "Linux",
-                      "vhdName": "vhdName",
-                      "vhdType": "VHD",
-                      "sasUri": "https://<yourstorage>.blob.core.windows.net/<yourcontainer>/<yourfile>?sp=rl&st=st>Z&se=<se>Z&sv=<sv>&sr=b&sig=<signature>"
+                    "storageProfile": {
+                      "imageReference": {
+                        "publisher": "Canonical",
+                        "offer": "UbuntuServer",
+                        "sku": "18.04-LTS",
+                        "version": "18.04.201804262"
+                      },
+                      "osDisk": {
+                        "osType": "Linux",
+                        "name": "vhdName",
+                        "diskSizeGB": 30,
+                        "vhd": {}
+                      },
+                      "dataDisks": [
+                        {
+                          "createOption": "Empty",
+                          "name": "DataDisk1",
+                          "diskSizeGB": 10
+                        }
+                      ]
                     },
                     "osProfile": {
                       "adminUsername": "dummyuser",
-                      "sshPublicKey": null
+                      "linuxConfiguration": {
+                        "ssh": {
+                          "publicKeys": [
+                            {
+                              "path": "home/user/.ssh/authorized_keys",
+                              "keyData": "ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAgEAwrr66r8n6B8Y0zMF3dOpXEapIQD9DiYQ6D6/zwor9o39jSkHNiMMER/GETBbzP83LOcekm02aRjo55ArO7gPPVvCXbrirJu9pkm4AC4BBre5xSLS= user@constoso-DSH"
+                            }
+                          ]
+                        }
+                      },
+                      "customData": "base-64 encoded string of custom data"
+                    },
+                    "customProfile": {
+                      "metadataConfigurationPath": "/var/logs/network.cfg"
                     },
                     "networkInterfaces": [
                       {
@@ -79,21 +107,49 @@
               "preview": true,
               "provisioningState": "Succeeded",
               "managedApplicationTemplate": {},
-              "virtualNetworkFunctionTemplate": {
-                "virutalNetworkFunctionRoleConfigurations": [
+              "networkFunctionTemplate": {
+                "networkFunctionRoleConfigurations": [
                   {
                     "roleName": "test",
                     "roleType": "VirtualMachine",
                     "virtualMachineSize": "Standard_D3_v2",
-                    "imageReference": {
-                      "osType": "Linux",
-                      "vhdName": "vhdName",
-                      "vhdType": "VHD",
-                      "sasUri": "https://<yourstorage>.blob.core.windows.net/<yourcontainer>/<yourfile>?sp=rl&st=st>Z&se=<se>Z&sv=<sv>&sr=b&sig=<signature>"
+                    "storageProfile": {
+                      "imageReference": {
+                        "publisher": "Canonical",
+                        "offer": "UbuntuServer",
+                        "sku": "18.04-LTS",
+                        "version": "18.04.201804262"
+                      },
+                      "osDisk": {
+                        "osType": "Linux",
+                        "name": "vhdName",
+                        "diskSizeGB": 30,
+                        "vhd": {}
+                      },
+                      "dataDisks": [
+                        {
+                          "createOption": "Empty",
+                          "name": "DataDisk1",
+                          "diskSizeGB": 10
+                        }
+                      ]
                     },
                     "osProfile": {
                       "adminUsername": "dummyuser",
-                      "sshPublicKey": null
+                      "linuxConfiguration": {
+                        "ssh": {
+                          "publicKeys": [
+                            {
+                              "path": "home/user/.ssh/authorized_keys",
+                              "keyData": "ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAgEAwrr66r8n6B8Y0zMF3dOpXEapIQD9DiYQ6D6/zwor9o39jSkHNiMMER/GETBbzP83LOcekm02aRjo55ArO7gPPVvCXbrirJu9pkm4AC4BBre5xSLS= user@constoso-DSH"
+                            }
+                          ]
+                        }
+                      },
+                      "customData": "base-64 encoded string of custom data"
+                    },
+                    "customProfile": {
+                      "metadataConfigurationPath": "/var/logs/network.cfg"
                     },
                     "networkInterfaces": [
                       {
diff --git a/specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/examples/CreateVendorSkuPreview.json b/specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/examples/VendorSkuPreviewCreate.json
similarity index 100%
rename from specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/examples/CreateVendorSkuPreview.json
rename to specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/examples/VendorSkuPreviewCreate.json
diff --git a/specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/examples/DeleteVendorSkuPreview.json b/specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/examples/VendorSkuPreviewDelete.json
similarity index 100%
rename from specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/examples/DeleteVendorSkuPreview.json
rename to specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/examples/VendorSkuPreviewDelete.json
diff --git a/specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/examples/GetVendorSkuPreview.json b/specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/examples/VendorSkuPreviewGet.json
similarity index 100%
rename from specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/examples/GetVendorSkuPreview.json
rename to specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/examples/VendorSkuPreviewGet.json
diff --git a/specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/examples/GetVendorSkuPreviews.json b/specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/examples/VendorSkuPreviewListBySku.json
similarity index 100%
rename from specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/examples/GetVendorSkuPreviews.json
rename to specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/examples/VendorSkuPreviewListBySku.json
diff --git a/specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/networkFunction.json b/specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/networkFunction.json
new file mode 100644
index 000000000000..d64f1c46f743
--- /dev/null
+++ b/specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/networkFunction.json
@@ -0,0 +1,452 @@
+{
+  "swagger": "2.0",
+  "info": {
+    "title": "HybridNetworkManagementClient",
+    "description": "The resources in this swagger specification will be used to manage the network function deployment in a Hybrid Network resource provider.",
+    "version": "2020-01-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.HybridNetwork/networkFunctions/{networkFunctionName}": {
+      "delete": {
+        "tags": [
+          "NetworkFunctions"
+        ],
+        "operationId": "NetworkFunctions_Delete",
+        "description": "Deletes the specified network function resource.",
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v2/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "name": "networkFunctionName",
+            "description": "The name of the network function.",
+            "in": "path",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v2/types.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v2/types.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The operation is completed successfully."
+          },
+          "202": {
+            "description": "Accepted. The header contains 'Azure-AsyncOperation' header pointing to an operations resource. The operation URI can be queried to find the current state of the operation."
+          },
+          "204": {
+            "description": "Request is successful. Resource with the specified name does not exist."
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "../../../../../common-types/resource-management/v2/types.json#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-examples": {
+          "Delete network function resource": {
+            "$ref": "./examples/NetworkFunctionDelete.json"
+          }
+        },
+        "x-ms-long-running-operation": true,
+        "x-ms-long-running-operation-options": {
+          "final-state-via": "location"
+        }
+      },
+      "get": {
+        "tags": [
+          "NetworkFunctions"
+        ],
+        "operationId": "NetworkFunctions_Get",
+        "description": "Gets information about the specified network function resource.",
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v2/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "name": "networkFunctionName",
+            "in": "path",
+            "required": true,
+            "type": "string",
+            "description": "The name of the network function resource."
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v2/types.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v2/types.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Operation is successful. The operation returns the resulting network function resource.",
+            "schema": {
+              "$ref": "#/definitions/NetworkFunction"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "../../../../../common-types/resource-management/v2/types.json#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-examples": {
+          "Get network function resource": {
+            "$ref": "./examples/NetworkFunctionGet.json"
+          }
+        }
+      },
+      "put": {
+        "tags": [
+          "NetworkFunctions"
+        ],
+        "operationId": "NetworkFunctions_CreateOrUpdate",
+        "description": "Creates or updates a network function resource.",
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v2/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "name": "networkFunctionName",
+            "in": "path",
+            "required": true,
+            "type": "string",
+            "description": "Resource name for the network function resource."
+          },
+          {
+            "name": "parameters",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/NetworkFunction"
+            },
+            "description": "Parameters supplied in the body to the create or update network function operation."
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v2/types.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v2/types.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The operation is completed successfully.",
+            "schema": {
+              "$ref": "#/definitions/NetworkFunction"
+            }
+          },
+          "201": {
+            "description": "Created or Updated. The header contains 'Azure-AsyncOperation' header pointing to an operation resource. The operation URI can be queried to find the current state of the operation.",
+            "schema": {
+              "$ref": "#/definitions/NetworkFunction"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "../../../../../common-types/resource-management/v2/types.json#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-examples": {
+          "Create network function resource": {
+            "$ref": "./examples/NetworkFunctionCreate.json"
+          }
+        },
+        "x-ms-long-running-operation": true,
+        "x-ms-long-running-operation-options": {
+          "final-state-via": "azure-async-operation"
+        }
+      },
+      "patch": {
+        "tags": [
+          "NetworkFunctions"
+        ],
+        "operationId": "NetworkFunctions_UpdateTags",
+        "description": "Updates the tags for the network function resource.",
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v2/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "name": "networkFunctionName",
+            "in": "path",
+            "required": true,
+            "type": "string",
+            "description": "Resource name for the network function resource."
+          },
+          {
+            "name": "parameters",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "./common.json#/definitions/TagsObject"
+            },
+            "description": "Parameters supplied to the update network function tags operation."
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v2/types.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v2/types.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Update is completed successfully. The operation returns the resulting network function resource.",
+            "schema": {
+              "$ref": "#/definitions/NetworkFunction"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "../../../../../common-types/resource-management/v2/types.json#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-examples": {
+          "Update tags for network function resource": {
+            "$ref": "./examples/NetworkFunctionUpdateTags.json"
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/providers/Microsoft.HybridNetwork/networkFunctions": {
+      "get": {
+        "description": "Lists all the network functions in a subscription.",
+        "operationId": "NetworkFunctions_ListBySubscription",
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v2/types.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v2/types.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Request is successful. The operation returns a list of network function resources.",
+            "schema": {
+              "$ref": "#/definitions/NetworkFunctionListResult"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "../../../../../common-types/resource-management/v2/types.json#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "tags": [
+          "NetworkFunctions"
+        ],
+        "x-ms-examples": {
+          "List all network function resources in subscription.": {
+            "$ref": "./examples/NetworkFunctionListBySubscription.json"
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.HybridNetwork/networkFunctions": {
+      "get": {
+        "tags": [
+          "NetworkFunctions"
+        ],
+        "operationId": "NetworkFunctions_ListByResourceGroup",
+        "description": "Lists all the network function resources in a resource group.",
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v2/types.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v2/types.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v2/types.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Request is successful. The operation returns a list of network function resources.",
+            "schema": {
+              "$ref": "#/definitions/NetworkFunctionListResult"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "../../../../../common-types/resource-management/v2/types.json#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-examples": {
+          "List network function in resource group": {
+            "$ref": "./examples/NetworkFunctionListByResourceGroup.json"
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        }
+      }
+    }
+  },
+  "definitions": {
+    "NetworkFunction": {
+      "properties": {
+        "properties": {
+          "x-ms-client-flatten": true,
+          "$ref": "#/definitions/NetworkFunctionPropertiesFormat",
+          "description": "Network function properties."
+        },
+        "etag": {
+          "type": "string",
+          "description": "A unique read-only string that changes whenever the resource is updated."
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "../../../../../common-types/resource-management/v2/types.json#/definitions/TrackedResource"
+        }
+      ],
+      "description": "Network function resource response."
+    },
+    "NetworkFunctionPropertiesFormat": {
+      "description": "Network function properties.",
+      "properties": {
+        "provisioningState": {
+          "readOnly": true,
+          "$ref": "./common.json#/definitions/ProvisioningState",
+          "description": "The provisioning state of the network function resource."
+        },
+        "device": {
+          "$ref": "./common.json#/definitions/SubResource",
+          "description": "The reference to the device resource."
+        },
+        "skuName": {
+          "type": "string",
+          "description": "The sku name for the network function."
+        },
+        "skuType": {
+          "readOnly": true,
+          "$ref": "./common.json#/definitions/SkuType",
+          "description": "The sku type for the network function."
+        },
+        "vendorName": {
+          "type": "string",
+          "description": "The vendor name for the network function."
+        },
+        "serviceKey": {
+          "type": "string",
+          "readOnly": true,
+          "description": "The service key for the network function resource."
+        },
+        "vendorProvisioningState": {
+          "readOnly": true,
+          "$ref": "./common.json#/definitions/VendorProvisioningState",
+          "description": "The vendor provisioning state for the network function resource."
+        },
+        "managedApplication": {
+          "readOnly": true,
+          "$ref": "./common.json#/definitions/SubResource",
+          "description": "The resource URI of the managed application."
+        },
+        "managedApplicationParameters": {
+          "$ref": "./common.json#/definitions/ManagedApplicationParameters",
+          "description": "The parameters for the managed application."
+        },
+        "networkFunctionUserConfigurations": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/NetworkFunctionUserConfiguration"
+          },
+          "description": "The network function configurations from the user."
+        }
+      }
+    },
+    "NetworkFunctionListResult": {
+      "properties": {
+        "value": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/NetworkFunction"
+          },
+          "description": "A list of network function resources in a subscription or resource group."
+        },
+        "nextLink": {
+          "type": "string",
+          "readOnly": true,
+          "description": "The URL to get the next set of results."
+        }
+      },
+      "description": "Response for network function API service call."
+    },
+    "NetworkFunctionUserConfiguration": {
+      "properties": {
+        "roleName": {
+          "type": "string",
+          "description": "The name of the network function role."
+        },
+        "userDataParameters": {
+          "$ref": "./common.json#/definitions/UserDataParameters",
+          "description": "The user data parameters from the customer."
+        },
+        "networkInterfaces": {
+          "type": "array",
+          "items": {
+            "$ref": "./common.json#/definitions/NetworkInterface"
+          },
+          "description": "The network interface configuration."
+        },
+        "osProfile": {
+          "properties": {
+            "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 the operating system settings for the role instance."
+        }
+      },
+      "description": "The network function user configuration."
+    }
+  }
+}
diff --git a/specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/virtualNetworkFunctionVendors.json b/specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/networkFunctionVendor.json
similarity index 55%
rename from specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/virtualNetworkFunctionVendors.json
rename to specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/networkFunctionVendor.json
index 83e78c9b7b4c..b7125d5ad621 100644
--- a/specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/virtualNetworkFunctionVendors.json
+++ b/specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/networkFunctionVendor.json
@@ -2,7 +2,7 @@
   "swagger": "2.0",
   "info": {
     "title": "HybridNetworkManagementClient",
-    "description": "The resources in this swagger specification will be used to manage the virtual network function vendor in a hybrid network resource provider.",
+    "description": "The resources in this swagger specification will be used to manage the network function vendor in a Hybrid Network resource provider.",
     "version": "2020-01-01-preview"
   },
   "host": "management.azure.com",
@@ -34,38 +34,38 @@
     }
   },
   "paths": {
-    "/subscriptions/{subscriptionId}/providers/Microsoft.HybridNetwork/virtualNetworkFunctionVendors": {
+    "/subscriptions/{subscriptionId}/providers/Microsoft.HybridNetwork/networkFunctionVendors": {
       "get": {
         "tags": [
-          "virtualNetworkFunctionVendors"
+          "networkFunctionVendors"
         ],
-        "operationId": "virtualNetworkFunctionVendors_List",
-        "description": "List all the available vendor and sku information in hybrid network.",
+        "operationId": "networkFunctionVendors_List",
+        "description": "Lists all the available vendor and sku information.",
         "parameters": [
           {
-            "$ref": "./common.json#/parameters/ApiVersionParameter"
+            "$ref": "../../../../../common-types/resource-management/v2/types.json#/parameters/ApiVersionParameter"
           },
           {
-            "$ref": "./common.json#/parameters/SubscriptionIdParameter"
+            "$ref": "../../../../../common-types/resource-management/v2/types.json#/parameters/SubscriptionIdParameter"
           }
         ],
         "responses": {
           "200": {
-            "description": "Request successful. The operation returns a list of hybrid network vendors with available sku information.",
+            "description": "Request is successful. The operation returns a list of vendors with available sku information.",
             "schema": {
-              "$ref": "#/definitions/VirtualNetworkFunctionVendorListResult"
+              "$ref": "#/definitions/NetworkFunctionVendorListResult"
             }
           },
           "default": {
             "description": "Error response describing why the operation failed.",
             "schema": {
-              "$ref": "./common.json#/definitions/ErrorDetails"
+              "$ref": "../../../../../common-types/resource-management/v2/types.json#/definitions/ErrorResponse"
             }
           }
         },
         "x-ms-examples": {
-          "List hybrid network vendors and skus.": {
-            "$ref": "./examples/VirtualNetworkFunctionVendorAndSkuList.json"
+          "List vendors and skus.": {
+            "$ref": "./examples/NetworkFunctionVendorAndSkuListBySubscription.json"
           }
         },
         "x-ms-pageable": {
@@ -73,45 +73,45 @@
         }
       }
     },
-    "/subscriptions/{subscriptionId}/providers/Microsoft.HybridNetwork/virtualNetworkFunctionVendors/{vendorName}/vendorSkus": {
+    "/subscriptions/{subscriptionId}/providers/Microsoft.HybridNetwork/networkFunctionVendors/{vendorName}/vendorSkus": {
       "get": {
         "tags": [
-          "virtualNetworkFunctionVendors"
+          "networkFunctionVendors"
         ],
-        "operationId": "VirtualNetworkFunctionVendorSkus_ListByVendor",
-        "description": "List all virtual network function vendor sku details in a vendor",
+        "operationId": "NetworkFunctionVendorSkus_ListByVendor",
+        "description": "Lists all network function vendor sku details in a vendor.",
         "parameters": [
           {
             "name": "vendorName",
-            "description": "The name of the hybrid network virtual network function vendor.",
+            "description": "The name of the network function vendor.",
             "in": "path",
             "required": true,
             "type": "string"
           },
           {
-            "$ref": "./common.json#/parameters/ApiVersionParameter"
+            "$ref": "../../../../../common-types/resource-management/v2/types.json#/parameters/ApiVersionParameter"
           },
           {
-            "$ref": "./common.json#/parameters/SubscriptionIdParameter"
+            "$ref": "../../../../../common-types/resource-management/v2/types.json#/parameters/SubscriptionIdParameter"
           }
         ],
         "responses": {
           "200": {
-            "description": "Request successful. The operation returns a list of virtual network function vendor skus",
+            "description": "Request is successful. The operation returns a list of network function vendor skus.",
             "schema": {
-              "$ref": "#/definitions/VirtualNetworkFunctionSkuListResult"
+              "$ref": "#/definitions/NetworkFunctionSkuListResult"
             }
           },
           "default": {
             "description": "Error response describing why the operation failed.",
             "schema": {
-              "$ref": "./common.json#/definitions/ErrorDetails"
+              "$ref": "../../../../../common-types/resource-management/v2/types.json#/definitions/ErrorResponse"
             }
           }
         },
         "x-ms-examples": {
-          "List hybrid network vendors and skus.": {
-            "$ref": "./examples/VirtualNetworkFunctionSkuList.json"
+          "List vendors and skus.": {
+            "$ref": "./examples/NetworkFunctionSkuListByVendor.json"
           }
         },
         "x-ms-pageable": {
@@ -119,52 +119,52 @@
         }
       }
     },
-    "/subscriptions/{subscriptionId}/providers/Microsoft.HybridNetwork/virtualNetworkFunctionVendors/{vendorName}/vendorSkus/{vendorSkuName}": {
+    "/subscriptions/{subscriptionId}/providers/Microsoft.HybridNetwork/networkFunctionVendors/{vendorName}/vendorSkus/{vendorSkuName}": {
       "get": {
         "tags": [
-          "virtualNetworkFunctionVendors"
+          "networkFunctionVendors"
         ],
-        "operationId": "virtualNetworkFunctionVendorSkus_List",
-        "description": "Gets information about hybrid network virtual network function vendor sku details",
+        "operationId": "networkFunctionVendorSkus_ListBySku",
+        "description": "Lists information about network function vendor sku details.",
         "parameters": [
           {
             "name": "vendorName",
-            "description": "The name of the hybrid network virtual network function vendor.",
+            "description": "The name of the network function vendor.",
             "in": "path",
             "required": true,
             "type": "string"
           },
           {
             "name": "vendorSkuName",
-            "description": "The name of the hybrid network virtual network function sku.",
+            "description": "The name of the network function sku.",
             "in": "path",
             "required": true,
             "type": "string"
           },
           {
-            "$ref": "./common.json#/parameters/ApiVersionParameter"
+            "$ref": "../../../../../common-types/resource-management/v2/types.json#/parameters/ApiVersionParameter"
           },
           {
-            "$ref": "./common.json#/parameters/SubscriptionIdParameter"
+            "$ref": "../../../../../common-types/resource-management/v2/types.json#/parameters/SubscriptionIdParameter"
           }
         ],
         "responses": {
           "200": {
-            "description": "Request successful. The operation returns the resulting hybrid network virtual network function vendor sku details.",
+            "description": "Request is successful. The operation returns the resulting network function vendor sku details.",
             "schema": {
-              "$ref": "#/definitions/VirtualNetworkFunctionSkuDetails"
+              "$ref": "#/definitions/NetworkFunctionSkuDetails"
             }
           },
           "default": {
             "description": "Error response describing why the operation failed.",
             "schema": {
-              "$ref": "./common.json#/definitions/ErrorDetails"
+              "$ref": "../../../../../common-types/resource-management/v2/types.json#/definitions/ErrorResponse"
             }
           }
         },
         "x-ms-examples": {
-          "Get virtual network function sku details": {
-            "$ref": "./examples/VirtualNetworkFunctionGetSkuDetails.json"
+          "Get network function sku details": {
+            "$ref": "./examples/NetworkFunctionSkuDetailsGet.json"
           }
         },
         "x-ms-pageable": {
@@ -185,20 +185,20 @@
           "description": "The vendor sku type."
         }
       },
-      "description": "The virtual network function sku overview."
+      "description": "The network function sku overview."
     },
-    "VirtualNetworkFunctionSkuDetails": {
+    "NetworkFunctionSkuDetails": {
       "properties": {
         "skuType": {
           "$ref": "./common.json#/definitions/SkuType",
-          "description": "The virtual network function sku type."
+          "description": "The network function sku type."
         },
         "value": {
           "type": "array",
           "items": {
-            "$ref": "#/definitions/VirtualNetworkFunctionSkuRoleDetails"
+            "$ref": "#/definitions/NetworkFunctionSkuRoleDetails"
           },
-          "description": "The virtual network function sku role details."
+          "description": "The network function sku role details."
         },
         "nextLink": {
           "type": "string",
@@ -206,42 +206,42 @@
           "description": "The URL to get the next set of results."
         }
       },
-      "description": "The virtual network function sku details."
+      "description": "The network function sku details."
     },
     "VendorDetails": {
       "properties": {
         "vendorName": {
           "type": "string",
-          "description": "The virtual network function vendor name."
+          "description": "The network function vendor name."
         },
         "skuList": {
           "type": "array",
           "items": {
             "$ref": "#/definitions/SkuOverview"
           },
-          "description": "The virtual network function sku list."
+          "description": "The network function sku list."
         }
       },
-      "description": "The virtual network function vendor details."
+      "description": "The network function vendor details."
     },
-    "VirtualNetworkFunctionVendor": {
+    "NetworkFunctionVendor": {
       "properties": {
         "properties": {
           "x-ms-client-flatten": true,
           "$ref": "#/definitions/VendorDetails",
-          "description": "Vendors of the hybrid network service provider."
+          "description": "Vendors of Hybrid Network service provider."
         }
       },
-      "description": "The virtual network function vendor."
+      "description": "The network function vendor."
     },
-    "VirtualNetworkFunctionVendorListResult": {
+    "NetworkFunctionVendorListResult": {
       "properties": {
         "value": {
           "type": "array",
           "items": {
-            "$ref": "#/definitions/VirtualNetworkFunctionVendor"
+            "$ref": "#/definitions/NetworkFunctionVendor"
           },
-          "description": "A list of available hybrid network virtual network function vendors and skus."
+          "description": "A list of available network function vendors and skus."
         },
         "nextLink": {
           "type": "string",
@@ -249,13 +249,13 @@
           "description": "The URL to get the next set of results."
         }
       },
-      "description": "The virtual network function vendor list result."
+      "description": "The network function vendor list result."
     },
-    "VirtualNetworkFunctionSkuRoleDetails": {
+    "NetworkFunctionSkuRoleDetails": {
       "properties": {
         "roleName": {
           "type": "string",
-          "description": "The name of the virtual network function role."
+          "description": "The name of the network function role."
         },
         "userDataTemplate": {
           "$ref": "./common.json#/definitions/UserDataTemplate",
@@ -273,16 +273,16 @@
           "description": "The network interface configuration."
         }
       },
-      "description": "The virtual network function user configuration."
+      "description": "The network function user configuration."
     },
-    "VirtualNetworkFunctionSkuListResult": {
+    "NetworkFunctionSkuListResult": {
       "properties": {
         "value": {
           "type": "array",
           "items": {
             "$ref": "#/definitions/SkuOverview"
           },
-          "description": "The virtual network function vendor sku overview properties."
+          "description": "The network function vendor sku overview properties."
         },
         "nextLink": {
           "type": "string",
@@ -290,7 +290,7 @@
           "description": "The URL to get the next set of results."
         }
       },
-      "description": "A list of available hybrid network virtual network function skus."
+      "description": "A list of available network function skus."
     }
   }
 }
diff --git a/specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/operations.json b/specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/operation.json
similarity index 86%
rename from specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/operations.json
rename to specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/operation.json
index eb38d176e17d..971cc4633244 100644
--- a/specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/operations.json
+++ b/specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/operation.json
@@ -43,12 +43,12 @@
         "description": "Gets a list of the operations.",
         "parameters": [
           {
-            "$ref": "./common.json#/parameters/ApiVersionParameter"
+            "$ref": "../../../../../common-types/resource-management/v2/types.json#/parameters/ApiVersionParameter"
           }
         ],
         "responses": {
           "200": {
-            "description": "OK Returns a list of operations.",
+            "description": "OK. Returns a list of operations.",
             "schema": {
               "$ref": "#/definitions/OperationList"
             }
@@ -56,7 +56,7 @@
           "default": {
             "description": "Error response describing why the operation failed.",
             "schema": {
-              "$ref": "./common.json#/definitions/ErrorDetails"
+              "$ref": "../../../../../common-types/resource-management/v2/types.json#/definitions/ErrorResponse"
             }
           }
         },
@@ -77,7 +77,7 @@
         "name": {
           "readOnly": true,
           "type": "string",
-          "description": "Operation name: {provider}/{resource}/{operation}"
+          "description": "Operation name: {provider}/{resource}/{operation}."
         },
         "display": {
           "readOnly": true,
@@ -85,11 +85,11 @@
           "properties": {
             "provider": {
               "type": "string",
-              "description": "Service provider: Microsoft.HybridNetwork"
+              "description": "Service provider: Microsoft.HybridNetwork."
             },
             "resource": {
               "type": "string",
-              "description": "Resource on which the operation is performed: Registration definition, registration assignment etc."
+              "description": "Resource on which the operation is performed: Registration definition, registration assignment, etc."
             },
             "operation": {
               "type": "string",
@@ -113,7 +113,7 @@
           "items": {
             "$ref": "#/definitions/Operation"
           },
-          "description": "List of Microsoft.HybridNetwork operations."
+          "description": "A list of Microsoft.HybridNetwork operations."
         },
         "nextLink": {
           "type": "string",
@@ -122,7 +122,7 @@
         }
       },
       "type": "object",
-      "description": "List of the operations."
+      "description": "A list of the operations."
     }
   }
 }
diff --git a/specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/vendor.json b/specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/vendor.json
index cee87dde532a..ad541989b452 100644
--- a/specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/vendor.json
+++ b/specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/vendor.json
@@ -2,7 +2,7 @@
   "swagger": "2.0",
   "info": {
     "title": "HybridNetworkManagementClient",
-    "description": "The resources in this swagger specification will be used by vendors to on-board offerings and manage virtual network functions.",
+    "description": "The resources in this swagger specification will be used by vendors to on-board offerings and manage network functions.",
     "version": "2020-01-01-preview"
   },
   "host": "management.azure.com",
@@ -50,10 +50,10 @@
             "description": "The name of the vendor."
           },
           {
-            "$ref": "./common.json#/parameters/ApiVersionParameter"
+            "$ref": "../../../../../common-types/resource-management/v2/types.json#/parameters/ApiVersionParameter"
           },
           {
-            "$ref": "./common.json#/parameters/SubscriptionIdParameter"
+            "$ref": "../../../../../common-types/resource-management/v2/types.json#/parameters/SubscriptionIdParameter"
           }
         ],
         "responses": {
@@ -64,12 +64,12 @@
             "description": "Accepted. Sets provisioningState to 'Deleting' until the operation is completed. Returns an operation URI that can be queried to find the current state of the operation."
           },
           "204": {
-            "description": "Request successful. Resource does not exist."
+            "description": "Request is successful. Resource does not exist."
           },
           "default": {
             "description": "Error response describing why the operation failed.",
             "schema": {
-              "$ref": "./common.json#/definitions/ErrorDetails"
+              "$ref": "../../../../../common-types/resource-management/v2/types.json#/definitions/ErrorResponse"
             }
           }
         },
@@ -95,18 +95,18 @@
             "in": "path",
             "required": true,
             "type": "string",
-            "description": "The name of vendor."
+            "description": "The name of the vendor."
           },
           {
-            "$ref": "./common.json#/parameters/ApiVersionParameter"
+            "$ref": "../../../../../common-types/resource-management/v2/types.json#/parameters/ApiVersionParameter"
           },
           {
-            "$ref": "./common.json#/parameters/SubscriptionIdParameter"
+            "$ref": "../../../../../common-types/resource-management/v2/types.json#/parameters/SubscriptionIdParameter"
           }
         ],
         "responses": {
           "200": {
-            "description": "Request successful. The operation returns the resulting vendor resource.",
+            "description": "Request is successful. The operation returns the resulting vendor resource.",
             "schema": {
               "$ref": "#/definitions/Vendor"
             }
@@ -114,7 +114,7 @@
           "default": {
             "description": "Error response describing why the operation failed.",
             "schema": {
-              "$ref": "./common.json#/definitions/ErrorDetails"
+              "$ref": "../../../../../common-types/resource-management/v2/types.json#/definitions/ErrorResponse"
             }
           }
         },
@@ -144,13 +144,13 @@
             "schema": {
               "$ref": "#/definitions/Vendor"
             },
-            "description": "Parameters supplied to the create vendor."
+            "description": "Parameters supplied to the create vendor operation."
           },
           {
-            "$ref": "./common.json#/parameters/ApiVersionParameter"
+            "$ref": "../../../../../common-types/resource-management/v2/types.json#/parameters/ApiVersionParameter"
           },
           {
-            "$ref": "./common.json#/parameters/SubscriptionIdParameter"
+            "$ref": "../../../../../common-types/resource-management/v2/types.json#/parameters/SubscriptionIdParameter"
           }
         ],
         "responses": {
@@ -161,7 +161,7 @@
             }
           },
           "201": {
-            "description": "Created. The header contains ‘Azure-AsyncOperation’ header pointing to an operations resource. The operation URI can be queried to find the current state of the operation.",
+            "description": "Created. The header contains 'Azure-AsyncOperation' header pointing to an operations resource. The operation URI can be queried to find the current state of the operation.",
             "schema": {
               "$ref": "#/definitions/Vendor"
             }
@@ -169,7 +169,7 @@
           "default": {
             "description": "Error response describing why the operation failed.",
             "schema": {
-              "$ref": "./common.json#/definitions/ErrorDetails"
+              "$ref": "../../../../../common-types/resource-management/v2/types.json#/definitions/ErrorResponse"
             }
           }
         },
@@ -193,15 +193,15 @@
         "description": "Lists all the vendors in a subscription.",
         "parameters": [
           {
-            "$ref": "./common.json#/parameters/ApiVersionParameter"
+            "$ref": "../../../../../common-types/resource-management/v2/types.json#/parameters/ApiVersionParameter"
           },
           {
-            "$ref": "./common.json#/parameters/SubscriptionIdParameter"
+            "$ref": "../../../../../common-types/resource-management/v2/types.json#/parameters/SubscriptionIdParameter"
           }
         ],
         "responses": {
           "200": {
-            "description": "Request successful. The operation returns a list of vendor resources.",
+            "description": "Request is successful. The operation returns a list of vendor resources.",
             "schema": {
               "$ref": "#/definitions/VendorListResult"
             }
@@ -209,13 +209,13 @@
           "default": {
             "description": "Error response describing why the operation failed.",
             "schema": {
-              "$ref": "./common.json#/definitions/ErrorDetails"
+              "$ref": "../../../../../common-types/resource-management/v2/types.json#/definitions/ErrorResponse"
             }
           }
         },
         "x-ms-examples": {
-          "Lists all vendor resources in subscription": {
-            "$ref": "./examples/VendorListAll.json"
+          "List all vendor resources in subscription": {
+            "$ref": "./examples/VendorListBySubscription.json"
           }
         },
         "x-ms-pageable": {
@@ -246,10 +246,10 @@
             "description": "The name of the sku."
           },
           {
-            "$ref": "./common.json#/parameters/ApiVersionParameter"
+            "$ref": "../../../../../common-types/resource-management/v2/types.json#/parameters/ApiVersionParameter"
           },
           {
-            "$ref": "./common.json#/parameters/SubscriptionIdParameter"
+            "$ref": "../../../../../common-types/resource-management/v2/types.json#/parameters/SubscriptionIdParameter"
           }
         ],
         "responses": {
@@ -257,15 +257,15 @@
             "description": "OK. Request is successful."
           },
           "202": {
-            "description": "Accepted. Sets provisioningState to 'Deleting' until the operation is completed.. Returns an operation URI that can be queried to find the current state of the operation."
+            "description": "Accepted. Sets provisioningState to 'Deleting' until the operation is completed. Returns an operation URI that can be queried to find the current state of the operation."
           },
           "204": {
-            "description": "Request successful. Resource does not exist."
+            "description": "Request is successful. Resource does not exist."
           },
           "default": {
             "description": "Error response describing why the operation failed.",
             "schema": {
-              "$ref": "./common.json#/definitions/ErrorDetails"
+              "$ref": "../../../../../common-types/resource-management/v2/types.json#/definitions/ErrorResponse"
             }
           }
         },
@@ -291,7 +291,7 @@
             "in": "path",
             "required": true,
             "type": "string",
-            "description": "The name of vendor."
+            "description": "The name of the vendor."
           },
           {
             "name": "skuName",
@@ -301,15 +301,15 @@
             "description": "The name of the sku."
           },
           {
-            "$ref": "./common.json#/parameters/ApiVersionParameter"
+            "$ref": "../../../../../common-types/resource-management/v2/types.json#/parameters/ApiVersionParameter"
           },
           {
-            "$ref": "./common.json#/parameters/SubscriptionIdParameter"
+            "$ref": "../../../../../common-types/resource-management/v2/types.json#/parameters/SubscriptionIdParameter"
           }
         ],
         "responses": {
           "200": {
-            "description": "Request successful. The operation returns the resulting vendor resource.",
+            "description": "Request is successful. The operation returns the resulting vendor resource.",
             "schema": {
               "$ref": "#/definitions/VendorSku"
             }
@@ -317,12 +317,12 @@
           "default": {
             "description": "Error response describing why the operation failed.",
             "schema": {
-              "$ref": "./common.json#/definitions/ErrorDetails"
+              "$ref": "../../../../../common-types/resource-management/v2/types.json#/definitions/ErrorResponse"
             }
           }
         },
         "x-ms-examples": {
-          "Get the sku of Vendor resource": {
+          "Get the sku of vendor resource": {
             "$ref": "./examples/VendorSkuGet.json"
           }
         }
@@ -355,18 +355,18 @@
             "schema": {
               "$ref": "#/definitions/VendorSku"
             },
-            "description": "Parameters supplied to the create or update sku."
+            "description": "Parameters supplied to the create or update sku operation."
           },
           {
-            "$ref": "./common.json#/parameters/ApiVersionParameter"
+            "$ref": "../../../../../common-types/resource-management/v2/types.json#/parameters/ApiVersionParameter"
           },
           {
-            "$ref": "./common.json#/parameters/SubscriptionIdParameter"
+            "$ref": "../../../../../common-types/resource-management/v2/types.json#/parameters/SubscriptionIdParameter"
           }
         ],
         "responses": {
           "200": {
-            "description": "Update or creation successful. The operation returns the resulting vendor sku sub resource.",
+            "description": "Creation or update is successful. The operation returns the resulting vendor sku sub resource.",
             "schema": {
               "$ref": "#/definitions/VendorSku"
             }
@@ -380,12 +380,12 @@
           "default": {
             "description": "Error response describing why the operation failed.",
             "schema": {
-              "$ref": "./common.json#/definitions/ErrorDetails"
+              "$ref": "../../../../../common-types/resource-management/v2/types.json#/definitions/ErrorResponse"
             }
           }
         },
         "x-ms-examples": {
-          "Create or update the sku of Vendor resource": {
+          "Create or update the sku of vendor resource": {
             "$ref": "./examples/VendorSkuCreate.json"
           }
         },
@@ -411,15 +411,15 @@
             "description": "The name of the vendor."
           },
           {
-            "$ref": "./common.json#/parameters/ApiVersionParameter"
+            "$ref": "../../../../../common-types/resource-management/v2/types.json#/parameters/ApiVersionParameter"
           },
           {
-            "$ref": "./common.json#/parameters/SubscriptionIdParameter"
+            "$ref": "../../../../../common-types/resource-management/v2/types.json#/parameters/SubscriptionIdParameter"
           }
         ],
         "responses": {
           "200": {
-            "description": "Request successful. The operation returns a list of vendor sku resources.",
+            "description": "Request is successful. The operation returns a list of vendor sku resources.",
             "schema": {
               "$ref": "#/definitions/VendorSkuListResult"
             }
@@ -427,204 +427,13 @@
           "default": {
             "description": "Error response describing why the operation failed.",
             "schema": {
-              "$ref": "./common.json#/definitions/ErrorDetails"
-            }
-          }
-        },
-        "x-ms-examples": {
-          "Lists all the vendor skus of vendor resource": {
-            "$ref": "./examples/VendorSkuListAll.json"
-          }
-        },
-        "x-ms-pageable": {
-          "nextLinkName": "nextLink"
-        }
-      }
-    },
-    "/subscriptions/{subscriptionId}/providers/Microsoft.HybridNetwork/locations/{locationName}/vendors/{vendorName}/virtualNetworkFunctions/{serviceKey}": {
-      "get": {
-        "tags": [
-          "VendorVirtualNetworkFunctions"
-        ],
-        "operationId": "VendorVirtualNetworkFunctions_Get",
-        "description": "Gets information about the specified virtual network function.",
-        "parameters": [
-          {
-            "name": "locationName",
-            "in": "path",
-            "required": true,
-            "type": "string",
-            "description": "The azure region where the virtual network function sub resource was created by customer."
-          },
-          {
-            "name": "vendorName",
-            "in": "path",
-            "required": true,
-            "type": "string",
-            "description": "The name of the vendor."
-          },
-          {
-            "name": "serviceKey",
-            "in": "path",
-            "required": true,
-            "type": "string",
-            "description": "The unique GUID for the virtual network function."
-          },
-          {
-            "$ref": "./common.json#/parameters/ApiVersionParameter"
-          },
-          {
-            "$ref": "./common.json#/parameters/SubscriptionIdParameter"
-          }
-        ],
-        "responses": {
-          "200": {
-            "description": "Request successful. The operation returns the resulting vendor virtual network function sub resource.",
-            "schema": {
-              "$ref": "#/definitions/VendorVirtualNetworkFunction"
-            }
-          },
-          "default": {
-            "description": "Error response describing why the operation failed.",
-            "schema": {
-              "$ref": "./common.json#/definitions/ErrorDetails"
-            }
-          }
-        },
-        "x-ms-examples": {
-          "Get vendor virtual network function sub resource by service key of virtual network function.": {
-            "$ref": "./examples/VendorVnfGet.json"
-          }
-        }
-      },
-      "put": {
-        "tags": [
-          "VendorVirtualNetworkFunctions"
-        ],
-        "operationId": "VendorVirtualNetworkFunctions_CreateOrUpdate",
-        "description": "Create or update a virtual network function.",
-        "parameters": [
-          {
-            "name": "locationName",
-            "in": "path",
-            "required": true,
-            "type": "string",
-            "description": "The azure region where the virtual network function resource was created by customer."
-          },
-          {
-            "name": "vendorName",
-            "in": "path",
-            "required": true,
-            "type": "string",
-            "description": "The name of the vendor."
-          },
-          {
-            "name": "serviceKey",
-            "in": "path",
-            "required": true,
-            "type": "string",
-            "description": "The unique GUID for the virtual network function."
-          },
-          {
-            "name": "parameters",
-            "in": "body",
-            "required": true,
-            "schema": {
-              "$ref": "#/definitions/VendorVirtualNetworkFunction"
-            },
-            "description": "Parameters supplied to the update vendor virtual network function."
-          },
-          {
-            "$ref": "./common.json#/parameters/ApiVersionParameter"
-          },
-          {
-            "$ref": "./common.json#/parameters/SubscriptionIdParameter"
-          }
-        ],
-        "responses": {
-          "200": {
-            "description": "Create or update is successful. The operation returns the resulting vendor virtual network function sub resource.",
-            "schema": {
-              "$ref": "#/definitions/VendorVirtualNetworkFunction"
-            }
-          },
-          "201": {
-            "description": "Created. The operation returns the resulting vendor virtual network function sub resource.",
-            "schema": {
-              "$ref": "#/definitions/VendorVirtualNetworkFunction"
-            }
-          },
-          "default": {
-            "description": "Error response describing why the operation failed.",
-            "schema": {
-              "$ref": "./common.json#/definitions/ErrorDetails"
-            }
-          }
-        },
-        "x-ms-examples": {
-          "Update vendor virtual network function sub resource": {
-            "$ref": "./examples/VendorVnfCreate.json"
-          }
-        },
-        "x-ms-long-running-operation": true,
-        "x-ms-long-running-operation-options": {
-          "final-state-via": "azure-async-operation"
-        }
-      }
-    },
-    "/subscriptions/{subscriptionId}/providers/Microsoft.HybridNetwork/locations/{locationName}/vendors/{vendorName}/virtualNetworkFunctions": {
-      "get": {
-        "tags": [
-          "VendorVirtualNetworkFunctions"
-        ],
-        "operationId": "VendorVirtualNetworkFunctions_List",
-        "description": "List all the vendor virtual network function sub resources in an azure region. Filter by skuType, skuName, vendorProvisioningState",
-        "parameters": [
-          {
-            "name": "locationName",
-            "in": "path",
-            "required": true,
-            "type": "string",
-            "description": "The azure region where the virtual network function resource was created by customer."
-          },
-          {
-            "name": "vendorName",
-            "in": "path",
-            "required": true,
-            "type": "string",
-            "description": "The name of the vendor."
-          },
-          {
-            "name": "$filter",
-            "in": "query",
-            "required": false,
-            "type": "string",
-            "description": "The filter to apply on the operation. The properties you can use for eq (equals) are: skuType, skuName and vendorProvisioningState."
-          },
-          {
-            "$ref": "./common.json#/parameters/ApiVersionParameter"
-          },
-          {
-            "$ref": "./common.json#/parameters/SubscriptionIdParameter"
-          }
-        ],
-        "responses": {
-          "200": {
-            "description": "Request successful. The operation returns the resulting hybrid network vendor virtual network function sub resource.",
-            "schema": {
-              "$ref": "#/definitions/VendorVirtualNetworkFunctionListResult"
-            }
-          },
-          "default": {
-            "description": "Error response describing why the operation failed.",
-            "schema": {
-              "$ref": "./common.json#/definitions/ErrorDetails"
+              "$ref": "../../../../../common-types/resource-management/v2/types.json#/definitions/ErrorResponse"
             }
           }
         },
         "x-ms-examples": {
-          "Get all vnf of Vendor resource": {
-            "$ref": "./examples/VendorVnfList.json"
+          "List all the vendor skus of vendor resource": {
+            "$ref": "./examples/VendorSkuListByVendor.json"
           }
         },
         "x-ms-pageable": {
@@ -638,7 +447,7 @@
           "VendorSkuPreview"
         ],
         "operationId": "VendorSkuPreview_List",
-        "description": "Gets preview information of a vendor sku",
+        "description": "Lists all the preview information of a vendor sku.",
         "parameters": [
           {
             "name": "vendorName",
@@ -655,15 +464,15 @@
             "description": "The name of the sku."
           },
           {
-            "$ref": "./common.json#/parameters/ApiVersionParameter"
+            "$ref": "../../../../../common-types/resource-management/v2/types.json#/parameters/ApiVersionParameter"
           },
           {
-            "$ref": "./common.json#/parameters/SubscriptionIdParameter"
+            "$ref": "../../../../../common-types/resource-management/v2/types.json#/parameters/SubscriptionIdParameter"
           }
         ],
         "responses": {
           "200": {
-            "description": "Request successful. The operation returns the preview information of the vendor sku sub resource.",
+            "description": "Request is successful. The operation returns the preview information of the vendor sku sub resource.",
             "schema": {
               "$ref": "#/definitions/PreviewSubscriptionsList"
             }
@@ -671,13 +480,13 @@
           "default": {
             "description": "Error response describing why the operation failed.",
             "schema": {
-              "$ref": "./common.json#/definitions/ErrorDetails"
+              "$ref": "../../../../../common-types/resource-management/v2/types.json#/definitions/ErrorResponse"
             }
           }
         },
         "x-ms-examples": {
-          "Get all preview subscriptions of vendor sku sub resource": {
-            "$ref": "./examples/GetVendorSkuPreviews.json"
+          "List all preview subscriptions of vendor sku sub resource": {
+            "$ref": "./examples/VendorSkuPreviewListBySku.json"
           }
         },
         "x-ms-pageable": {
@@ -691,7 +500,7 @@
           "VendorSkuPreview"
         ],
         "operationId": "VendorSkuPreview_CreateOrUpdate",
-        "description": "Creates or updates preview information of a vendor sku",
+        "description": "Creates or updates preview information of a vendor sku.",
         "parameters": [
           {
             "name": "vendorName",
@@ -712,7 +521,7 @@
             "in": "path",
             "required": true,
             "type": "string",
-            "description": "Preview subscription id."
+            "description": "Preview subscription ID."
           },
           {
             "name": "parameters",
@@ -721,24 +530,24 @@
             "schema": {
               "$ref": "#/definitions/PreviewSubscription"
             },
-            "description": "Parameters supplied to the update vendor virtual network function."
+            "description": "Parameters supplied to the create or update vendor preview subscription operation."
           },
           {
-            "$ref": "./common.json#/parameters/ApiVersionParameter"
+            "$ref": "../../../../../common-types/resource-management/v2/types.json#/parameters/ApiVersionParameter"
           },
           {
-            "$ref": "./common.json#/parameters/SubscriptionIdParameter"
+            "$ref": "../../../../../common-types/resource-management/v2/types.json#/parameters/SubscriptionIdParameter"
           }
         ],
         "responses": {
           "201": {
-            "description": "Request accepted. The operation is updating or creating the preview information of the vendor sku sub resource.",
+            "description": "Request is accepted. The operation is updating or creating the preview information of the vendor sku sub resource.",
             "schema": {
               "$ref": "#/definitions/PreviewSubscription"
             }
           },
           "200": {
-            "description": "Request successful. The operation updated the preview information of the vendor sku sub resource.",
+            "description": "Request is successful. The operation updated the preview information of the vendor sku sub resource.",
             "schema": {
               "$ref": "#/definitions/PreviewSubscription"
             }
@@ -746,7 +555,7 @@
           "default": {
             "description": "Error response describing why the operation failed.",
             "schema": {
-              "$ref": "./common.json#/definitions/ErrorDetails"
+              "$ref": "../../../../../common-types/resource-management/v2/types.json#/definitions/ErrorResponse"
             }
           }
         },
@@ -755,8 +564,8 @@
           "final-state-via": "azure-async-operation"
         },
         "x-ms-examples": {
-          "Creates or updates preview subscription of vendor sku sub resource": {
-            "$ref": "./examples/CreateVendorSkuPreview.json"
+          "Create or update preview subscription of vendor sku sub resource": {
+            "$ref": "./examples/VendorSkuPreviewCreate.json"
           }
         }
       },
@@ -765,7 +574,7 @@
           "VendorSkuPreview"
         ],
         "operationId": "VendorSkuPreview_Get",
-        "description": "Gets preview information of a vendor sku",
+        "description": "Gets the preview information of a vendor sku.",
         "parameters": [
           {
             "name": "vendorName",
@@ -786,18 +595,18 @@
             "in": "path",
             "required": true,
             "type": "string",
-            "description": "Preview subscription id."
+            "description": "Preview subscription ID."
           },
           {
-            "$ref": "./common.json#/parameters/ApiVersionParameter"
+            "$ref": "../../../../../common-types/resource-management/v2/types.json#/parameters/ApiVersionParameter"
           },
           {
-            "$ref": "./common.json#/parameters/SubscriptionIdParameter"
+            "$ref": "../../../../../common-types/resource-management/v2/types.json#/parameters/SubscriptionIdParameter"
           }
         ],
         "responses": {
           "200": {
-            "description": "Request successful. The operation updated the preview information of the vendor sku sub resource.",
+            "description": "Request is successful. The operation updated the preview information of the vendor sku sub resource.",
             "schema": {
               "$ref": "#/definitions/PreviewSubscription"
             }
@@ -805,13 +614,13 @@
           "default": {
             "description": "Error response describing why the operation failed.",
             "schema": {
-              "$ref": "./common.json#/definitions/ErrorDetails"
+              "$ref": "../../../../../common-types/resource-management/v2/types.json#/definitions/ErrorResponse"
             }
           }
         },
         "x-ms-examples": {
-          "Gets preview subscription of vendor sku sub resource": {
-            "$ref": "./examples/GetVendorSkuPreview.json"
+          "Get preview subscription of vendor sku sub resource": {
+            "$ref": "./examples/VendorSkuPreviewGet.json"
           }
         }
       },
@@ -820,7 +629,7 @@
           "VendorSkuPreview"
         ],
         "operationId": "VendorSkuPreview_Delete",
-        "description": "Deletes preview information of a vendor sku",
+        "description": "Deletes the preview information of a vendor sku.",
         "parameters": [
           {
             "name": "vendorName",
@@ -841,29 +650,29 @@
             "in": "path",
             "required": true,
             "type": "string",
-            "description": "Preview subscription id."
+            "description": "Preview subscription ID."
           },
           {
-            "$ref": "./common.json#/parameters/ApiVersionParameter"
+            "$ref": "../../../../../common-types/resource-management/v2/types.json#/parameters/ApiVersionParameter"
           },
           {
-            "$ref": "./common.json#/parameters/SubscriptionIdParameter"
+            "$ref": "../../../../../common-types/resource-management/v2/types.json#/parameters/SubscriptionIdParameter"
           }
         ],
         "responses": {
           "200": {
-            "description": "Request successful. The operation deleted the vendor sku preview resource."
+            "description": "Request is successful. The operation deleted the vendor sku preview resource."
           },
           "202": {
             "description": "Request is accepted. The operation is deleting the vendor sku preview resource."
           },
           "204": {
-            "description": "Request successful. The vendor sku preview resource does not exist."
+            "description": "Request is successful. The vendor sku preview resource does not exist."
           },
           "default": {
             "description": "Error response describing why the operation failed.",
             "schema": {
-              "$ref": "./common.json#/definitions/ErrorDetails"
+              "$ref": "../../../../../common-types/resource-management/v2/types.json#/definitions/ErrorResponse"
             }
           }
         },
@@ -872,8 +681,8 @@
           "final-state-via": "location"
         },
         "x-ms-examples": {
-          "Deletes preview subscription of vendor sku sub resource": {
-            "$ref": "./examples/DeleteVendorSkuPreview.json"
+          "Delete preview subscription of vendor sku sub resource": {
+            "$ref": "./examples/VendorSkuPreviewDelete.json"
           }
         }
       }
@@ -890,7 +699,7 @@
       },
       "allOf": [
         {
-          "$ref": "./common.json#/definitions/Resource"
+          "$ref": "../../../../../common-types/resource-management/v2/types.json#/definitions/ProxyResource"
         }
       ],
       "description": "Vendor resource."
@@ -909,7 +718,7 @@
             "$ref": "./common.json#/definitions/SubResource"
           },
           "readOnly": true,
-          "description": "A list of ids of the vendor skus offered by the vendor."
+          "description": "A list of IDs of the vendor skus offered by the vendor."
         }
       }
     },
@@ -923,13 +732,13 @@
       },
       "allOf": [
         {
-          "$ref": "./common.json#/definitions/Resource"
+          "$ref": "../../../../../common-types/resource-management/v2/types.json#/definitions/ProxyResource"
         }
       ],
       "description": "Sku sub resource."
     },
     "VendorSkuPropertiesFormat": {
-      "description": "Sku  properties",
+      "description": "Sku properties",
       "properties": {
         "provisioningState": {
           "readOnly": true,
@@ -938,11 +747,11 @@
         },
         "skuType": {
           "$ref": "./common.json#/definitions/SkuType",
-          "description": "Sku type."
+          "description": "The sku type."
         },
         "deploymentMode": {
           "type": "string",
-          "description": "Sku deployment mode.",
+          "description": "The sku deployment mode.",
           "enum": [
             "Unknown",
             "Azure",
@@ -959,15 +768,15 @@
         },
         "managedApplicationParameters": {
           "$ref": "./common.json#/definitions/ManagedApplicationParameters",
-          "description": "The parameters for the managed application to be supplied by vendor."
+          "description": "The parameters for the managed application to be supplied by the vendor."
         },
         "managedApplicationTemplate": {
           "type": "object",
           "description": "The template for the managed application deployment."
         },
-        "virtualNetworkFunctionTemplate": {
-          "$ref": "#/definitions/VirtualNetworkFunctionTemplate",
-          "description": "The template definition of the virtual network function."
+        "networkFunctionTemplate": {
+          "$ref": "#/definitions/NetworkFunctionTemplate",
+          "description": "The template definition of the network function."
         }
       }
     },
@@ -1003,89 +812,26 @@
           "description": "The URL to get the next set of results."
         }
       },
-      "description": "Response for Vendors API service call."
-    },
-    "VendorVirtualNetworkFunctionListResult": {
-      "properties": {
-        "value": {
-          "type": "array",
-          "items": {
-            "$ref": "#/definitions/VendorVirtualNetworkFunction"
-          },
-          "description": "A list of vendor virtual network function."
-        },
-        "nextLink": {
-          "readOnly": true,
-          "type": "string",
-          "description": "The URL to get the next set of results."
-        }
-      },
       "description": "Response for vendors API service call."
     },
-    "VendorVirtualNetworkFunction": {
-      "properties": {
-        "properties": {
-          "x-ms-client-flatten": true,
-          "$ref": "#/definitions/VendorVirtualNetworkFunctionPropertiesFormat",
-          "description": "Virtual network function details."
-        }
-      },
-      "allOf": [
-        {
-          "$ref": "./common.json#/definitions/Resource"
-        }
-      ],
-      "description": "Vendor virtual network function sub resource."
-    },
-    "VendorVirtualNetworkFunctionPropertiesFormat": {
-      "description": "Vendor virtual network function properties",
+    "NetworkFunctionTemplate": {
       "properties": {
-        "provisioningState": {
-          "readOnly": true,
-          "$ref": "./common.json#/definitions/ProvisioningState",
-          "description": "The provisioning state of the vendor virtual network function sub resource."
-        },
-        "vendorProvisioningState": {
-          "$ref": "./common.json#/definitions/VendorProvisioningState",
-          "description": "Vendor controlled provisioning state of the vendor virtual network function."
-        },
-        "skuName": {
-          "readOnly": true,
-          "type": "string",
-          "description": "Name of the sku"
-        },
-        "skuType": {
-          "$ref": "./common.json#/definitions/SkuType",
-          "description": "Sku type.",
-          "readOnly": true
-        },
-        "virtualNetworkFunctionVendorConfigurations": {
+        "networkFunctionRoleConfigurations": {
           "type": "array",
           "items": {
-            "$ref": "#/definitions/VirtualNetworkFunctionVendorConfiguration"
+            "$ref": "#/definitions/NetworkFunctionRoleConfiguration"
           },
-          "description": "An array of virtual network function vendor configurations."
-        }
-      }
-    },
-    "VirtualNetworkFunctionTemplate": {
-      "properties": {
-        "virutalNetworkFunctionRoleConfigurations": {
-          "type": "array",
-          "items": {
-            "$ref": "#/definitions/VirtualNetworkFunctionRoleConfiguration"
-          },
-          "description": "An array of virtual network function role definitions."
+          "description": "An array of network function role definitions."
         }
       },
-      "description": "The virtual network function template."
+      "description": "The network function template."
     },
-    "VirtualNetworkFunctionRoleConfiguration": {
-      "description": "Virtual network function role configuration.",
+    "NetworkFunctionRoleConfiguration": {
+      "description": "Network function role configuration.",
       "properties": {
         "roleName": {
           "type": "string",
-          "description": "The name of the virtual network function role."
+          "description": "The name of the network function role."
         },
         "roleType": {
           "type": "string",
@@ -1095,7 +841,7 @@
             "VirtualMachine"
           ],
           "x-ms-enum": {
-            "name": "VirtualNetworkFunctionRoleConfigurationType",
+            "name": "NetworkFunctionRoleConfigurationType",
             "modelAsString": true
           }
         },
@@ -1119,24 +865,30 @@
             "Standard_DS5_v2",
             "Standard_DS11_v2",
             "Standard_DS12_v2",
-            "Standard_DS13_v2"
+            "Standard_DS13_v2",
+            "Standard_F1",
+            "Standard_F2",
+            "Standard_F4",
+            "Standard_F8",
+            "Standard_F16",
+            "Standard_F1s",
+            "Standard_F2s",
+            "Standard_F4s",
+            "Standard_F8s",
+            "Standard_F16s"
           ],
           "x-ms-enum": {
             "name": "VirtualMachineSizeTypes",
             "modelAsString": true
           }
         },
-        "imageReference": {
-          "description": "The definition of image reference.",
-          "$ref": "#/definitions/ImageReference"
-        },
         "osProfile": {
-          "description": "Specifies the operating system settings for the role instance. This value can be updated during the deployment of virtual network function.",
-          "$ref": "#/definitions/OsProfile"
+          "description": "Specifies the operating system settings for the role instance. This value can be updated during the deployment of network function.",
+          "$ref": "./common.json#/definitions/OsProfile"
         },
         "userDataTemplate": {
           "$ref": "./common.json#/definitions/UserDataTemplate",
-          "description": "The user data template for customers. This is json scheme template describing the format and data type of user data parameters."
+          "description": "The user data template for customers. This is a json schema template describing the format and data type of user data parameters."
         },
         "userDataParameters": {
           "$ref": "./common.json#/definitions/UserDataParameters",
@@ -1148,39 +900,63 @@
             "$ref": "./common.json#/definitions/NetworkInterface"
           },
           "description": "The network interface configurations."
+        },
+        "storageProfile": {
+          "$ref": "#/definitions/StorageProfile",
+          "description": "Specifies the storage settings for the virtual machine disks."
+        },
+        "customProfile": {
+          "$ref": "#/definitions/CustomProfile",
+          "description": "Specifies the custom settings for the virtual machine."
         }
       }
     },
-    "VirtualNetworkFunctionVendorConfiguration": {
+    "ImageReference": {
       "properties": {
-        "roleName": {
+        "publisher": {
           "type": "string",
-          "description": "The name of the virtual network function role."
+          "description": "The image publisher."
         },
-        "customData": {
+        "offer": {
           "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 the offer of the image used to create the virtual machine."
         },
-        "osProfile": {
-          "description": "Specifies the operating system settings for the role instance.",
-          "$ref": "#/definitions/OsProfile"
+        "sku": {
+          "type": "string",
+          "description": "The image SKU."
         },
-        "userDataParameters": {
-          "$ref": "./common.json#/definitions/UserDataParameters",
-          "readOnly": true,
-          "description": "The user parameters from the customer."
+        "version": {
+          "type": "string",
+          "description": "Specifies the version of the image used to create the virtual machine. The allowed formats are Major.Minor.Build or 'latest'. Major, Minor, and Build are decimal numbers. Specify 'latest' to use the latest version of an image available at deploy time. Even if you use 'latest', the VM image will not automatically update after deploy time even if a new version becomes available."
         },
-        "networkInterfaces": {
+        "exactVersion": {
+          "type": "string",
+          "description": "Specifies in decimal numbers, the exact version of image used to create the virtual machine."
+        }
+      },
+      "description": "The image reference properties."
+    },
+    "StorageProfile": {
+      "properties": {
+        "imageReference": {
+          "$ref": "#/definitions/ImageReference",
+          "description": "The image reference properties."
+        },
+        "osDisk": {
+          "$ref": "#/definitions/OsDisk",
+          "description": "Specifies information about the operating system disk used by the virtual machine."
+        },
+        "dataDisks": {
           "type": "array",
           "items": {
-            "$ref": "./common.json#/definitions/NetworkInterface"
+            "$ref": "#/definitions/DataDisk"
           },
-          "description": "The network interface configurations."
+          "description": "Specifies the parameters that are used to add a data disk to a virtual machine."
         }
       },
-      "description": "Virtual network function vendor configuration."
+      "description": "Specifies the storage settings for the virtual machine disks."
     },
-    "ImageReference": {
+    "OsDisk": {
       "properties": {
         "osType": {
           "type": "string",
@@ -1195,51 +971,70 @@
             "modelAsString": true
           }
         },
-        "vhdName": {
+        "name": {
           "type": "string",
           "description": "The VHD name."
         },
-        "vhdType": {
+        "vhd": {
+          "$ref": "#/definitions/VirtualHardDisk",
+          "description": "The virtual hard disk."
+        },
+        "diskSizeGB": {
+          "type": "integer",
+          "format": "int32",
+          "description": "Specifies the size of os disk in gigabytes. This is the fully expanded disk size needed of the VHD image on the ASE. This disk size should be greater than the size of the VHD provided in vhdUri."
+        }
+      },
+      "description": "Specifies information about the operating system disk used by the virtual machine. <br><br> For more information about disks, see [About disks and VHDs for Azure virtual machines](https://docs.microsoft.com/azure/virtual-machines/virtual-machines-windows-about-disks-vhds?toc=%2fazure%2fvirtual-machines%2fwindows%2ftoc.json)."
+    },
+    "VirtualHardDisk": {
+      "properties": {
+        "uri": {
           "type": "string",
-          "description": "The VHD type.",
+          "x-ms-secret": true,
+          "x-ms-mutability": [
+            "create",
+            "update"
+          ],
+          "description": "Specifies the virtual hard disk's uri."
+        }
+      },
+      "description": "Describes the uri of a disk."
+    },
+    "DataDisk": {
+      "properties": {
+        "createOption": {
+          "type": "string",
+          "description": "Specifies how the virtual machine should be created.",
           "enum": [
             "Unknown",
-            "VHD",
-            "VHDX"
+            "Empty"
           ],
           "x-ms-enum": {
-            "name": "VHDType",
+            "name": "DiskCreateOptionTypes",
             "modelAsString": true
           }
         },
-        "sasUri": {
+        "name": {
           "type": "string",
-          "description": "The VHD SAS URI."
+          "description": "The name of data disk."
+        },
+        "diskSizeGB": {
+          "type": "integer",
+          "format": "int32",
+          "description": "Specifies the size of an empty disk in gigabytes. This element can be used to overwrite the size of the disk in a virtual machine image."
         }
       },
-      "description": "The image reference properties."
+      "description": "Specifies information about the operating system disk used by the virtual machine. <br><br> For more information about disks, see [About disks and VHDs for Azure virtual machines](https://docs.microsoft.com/azure/virtual-machines/virtual-machines-windows-about-disks-vhds?toc=%2fazure%2fvirtual-machines%2fwindows%2ftoc.json)."
     },
-    "OsProfile": {
+    "CustomProfile": {
       "properties": {
-        "adminUsername": {
-          "type": "string",
-          "description": "Specifies the name of the administrator account. <br><br> **Windows-only restriction:** Cannot end in \".\" <br><br> **Disallowed values:** \"administrator\", \"admin\", \"user\", \"user1\", \"test\", \"user2\", \"test1\", \"user3\", \"admin1\", \"1\", \"123\", \"a\", \"actuser\", \"adm\", \"admin2\", \"aspnet\", \"backup\", \"console\", \"david\", \"guest\", \"john\", \"owner\", \"root\", \"server\", \"sql\", \"support\", \"support_388945a0\", \"sys\", \"test2\", \"test3\", \"user4\", \"user5\". <br><br> **Minimum-length (Linux):** 1  character <br><br> **Max-length (Linux):** 64 characters <br><br> **Max-length (Windows):** 20 characters  <br><br><li> For root access to the Linux VM, see [Using root privileges on Linux virtual machines in Azure](https://docs.microsoft.com/azure/virtual-machines/virtual-machines-linux-use-root-privileges?toc=%2fazure%2fvirtual-machines%2flinux%2ftoc.json)<br><li> For a list of built-in system users on Linux that should not be used in this field, see [Selecting User Names for Linux on Azure](https://docs.microsoft.com/azure/virtual-machines/virtual-machines-linux-usernames?toc=%2fazure%2fvirtual-machines%2flinux%2ftoc.json)."
-        },
-        "adminPassword": {
-          "type": "string",
-          "x-ms-secret": true,
-          "x-ms-mutability": [
-            "create",
-            "update"
-          ],
-          "description": "Specifies the password of the administrator account. <br><br> **Minimum-length (Windows):** 8 characters <br><br> **Minimum-length (Linux):** 6 characters <br><br> **Max-length (Windows):** 123 characters <br><br> **Max-length (Linux):** 72 characters <br><br> **Complexity requirements:** 3 out of 4 conditions below need to be fulfilled <br> Has lower characters <br>Has upper characters <br> Has a digit <br> Has a special character (Regex match [\\W_]) <br><br> For resetting the password, see [How to reset the Remote Desktop service or its login password in a Windows VM](https://docs.microsoft.com/azure/virtual-machines/virtual-machines-windows-reset-rdp?toc=%2fazure%2fvirtual-machines%2fwindows%2ftoc.json) <br><br> For resetting root password, see [Manage users, SSH, and check or repair disks on Azure Linux VMs using the VMAccess Extension](https://docs.microsoft.com/azure/virtual-machines/virtual-machines-linux-using-vmaccess-extension?toc=%2fazure%2fvirtual-machines%2flinux%2ftoc.json#reset-root-password)."
-        },
-        "sshPublicKey": {
+        "metadataConfigurationPath": {
           "type": "string",
-          "description": "Contains information about SSH certificate public key and the path on the Linux VM where the public key is placed."
+          "description": "Path for metadata configuration."
         }
       },
-      "description": "Specifies the operating system settings for the role instance."
+      "description": "Specifies the custom settings for the virtual machine."
     },
     "PreviewSubscription": {
       "x-ms-azure-resource": true,
@@ -1248,22 +1043,22 @@
         "name": {
           "type": "string",
           "readOnly": true,
-          "description": "Preview subscription id"
+          "description": "The preview subscription ID."
         },
         "id": {
           "type": "string",
           "readOnly": true,
-          "description": "ARM id of the resource"
+          "description": "The ARM ID of the resource."
         },
         "type": {
           "type": "string",
           "readOnly": true,
-          "description": "Type of the resource"
+          "description": "The type of the resource."
         }
       }
     },
     "PreviewSubscriptionsList": {
-      "description": "List of customer subscriptions which can use a sku.",
+      "description": "A list of customer subscriptions which can use a sku.",
       "properties": {
         "value": {
           "type": "array",
diff --git a/specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/vendorNetworkFunction.json b/specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/vendorNetworkFunction.json
new file mode 100644
index 000000000000..16ffd4f5a464
--- /dev/null
+++ b/specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/vendorNetworkFunction.json
@@ -0,0 +1,708 @@
+{
+  "swagger": "2.0",
+  "info": {
+    "title": "HybridNetworkManagementClient",
+    "description": "The resources in this swagger specification will be used to manage the vendor network function deployment in the Microsoft.HybridNetwork resource provider.",
+    "version": "2020-01-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.HybridNetwork/locations/{locationName}/vendors/{vendorName}/networkFunctions/{serviceKey}": {
+      "get": {
+        "tags": [
+          "VendorNetworkFunctions"
+        ],
+        "operationId": "VendorNetworkFunctions_Get",
+        "description": "Gets information about the specified vendor network function.",
+        "parameters": [
+          {
+            "name": "locationName",
+            "in": "path",
+            "required": true,
+            "type": "string",
+            "description": "The Azure region where the network function resource was created by the customer."
+          },
+          {
+            "name": "vendorName",
+            "in": "path",
+            "required": true,
+            "type": "string",
+            "description": "The name of the vendor."
+          },
+          {
+            "name": "serviceKey",
+            "in": "path",
+            "required": true,
+            "type": "string",
+            "description": "The GUID for the vendor network function."
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v2/types.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v2/types.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Request is successful. The operation returns the resulting vendor network function sub resource.",
+            "schema": {
+              "$ref": "#/definitions/VendorNetworkFunction"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "../../../../../common-types/resource-management/v2/types.json#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-examples": {
+          "Get vendor network function sub resource by service key of network function.": {
+            "$ref": "./examples/VendorNfGet.json"
+          }
+        }
+      },
+      "put": {
+        "tags": [
+          "VendorNetworkFunctions"
+        ],
+        "operationId": "VendorNetworkFunctions_CreateOrUpdate",
+        "description": "Creates or updates a vendor network function.",
+        "parameters": [
+          {
+            "name": "locationName",
+            "in": "path",
+            "required": true,
+            "type": "string",
+            "description": "The Azure region where the network function resource was created by the customer."
+          },
+          {
+            "name": "vendorName",
+            "in": "path",
+            "required": true,
+            "type": "string",
+            "description": "The name of the vendor."
+          },
+          {
+            "name": "serviceKey",
+            "in": "path",
+            "required": true,
+            "type": "string",
+            "description": "The GUID for the vendor network function."
+          },
+          {
+            "name": "parameters",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/VendorNetworkFunction"
+            },
+            "description": "Parameters supplied to the create or update vendor network function operation."
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v2/types.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v2/types.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Creation or update is successful. The operation returns the resulting vendor network function sub resource.",
+            "schema": {
+              "$ref": "#/definitions/VendorNetworkFunction"
+            }
+          },
+          "201": {
+            "description": "Created. The operation returns the resulting vendor network function sub resource.",
+            "schema": {
+              "$ref": "#/definitions/VendorNetworkFunction"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "../../../../../common-types/resource-management/v2/types.json#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-examples": {
+          "Create or update vendor network function sub resource": {
+            "$ref": "./examples/VendorNfCreate.json"
+          }
+        },
+        "x-ms-long-running-operation": true,
+        "x-ms-long-running-operation-options": {
+          "final-state-via": "azure-async-operation"
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/providers/Microsoft.HybridNetwork/locations/{locationName}/vendors/{vendorName}/networkFunctions/{serviceKey}/roleInstances/{roleInstanceName}/start": {
+      "post": {
+        "tags": [
+          "RoleInstances"
+        ],
+        "operationId": "RoleInstances_Start",
+        "description": "Starts a role instance of a vendor network function.",
+        "parameters": [
+          {
+            "name": "locationName",
+            "in": "path",
+            "required": true,
+            "type": "string",
+            "description": "The Azure region where the network function resource was created by customer."
+          },
+          {
+            "name": "vendorName",
+            "in": "path",
+            "required": true,
+            "type": "string",
+            "description": "The name of the vendor."
+          },
+          {
+            "name": "serviceKey",
+            "in": "path",
+            "required": true,
+            "type": "string",
+            "description": "The GUID for the vendor network function."
+          },
+          {
+            "name": "roleInstanceName",
+            "in": "path",
+            "required": true,
+            "type": "string",
+            "description": "The name of the role instance of the vendor network function."
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v2/types.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v2/types.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK."
+          },
+          "202": {
+            "description": "Accepted. The header contains 'Azure-AsyncOperation' header which can be used to monitor the progress of the operation."
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "../../../../../common-types/resource-management/v2/types.json#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-examples": {
+          "Start a role instance of a vendor network function": {
+            "$ref": "./examples/RoleInstanceStart.json"
+          }
+        },
+        "x-ms-long-running-operation": true,
+        "x-ms-long-running-operation-options": {
+          "final-state-via": "location"
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/providers/Microsoft.HybridNetwork/locations/{locationName}/vendors/{vendorName}/networkFunctions/{serviceKey}/roleInstances/{roleInstanceName}/stop": {
+      "post": {
+        "tags": [
+          "RoleInstances"
+        ],
+        "operationId": "RoleInstances_Stop",
+        "description": "Powers off (stop) a role instance of a vendor network function.",
+        "parameters": [
+          {
+            "name": "locationName",
+            "in": "path",
+            "required": true,
+            "type": "string",
+            "description": "The Azure region where the network function resource was created by customer."
+          },
+          {
+            "name": "vendorName",
+            "in": "path",
+            "required": true,
+            "type": "string",
+            "description": "The name of the vendor."
+          },
+          {
+            "name": "serviceKey",
+            "in": "path",
+            "required": true,
+            "type": "string",
+            "description": "The GUID for the vendor network function."
+          },
+          {
+            "name": "roleInstanceName",
+            "in": "path",
+            "required": true,
+            "type": "string",
+            "description": "The name of the role instance of the vendor network function."
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v2/types.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v2/types.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK."
+          },
+          "202": {
+            "description": "Accepted. The header contains 'Azure-AsyncOperation' header which can be used to monitor the progress of the operation."
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "../../../../../common-types/resource-management/v2/types.json#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-examples": {
+          "Stop a role instance of a vendor network function": {
+            "$ref": "./examples/RoleInstanceStop.json"
+          }
+        },
+        "x-ms-long-running-operation": true,
+        "x-ms-long-running-operation-options": {
+          "final-state-via": "location"
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/providers/Microsoft.HybridNetwork/locations/{locationName}/vendors/{vendorName}/networkFunctions/{serviceKey}/roleInstances/{roleInstanceName}/restart": {
+      "post": {
+        "tags": [
+          "RoleInstances"
+        ],
+        "operationId": "RoleInstances_Restart",
+        "description": "Restarts a role instance of a vendor network function.",
+        "parameters": [
+          {
+            "name": "locationName",
+            "in": "path",
+            "required": true,
+            "type": "string",
+            "description": "The Azure region where the network function resource was created by customer."
+          },
+          {
+            "name": "vendorName",
+            "in": "path",
+            "required": true,
+            "type": "string",
+            "description": "The name of the vendor."
+          },
+          {
+            "name": "serviceKey",
+            "in": "path",
+            "required": true,
+            "type": "string",
+            "description": "The GUID for the vendor network function."
+          },
+          {
+            "name": "roleInstanceName",
+            "in": "path",
+            "required": true,
+            "type": "string",
+            "description": "The name of the role instance of the vendor network function."
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v2/types.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v2/types.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK."
+          },
+          "202": {
+            "description": "Accepted. The header contains 'Azure-AsyncOperation' header which can be used to monitor the progress of the operation."
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "../../../../../common-types/resource-management/v2/types.json#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-examples": {
+          "Restart a role instance of a vendor network function": {
+            "$ref": "./examples/RoleInstanceRestart.json"
+          }
+        },
+        "x-ms-long-running-operation": true,
+        "x-ms-long-running-operation-options": {
+          "final-state-via": "location"
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/providers/Microsoft.HybridNetwork/locations/{locationName}/vendors/{vendorName}/networkFunctions/{serviceKey}/roleInstances/{roleInstanceName}": {
+      "get": {
+        "tags": [
+          "RoleInstances"
+        ],
+        "operationId": "RoleInstances_Get",
+        "description": "Gets the information of role instance of vendor network function.",
+        "parameters": [
+          {
+            "name": "locationName",
+            "in": "path",
+            "required": true,
+            "type": "string",
+            "description": "The Azure region where the network function resource was created by customer."
+          },
+          {
+            "name": "vendorName",
+            "in": "path",
+            "required": true,
+            "type": "string",
+            "description": "The name of the vendor."
+          },
+          {
+            "name": "serviceKey",
+            "in": "path",
+            "required": true,
+            "type": "string",
+            "description": "The GUID for the vendor network function."
+          },
+          {
+            "name": "roleInstanceName",
+            "in": "path",
+            "required": true,
+            "type": "string",
+            "description": "The name of the role instance of the vendor network function."
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v2/types.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v2/types.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK.",
+            "schema": {
+              "$ref": "#/definitions/RoleInstance"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "../../../../../common-types/resource-management/v2/types.json#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-examples": {
+          "Get the operational state of role instance of vendor network function": {
+            "$ref": "./examples/RoleInstanceGet.json"
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/providers/Microsoft.HybridNetwork/locations/{locationName}/vendors/{vendorName}/networkFunctions": {
+      "get": {
+        "tags": [
+          "VendorNetworkFunctions"
+        ],
+        "operationId": "VendorNetworkFunctions_List",
+        "description": "Lists all the vendor network function sub resources in an Azure region, filtered by skuType, skuName, vendorProvisioningState.",
+        "parameters": [
+          {
+            "name": "locationName",
+            "in": "path",
+            "required": true,
+            "type": "string",
+            "description": "The Azure region where the network function resource was created by the customer."
+          },
+          {
+            "name": "vendorName",
+            "in": "path",
+            "required": true,
+            "type": "string",
+            "description": "The name of the vendor."
+          },
+          {
+            "name": "$filter",
+            "in": "query",
+            "required": false,
+            "type": "string",
+            "description": "The filter to apply on the operation. The properties you can use for eq (equals) are: skuType, skuName and vendorProvisioningState."
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v2/types.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v2/types.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Request is successful. The operation returns the resulting vendor network function sub resource.",
+            "schema": {
+              "$ref": "#/definitions/VendorNetworkFunctionListResult"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "../../../../../common-types/resource-management/v2/types.json#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-examples": {
+          "List all nfs of vendor resource": {
+            "$ref": "./examples/VendorNfListByVendor.json"
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/providers/Microsoft.HybridNetwork/locations/{locationName}/vendors/{vendorName}/networkFunctions/{serviceKey}/roleInstances": {
+      "get": {
+        "tags": [
+          "RoleInstances"
+        ],
+        "operationId": "RoleInstances_List",
+        "description": "Lists the information of role instances of vendor network function.",
+        "parameters": [
+          {
+            "name": "locationName",
+            "in": "path",
+            "required": true,
+            "type": "string",
+            "description": "The Azure region where the network function resource was created by customer."
+          },
+          {
+            "name": "vendorName",
+            "in": "path",
+            "required": true,
+            "type": "string",
+            "description": "The name of the vendor."
+          },
+          {
+            "name": "serviceKey",
+            "in": "path",
+            "required": true,
+            "type": "string",
+            "description": "The GUID for the vendor network function."
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v2/types.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v2/types.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK.",
+            "schema": {
+              "$ref": "#/definitions/NetworkFunctionRoleInstanceListResult"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "../../../../../common-types/resource-management/v2/types.json#/definitions/ErrorResponse"
+            }
+          }
+        },
+        "x-ms-examples": {
+          "List all role instances of vendor network function": {
+            "$ref": "./examples/RoleInstanceListByVendorNetworkFunction.json"
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        }
+      }
+    }
+  },
+  "definitions": {
+    "VendorNetworkFunctionListResult": {
+      "properties": {
+        "value": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/VendorNetworkFunction"
+          },
+          "description": "A list of vendor network functions."
+        },
+        "nextLink": {
+          "readOnly": true,
+          "type": "string",
+          "description": "The URL to get the next set of results."
+        }
+      },
+      "description": "Response for vendors API service call."
+    },
+    "VendorNetworkFunction": {
+      "properties": {
+        "properties": {
+          "x-ms-client-flatten": true,
+          "$ref": "#/definitions/VendorNetworkFunctionPropertiesFormat",
+          "description": "Network function details."
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "../../../../../common-types/resource-management/v2/types.json#/definitions/ProxyResource"
+        }
+      ],
+      "description": "Vendor network function sub resource."
+    },
+    "VendorNetworkFunctionPropertiesFormat": {
+      "description": "Vendor network function properties.",
+      "properties": {
+        "provisioningState": {
+          "readOnly": true,
+          "$ref": "./common.json#/definitions/ProvisioningState",
+          "description": "The provisioning state of the vendor network function sub resource."
+        },
+        "vendorProvisioningState": {
+          "$ref": "./common.json#/definitions/VendorProvisioningState",
+          "description": "The vendor controlled provisioning state of the vendor network function."
+        },
+        "skuName": {
+          "readOnly": true,
+          "type": "string",
+          "description": "The name of the sku."
+        },
+        "skuType": {
+          "$ref": "./common.json#/definitions/SkuType",
+          "description": "The sku type.",
+          "readOnly": true
+        },
+        "networkFunctionVendorConfigurations": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/NetworkFunctionVendorConfiguration"
+          },
+          "description": "An array of network function vendor configurations."
+        }
+      }
+    },
+    "NetworkFunctionVendorConfiguration": {
+      "properties": {
+        "roleName": {
+          "type": "string",
+          "description": "The name of the vendor network function role."
+        },
+        "osProfile": {
+          "description": "Specifies the operating system settings for the role instance.",
+          "$ref": "./common.json#/definitions/OsProfile"
+        },
+        "userDataParameters": {
+          "$ref": "./common.json#/definitions/UserDataParameters",
+          "readOnly": true,
+          "description": "The user parameters from the customer."
+        },
+        "networkInterfaces": {
+          "type": "array",
+          "items": {
+            "$ref": "./common.json#/definitions/NetworkInterface"
+          },
+          "description": "The network interface configurations."
+        }
+      },
+      "description": "Network function vendor configuration."
+    },
+    "NetworkFunctionRoleInstanceListResult": {
+      "description": "List of role instances of vendor network function.",
+      "properties": {
+        "value": {
+          "readOnly": true,
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/RoleInstance"
+          },
+          "description": "A list of role instances."
+        },
+        "nextLink": {
+          "readOnly": true,
+          "type": "string",
+          "description": "The URL to get the next set of results."
+        }
+      }
+    },
+    "RoleInstance": {
+      "x-ms-azure-resource": true,
+      "properties": {
+        "name": {
+          "type": "string",
+          "description": "The role instance name."
+        },
+        "id": {
+          "type": "string",
+          "description": "The ARM ID of the resource."
+        },
+        "type": {
+          "type": "string",
+          "description": "The type of the resource."
+        },
+        "properties": {
+          "x-ms-client-flatten": true,
+          "$ref": "#/definitions/RoleInstanceProperties",
+          "description": "The role instance properties."
+        }
+      },
+      "description": "The role instance sub resource."
+    },
+    "RoleInstanceProperties": {
+      "properties": {
+        "operationalState": {
+          "type": "string",
+          "description": "The operational state of the role instance.",
+          "enum": [
+            "Unknown",
+            "Stopped",
+            "Running",
+            "Stopping",
+            "Starting"
+          ],
+          "x-ms-enum": {
+            "name": "OperationalState",
+            "modelAsString": true
+          }
+        }
+      },
+      "description": "The role instance properties of the network function."
+    }
+  }
+}
diff --git a/specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/virtualNetworkFunction.json b/specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/virtualNetworkFunction.json
deleted file mode 100644
index 41d501d7b662..000000000000
--- a/specification/hybridnetwork/resource-manager/Microsoft.HybridNetwork/preview/2020-01-01-preview/virtualNetworkFunction.json
+++ /dev/null
@@ -1,463 +0,0 @@
-{
-  "swagger": "2.0",
-  "info": {
-    "title": "HybridNetworkManagementClient",
-    "description": "The resources in this swagger specification will be used to manage the virtual network function deployment in a hybrid network resource provider.",
-    "version": "2020-01-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.HybridNetwork/virtualNetworkFunctions/{virtualNetworkFunctionName}": {
-      "delete": {
-        "tags": [
-          "VirtualNetworkFunctions"
-        ],
-        "operationId": "VirtualNetworkFunctions_Delete",
-        "description": "Deletes the specified hybrid network virtual network function resource.",
-        "parameters": [
-          {
-            "name": "resourceGroupName",
-            "in": "path",
-            "required": true,
-            "type": "string",
-            "description": "The name of the resource group."
-          },
-          {
-            "name": "virtualNetworkFunctionName",
-            "description": "The name of the hybrid network virtual network function.",
-            "in": "path",
-            "required": true,
-            "type": "string"
-          },
-          {
-            "$ref": "./common.json#/parameters/ApiVersionParameter"
-          },
-          {
-            "$ref": "./common.json#/parameters/SubscriptionIdParameter"
-          }
-        ],
-        "responses": {
-          "200": {
-            "description": "The operation is completed successfully."
-          },
-          "202": {
-            "description": "Accepted. The header contains ‘Azure-AsyncOperation’ header pointing to an operations resource. The operation URI can be queried to find the current state of the operation."
-          },
-          "204": {
-            "description": "Request successful. Resource with the specified name does not exist."
-          },
-          "default": {
-            "description": "Error response describing why the operation failed.",
-            "schema": {
-              "$ref": "./common.json#/definitions/ErrorDetails"
-            }
-          }
-        },
-        "x-ms-examples": {
-          "Delete hybrid network virtual network function resource": {
-            "$ref": "./examples/VirtualNetworkFunctionDelete.json"
-          }
-        },
-        "x-ms-long-running-operation": true,
-        "x-ms-long-running-operation-options": {
-          "final-state-via": "location"
-        }
-      },
-      "get": {
-        "tags": [
-          "VirtualNetworkFunctions"
-        ],
-        "operationId": "VirtualNetworkFunctions_Get",
-        "description": "Gets information about the specified hybrid network virtual network function resource.",
-        "parameters": [
-          {
-            "name": "resourceGroupName",
-            "in": "path",
-            "required": true,
-            "type": "string",
-            "description": "The name of the resource group."
-          },
-          {
-            "name": "virtualNetworkFunctionName",
-            "in": "path",
-            "required": true,
-            "type": "string",
-            "description": "The name of hybrid network virtual network function resource."
-          },
-          {
-            "$ref": "./common.json#/parameters/ApiVersionParameter"
-          },
-          {
-            "$ref": "./common.json#/parameters/SubscriptionIdParameter"
-          }
-        ],
-        "responses": {
-          "200": {
-            "description": "Operation successful. The operation returns the resulting hybrid network virtual network function resource.",
-            "schema": {
-              "$ref": "#/definitions/VirtualNetworkFunction"
-            }
-          },
-          "default": {
-            "description": "Error response describing why the operation failed.",
-            "schema": {
-              "$ref": "./common.json#/definitions/ErrorDetails"
-            }
-          }
-        },
-        "x-ms-examples": {
-          "Get hybrid network virtual network function resource": {
-            "$ref": "./examples/VirtualNetworkFunctionGet.json"
-          }
-        }
-      },
-      "put": {
-        "tags": [
-          "VirtualNetworkFunctions"
-        ],
-        "operationId": "VirtualNetworkFunctions_CreateOrUpdate",
-        "description": "Creates or updates a hybrid network virtual network function resource.",
-        "parameters": [
-          {
-            "name": "resourceGroupName",
-            "in": "path",
-            "required": true,
-            "type": "string",
-            "description": "The name of the resource group."
-          },
-          {
-            "name": "virtualNetworkFunctionName",
-            "in": "path",
-            "required": true,
-            "type": "string",
-            "description": "Resource name for the hybrid network virtual network function resource."
-          },
-          {
-            "name": "parameters",
-            "in": "body",
-            "required": true,
-            "schema": {
-              "$ref": "#/definitions/VirtualNetworkFunction"
-            },
-            "description": "Parameters supplied in the body to create or update hybrid network virtual network function operation."
-          },
-          {
-            "$ref": "./common.json#/parameters/ApiVersionParameter"
-          },
-          {
-            "$ref": "./common.json#/parameters/SubscriptionIdParameter"
-          }
-        ],
-        "responses": {
-          "200": {
-            "description": "The operation is completed successfully.",
-            "schema": {
-              "$ref": "#/definitions/VirtualNetworkFunction"
-            }
-          },
-          "201": {
-            "description": "Created or Updated. The header contains ‘Azure-AsyncOperation’ header pointing to an operation resource. The operation URI can be queried to find the current state of the operation.",
-            "schema": {
-              "$ref": "#/definitions/VirtualNetworkFunction"
-            }
-          },
-          "default": {
-            "description": "Error response describing why the operation failed.",
-            "schema": {
-              "$ref": "./common.json#/definitions/ErrorDetails"
-            }
-          }
-        },
-        "x-ms-examples": {
-          "Create hybrid network virtual network function resource": {
-            "$ref": "./examples/VirtualNetworkFunctionCreate.json"
-          }
-        },
-        "x-ms-long-running-operation": true,
-        "x-ms-long-running-operation-options": {
-          "final-state-via": "azure-async-operation"
-        }
-      },
-      "patch": {
-        "tags": [
-          "VirtualNetworkFunctions"
-        ],
-        "operationId": "VirtualNetworkFunctions_UpdateTags",
-        "description": "Updates the tags for hybrid network virtual network function resource.",
-        "parameters": [
-          {
-            "name": "resourceGroupName",
-            "in": "path",
-            "required": true,
-            "type": "string",
-            "description": "The name of the resource group."
-          },
-          {
-            "name": "virtualNetworkFunctionName",
-            "in": "path",
-            "required": true,
-            "type": "string",
-            "description": "Resource name for the virtual network function resource."
-          },
-          {
-            "name": "parameters",
-            "in": "body",
-            "required": true,
-            "schema": {
-              "$ref": "./common.json#/definitions/TagsObject"
-            },
-            "description": "Parameters supplied to update hybrid network virtual network function tags."
-          },
-          {
-            "$ref": "./common.json#/parameters/ApiVersionParameter"
-          },
-          {
-            "$ref": "./common.json#/parameters/SubscriptionIdParameter"
-          }
-        ],
-        "responses": {
-          "200": {
-            "description": "Update is completed successfully. The operation returns the resulting hybrid network virtual network function resource.",
-            "schema": {
-              "$ref": "#/definitions/VirtualNetworkFunction"
-            }
-          },
-          "default": {
-            "description": "Error response describing why the operation failed.",
-            "schema": {
-              "$ref": "./common.json#/definitions/ErrorDetails"
-            }
-          }
-        },
-        "x-ms-examples": {
-          "Update tags for hybrid network virtual network function resource": {
-            "$ref": "./examples/VirtualNetworkFunctionUpdateTags.json"
-          }
-        }
-      }
-    },
-    "/subscriptions/{subscriptionId}/providers/Microsoft.HybridNetwork/virtualNetworkFunctions": {
-      "get": {
-        "description": "List all the hybrid network virtual network functions in a subscription.",
-        "operationId": "VirtualNetworkFunctions_ListBySubscription",
-        "parameters": [
-          {
-            "$ref": "./common.json#/parameters/ApiVersionParameter"
-          },
-          {
-            "$ref": "./common.json#/parameters/SubscriptionIdParameter"
-          }
-        ],
-        "responses": {
-          "200": {
-            "description": "Request successful. The operation returns a list of hybrid network virtual network function resources.",
-            "schema": {
-              "$ref": "#/definitions/VirtualNetworkFunctionListResult"
-            }
-          },
-          "default": {
-            "description": "Error response describing why the operation failed.",
-            "schema": {
-              "$ref": "./common.json#/definitions/ErrorDetails"
-            }
-          }
-        },
-        "tags": [
-          "VirtualNetworkFunctions"
-        ],
-        "x-ms-examples": {
-          "List all hybrid network virtual network function resources in subscription.": {
-            "$ref": "./examples/VirtualNetworkFunctionListBySubscription.json"
-          }
-        },
-        "x-ms-pageable": {
-          "nextLinkName": "nextLink"
-        }
-      }
-    },
-    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.HybridNetwork/virtualNetworkFunctions": {
-      "get": {
-        "tags": [
-          "VirtualNetworkFunctions"
-        ],
-        "operationId": "VirtualNetworkFunctions_ListByResourceGroup",
-        "description": "List all the hybrid network virtual network function resources in a resource group.",
-        "parameters": [
-          {
-            "name": "resourceGroupName",
-            "in": "path",
-            "required": true,
-            "type": "string",
-            "description": "The name of the resource group."
-          },
-          {
-            "$ref": "./common.json#/parameters/ApiVersionParameter"
-          },
-          {
-            "$ref": "./common.json#/parameters/SubscriptionIdParameter"
-          }
-        ],
-        "responses": {
-          "200": {
-            "description": "Request successful. The operation returns a list of hybrid network virtual network function resources.",
-            "schema": {
-              "$ref": "#/definitions/VirtualNetworkFunctionListResult"
-            }
-          },
-          "default": {
-            "description": "Error response describing why the operation failed.",
-            "schema": {
-              "$ref": "./common.json#/definitions/ErrorDetails"
-            }
-          }
-        },
-        "x-ms-examples": {
-          "List hybrid network virtual network function in resource group": {
-            "$ref": "./examples/VirtualNetworkFunctionListByResourceGroup.json"
-          }
-        },
-        "x-ms-pageable": {
-          "nextLinkName": "nextLink"
-        }
-      }
-    }
-  },
-  "definitions": {
-    "VirtualNetworkFunction": {
-      "properties": {
-        "properties": {
-          "x-ms-client-flatten": true,
-          "$ref": "#/definitions/VirtualNetworkFunctionPropertiesFormat",
-          "description": "Hybrid network virtual network function properties."
-        },
-        "etag": {
-          "type": "string",
-          "description": "A unique read-only string that changes whenever the resource is updated."
-        }
-      },
-      "allOf": [
-        {
-          "$ref": "./common.json#/definitions/Resource"
-        }
-      ],
-      "description": "Hybrid network virtual network function resource response."
-    },
-    "VirtualNetworkFunctionPropertiesFormat": {
-      "description": "Hybrid network virtual network function properties.",
-      "properties": {
-        "provisioningState": {
-          "readOnly": true,
-          "$ref": "./common.json#/definitions/ProvisioningState",
-          "description": "The provisioning state of the hybrid network virtual network function resource."
-        },
-        "device": {
-          "$ref": "./common.json#/definitions/SubResource",
-          "description": "The reference to the hybrid network device."
-        },
-        "skuName": {
-          "type": "string",
-          "description": "The sku name for the hybrid network virtual network function."
-        },
-        "skuType": {
-          "readOnly": true,
-          "$ref": "./common.json#/definitions/SkuType",
-          "description": "The sku type for the hybrid network virtual network function."
-        },
-        "vendorName": {
-          "type": "string",
-          "description": "The vendor name for the hybrid network virtual network function."
-        },
-        "serviceKey": {
-          "type": "string",
-          "readOnly": true,
-          "description": "The service key for the virtual network function resource."
-        },
-        "vendorProvisioningState": {
-          "readOnly": true,
-          "$ref": "./common.json#/definitions/VendorProvisioningState",
-          "description": "The vendor provisioning state for the virtual network function resource."
-        },
-        "managedApplication": {
-          "readOnly": true,
-          "$ref": "./common.json#/definitions/SubResource",
-          "description": "The resource URI of the managed application."
-        },
-        "managedApplicationParameters": {
-          "$ref": "./common.json#/definitions/ManagedApplicationParameters",
-          "description": "The parameters for the managed application."
-        },
-        "virtualNetworkFunctionUserConfigurations": {
-          "type": "array",
-          "items": {
-            "$ref": "#/definitions/VirtualNetworkFunctionUserConfiguration"
-          },
-          "description": "The virtual network function configurations from the user."
-        }
-      }
-    },
-    "VirtualNetworkFunctionListResult": {
-      "properties": {
-        "value": {
-          "type": "array",
-          "items": {
-            "$ref": "#/definitions/VirtualNetworkFunction"
-          },
-          "description": "A list of hybrid network virtual network function resources in a subscription or resource group."
-        },
-        "nextLink": {
-          "type": "string",
-          "readOnly": true,
-          "description": "The URL to get the next set of results."
-        }
-      },
-      "description": "Response for hybrid network virtual network function API service call."
-    },
-    "VirtualNetworkFunctionUserConfiguration": {
-      "properties": {
-        "roleName": {
-          "type": "string",
-          "description": "The name of the virtual network function role."
-        },
-        "userDataParameters": {
-          "$ref": "./common.json#/definitions/UserDataParameters",
-          "description": "The user data parameters from the customer."
-        },
-        "networkInterfaces": {
-          "type": "array",
-          "items": {
-            "$ref": "./common.json#/definitions/NetworkInterface"
-          },
-          "description": "The network interface configuration."
-        }
-      },
-      "description": "The virtual network function user configuration."
-    }
-  }
-}
diff --git a/specification/hybridnetwork/resource-manager/readme.azureresourceschema.md b/specification/hybridnetwork/resource-manager/readme.azureresourceschema.md
index e01e8f7e4357..a8d43d547bdb 100644
--- a/specification/hybridnetwork/resource-manager/readme.azureresourceschema.md
+++ b/specification/hybridnetwork/resource-manager/readme.azureresourceschema.md
@@ -20,10 +20,11 @@ output-folder: $(azureresourceschema-folder)/schemas
 # all the input files in this apiVersion
 input-file:
   - Microsoft.HybridNetwork/preview/2020-01-01-preview/common.json
-  - Microsoft.HybridNetwork/preview/2020-01-01-preview/virtualNetworkFunction.json
+  - Microsoft.HybridNetwork/preview/2020-01-01-preview/networkFunction.json
   - Microsoft.HybridNetwork/preview/2020-01-01-preview/device.json
-  - Microsoft.HybridNetwork/preview/2020-01-01-preview/operations.json
+  - Microsoft.HybridNetwork/preview/2020-01-01-preview/operation.json
   - Microsoft.HybridNetwork/preview/2020-01-01-preview/vendor.json
-  - Microsoft.HybridNetwork/preview/2020-01-01-preview/virtualNetworkFunctionVendors.json
+  - Microsoft.HybridNetwork/preview/2020-01-01-preview/networkFunctionVendor.json
+  - Microsoft.HybridNetwork/preview/2020-01-01-preview/vendorNetworkFunction.json
 
 ```
diff --git a/specification/hybridnetwork/resource-manager/readme.go.md b/specification/hybridnetwork/resource-manager/readme.go.md
index 31aa99b2c827..5485073c0531 100644
--- a/specification/hybridnetwork/resource-manager/readme.go.md
+++ b/specification/hybridnetwork/resource-manager/readme.go.md
@@ -22,5 +22,5 @@ Please also specify `--go-sdks-folder=<path to the root directory of your azure-
 
 ```yaml $(tag) == 'package-2020-01-01-preview' && $(go)
 namespace: hybridnetwork
-output-folder: $(go-sdk-folder)/services/preview/management/2020-01-01-preview/$(namespace)
+output-folder: $(go-sdk-folder)/services/preview/$(namespace)/management/2020-01-01-preview/$(namespace)
 ```
\ No newline at end of file
diff --git a/specification/hybridnetwork/resource-manager/readme.md b/specification/hybridnetwork/resource-manager/readme.md
index 0db26ee67c23..0587f415d85b 100644
--- a/specification/hybridnetwork/resource-manager/readme.md
+++ b/specification/hybridnetwork/resource-manager/readme.md
@@ -26,6 +26,7 @@ These are the global settings for the hybridnetwork.
 
 ```yaml
 openapi-type: arm
+openapi-subtype: rpaas
 tag: package-2020-01-01-preview
 ```
 
@@ -36,11 +37,12 @@ These settings apply only when `--tag=package-2020-01-01-preview` is specified o
 ```yaml $(tag) == 'package-2020-01-01-preview'
 input-file:
   - Microsoft.HybridNetwork/preview/2020-01-01-preview/common.json
-  - Microsoft.HybridNetwork/preview/2020-01-01-preview/virtualNetworkFunction.json
+  - Microsoft.HybridNetwork/preview/2020-01-01-preview/networkFunction.json
   - Microsoft.HybridNetwork/preview/2020-01-01-preview/device.json
-  - Microsoft.HybridNetwork/preview/2020-01-01-preview/operations.json
+  - Microsoft.HybridNetwork/preview/2020-01-01-preview/operation.json
   - Microsoft.HybridNetwork/preview/2020-01-01-preview/vendor.json
-  - Microsoft.HybridNetwork/preview/2020-01-01-preview/virtualNetworkFunctionVendors.json
+  - Microsoft.HybridNetwork/preview/2020-01-01-preview/networkFunctionVendor.json
+  - Microsoft.HybridNetwork/preview/2020-01-01-preview/vendorNetworkFunction.json
 ```
 
 # Code Generation
@@ -87,4 +89,3 @@ See configuration in [readme.csharp.md](./readme.csharp.md)
 ## AzureResourceSchema
 
 See configuration in [readme.azureresourceschema.md](./readme.azureresourceschema.md)
-
diff --git a/specification/keyvault/data-plane/Microsoft.KeyVault/preview/7.2-preview/examples/ExportKey-example.json b/specification/keyvault/data-plane/Microsoft.KeyVault/preview/7.2-preview/examples/ExportKey-example.json
index 8cb42488f38b..33e83bcdc8ac 100644
--- a/specification/keyvault/data-plane/Microsoft.KeyVault/preview/7.2-preview/examples/ExportKey-example.json
+++ b/specification/keyvault/data-plane/Microsoft.KeyVault/preview/7.2-preview/examples/ExportKey-example.json
@@ -29,24 +29,8 @@
           "key_hsm": "CxX3qVTt22ZvjwdS-fmMSsLpaQQ8IcfGAC2TYWo3FXIPnOrSmZWdWN3gLMNSLUtUOhXqwXCe6jOxH2jMr6suO4Q0mfrKurAB-IC5gbDZGGD9XksrAkyYS-0p4p4I4Q4QxEOCtCKYPYWWu91dg5xg5aYjVRyR5G3C6O0haotp1FL1FiOB1PVcW9HchDIdHMFCszsb33pbvDuYvJXPPqdSIGIT8P8ExVG9_RwYTZl2Kj3MTSbe9zjOEEW-EnA6Phr0EFO0h94dWK0Y2tPhyzGYOSBScJCWIdwD9lT1aaHNFE0rSLJ9wv0qGezR10nD7V7ALZiEscsrAcwrWTtmmCJMAIJpGf0u9rN1_JQiXuO4Q9Cf4b73nSP1kIIAPkZ3r6Fqmrm8F7NeKis"
         },
         "release_policy": {
-          "anyOf": [
-            {
-              "allOf": [
-                {
-                  "claim": "sgx-mrsigner",
-                  "condition": "equals",
-                  "value": "86788fe40448f2a12e20bf8d5e7a1c3139bc5fdc1432b370c1da3489ab649a85"
-                },
-                {
-                  "claim": "is-debuggable",
-                  "condition": "equals",
-                  "value": "false"
-                }
-              ],
-              "authority": "http://localhost:8023/"
-            }
-          ],
-          "version": "0.2"
+          "contentType": "application/json; charset=utf-8; version=1.0",
+          "data": "eyJhbnlPZiI6W3siYWxsT2YiOlt7ImNsYWltIjoic2d4LW1yc2lnbmVyIiwiY29uZGl0aW9uIjoiZXF1YWxzIiwidmFsdWUiOiI4Njc4OGZlNDA0NDhmMmExMmUyMGJmOGQ1ZTdhMWMzMTM5YmM1ZmRjMTQzMmIzNzBjMWRhMzQ4OWFiNjQ5YTg1In0seyJjbGFpbSI6ImlzLWRlYnVnZ2FibGUiLCJjb25kaXRpb24iOiJlcXVhbHMiLCJ2YWx1ZSI6ImZhbHNlIn1dLCJhdXRob3JpdHkiOiJodHRwOi8vbG9jYWxob3N0OjgwMjMvIn1dfQ"
         }
       }
     }
diff --git a/specification/keyvault/data-plane/Microsoft.KeyVault/preview/7.2-preview/keys.json b/specification/keyvault/data-plane/Microsoft.KeyVault/preview/7.2-preview/keys.json
index ad468d0f250f..2d19a1aa5d13 100644
--- a/specification/keyvault/data-plane/Microsoft.KeyVault/preview/7.2-preview/keys.json
+++ b/specification/keyvault/data-plane/Microsoft.KeyVault/preview/7.2-preview/keys.json
@@ -1033,83 +1033,6 @@
     }
   },
   "definitions": {
-    "KeyReleaseCondition": {
-      "properties": {
-        "claim": {
-          "x-ms-client-name": "claimType",
-          "type": "string",
-          "minLength": 1,
-          "description": "claim type name"
-        },
-        "condition": {
-          "x-ms-client-name": "claimCondition",
-          "type": "string",
-          "minLength": 1,
-          "description": "condition to test",
-          "enum": [
-            "equals"
-          ],
-          "x-ms-enum": {
-            "name": "KeyReleaseConditionCondition",
-            "modelAsString": true,
-            "values": [
-              {
-                "value": "equals",
-                "description": "equals comparison."
-              }
-            ]
-          }
-        },
-        "value": {
-          "type": "string"
-        }
-      }
-    },
-    "KeyReleaseAuthority": {
-      "properties": {
-        "authority": {
-          "x-ms-client-name": "authorityURL",
-          "type": "string",
-          "minLength": 1,
-          "description": "Base URL of the attestation service."
-        },
-        "allOf": {
-          "type": "array",
-          "items": {
-            "$ref": "#/definitions/KeyReleaseCondition",
-            "description": "The set of claim conditions that must be met."
-          }
-        }
-      }
-    },
-    "KeyReleasePolicy": {
-      "properties": {
-        "version": {
-          "description": "key release policy version",
-          "type": "string",
-          "enum": [
-            "0.2"
-          ],
-          "x-ms-enum": {
-            "name": "KeyReleasePolicyVersion",
-            "modelAsString": true,
-            "values": [
-              {
-                "value": "0.2",
-                "description": "Schema version 0.2"
-              }
-            ]
-          }
-        },
-        "anyOf": {
-          "type": "array",
-          "items": {
-            "$ref": "#/definitions/KeyReleaseAuthority",
-            "description": "Authorities."
-          }
-        }
-      }
-    },
     "JsonWebKey": {
       "properties": {
         "kid": {
@@ -1387,6 +1310,20 @@
       },
       "description": "The key item containing key metadata."
     },
+    "KeyReleasePolicy": {
+      "properties": {
+        "contentType": {
+          "description": "Content type and version of key release policy",
+          "type": "string",
+          "default": "application/json; charset=utf-8; version=1.0"
+        },
+        "data": {
+          "description": "Blob encoding the policy rules under which the key can be exported.",
+          "type": "string",
+          "format": "base64url"
+        }
+      }
+    },
     "DeletedKeyBundle": {
       "allOf": [
         {
diff --git a/specification/keyvault/resource-manager/readme.java.md b/specification/keyvault/resource-manager/readme.java.md
index 161b5ee85134..cd19bdec7637 100644
--- a/specification/keyvault/resource-manager/readme.java.md
+++ b/specification/keyvault/resource-manager/readme.java.md
@@ -15,11 +15,29 @@ output-folder: $(azure-libraries-for-java-folder)/azure-mgmt-keyvault
 
 ```yaml $(java) && $(multiapi)
 batch:
+  - tag: profile-hybrid-2020-09-01
   - tag: package-2018-02-14-preview
   - tag: package-2016-10
   - tag: package-2015-06
 ```
 
+### Tag: profile-hybrid-2020-09-01 and java
+
+These settings apply only when `--tag=profile-hybrid-2020-09-01 --java` is specified on the command line.
+Please also specify `--azure-libraries-for-java-folder=<path to the root directory of your azure-sdk-for-java clone>`.
+
+``` yaml $(tag) == 'profile-hybrid-2020-09-01' && $(java) && $(multiapi)
+java:
+  namespace: com.microsoft.azure.management.keyvault.v2019_09_01
+  output-folder: $(azure-libraries-for-java-folder)/sdk/keyvault/mgmt-v2019_09_01
+regenerate-manager: true
+generate-interface: true
+directive:
+  from: keyvault.json
+  where: $.paths["/subscriptions/{subscriptionId}/resources"].get
+  transform: $['operationId'] = 'Vaults_ListResource'
+```
+
 ### Tag: package-2018-02-14-preview and java
 
 These settings apply only when `--tag=package-2018-02-14-preview --java` is specified on the command line.
@@ -95,3 +113,15 @@ input-file:
 - Microsoft.KeyVault/stable/2016-10-01/keyvault.json
 - Microsoft.KeyVault/stable/2016-10-01/secrets.json
 ```
+
+### Tag: profile-hybrid-2020-09-01
+
+These settings apply only when `--tag=profile-hybrid-2020-09-01` is specified on the command line.
+Creating this tag to pick proper resources from the hybrid profile.
+
+``` yaml $(tag) == 'profile-hybrid-2020-09-01'
+input-file:
+- Microsoft.KeyVault/stable/2019-09-01/providers.json
+- Microsoft.KeyVault/stable/2019-09-01/keyvault.json
+- Microsoft.KeyVault/stable/2019-09-01/secrets.json
+```
diff --git a/specification/mysql/resource-manager/Microsoft.DBforMySQL/preview/2020-07-01-preview/examples/CapabilitiesByLocationList.json b/specification/mysql/resource-manager/Microsoft.DBforMySQL/preview/2020-07-01-preview/examples/CapabilitiesByLocationList.json
new file mode 100644
index 000000000000..54179b014b28
--- /dev/null
+++ b/specification/mysql/resource-manager/Microsoft.DBforMySQL/preview/2020-07-01-preview/examples/CapabilitiesByLocationList.json
@@ -0,0 +1,197 @@
+{
+  "parameters": {
+    "api-version": "2020-07-01-preview",
+    "subscriptionId": "ffffffff-ffff-ffff-ffff-ffffffffffff",
+    "locationName": "WestUS"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "zone": "none",
+            "supportedFlexibleServerEditions": [
+              {
+                "name": "Burstable",
+                "supportedStorageEditions": [
+                  {
+                    "name": "PremiumFileShare",
+                    "minStorageSize": {
+                      "name": "10240",
+                      "storageSizeMB": 10240
+                    },
+                    "maxStorageSize": {
+                      "name": "16777216",
+                      "storageSizeMB": 16777216
+                    },
+                    "minBackupRetentionDays": 7,
+                    "maxBackupRetentionDays": 35
+                  }
+                ],
+                "supportedServerVersions": [
+                  {
+                    "name": "5.7",
+                    "supportedVcores": [
+                      {
+                        "name": "Standard_B1s",
+                        "vCores": 1,
+                        "supportedIops": 320,
+                        "supportedMemoryPerVcoreMB": 2048
+                      },
+                      {
+                        "name": "Standard_B1ms",
+                        "vCores": 1,
+                        "supportedIops": 640,
+                        "supportedMemoryPerVcoreMB": 2048
+                      },
+                      {
+                        "name": "Standard_B2s",
+                        "vCores": 2,
+                        "supportedIops": 1280,
+                        "supportedMemoryPerVcoreMB": 2048
+                      }
+                    ]
+                  }
+                ]
+              },
+              {
+                "name": "GeneralPurpose",
+                "supportedStorageEditions": [
+                  {
+                    "name": "PremiumFileShare",
+                    "minStorageSize": {
+                      "name": "10240",
+                      "storageSizeMB": 10240
+                    },
+                    "maxStorageSize": {
+                      "name": "16777216",
+                      "storageSizeMB": 16777216
+                    },
+                    "minBackupRetentionDays": 7,
+                    "maxBackupRetentionDays": 35
+                  }
+                ],
+                "supportedServerVersions": [
+                  {
+                    "name": "5.7",
+                    "supportedVcores": [
+                      {
+                        "name": "Standard_D2ds_v4",
+                        "vCores": 2,
+                        "supportedIops": 3200,
+                        "supportedMemoryPerVcoreMB": 4096
+                      },
+                      {
+                        "name": "Standard_D4ds_v4",
+                        "vCores": 4,
+                        "supportedIops": 6400,
+                        "supportedMemoryPerVcoreMB": 4096
+                      },
+                      {
+                        "name": "Standard_D8ds_v4",
+                        "vCores": 8,
+                        "supportedIops": 12800,
+                        "supportedMemoryPerVcoreMB": 4096
+                      },
+                      {
+                        "name": "Standard_D16ds_v4",
+                        "vCores": 16,
+                        "supportedIops": 20000,
+                        "supportedMemoryPerVcoreMB": 4096
+                      },
+                      {
+                        "name": "Standard_D32ds_v4",
+                        "vCores": 32,
+                        "supportedIops": 20000,
+                        "supportedMemoryPerVcoreMB": 4096
+                      },
+                      {
+                        "name": "Standard_D48ds_v4",
+                        "vCores": 48,
+                        "supportedIops": 20000,
+                        "supportedMemoryPerVcoreMB": 4096
+                      },
+                      {
+                        "name": "Standard_D64ds_v4",
+                        "vCores": 64,
+                        "supportedIops": 20000,
+                        "supportedMemoryPerVcoreMB": 4096
+                      }
+                    ]
+                  }
+                ]
+              },
+              {
+                "name": "MemoryOptimized",
+                "supportedStorageEditions": [
+                  {
+                    "name": "PremiumFileShare",
+                    "minStorageSize": {
+                      "name": "10240",
+                      "storageSizeMB": 10240
+                    },
+                    "maxStorageSize": {
+                      "name": "16777216",
+                      "storageSizeMB": 16777216
+                    },
+                    "minBackupRetentionDays": 7,
+                    "maxBackupRetentionDays": 35
+                  }
+                ],
+                "supportedServerVersions": [
+                  {
+                    "name": "5.7",
+                    "supportedVcores": [
+                      {
+                        "name": "Standard_E2ds_v4",
+                        "vCores": 2,
+                        "supportedIops": 3200,
+                        "supportedMemoryPerVcoreMB": 8192
+                      },
+                      {
+                        "name": "Standard_E4ds_v4",
+                        "vCores": 4,
+                        "supportedIops": 6400,
+                        "supportedMemoryPerVcoreMB": 8192
+                      },
+                      {
+                        "name": "Standard_E8ds_v4",
+                        "vCores": 8,
+                        "supportedIops": 12800,
+                        "supportedMemoryPerVcoreMB": 8192
+                      },
+                      {
+                        "name": "Standard_E16ds_v4",
+                        "vCores": 16,
+                        "supportedIops": 20000,
+                        "supportedMemoryPerVcoreMB": 8192
+                      },
+                      {
+                        "name": "Standard_E32ds_v4",
+                        "vCores": 32,
+                        "supportedIops": 20000,
+                        "supportedMemoryPerVcoreMB": 8192
+                      },
+                      {
+                        "name": "Standard_E48ds_v4",
+                        "vCores": 48,
+                        "supportedIops": 20000,
+                        "supportedMemoryPerVcoreMB": 8192
+                      },
+                      {
+                        "name": "Standard_E64ds_v4",
+                        "vCores": 64,
+                        "supportedIops": 20000,
+                        "supportedMemoryPerVcoreMB": 8192
+                      }
+                    ]
+                  }
+                ]
+              }
+            ]
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/mysql/resource-manager/Microsoft.DBforMySQL/preview/2020-07-01-preview/examples/CheckNameAvailability.json b/specification/mysql/resource-manager/Microsoft.DBforMySQL/preview/2020-07-01-preview/examples/CheckNameAvailability.json
new file mode 100644
index 000000000000..03f4890a7aec
--- /dev/null
+++ b/specification/mysql/resource-manager/Microsoft.DBforMySQL/preview/2020-07-01-preview/examples/CheckNameAvailability.json
@@ -0,0 +1,19 @@
+{
+  "parameters": {
+    "api-version": "2020-07-01-preview",
+    "subscriptionId": "ffffffff-ffff-ffff-ffff-ffffffffffff",
+    "nameAvailabilityRequest": {
+      "name": "name1",
+      "type": "Microsoft.DBforMySQL"
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "nameAvailable": true,
+        "message": "",
+        "reason": ""
+      }
+    }
+  }
+}
diff --git a/specification/mysql/resource-manager/Microsoft.DBforMySQL/preview/2020-07-01-preview/examples/CheckVirtualNetworkSubnetUsage.json b/specification/mysql/resource-manager/Microsoft.DBforMySQL/preview/2020-07-01-preview/examples/CheckVirtualNetworkSubnetUsage.json
new file mode 100644
index 000000000000..90177d94e351
--- /dev/null
+++ b/specification/mysql/resource-manager/Microsoft.DBforMySQL/preview/2020-07-01-preview/examples/CheckVirtualNetworkSubnetUsage.json
@@ -0,0 +1,26 @@
+{
+  "parameters": {
+    "api-version": "2020-07-01-preview",
+    "subscriptionId": "ffffffff-ffff-ffff-ffff-ffffffffffff",
+    "locationName": "WestUS",
+    "parameters": {
+      "virtualNetworkArmResourceId": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/testrg/providers/Microsoft.Network/virtualNetworks/testvnet"
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "delegatedSubnetsUsage": [
+          {
+            "subnetName": "test-subnet-1",
+            "usage": 2
+          },
+          {
+            "subnetName": "test-subnet-2",
+            "usage": 3
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/mysql/resource-manager/Microsoft.DBforMySQL/preview/2020-07-01-preview/examples/ConfigurationGet.json b/specification/mysql/resource-manager/Microsoft.DBforMySQL/preview/2020-07-01-preview/examples/ConfigurationGet.json
new file mode 100644
index 000000000000..70a438703fd8
--- /dev/null
+++ b/specification/mysql/resource-manager/Microsoft.DBforMySQL/preview/2020-07-01-preview/examples/ConfigurationGet.json
@@ -0,0 +1,29 @@
+{
+  "parameters": {
+    "configurationName": "event_scheduler",
+    "serverName": "testserver",
+    "resourceGroupName": "TestGroup",
+    "api-version": "2020-07-01-preview",
+    "subscriptionId": "ffffffff-ffff-ffff-ffff-ffffffffffff"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "properties": {
+          "value": "ON",
+          "description": "Indicates the status of the Event Scheduler.",
+          "defaultValue": "OFF",
+          "dataType": "Enumeration",
+          "allowedValues": "ON,OFF,DISABLED",
+          "source": "user-override",
+          "isConfigPendingRestart": "False",
+          "isDynamicConfig": "True",
+          "isReadOnly": "False"
+        },
+        "id": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/TestGroup/providers/Microsoft.DBforMySQL/flexibleServers/testserver/configurations/event_scheduler",
+        "name": "event_scheduler",
+        "type": "Microsoft.DBforMySQL/flexibleServers/configurations"
+      }
+    }
+  }
+}
diff --git a/specification/mysql/resource-manager/Microsoft.DBforMySQL/preview/2020-07-01-preview/examples/ConfigurationUpdate.json b/specification/mysql/resource-manager/Microsoft.DBforMySQL/preview/2020-07-01-preview/examples/ConfigurationUpdate.json
new file mode 100644
index 000000000000..4d8bdab664bc
--- /dev/null
+++ b/specification/mysql/resource-manager/Microsoft.DBforMySQL/preview/2020-07-01-preview/examples/ConfigurationUpdate.json
@@ -0,0 +1,35 @@
+{
+  "parameters": {
+    "serverName": "testserver",
+    "configurationName": "event_scheduler",
+    "resourceGroupName": "testrg",
+    "api-version": "2020-07-01-preview",
+    "subscriptionId": "ffffffff-ffff-ffff-ffff-ffffffffffff",
+    "parameters": {
+      "properties": {
+        "value": "on",
+        "source": "user-override"
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "properties": {
+          "value": "ON",
+          "description": "Indicates the status of the Event Scheduler.",
+          "defaultValue": "OFF",
+          "dataType": "Enumeration",
+          "allowedValues": "ON,OFF,DISABLED",
+          "source": "user-override",
+          "isConfigPendingRestart": "False",
+          "isDynamicConfig": "True"
+        },
+        "id": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/testrg/providers/Microsoft.DBforMySQL/flexibleServers/testserver/configurations/event_scheduler",
+        "name": "event_scheduler",
+        "type": "Microsoft.DBforMySQL/flexibleServers/configurations"
+      }
+    },
+    "202": {}
+  }
+}
diff --git a/specification/mysql/resource-manager/Microsoft.DBforMySQL/preview/2020-07-01-preview/examples/ConfigurationsListByServer.json b/specification/mysql/resource-manager/Microsoft.DBforMySQL/preview/2020-07-01-preview/examples/ConfigurationsListByServer.json
new file mode 100644
index 000000000000..def3b30711ea
--- /dev/null
+++ b/specification/mysql/resource-manager/Microsoft.DBforMySQL/preview/2020-07-01-preview/examples/ConfigurationsListByServer.json
@@ -0,0 +1,91 @@
+{
+  "parameters": {
+    "serverName": "mysqltestsvc1",
+    "resourceGroupName": "testrg",
+    "api-version": "2020-07-01-preview",
+    "subscriptionId": "ffffffff-ffff-ffff-ffff-ffffffffffff"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "properties": {
+              "value": "OFF",
+              "description": "Indicates the status of the Event Scheduler.",
+              "defaultValue": "OFF",
+              "dataType": "Enumeration",
+              "allowedValues": "ON,OFF,DISABLED",
+              "source": "system-default",
+              "isConfigPendingRestart": "False",
+              "isDynamicConfig": "True"
+            },
+            "id": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/testrg/providers/Microsoft.DBforMySQL/flexibleServers/mysqltestsvc1/configurations/event_scheduler",
+            "name": "event_scheduler",
+            "type": "Microsoft.DBforMySQL/flexibleServers/configurations"
+          },
+          {
+            "properties": {
+              "value": "4",
+              "description": "Number of digits by which to increase the scale of the result of division operations.",
+              "defaultValue": "4",
+              "dataType": "Integer",
+              "allowedValues": "0-30",
+              "source": "system-default",
+              "isConfigPendingRestart": "False",
+              "isDynamicConfig": "True"
+            },
+            "id": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/testrg/providers/Microsoft.DBforMySQL/flexibleServers/mysqltestsvc1/configurations/div_precision_increment",
+            "name": "div_precision_increment",
+            "type": "Microsoft.DBforMySQL/flexibleServers/configurations"
+          },
+          {
+            "properties": {
+              "value": "1024",
+              "description": "Maximum allowed result length in bytes for the GROUP_CONCAT().",
+              "defaultValue": "1024",
+              "dataType": "Integer",
+              "allowedValues": "4-16777216",
+              "source": "system-default",
+              "isConfigPendingRestart": "False",
+              "isDynamicConfig": "True"
+            },
+            "id": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/testrg/providers/Microsoft.DBforMySQL/flexibleServers/mysqltestsvc1/configurations/group_concat_max_len",
+            "name": "group_concat_max_len",
+            "type": "Microsoft.DBforMySQL/flexibleServers/configurations"
+          },
+          {
+            "properties": {
+              "value": "ON",
+              "description": "Whether innodb adaptive hash indexes are enabled or disabled.",
+              "defaultValue": "ON",
+              "dataType": "Enumeration",
+              "allowedValues": "ON,OFF",
+              "source": "system-default",
+              "isConfigPendingRestart": "False",
+              "isDynamicConfig": "True"
+            },
+            "id": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/testrg/providers/Microsoft.DBforMySQL/flexibleServers/mysqltestsvc1/configurations/innodb_adaptive_hash_index",
+            "name": "innodb_adaptive_hash_index",
+            "type": "Microsoft.DBforMySQL/flexibleServers/configurations"
+          },
+          {
+            "properties": {
+              "value": "50",
+              "description": "The length of time in seconds an InnoDB transaction waits for a row lock before giving up.",
+              "defaultValue": "50",
+              "dataType": "Integer",
+              "allowedValues": "1-3600",
+              "source": "system-default",
+              "isConfigPendingRestart": "False",
+              "isDynamicConfig": "True"
+            },
+            "id": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/testrg/providers/Microsoft.DBforMySQL/flexibleServers/mysqltestsvc1/configurations/innodb_lock_wait_timeout",
+            "name": "innodb_lock_wait_timeout",
+            "type": "Microsoft.DBforMySQL/flexibleServers/configurations"
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/mysql/resource-manager/Microsoft.DBforMySQL/preview/2020-07-01-preview/examples/DatabaseCreate.json b/specification/mysql/resource-manager/Microsoft.DBforMySQL/preview/2020-07-01-preview/examples/DatabaseCreate.json
new file mode 100644
index 000000000000..bff8a976401a
--- /dev/null
+++ b/specification/mysql/resource-manager/Microsoft.DBforMySQL/preview/2020-07-01-preview/examples/DatabaseCreate.json
@@ -0,0 +1,40 @@
+{
+  "parameters": {
+    "databaseName": "db1",
+    "serverName": "testserver",
+    "resourceGroupName": "TestGroup",
+    "api-version": "2020-07-01-preview",
+    "subscriptionId": "ffffffff-ffff-ffff-ffff-ffffffffffff",
+    "parameters": {
+      "properties": {
+        "charset": "utf8",
+        "collation": "utf8_general_ci"
+      }
+    }
+  },
+  "responses": {
+    "201": {
+      "body": {
+        "id": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/TestGroup/providers/Microsoft.DBforMySQL/flexibleServers/testserver/databases/db1",
+        "name": "db1",
+        "type": "Microsoft.DBforMySQL/flexibleServers/databases",
+        "properties": {
+          "charset": "utf8",
+          "collation": "utf8_general_ci"
+        }
+      }
+    },
+    "200": {
+      "body": {
+        "id": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/TestGroup/providers/Microsoft.DBforMySQL/flexibleServers/testserver/databases/db1",
+        "name": "db1",
+        "type": "Microsoft.DBforMySQL/flexibleServers/databases",
+        "properties": {
+          "charset": "utf8",
+          "collation": "utf8_general_ci"
+        }
+      }
+    },
+    "202": {}
+  }
+}
diff --git a/specification/mysql/resource-manager/Microsoft.DBforMySQL/preview/2020-07-01-preview/examples/DatabaseDelete.json b/specification/mysql/resource-manager/Microsoft.DBforMySQL/preview/2020-07-01-preview/examples/DatabaseDelete.json
new file mode 100644
index 000000000000..404378d42fe4
--- /dev/null
+++ b/specification/mysql/resource-manager/Microsoft.DBforMySQL/preview/2020-07-01-preview/examples/DatabaseDelete.json
@@ -0,0 +1,14 @@
+{
+  "parameters": {
+    "databaseName": "db1",
+    "serverName": "testserver",
+    "resourceGroupName": "TestGroup",
+    "api-version": "2020-07-01-preview",
+    "subscriptionId": "ffffffff-ffff-ffff-ffff-ffffffffffff"
+  },
+  "responses": {
+    "200": {},
+    "202": {},
+    "204": {}
+  }
+}
diff --git a/specification/mysql/resource-manager/Microsoft.DBforMySQL/preview/2020-07-01-preview/examples/DatabaseGet.json b/specification/mysql/resource-manager/Microsoft.DBforMySQL/preview/2020-07-01-preview/examples/DatabaseGet.json
new file mode 100644
index 000000000000..820cc9b63ff5
--- /dev/null
+++ b/specification/mysql/resource-manager/Microsoft.DBforMySQL/preview/2020-07-01-preview/examples/DatabaseGet.json
@@ -0,0 +1,22 @@
+{
+  "parameters": {
+    "databaseName": "db1",
+    "serverName": "testserver",
+    "resourceGroupName": "TestGroup",
+    "api-version": "2020-07-01-preview",
+    "subscriptionId": "ffffffff-ffff-ffff-ffff-ffffffffffff"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/TestGroup/providers/Microsoft.DBforMySQL/flexibleServers/testserver/databases/db1",
+        "name": "db1",
+        "type": "Microsoft.DBforMySQL/flexibleServers/databases",
+        "properties": {
+          "charset": "utf8",
+          "collation": "utf8_general_ci"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/mysql/resource-manager/Microsoft.DBforMySQL/preview/2020-07-01-preview/examples/DatabasesListByServer.json b/specification/mysql/resource-manager/Microsoft.DBforMySQL/preview/2020-07-01-preview/examples/DatabasesListByServer.json
new file mode 100644
index 000000000000..e0da00a6f878
--- /dev/null
+++ b/specification/mysql/resource-manager/Microsoft.DBforMySQL/preview/2020-07-01-preview/examples/DatabasesListByServer.json
@@ -0,0 +1,34 @@
+{
+  "parameters": {
+    "serverName": "testserver",
+    "resourceGroupName": "TestGroup",
+    "api-version": "2020-07-01-preview",
+    "subscriptionId": "ffffffff-ffff-ffff-ffff-ffffffffffff"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "id": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/TestGroup/providers/Microsoft.DBforMySQL/flexibleServers/testserver/databases/db1",
+            "name": "db1",
+            "type": "Microsoft.DBforMySQL/flexibleServers/databases",
+            "properties": {
+              "charset": "utf8",
+              "collation": "utf8_general_ci"
+            }
+          },
+          {
+            "id": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/TestGroup/providers/Microsoft.DBforMySQL/flexibleServers/testserver/databases/db2",
+            "name": "db2",
+            "type": "Microsoft.DBforMySQL/flexibleServers/databases",
+            "properties": {
+              "charset": "utf8",
+              "collation": "utf8_general_ci"
+            }
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/mysql/resource-manager/Microsoft.DBforMySQL/preview/2020-07-01-preview/examples/FirewallRuleCreate.json b/specification/mysql/resource-manager/Microsoft.DBforMySQL/preview/2020-07-01-preview/examples/FirewallRuleCreate.json
new file mode 100644
index 000000000000..03b11cd864c4
--- /dev/null
+++ b/specification/mysql/resource-manager/Microsoft.DBforMySQL/preview/2020-07-01-preview/examples/FirewallRuleCreate.json
@@ -0,0 +1,40 @@
+{
+  "parameters": {
+    "firewallRuleName": "rule1",
+    "serverName": "testserver",
+    "resourceGroupName": "TestGroup",
+    "api-version": "2020-07-01-preview",
+    "subscriptionId": "ffffffff-ffff-ffff-ffff-ffffffffffff",
+    "parameters": {
+      "properties": {
+        "startIpAddress": "0.0.0.0",
+        "endIpAddress": "255.255.255.255"
+      }
+    }
+  },
+  "responses": {
+    "201": {
+      "body": {
+        "id": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/TestGroup/providers/Microsoft.DBforMySQL/flexibleServers/testserver/firewallRules/rule1",
+        "name": "rule1",
+        "type": "Microsoft.DBforMySQL/flexibleServers/firewallRules",
+        "properties": {
+          "startIpAddress": "0.0.0.0",
+          "endIpAddress": "255.255.255.255"
+        }
+      }
+    },
+    "200": {
+      "body": {
+        "id": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/TestGroup/providers/Microsoft.DBforMySQL/flexibleServers/testserver/firewallRules/rule1",
+        "name": "rule1",
+        "type": "Microsoft.DBforMySQL/flexibleServers/firewallRules",
+        "properties": {
+          "startIpAddress": "0.0.0.0",
+          "endIpAddress": "255.255.255.255"
+        }
+      }
+    },
+    "202": {}
+  }
+}
diff --git a/specification/mysql/resource-manager/Microsoft.DBforMySQL/preview/2020-07-01-preview/examples/FirewallRuleDelete.json b/specification/mysql/resource-manager/Microsoft.DBforMySQL/preview/2020-07-01-preview/examples/FirewallRuleDelete.json
new file mode 100644
index 000000000000..b181e98d1678
--- /dev/null
+++ b/specification/mysql/resource-manager/Microsoft.DBforMySQL/preview/2020-07-01-preview/examples/FirewallRuleDelete.json
@@ -0,0 +1,14 @@
+{
+  "parameters": {
+    "firewallRuleName": "rule1",
+    "serverName": "testserver",
+    "resourceGroupName": "TestGroup",
+    "api-version": "2020-07-01-preview",
+    "subscriptionId": "ffffffff-ffff-ffff-ffff-ffffffffffff"
+  },
+  "responses": {
+    "200": {},
+    "202": {},
+    "204": {}
+  }
+}
diff --git a/specification/mysql/resource-manager/Microsoft.DBforMySQL/preview/2020-07-01-preview/examples/FirewallRuleGet.json b/specification/mysql/resource-manager/Microsoft.DBforMySQL/preview/2020-07-01-preview/examples/FirewallRuleGet.json
new file mode 100644
index 000000000000..a1858025a6ae
--- /dev/null
+++ b/specification/mysql/resource-manager/Microsoft.DBforMySQL/preview/2020-07-01-preview/examples/FirewallRuleGet.json
@@ -0,0 +1,22 @@
+{
+  "parameters": {
+    "firewallRuleName": "rule1",
+    "serverName": "testserver",
+    "resourceGroupName": "TestGroup",
+    "api-version": "2020-07-01-preview",
+    "subscriptionId": "ffffffff-ffff-ffff-ffff-ffffffffffff"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/TestGroup/providers/Microsoft.DBforMySQL/flexibleServers/testserver/firewallRules/rule1",
+        "name": "rule1",
+        "type": "Microsoft.DBforMySQL/flexibleServers/firewallRules",
+        "properties": {
+          "startIpAddress": "0.0.0.0",
+          "endIpAddress": "255.255.255.255"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/mysql/resource-manager/Microsoft.DBforMySQL/preview/2020-07-01-preview/examples/FirewallRulesListByServer.json b/specification/mysql/resource-manager/Microsoft.DBforMySQL/preview/2020-07-01-preview/examples/FirewallRulesListByServer.json
new file mode 100644
index 000000000000..0b39100d799f
--- /dev/null
+++ b/specification/mysql/resource-manager/Microsoft.DBforMySQL/preview/2020-07-01-preview/examples/FirewallRulesListByServer.json
@@ -0,0 +1,34 @@
+{
+  "parameters": {
+    "serverName": "testserver",
+    "resourceGroupName": "TestGroup",
+    "api-version": "2020-07-01-preview",
+    "subscriptionId": "ffffffff-ffff-ffff-ffff-ffffffffffff"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "id": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/TestGroup/providers/Microsoft.DBforMySQL/flexibleServers/testserver/firewallRules/rule1",
+            "name": "rule1",
+            "type": "Microsoft.DBforMySQL/flexibleServers/firewallRules",
+            "properties": {
+              "startIpAddress": "0.0.0.0",
+              "endIpAddress": "255.255.255.255"
+            }
+          },
+          {
+            "id": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/TestGroup/providers/Microsoft.DBforMySQL/flexibleServers/testserver/firewallRules/rule2",
+            "name": "rule2",
+            "type": "Microsoft.DBforMySQL/flexibleServers/firewallRules",
+            "properties": {
+              "startIpAddress": "1.0.0.0",
+              "endIpAddress": "255.0.0.0"
+            }
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/mysql/resource-manager/Microsoft.DBforMySQL/preview/2020-07-01-preview/examples/OperationsList.json b/specification/mysql/resource-manager/Microsoft.DBforMySQL/preview/2020-07-01-preview/examples/OperationsList.json
new file mode 100644
index 000000000000..6add7867c492
--- /dev/null
+++ b/specification/mysql/resource-manager/Microsoft.DBforMySQL/preview/2020-07-01-preview/examples/OperationsList.json
@@ -0,0 +1,217 @@
+{
+  "parameters": {
+    "api-version": "2020-07-01-preview"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "name": "Microsoft.DBforMySQL/locations/performanceTiers/read",
+            "display": {
+              "provider": "Microsoft DB for MySQL",
+              "resource": "Performance Tiers",
+              "operation": "List Performance Tiers",
+              "description": "Returns the list of Performance Tiers available."
+            }
+          },
+          {
+            "name": "Microsoft.DBforMySQL/flexibleServers/firewallRules/read",
+            "display": {
+              "provider": "Microsoft DB for MySQL",
+              "resource": "Firewall Rules",
+              "operation": "List/Get Firewall Rules",
+              "description": "Return the list of firewall rules for a server or gets the properties for the specified firewall rule."
+            }
+          },
+          {
+            "name": "Microsoft.DBforMySQL/flexibleServers/firewallRules/write",
+            "display": {
+              "provider": "Microsoft DB for MySQL",
+              "resource": "Firewall Rules",
+              "operation": "Create/Update Firewall Rule",
+              "description": "Creates a firewall rule with the specified parameters or update an existing rule."
+            }
+          },
+          {
+            "name": "Microsoft.DBforMySQL/flexibleServers/firewallRules/delete",
+            "display": {
+              "provider": "Microsoft DB for MySQL",
+              "resource": "Firewall Rules",
+              "operation": "Delete Firewall Rule",
+              "description": "Deletes an existing firewall rule."
+            }
+          },
+          {
+            "name": "Microsoft.DBforMySQL/flexibleServers/read",
+            "display": {
+              "provider": "Microsoft DB for MySQL",
+              "resource": "MySQL Server",
+              "operation": "List/Get MySQL Servers",
+              "description": "Return the list of servers or gets the properties for the specified server."
+            }
+          },
+          {
+            "name": "Microsoft.DBforMySQL/flexibleServers/write",
+            "display": {
+              "provider": "Microsoft DB for MySQL",
+              "resource": "MySQL Server",
+              "operation": "Create/Update MySQL Server",
+              "description": "Creates a server with the specified parameters or update the properties or tags for the specified server."
+            }
+          },
+          {
+            "name": "Microsoft.DBforMySQL/flexibleServers/delete",
+            "display": {
+              "provider": "Microsoft DB for MySQL",
+              "resource": "MySQL Server",
+              "operation": "Delete MySQL Server",
+              "description": "Deletes an existing server."
+            }
+          },
+          {
+            "name": "Microsoft.DBforMySQL/performanceTiers/read",
+            "display": {
+              "provider": "Microsoft DB for MySQL",
+              "resource": "Performance Tiers",
+              "operation": "List Performance Tiers",
+              "description": "Returns the list of Performance Tiers available."
+            }
+          },
+          {
+            "name": "Microsoft.DBforMySQL/flexibleServers/recoverableServers/read",
+            "display": {
+              "provider": "Microsoft DB for MySQL",
+              "resource": "Recoverable MySQL Server",
+              "operation": "Get Recoverable MySQL Server info",
+              "description": "Return the recoverable MySQL Server info"
+            }
+          },
+          {
+            "name": "Microsoft.DBforMySQL/flexibleServers/providers/Microsoft.Insights/metricDefinitions/read",
+            "display": {
+              "provider": "Microsoft DB for MySQL",
+              "resource": "Database Metric Definition",
+              "operation": "Get database metric definitions",
+              "description": "Return types of metrics that are available for databases"
+            },
+            "properties": {
+              "serviceSpecification": {
+                "metricSpecifications": [
+                  {
+                    "name": "cpu_percent",
+                    "displayName": "CPU percent",
+                    "displayDescription": "CPU percent",
+                    "unit": "Percent",
+                    "aggregationType": "Average",
+                    "fillGapWithZero": true
+                  },
+                  {
+                    "name": "memory_percent",
+                    "displayName": "Memory percent",
+                    "displayDescription": "Memory percent",
+                    "unit": "Percent",
+                    "aggregationType": "Average",
+                    "fillGapWithZero": true
+                  },
+                  {
+                    "name": "io_consumption_percent",
+                    "displayName": "IO percent",
+                    "displayDescription": "IO percent",
+                    "unit": "Percent",
+                    "aggregationType": "Average",
+                    "fillGapWithZero": true
+                  },
+                  {
+                    "name": "storage_percent",
+                    "displayName": "Storage percentage",
+                    "displayDescription": "Storage percentage",
+                    "unit": "Percent",
+                    "aggregationType": "Average"
+                  },
+                  {
+                    "name": "storage_used",
+                    "displayName": "Storage used",
+                    "displayDescription": "Storage used",
+                    "unit": "Bytes",
+                    "aggregationType": "Average"
+                  },
+                  {
+                    "name": "storage_limit",
+                    "displayName": "Storage limit",
+                    "displayDescription": "Storage limit",
+                    "unit": "Bytes",
+                    "aggregationType": "Average"
+                  },
+                  {
+                    "name": "serverlog_storage_percent",
+                    "displayName": "Server Log storage percent",
+                    "displayDescription": "Server Log storage percent",
+                    "unit": "Percent",
+                    "aggregationType": "Average"
+                  },
+                  {
+                    "name": "serverlog_storage_usage",
+                    "displayName": "Server Log storage used",
+                    "displayDescription": "Server Log storage used",
+                    "unit": "Bytes",
+                    "aggregationType": "Average"
+                  },
+                  {
+                    "name": "serverlog_storage_limit",
+                    "displayName": "Server Log storage limit",
+                    "displayDescription": "Server Log storage limit",
+                    "unit": "Bytes",
+                    "aggregationType": "Average"
+                  },
+                  {
+                    "name": "active_connections",
+                    "displayName": "Total active connections",
+                    "displayDescription": "Total active connections",
+                    "unit": "Count",
+                    "aggregationType": "Average",
+                    "fillGapWithZero": true
+                  },
+                  {
+                    "name": "connections_failed",
+                    "displayName": "Total failed connections",
+                    "displayDescription": "Total failed connections",
+                    "unit": "Count",
+                    "aggregationType": "Average",
+                    "fillGapWithZero": true
+                  },
+                  {
+                    "name": "seconds_behind_master",
+                    "displayName": "Replication lag in seconds",
+                    "displayDescription": "Replication lag in seconds",
+                    "unit": "Count",
+                    "aggregationType": "Average",
+                    "fillGapWithZero": true
+                  }
+                ]
+              }
+            }
+          },
+          {
+            "name": "Microsoft.DBforMySQL/flexibleServers/providers/Microsoft.Insights/diagnosticSettings/read",
+            "display": {
+              "provider": "Microsoft DB for MySQL",
+              "resource": "Database Metric Definition",
+              "operation": "Read diagnostic setting",
+              "description": "Gets the disagnostic setting for the resource"
+            }
+          },
+          {
+            "name": "Microsoft.DBforMySQL/flexibleServers/providers/Microsoft.Insights/diagnosticSettings/write",
+            "display": {
+              "provider": "Microsoft DB for MySQL",
+              "resource": "Database Metric Definition",
+              "operation": "Write diagnostic setting",
+              "description": "Creates or updates the diagnostic setting for the resource"
+            }
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/mysql/resource-manager/Microsoft.DBforMySQL/preview/2020-07-01-preview/examples/ReplicasListByServer.json b/specification/mysql/resource-manager/Microsoft.DBforMySQL/preview/2020-07-01-preview/examples/ReplicasListByServer.json
new file mode 100644
index 000000000000..b5503df0c06f
--- /dev/null
+++ b/specification/mysql/resource-manager/Microsoft.DBforMySQL/preview/2020-07-01-preview/examples/ReplicasListByServer.json
@@ -0,0 +1,103 @@
+{
+  "parameters": {
+    "serverName": "testprimary",
+    "resourceGroupName": "TestGroup",
+    "api-version": "2020-07-01-preview",
+    "subscriptionId": "ffffffff-ffff-ffff-ffff-ffffffffffff"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "id": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/TestGroup/providers/Microsoft.DBforMySQL/flexibleServers/testserver",
+            "name": "testserver",
+            "type": "Microsoft.DBforMySQL/flexibleServers",
+            "location": "northeurope",
+            "tags": {
+              "elasticServer": "1"
+            },
+            "sku": {
+              "name": "Standard_D12_v2",
+              "tier": "GeneralPurpose"
+            },
+            "properties": {
+              "storageProfile": {
+                "storageMB": 256000,
+                "storageIops": 200,
+                "backupRetentionDays": 35
+              },
+              "administratorLogin": "cloudsa",
+              "sslEnforcement": "Enabled",
+              "publicNetworkAccess": "Enabled",
+              "state": "Ready",
+              "fullyQualifiedDomainName": "testserver.mysql.database.azure.com",
+              "version": "5.7",
+              "replicationRole": "Replica",
+              "sourceServerId": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/TestGroup/providers/Microsoft.DBforMySQL/flexibleServers/testprimary",
+              "replicaCapacity": 0
+            }
+          },
+          {
+            "id": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/TestGroup/providers/Microsoft.DBforMySQL/flexibleServers/testserver1",
+            "name": "testserver1",
+            "type": "Microsoft.DBforMySQL/flexibleServers",
+            "location": "northeurope",
+            "tags": {
+              "elasticServer": "1"
+            },
+            "sku": {
+              "name": "Standard_D12_v2",
+              "tier": "GeneralPurpose"
+            },
+            "properties": {
+              "storageProfile": {
+                "storageMB": 256000,
+                "storageIops": 200,
+                "backupRetentionDays": 35
+              },
+              "administratorLogin": "cloudsa",
+              "sslEnforcement": "Enabled",
+              "publicNetworkAccess": "Enabled",
+              "state": "Ready",
+              "fullyQualifiedDomainName": "testserver1.mysql.database.azure.com",
+              "version": "5.7",
+              "replicationRole": "Replica",
+              "sourceServerId": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/TestGroup/providers/Microsoft.DBforMySQL/flexibleServers/testprimary",
+              "replicaCapacity": 0
+            }
+          },
+          {
+            "id": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/TestGroup/providers/Microsoft.DBforMySQL/flexibleServers/testserver2",
+            "name": "testserver2",
+            "type": "Microsoft.DBforMySQL/flexibleServers",
+            "location": "northeurope",
+            "tags": {
+              "elasticServer": "1"
+            },
+            "sku": {
+              "name": "Standard_D12_v2",
+              "tier": "GeneralPurpose"
+            },
+            "properties": {
+              "storageProfile": {
+                "storageMB": 256000,
+                "storageIops": 200,
+                "backupRetentionDays": 35
+              },
+              "administratorLogin": "cloudsa",
+              "sslEnforcement": "Enabled",
+              "publicNetworkAccess": "Enabled",
+              "state": "Ready",
+              "fullyQualifiedDomainName": "testserver2.mysql.database.azure.com",
+              "version": "5.7",
+              "replicationRole": "Replica",
+              "sourceServerId": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/TestGroup/providers/Microsoft.DBforMySQL/flexibleServers/testprimary",
+              "replicaCapacity": 0
+            }
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/mysql/resource-manager/Microsoft.DBforMySQL/preview/2020-07-01-preview/examples/ServerCreate.json b/specification/mysql/resource-manager/Microsoft.DBforMySQL/preview/2020-07-01-preview/examples/ServerCreate.json
new file mode 100644
index 000000000000..db62b78f4e95
--- /dev/null
+++ b/specification/mysql/resource-manager/Microsoft.DBforMySQL/preview/2020-07-01-preview/examples/ServerCreate.json
@@ -0,0 +1,88 @@
+{
+  "parameters": {
+    "serverName": "mysqltestsvc4",
+    "resourceGroupName": "testrg",
+    "api-version": "2020-07-01-preview",
+    "subscriptionId": "ffffffff-ffff-ffff-ffff-ffffffffffff",
+    "parameters": {
+      "location": "westus",
+      "properties": {
+        "administratorLogin": "cloudsa",
+        "administratorLoginPassword": "pass$w0rd",
+        "sslEnforcement": "Enabled",
+        "storageProfile": {
+          "storageMB": 128000,
+          "storageIops": 200,
+          "backupRetentionDays": 7
+        },
+        "createMode": "Default"
+      },
+      "sku": {
+        "name": "Standard_D14_v2",
+        "tier": "GeneralPurpose"
+      },
+      "tags": {
+        "ElasticServer": "1"
+      }
+    }
+  },
+  "responses": {
+    "201": {
+      "body": {
+        "sku": {
+          "name": "Standard_D14_v2",
+          "tier": "GeneralPurpose"
+        },
+        "properties": {
+          "administratorLogin": "cloudsa",
+          "storageProfile": {
+            "storageMB": 128000,
+            "storageIops": 200,
+            "backupRetentionDays": 7
+          },
+          "version": "5.7",
+          "sslEnforcement": "Enabled",
+          "publicNetworkAccess": "Enabled",
+          "state": "Ready",
+          "fullyQualifiedDomainName": "mysqltestsvc4.mysql.database.azure.com"
+        },
+        "location": "westus",
+        "tags": {
+          "ElasticServer": "1"
+        },
+        "id": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/testrg/providers/Microsoft.DBforMySQL/flexibleServers/mysqltestsvc4",
+        "name": "mysqltestsvc4",
+        "type": "Microsoft.DBforMySQL/flexibleServers"
+      }
+    },
+    "200": {
+      "body": {
+        "id": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/testrg/providers/Microsoft.DBforMySQL/flexibleServers/mysqltestsvc4",
+        "name": "mysqltestsvc4",
+        "type": "Microsoft.DBforMySQL/flexibleServers",
+        "location": "westus",
+        "sku": {
+          "name": "Standard_D14_v2",
+          "tier": "GeneralPurpose"
+        },
+        "tags": {
+          "elasticServer": "1"
+        },
+        "properties": {
+          "administratorLogin": "cloudsa",
+          "storageProfile": {
+            "storageMB": 128000,
+            "storageIops": 200,
+            "backupRetentionDays": 7
+          },
+          "version": "5.7",
+          "sslEnforcement": "Enabled",
+          "publicNetworkAccess": "Enabled",
+          "state": "Ready",
+          "fullyQualifiedDomainName": "mysqltestsvc4.mysql.database.azure.com"
+        }
+      }
+    },
+    "202": {}
+  }
+}
diff --git a/specification/mysql/resource-manager/Microsoft.DBforMySQL/preview/2020-07-01-preview/examples/ServerCreateReplica.json b/specification/mysql/resource-manager/Microsoft.DBforMySQL/preview/2020-07-01-preview/examples/ServerCreateReplica.json
new file mode 100644
index 000000000000..04d66245e40d
--- /dev/null
+++ b/specification/mysql/resource-manager/Microsoft.DBforMySQL/preview/2020-07-01-preview/examples/ServerCreateReplica.json
@@ -0,0 +1,80 @@
+{
+  "parameters": {
+    "serverName": "targetserver",
+    "resourceGroupName": "TargetResourceGroup",
+    "api-version": "2020-07-01-preview",
+    "subscriptionId": "ffffffff-ffff-ffff-ffff-ffffffffffff",
+    "parameters": {
+      "location": "westus",
+      "properties": {
+        "createMode": "Replica",
+        "sourceServerId": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/PrimaryResourceGroup/providers/Microsoft.DBforMySQL/flexibleServers/primaryserver"
+      }
+    }
+  },
+  "responses": {
+    "201": {
+      "body": {
+        "sku": {
+          "name": "Standard_D14_v2",
+          "tier": "GeneralPurpose"
+        },
+        "properties": {
+          "administratorLogin": "cloudsa",
+          "storageProfile": {
+            "storageMB": 128000,
+            "storageIops": 200,
+            "backupRetentionDays": 14
+          },
+          "version": "5.7",
+          "sslEnforcement": "Enabled",
+          "publicNetworkAccess": "Enabled",
+          "state": "Ready",
+          "fullyQualifiedDomainName": "targetserver.mysql.database.azure.com",
+          "replicationRole": "Replica",
+          "sourceServerId": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/PrimaryResourceGroup/providers/Microsoft.DBforMySQL/flexibleServers/primaryserver",
+          "replicaCapacity": 0
+        },
+        "location": "westus",
+        "tags": {
+          "ElasticServer": "1"
+        },
+        "id": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/TargetResourceGroup/providers/Microsoft.DBforMySQL/flexibleServers/targetserver",
+        "name": "targetserver",
+        "type": "Microsoft.DBforMySQL/flexibleServers"
+      }
+    },
+    "200": {
+      "body": {
+        "sku": {
+          "name": "Standard_D14_v2",
+          "tier": "GeneralPurpose"
+        },
+        "properties": {
+          "administratorLogin": "cloudsa",
+          "storageProfile": {
+            "storageMB": 128000,
+            "storageIops": 200,
+            "backupRetentionDays": 14
+          },
+          "version": "5.7",
+          "sslEnforcement": "Enabled",
+          "publicNetworkAccess": "Enabled",
+          "state": "Ready",
+          "fullyQualifiedDomainName": "targetserver.mysql.database.azure.com",
+          "replicationRole": "Replica",
+          "sourceServerId": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/PrimaryResourceGroup/providers/Microsoft.DBforMySQL/flexibleServers/primaryserver",
+          "replicaCapacity": 0
+        },
+        "location": "westus",
+        "tags": {
+          "ElasticServer": "1"
+        },
+        "id": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/TargetResourceGroup/providers/Microsoft.DBforMySQL/flexibleServers/targetserver",
+        "name": "targetserver",
+        "type": "Microsoft.DBforMySQL/flexibleServers"
+      }
+    },
+    "202": {}
+  }
+}
diff --git a/specification/mysql/resource-manager/Microsoft.DBforMySQL/preview/2020-07-01-preview/examples/ServerCreateWithPointInTimeRestore.json b/specification/mysql/resource-manager/Microsoft.DBforMySQL/preview/2020-07-01-preview/examples/ServerCreateWithPointInTimeRestore.json
new file mode 100644
index 000000000000..3c5dfe80c7f1
--- /dev/null
+++ b/specification/mysql/resource-manager/Microsoft.DBforMySQL/preview/2020-07-01-preview/examples/ServerCreateWithPointInTimeRestore.json
@@ -0,0 +1,82 @@
+{
+  "parameters": {
+    "serverName": "targetserver",
+    "resourceGroupName": "TargetResourceGroup",
+    "api-version": "2020-07-01-preview",
+    "subscriptionId": "ffffffff-ffff-ffff-ffff-ffffffffffff",
+    "parameters": {
+      "location": "brazilsouth",
+      "properties": {
+        "restorePointInTime": "2017-12-14T00:00:37.467Z",
+        "createMode": "PointInTimeRestore",
+        "sourceServerId": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/SourceResourceGroup/providers/Microsoft.DBforMySQL/flexibleServers/sourceserver"
+      },
+      "sku": {
+        "name": "Standard_D14_v2",
+        "tier": "GeneralPurpose"
+      },
+      "tags": {
+        "ElasticServer": "1"
+      }
+    }
+  },
+  "responses": {
+    "201": {
+      "body": {
+        "sku": {
+          "name": "Standard_D14_v2",
+          "tier": "GeneralPurpose"
+        },
+        "properties": {
+          "administratorLogin": "cloudsa",
+          "storageProfile": {
+            "storageMB": 128000,
+            "storageIops": 200,
+            "backupRetentionDays": 7
+          },
+          "version": "5.7",
+          "sslEnforcement": "Enabled",
+          "publicNetworkAccess": "Enabled",
+          "state": "Ready",
+          "fullyQualifiedDomainName": "targetserver.mysql.database.azure.com"
+        },
+        "location": "brazilsouth",
+        "tags": {
+          "ElasticServer": "1"
+        },
+        "id": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/testrg/providers/Microsoft.DBforMySQL/flexibleServers/targetserver",
+        "name": "targetserver",
+        "type": "Microsoft.DBforMySQL/flexibleServers"
+      }
+    },
+    "200": {
+      "body": {
+        "id": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/testrg/providers/Microsoft.DBforMySQL/flexibleServers/targetserver",
+        "name": "targetserver",
+        "type": "Microsoft.DBforMySQL/flexibleServers",
+        "location": "brazilsouth",
+        "sku": {
+          "name": "Standard_D14_v2",
+          "tier": "GeneralPurpose"
+        },
+        "tags": {
+          "elasticServer": "1"
+        },
+        "properties": {
+          "administratorLogin": "cloudsa",
+          "storageProfile": {
+            "storageMB": 128000,
+            "storageIops": 200,
+            "backupRetentionDays": 7
+          },
+          "version": "5.7",
+          "sslEnforcement": "Enabled",
+          "publicNetworkAccess": "Enabled",
+          "state": "Ready",
+          "fullyQualifiedDomainName": "targetserver.mysql.database.azure.com"
+        }
+      }
+    },
+    "202": {}
+  }
+}
diff --git a/specification/mysql/resource-manager/Microsoft.DBforMySQL/preview/2020-07-01-preview/examples/ServerDelete.json b/specification/mysql/resource-manager/Microsoft.DBforMySQL/preview/2020-07-01-preview/examples/ServerDelete.json
new file mode 100644
index 000000000000..67aa06b12dd8
--- /dev/null
+++ b/specification/mysql/resource-manager/Microsoft.DBforMySQL/preview/2020-07-01-preview/examples/ServerDelete.json
@@ -0,0 +1,13 @@
+{
+  "parameters": {
+    "serverName": "testserver",
+    "resourceGroupName": "TestGroup",
+    "api-version": "2020-07-01-preview",
+    "subscriptionId": "ffffffff-ffff-ffff-ffff-ffffffffffff"
+  },
+  "responses": {
+    "200": {},
+    "202": {},
+    "204": {}
+  }
+}
diff --git a/specification/mysql/resource-manager/Microsoft.DBforMySQL/preview/2020-07-01-preview/examples/ServerGet.json b/specification/mysql/resource-manager/Microsoft.DBforMySQL/preview/2020-07-01-preview/examples/ServerGet.json
new file mode 100644
index 000000000000..a8da20a34712
--- /dev/null
+++ b/specification/mysql/resource-manager/Microsoft.DBforMySQL/preview/2020-07-01-preview/examples/ServerGet.json
@@ -0,0 +1,55 @@
+{
+  "parameters": {
+    "serverName": "mysqltestsvc4",
+    "resourceGroupName": "testrg",
+    "api-version": "2020-07-01-preview",
+    "subscriptionId": "ffffffff-ffff-ffff-ffff-ffffffffffff"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "sku": {
+          "name": "Standard_D14_v2",
+          "tier": "GeneralPurpose"
+        },
+        "properties": {
+          "administratorLogin": "cloudsa",
+          "storageProfile": {
+            "storageMB": 128000,
+            "storageIops": 200,
+            "backupRetentionDays": 7
+          },
+          "version": "5.7",
+          "sslEnforcement": "Enabled",
+          "state": "Ready",
+          "fullyQualifiedDomainName": "mysqltestsvc4.mysql.database.azure.com",
+          "earliestRestoreDate": "2020-03-14T18:02:41.577+00:00",
+          "replicationRole": "None",
+          "sourceServerId": "",
+          "replicaCapacity": 5,
+          "publicNetworkAccess": "Enabled",
+          "haEnabled": "Enabled",
+          "haState": "Healthy",
+          "availabilityZone": "1",
+          "standbyAvailabilityZone": "2",
+          "maintenanceWindow": {
+            "dayOfWeek": 0,
+            "startHour": 0,
+            "startMinute": 0,
+            "customWindow": "Disabled"
+          },
+          "delegatedSubnetArguments": {
+            "subnetArmResourceId": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/testrg/providers/Microsoft.Network/virtualNetworks/test-vnet/subnets/test-vnet-subnet"
+          }
+        },
+        "location": "westus",
+        "tags": {
+          "ElasticServer": "1"
+        },
+        "id": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/testrg/providers/Microsoft.DBforMySQL/flexibleServers/mysqltestsvc4",
+        "name": "mysqltestsvc4",
+        "type": "Microsoft.DBforMySQL/flexibleServers"
+      }
+    }
+  }
+}
diff --git a/specification/mysql/resource-manager/Microsoft.DBforMySQL/preview/2020-07-01-preview/examples/ServerGetWithVnet.json b/specification/mysql/resource-manager/Microsoft.DBforMySQL/preview/2020-07-01-preview/examples/ServerGetWithVnet.json
new file mode 100644
index 000000000000..23bfd3609f55
--- /dev/null
+++ b/specification/mysql/resource-manager/Microsoft.DBforMySQL/preview/2020-07-01-preview/examples/ServerGetWithVnet.json
@@ -0,0 +1,45 @@
+{
+  "parameters": {
+    "serverName": "mysqltestsrv",
+    "resourceGroupName": "testrg",
+    "api-version": "2020-07-01-preview",
+    "subscriptionId": "ffffffff-ffff-ffff-ffff-ffffffffffff"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "sku": {
+          "name": "Standard_D12_v2",
+          "tier": "GeneralPurpose"
+        },
+        "properties": {
+          "administratorLogin": "cloudsa",
+          "storageProfile": {
+            "storageMB": 128000,
+            "storageIops": 200,
+            "backupRetentionDays": 7
+          },
+          "version": "5.7",
+          "sslEnforcement": "Enabled",
+          "state": "Ready",
+          "fullyQualifiedDomainName": "mysqltestsrv.mysql.database.azure.com",
+          "replicationRole": "None",
+          "sourceServerId": "",
+          "replicaCapacity": 5,
+          "publicNetworkAccess": "Disabled",
+          "haEnabled": "Disabled",
+          "delegatedSubnetArguments": {
+            "subnetArmResourceId": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/testrg/providers/Microsoft.Network/virtualNetworks/test-vnet/subnets/test-vnet-subnet"
+          }
+        },
+        "location": "westus",
+        "tags": {
+          "ElasticServer": "1"
+        },
+        "id": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/testrg/providers/Microsoft.DBforMySQL/flexibleServers/mysqltestsrv",
+        "name": "mysqltestsrv",
+        "type": "Microsoft.DBforMySQL/flexibleServers"
+      }
+    }
+  }
+}
diff --git a/specification/mysql/resource-manager/Microsoft.DBforMySQL/preview/2020-07-01-preview/examples/ServerKeyCreate.json b/specification/mysql/resource-manager/Microsoft.DBforMySQL/preview/2020-07-01-preview/examples/ServerKeyCreate.json
new file mode 100644
index 000000000000..bbb430b43a56
--- /dev/null
+++ b/specification/mysql/resource-manager/Microsoft.DBforMySQL/preview/2020-07-01-preview/examples/ServerKeyCreate.json
@@ -0,0 +1,44 @@
+{
+  "parameters": {
+    "subscriptionId": "ffffffff-ffff-ffff-ffff-ffffffffffff",
+    "resourceGroupName": "testrg",
+    "serverName": "testserver",
+    "keyName": "someVault_someKey_01234567890123456789012345678901",
+    "api-version": "2020-07-01-preview",
+    "parameters": {
+      "properties": {
+        "serverKeyType": "AzureKeyVault",
+        "uri": "https://someVault.vault.azure.net/keys/someKey/01234567890123456789012345678901"
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/testrg/providers/Microsoft.DBForMySql/flexibleServers/testserver/keys/someVault_someKey_01234567890123456789012345678901",
+        "name": "omeVault_someKey_01234567890123456789012345678901",
+        "type": "Microsoft.DBforMySQL/flexibleServers/keys",
+        "kind": "azurekeyvault",
+        "properties": {
+          "serverKeyType": "AzureKeyVault",
+          "uri": "https://someVault.vault.azure.net/keys/someKey/01234567890123456789012345678901",
+          "creationDate": "2017-05-01T00:00:00.0Z"
+        }
+      }
+    },
+    "201": {
+      "body": {
+        "id": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/testrg/providers/Microsoft.DBForMySql/flexibleServers/testserver/keys/someVault_someKey_01234567890123456789012345678901",
+        "name": "omeVault_someKey_01234567890123456789012345678901",
+        "type": "Microsoft.DBforMySQL/flexibleServers/keys",
+        "kind": "azurekeyvault",
+        "properties": {
+          "serverKeyType": "AzureKeyVault",
+          "uri": "https://someVault.vault.azure.net/keys/someKey/01234567890123456789012345678901",
+          "creationDate": "2017-05-01T00:00:00.0Z"
+        }
+      }
+    },
+    "202": {}
+  }
+}
diff --git a/specification/mysql/resource-manager/Microsoft.DBforMySQL/preview/2020-07-01-preview/examples/ServerKeyDelete.json b/specification/mysql/resource-manager/Microsoft.DBforMySQL/preview/2020-07-01-preview/examples/ServerKeyDelete.json
new file mode 100644
index 000000000000..2ffdb19b61a5
--- /dev/null
+++ b/specification/mysql/resource-manager/Microsoft.DBforMySQL/preview/2020-07-01-preview/examples/ServerKeyDelete.json
@@ -0,0 +1,14 @@
+{
+  "parameters": {
+    "subscriptionId": "ffffffff-ffff-ffff-ffff-ffffffffffff",
+    "resourceGroupName": "testrg",
+    "serverName": "testserver",
+    "keyName": "someVault_someKey_01234567890123456789012345678901",
+    "api-version": "2020-07-01-preview"
+  },
+  "responses": {
+    "200": {},
+    "202": {},
+    "204": {}
+  }
+}
diff --git a/specification/mysql/resource-manager/Microsoft.DBforMySQL/preview/2020-07-01-preview/examples/ServerKeyGet.json b/specification/mysql/resource-manager/Microsoft.DBforMySQL/preview/2020-07-01-preview/examples/ServerKeyGet.json
new file mode 100644
index 000000000000..c30a6a2402cd
--- /dev/null
+++ b/specification/mysql/resource-manager/Microsoft.DBforMySQL/preview/2020-07-01-preview/examples/ServerKeyGet.json
@@ -0,0 +1,24 @@
+{
+  "parameters": {
+    "subscriptionId": "ffffffff-ffff-ffff-ffff-ffffffffffff",
+    "resourceGroupName": "testrg",
+    "serverName": "testserver",
+    "keyName": "someVault_someKey_01234567890123456789012345678901",
+    "api-version": "2020-07-01-preview"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/testrg/providers/Microsoft.DBForMySql/flexibleServers/testserver/keys/someVault_someKey_01234567890123456789012345678901",
+        "name": "someVault_someKey_01234567890123456789012345678901",
+        "type": "Microsoft.DBforMySQL/flexibleServers/keys",
+        "kind": "azurekeyvault",
+        "properties": {
+          "serverKeyType": "AzureKeyVault",
+          "uri": "https://someVault.vault.azure.net/keys/someKey/01234567890123456789012345678901",
+          "creationDate": "2019-12-01T00:00:00.0Z"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/mysql/resource-manager/Microsoft.DBforMySQL/preview/2020-07-01-preview/examples/ServerKeysListByServer.json b/specification/mysql/resource-manager/Microsoft.DBforMySQL/preview/2020-07-01-preview/examples/ServerKeysListByServer.json
new file mode 100644
index 000000000000..333b0be52aca
--- /dev/null
+++ b/specification/mysql/resource-manager/Microsoft.DBforMySQL/preview/2020-07-01-preview/examples/ServerKeysListByServer.json
@@ -0,0 +1,27 @@
+{
+  "parameters": {
+    "subscriptionId": "ffffffff-ffff-ffff-ffff-ffffffffffff",
+    "resourceGroupName": "testrg",
+    "serverName": "testserver",
+    "api-version": "2020-07-01-preview"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "id": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/testrg/providers/Microsoft.DBForMySql/flexibleServers/testserver/keys/someVault_someKey_01234567890123456789012345678901",
+            "name": "someVault_someKey_01234567890123456789012345678901",
+            "type": "Microsoft.DBforMySQL/flexibleServers/keys",
+            "kind": "azurekeyvault",
+            "properties": {
+              "serverKeyType": "AzureKeyVault",
+              "uri": "https://someVault.vault.azure.net/keys/someKey/01234567890123456789012345678901",
+              "creationDate": "2019-12-01T00:00:00.0Z"
+            }
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/mysql/resource-manager/Microsoft.DBforMySQL/preview/2020-07-01-preview/examples/ServerRestart.json b/specification/mysql/resource-manager/Microsoft.DBforMySQL/preview/2020-07-01-preview/examples/ServerRestart.json
new file mode 100644
index 000000000000..2113645e4f96
--- /dev/null
+++ b/specification/mysql/resource-manager/Microsoft.DBforMySQL/preview/2020-07-01-preview/examples/ServerRestart.json
@@ -0,0 +1,12 @@
+{
+  "parameters": {
+    "serverName": "testserver",
+    "resourceGroupName": "TestGroup",
+    "api-version": "2020-07-01-preview",
+    "subscriptionId": "ffffffff-ffff-ffff-ffff-ffffffffffff"
+  },
+  "responses": {
+    "200": {},
+    "202": {}
+  }
+}
diff --git a/specification/mysql/resource-manager/Microsoft.DBforMySQL/preview/2020-07-01-preview/examples/ServerStart.json b/specification/mysql/resource-manager/Microsoft.DBforMySQL/preview/2020-07-01-preview/examples/ServerStart.json
new file mode 100644
index 000000000000..2113645e4f96
--- /dev/null
+++ b/specification/mysql/resource-manager/Microsoft.DBforMySQL/preview/2020-07-01-preview/examples/ServerStart.json
@@ -0,0 +1,12 @@
+{
+  "parameters": {
+    "serverName": "testserver",
+    "resourceGroupName": "TestGroup",
+    "api-version": "2020-07-01-preview",
+    "subscriptionId": "ffffffff-ffff-ffff-ffff-ffffffffffff"
+  },
+  "responses": {
+    "200": {},
+    "202": {}
+  }
+}
diff --git a/specification/mysql/resource-manager/Microsoft.DBforMySQL/preview/2020-07-01-preview/examples/ServerStop.json b/specification/mysql/resource-manager/Microsoft.DBforMySQL/preview/2020-07-01-preview/examples/ServerStop.json
new file mode 100644
index 000000000000..2113645e4f96
--- /dev/null
+++ b/specification/mysql/resource-manager/Microsoft.DBforMySQL/preview/2020-07-01-preview/examples/ServerStop.json
@@ -0,0 +1,12 @@
+{
+  "parameters": {
+    "serverName": "testserver",
+    "resourceGroupName": "TestGroup",
+    "api-version": "2020-07-01-preview",
+    "subscriptionId": "ffffffff-ffff-ffff-ffff-ffffffffffff"
+  },
+  "responses": {
+    "200": {},
+    "202": {}
+  }
+}
diff --git a/specification/mysql/resource-manager/Microsoft.DBforMySQL/preview/2020-07-01-preview/examples/ServerUpdate.json b/specification/mysql/resource-manager/Microsoft.DBforMySQL/preview/2020-07-01-preview/examples/ServerUpdate.json
new file mode 100644
index 000000000000..21a0ca95270c
--- /dev/null
+++ b/specification/mysql/resource-manager/Microsoft.DBforMySQL/preview/2020-07-01-preview/examples/ServerUpdate.json
@@ -0,0 +1,55 @@
+{
+  "parameters": {
+    "serverName": "mysqltestsvc4",
+    "resourceGroupName": "testrg",
+    "api-version": "2020-07-01-preview",
+    "subscriptionId": "ffffffff-ffff-ffff-ffff-ffffffffffff",
+    "parameters": {
+      "properties": {
+        "administratorLoginPassword": "newpa$$w0rd",
+        "sslEnforcement": "Disabled"
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "sku": {
+          "name": "Standard_D12_v2",
+          "tier": "GeneralPurpose"
+        },
+        "properties": {
+          "administratorLogin": "cloudsa",
+          "storageProfile": {
+            "storageMB": 128000,
+            "backupRetentionDays": 7
+          },
+          "version": "5.7",
+          "sslEnforcement": "Disabled",
+          "publicNetworkAccess": "Enabled",
+          "state": "Ready",
+          "fullyQualifiedDomainName": "mysqltestsvc4.mysql.database.azure.com",
+          "haEnabled": "Enabled",
+          "haState": "Healthy",
+          "availabilityZone": "1",
+          "standbyAvailabilityZone": "2",
+          "maintenanceWindow": {
+            "dayOfWeek": 0,
+            "startHour": 0,
+            "startMinute": 0,
+            "customWindow": "Disabled"
+          },
+          "delegatedSubnetArguments": {}
+        },
+        "location": "westus",
+        "tags": {
+          "ElasticServer": "1"
+        },
+        "id": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/testrg/providers/Microsoft.DBforMySQL/flexibleServers/mysqltestsvc4",
+        "name": "mysqltestsvc4",
+        "type": "Microsoft.DBforMySQL/flexibleServers"
+      }
+    },
+    "202": {}
+  }
+}
diff --git a/specification/mysql/resource-manager/Microsoft.DBforMySQL/preview/2020-07-01-preview/examples/ServerUpdateWithCustomerMaintenanceWindow.json b/specification/mysql/resource-manager/Microsoft.DBforMySQL/preview/2020-07-01-preview/examples/ServerUpdateWithCustomerMaintenanceWindow.json
new file mode 100644
index 000000000000..eab5131bebdf
--- /dev/null
+++ b/specification/mysql/resource-manager/Microsoft.DBforMySQL/preview/2020-07-01-preview/examples/ServerUpdateWithCustomerMaintenanceWindow.json
@@ -0,0 +1,59 @@
+{
+  "parameters": {
+    "serverName": "mysqltestsvc4",
+    "resourceGroupName": "testrg",
+    "api-version": "2020-07-01-preview",
+    "subscriptionId": "ffffffff-ffff-ffff-ffff-ffffffffffff",
+    "parameters": {
+      "properties": {
+        "maintenanceWindow": {
+          "customWindow": "Enabled",
+          "dayOfWeek": 0,
+          "startHour": 8,
+          "startMinute": 0
+        }
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "sku": {
+          "name": "Standard_D12_v2",
+          "tier": "GeneralPurpose"
+        },
+        "properties": {
+          "administratorLogin": "cloudsa",
+          "storageProfile": {
+            "storageMB": 128000,
+            "backupRetentionDays": 7
+          },
+          "version": "5.7",
+          "sslEnforcement": "Disabled",
+          "publicNetworkAccess": "Enabled",
+          "state": "Ready",
+          "fullyQualifiedDomainName": "mysqltestsvc4.mysql.database.azure.com",
+          "haEnabled": "Disabled",
+          "haState": "NotEnabled",
+          "availabilityZone": "1",
+          "standbyAvailabilityZone": null,
+          "maintenanceWindow": {
+            "dayOfWeek": 0,
+            "startHour": 8,
+            "startMinute": 0,
+            "customWindow": "Enabled"
+          },
+          "delegatedSubnetArguments": {}
+        },
+        "location": "westus",
+        "tags": {
+          "ElasticServer": "1"
+        },
+        "id": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/testrg/providers/Microsoft.DBforMySQL/flexibleServers/mysqltestsvc4",
+        "name": "mysqltestsvc4",
+        "type": "Microsoft.DBforMySQL/flexibleServers"
+      }
+    },
+    "202": {}
+  }
+}
diff --git a/specification/mysql/resource-manager/Microsoft.DBforMySQL/preview/2020-07-01-preview/examples/ServersList.json b/specification/mysql/resource-manager/Microsoft.DBforMySQL/preview/2020-07-01-preview/examples/ServersList.json
new file mode 100644
index 000000000000..4380b5404009
--- /dev/null
+++ b/specification/mysql/resource-manager/Microsoft.DBforMySQL/preview/2020-07-01-preview/examples/ServersList.json
@@ -0,0 +1,83 @@
+{
+  "parameters": {
+    "api-version": "2020-07-01-preview",
+    "subscriptionId": "ffffffff-ffff-ffff-ffff-ffffffffffff"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "sku": {
+              "name": "Standard_D12_v2",
+              "tier": "GeneralPurpose"
+            },
+            "properties": {
+              "administratorLogin": "testuser",
+              "storageProfile": {
+                "storageMB": 5120,
+                "storageIops": 200,
+                "backupRetentionDays": 7
+              },
+              "version": "5.7",
+              "sslEnforcement": "Enabled",
+              "state": "Ready",
+              "fullyQualifiedDomainName": "mysqltestsvc1.mysql.database.azure.com",
+              "publicNetworkAccess": "Enabled"
+            },
+            "location": "westus",
+            "id": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/testrg/providers/Microsoft.DBforMySQL/flexibleServers/mysqltestsvc1",
+            "name": "mysqltestsvc1",
+            "type": "Microsoft.DBforMySQL/flexibleServers"
+          },
+          {
+            "sku": {
+              "name": "Standard_D12_v2",
+              "tier": "GeneralPurpose"
+            },
+            "properties": {
+              "administratorLogin": "testuser",
+              "storageProfile": {
+                "storageMB": 5120,
+                "storageIops": 200,
+                "backupRetentionDays": 7
+              },
+              "version": "5.7",
+              "sslEnforcement": "Enabled",
+              "state": "Ready",
+              "fullyQualifiedDomainName": "mysqltstsvc2.mysql.database.azure.com",
+              "publicNetworkAccess": "Enabled"
+            },
+            "location": "westus",
+            "id": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/testrg/providers/Microsoft.DBforMySQL/flexibleServers/mysqltstsvc2",
+            "name": "mysqltstsvc2",
+            "type": "Microsoft.DBforMySQL/flexibleServers"
+          },
+          {
+            "sku": {
+              "name": "Standard_D13_v2",
+              "tier": "GeneralPurpose"
+            },
+            "properties": {
+              "administratorLogin": "testuser",
+              "storageProfile": {
+                "storageMB": 102400,
+                "storageIops": 200,
+                "backupRetentionDays": 35
+              },
+              "version": "5.7",
+              "sslEnforcement": "Enabled",
+              "state": "Ready",
+              "fullyQualifiedDomainName": "mysqltestsvc3.mysql.database.azure.com",
+              "publicNetworkAccess": "Enabled"
+            },
+            "location": "westus",
+            "id": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/testrg1/providers/Microsoft.DBforMySQL/flexibleServers/mysqltestsvc3",
+            "name": "mysqltestsvc3",
+            "type": "Microsoft.DBforMySQL/flexibleServers"
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/mysql/resource-manager/Microsoft.DBforMySQL/preview/2020-07-01-preview/examples/ServersListByResourceGroup.json b/specification/mysql/resource-manager/Microsoft.DBforMySQL/preview/2020-07-01-preview/examples/ServersListByResourceGroup.json
new file mode 100644
index 000000000000..0dd487649c37
--- /dev/null
+++ b/specification/mysql/resource-manager/Microsoft.DBforMySQL/preview/2020-07-01-preview/examples/ServersListByResourceGroup.json
@@ -0,0 +1,61 @@
+{
+  "parameters": {
+    "resourceGroupName": "testrg",
+    "api-version": "2020-07-01-preview",
+    "subscriptionId": "ffffffff-ffff-ffff-ffff-ffffffffffff"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "sku": {
+              "name": "Standard_D12_v2",
+              "tier": "GeneralPurpose"
+            },
+            "properties": {
+              "administratorLogin": "testuser",
+              "storageProfile": {
+                "storageMB": 5120,
+                "storageIops": 200,
+                "backupRetentionDays": 7
+              },
+              "version": "5.7",
+              "sslEnforcement": "Enabled",
+              "state": "Ready",
+              "fullyQualifiedDomainName": "mysqltestsvc1.mysql.database.azure.com",
+              "publicNetworkAccess": "Enabled"
+            },
+            "location": "westus",
+            "id": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/testrg/providers/Microsoft.DBforMySQL/flexibleServers/mysqltestsvc1",
+            "name": "mysqltestsvc1",
+            "type": "Microsoft.DBforMySQL/flexibleServers"
+          },
+          {
+            "sku": {
+              "name": "Standard_D13_v2",
+              "tier": "GeneralPurpose"
+            },
+            "properties": {
+              "administratorLogin": "testuser",
+              "storageProfile": {
+                "storageMB": 5120,
+                "storageIops": 200,
+                "backupRetentionDays": 7
+              },
+              "version": "5.7",
+              "sslEnforcement": "Enabled",
+              "state": "Ready",
+              "fullyQualifiedDomainName": "mysqltstsvc2.mysql.database.azure.com",
+              "publicNetworkAccess": "Enabled"
+            },
+            "location": "westus",
+            "id": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/testrg/providers/Microsoft.DBforMySQL/flexibleServers/mysqltstsvc2",
+            "name": "mysqltstsvc2",
+            "type": "Microsoft.DBforMySQL/flexibleServers"
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/mysql/resource-manager/Microsoft.DBforMySQL/preview/2020-07-01-preview/mysql.json b/specification/mysql/resource-manager/Microsoft.DBforMySQL/preview/2020-07-01-preview/mysql.json
new file mode 100644
index 000000000000..aae90e29117a
--- /dev/null
+++ b/specification/mysql/resource-manager/Microsoft.DBforMySQL/preview/2020-07-01-preview/mysql.json
@@ -0,0 +1,2484 @@
+{
+  "swagger": "2.0",
+  "info": {
+    "title": "MySQLManagementClient",
+    "description": "The Microsoft Azure management API provides create, read, update, and delete functionality for Azure MySQL resources including servers, databases, firewall rules and configurations.",
+    "version": "2020-07-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.DBForMySql/flexibleServers/{serverName}": {
+      "put": {
+        "tags": [
+          "Servers"
+        ],
+        "operationId": "Servers_Create",
+        "x-ms-examples": {
+          "Create a new server": {
+            "$ref": "./examples/ServerCreate.json"
+          },
+          "Create a server as a point in time restore": {
+            "$ref": "./examples/ServerCreateWithPointInTimeRestore.json"
+          },
+          "Create a replica server": {
+            "$ref": "./examples/ServerCreateReplica.json"
+          }
+        },
+        "description": "Creates a new server or updates an existing server. The update action will overwrite the existing server.",
+        "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": "#/parameters/ServerNameParameter"
+          },
+          {
+            "name": "parameters",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/Server"
+            },
+            "description": "The required parameters for creating or updating a server."
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/Server"
+            }
+          },
+          "201": {
+            "description": "Created",
+            "schema": {
+              "$ref": "#/definitions/Server"
+            }
+          },
+          "202": {
+            "description": "Accepted"
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/CloudError"
+            }
+          }
+        },
+        "x-ms-long-running-operation": true
+      },
+      "patch": {
+        "tags": [
+          "Servers"
+        ],
+        "operationId": "Servers_Update",
+        "x-ms-examples": {
+          "Update a server": {
+            "$ref": "./examples/ServerUpdate.json"
+          },
+          "Update server customer maintenance window": {
+            "$ref": "./examples/ServerUpdateWithCustomerMaintenanceWindow.json"
+          }
+        },
+        "description": "Updates an existing server. The request body can contain one to many of the properties present in the normal server definition.",
+        "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": "#/parameters/ServerNameParameter"
+          },
+          {
+            "name": "parameters",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/ServerForUpdate"
+            },
+            "description": "The required parameters for updating a server."
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/Server"
+            }
+          },
+          "202": {
+            "description": "Accepted"
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/CloudError"
+            }
+          }
+        },
+        "x-ms-long-running-operation": true
+      },
+      "delete": {
+        "tags": [
+          "Servers"
+        ],
+        "operationId": "Servers_Delete",
+        "x-ms-examples": {
+          "Delete a server": {
+            "$ref": "./examples/ServerDelete.json"
+          }
+        },
+        "description": "Deletes a server.",
+        "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": "#/parameters/ServerNameParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK"
+          },
+          "202": {
+            "description": "Accepted"
+          },
+          "204": {
+            "description": "NoContent"
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/CloudError"
+            }
+          }
+        },
+        "x-ms-long-running-operation": true
+      },
+      "get": {
+        "tags": [
+          "Servers"
+        ],
+        "operationId": "Servers_Get",
+        "x-ms-examples": {
+          "Get a server": {
+            "$ref": "./examples/ServerGet.json"
+          },
+          "Get a server with vnet": {
+            "$ref": "./examples/ServerGetWithVnet.json"
+          }
+        },
+        "description": "Gets information about a server.",
+        "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": "#/parameters/ServerNameParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/Server"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/CloudError"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBForMySql/flexibleServers": {
+      "get": {
+        "tags": [
+          "Servers"
+        ],
+        "operationId": "Servers_ListByResourceGroup",
+        "x-ms-examples": {
+          "List servers in a resource group": {
+            "$ref": "./examples/ServersListByResourceGroup.json"
+          }
+        },
+        "description": "List all the servers in a given resource group.",
+        "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/ServerListResult"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/CloudError"
+            }
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/providers/Microsoft.DBForMySql/flexibleServers": {
+      "get": {
+        "tags": [
+          "Servers"
+        ],
+        "operationId": "Servers_List",
+        "x-ms-examples": {
+          "List servers in a subscription": {
+            "$ref": "./examples/ServersList.json"
+          }
+        },
+        "description": "List all the servers in a given subscription.",
+        "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/ServerListResult"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/CloudError"
+            }
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBForMySql/flexibleServers/{serverName}/restart": {
+      "post": {
+        "tags": [
+          "ServerRestart"
+        ],
+        "operationId": "Servers_Restart",
+        "x-ms-examples": {
+          "Restart a server": {
+            "$ref": "./examples/ServerRestart.json"
+          }
+        },
+        "description": "Restarts a server.",
+        "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": "#/parameters/ServerNameParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK"
+          },
+          "202": {
+            "description": "Accepted"
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/CloudError"
+            }
+          }
+        },
+        "x-ms-long-running-operation": true
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBForMySql/flexibleServers/{serverName}/start": {
+      "post": {
+        "tags": [
+          "ServerStart"
+        ],
+        "operationId": "Servers_Start",
+        "x-ms-examples": {
+          "Start a server": {
+            "$ref": "./examples/ServerStart.json"
+          }
+        },
+        "description": "Starts a server.",
+        "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": "#/parameters/ServerNameParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK"
+          },
+          "202": {
+            "description": "Accepted"
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/CloudError"
+            }
+          }
+        },
+        "x-ms-long-running-operation": true
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBForMySql/flexibleServers/{serverName}/stop": {
+      "post": {
+        "tags": [
+          "ServerStop"
+        ],
+        "operationId": "Servers_Stop",
+        "x-ms-examples": {
+          "Stop a server": {
+            "$ref": "./examples/ServerStop.json"
+          }
+        },
+        "description": "Stops a server.",
+        "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": "#/parameters/ServerNameParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK"
+          },
+          "202": {
+            "description": "Accepted"
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/CloudError"
+            }
+          }
+        },
+        "x-ms-long-running-operation": true
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBForMySql/flexibleServers/{serverName}/replicas": {
+      "get": {
+        "tags": [
+          "Servers"
+        ],
+        "operationId": "Replicas_ListByServer",
+        "x-ms-examples": {
+          "List replicas for a server": {
+            "$ref": "./examples/ReplicasListByServer.json"
+          }
+        },
+        "description": "List all the replicas for a given server.",
+        "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": "#/parameters/ServerNameParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/ServerListResult"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/CloudError"
+            }
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBForMySql/flexibleServers/{serverName}/keys/{keyName}": {
+      "put": {
+        "tags": [
+          "ServerKeys"
+        ],
+        "operationId": "ServerKeys_CreateOrUpdate",
+        "x-ms-examples": {
+          "Creates or updates a MySQL Server key": {
+            "$ref": "./examples/ServerKeyCreate.json"
+          }
+        },
+        "description": "Creates or updates a MySQL Server key.",
+        "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": "#/parameters/ServerNameParameter"
+          },
+          {
+            "$ref": "#/parameters/KeyNameParameter"
+          },
+          {
+            "name": "parameters",
+            "in": "body",
+            "description": "The requested MySQL Server key resource state.",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/ServerKey"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/ServerKey"
+            }
+          },
+          "201": {
+            "description": "Created",
+            "schema": {
+              "$ref": "#/definitions/ServerKey"
+            }
+          },
+          "202": {
+            "description": "Accepted"
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/CloudError"
+            }
+          }
+        },
+        "x-ms-long-running-operation": true
+      },
+      "delete": {
+        "tags": [
+          "ServerKeys"
+        ],
+        "operationId": "ServerKeys_Delete",
+        "x-ms-examples": {
+          "Delete the MySQL Server key": {
+            "$ref": "./examples/ServerKeyDelete.json"
+          }
+        },
+        "description": "Deletes the MySQL Server key with the given name.",
+        "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": "#/parameters/ServerNameParameter"
+          },
+          {
+            "$ref": "#/parameters/KeyNameParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK"
+          },
+          "202": {
+            "description": "Accepted"
+          },
+          "204": {
+            "description": "NoContent"
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/CloudError"
+            }
+          }
+        },
+        "x-ms-long-running-operation": true
+      },
+      "get": {
+        "tags": [
+          "ServerKeys"
+        ],
+        "operationId": "ServerKeys_Get",
+        "x-ms-examples": {
+          "Get a server key": {
+            "$ref": "./examples/ServerKeyGet.json"
+          }
+        },
+        "description": "Gets a server key.",
+        "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": "#/parameters/ServerNameParameter"
+          },
+          {
+            "$ref": "#/parameters/KeyNameParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/ServerKey"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/CloudError"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBForMySql/flexibleServers/{serverName}/keys": {
+      "get": {
+        "tags": [
+          "ServerKeys"
+        ],
+        "operationId": "ServerKeys_ListByServer",
+        "x-ms-examples": {
+          "List the keys for a server.": {
+            "$ref": "./examples/ServerKeysListByServer.json"
+          }
+        },
+        "description": "Gets a list of  Server keys.",
+        "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": "#/parameters/ServerNameParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/ServerKeyListResult"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/CloudError"
+            }
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBForMySql/flexibleServers/{serverName}/firewallRules/{firewallRuleName}": {
+      "put": {
+        "tags": [
+          "FirewallRules"
+        ],
+        "operationId": "FirewallRules_CreateOrUpdate",
+        "x-ms-examples": {
+          "Create a firewall rule": {
+            "$ref": "./examples/FirewallRuleCreate.json"
+          }
+        },
+        "description": "Creates a new firewall rule or updates an existing firewall rule.",
+        "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": "#/parameters/ServerNameParameter"
+          },
+          {
+            "$ref": "#/parameters/FirewallRuleNameParameter"
+          },
+          {
+            "name": "parameters",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/FirewallRule"
+            },
+            "description": "The required parameters for creating or updating a firewall rule."
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/FirewallRule"
+            }
+          },
+          "201": {
+            "description": "Created",
+            "schema": {
+              "$ref": "#/definitions/FirewallRule"
+            }
+          },
+          "202": {
+            "description": "Accepted"
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/CloudError"
+            }
+          }
+        },
+        "x-ms-long-running-operation": true
+      },
+      "delete": {
+        "tags": [
+          "FirewallRules"
+        ],
+        "operationId": "FirewallRules_Delete",
+        "x-ms-examples": {
+          "Delete a firewall rule": {
+            "$ref": "./examples/FirewallRuleDelete.json"
+          }
+        },
+        "description": "Deletes a firewall rule.",
+        "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": "#/parameters/ServerNameParameter"
+          },
+          {
+            "$ref": "#/parameters/FirewallRuleNameParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK"
+          },
+          "202": {
+            "description": "Accepted"
+          },
+          "204": {
+            "description": "NoContent"
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/CloudError"
+            }
+          }
+        },
+        "x-ms-long-running-operation": true
+      },
+      "get": {
+        "tags": [
+          "FirewallRules"
+        ],
+        "operationId": "FirewallRules_Get",
+        "x-ms-examples": {
+          "Get a firewall rule": {
+            "$ref": "./examples/FirewallRuleGet.json"
+          }
+        },
+        "description": "Gets information about a server firewall rule.",
+        "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": "#/parameters/ServerNameParameter"
+          },
+          {
+            "$ref": "#/parameters/FirewallRuleNameParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/FirewallRule"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/CloudError"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBForMySql/flexibleServers/{serverName}/firewallRules": {
+      "get": {
+        "tags": [
+          "FirewallRules"
+        ],
+        "operationId": "FirewallRules_ListByServer",
+        "x-ms-examples": {
+          "List all firewall rules in a server": {
+            "$ref": "./examples/FirewallRulesListByServer.json"
+          }
+        },
+        "description": "List all the firewall rules in a given server.",
+        "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": "#/parameters/ServerNameParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/FirewallRuleListResult"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/CloudError"
+            }
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBForMySql/flexibleServers/{serverName}/databases/{databaseName}": {
+      "put": {
+        "tags": [
+          "Databases"
+        ],
+        "operationId": "Databases_CreateOrUpdate",
+        "x-ms-examples": {
+          "Create a database": {
+            "$ref": "./examples/DatabaseCreate.json"
+          }
+        },
+        "description": "Creates a new database or updates an existing database.",
+        "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": "#/parameters/ServerNameParameter"
+          },
+          {
+            "$ref": "#/parameters/DatabaseNameParameter"
+          },
+          {
+            "name": "parameters",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/Database"
+            },
+            "description": "The required parameters for creating or updating a database."
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/Database"
+            }
+          },
+          "201": {
+            "description": "Created",
+            "schema": {
+              "$ref": "#/definitions/Database"
+            }
+          },
+          "202": {
+            "description": "Accepted"
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/CloudError"
+            }
+          }
+        },
+        "x-ms-long-running-operation": true
+      },
+      "delete": {
+        "tags": [
+          "Databases"
+        ],
+        "operationId": "Databases_Delete",
+        "x-ms-examples": {
+          "Delete a database": {
+            "$ref": "./examples/DatabaseDelete.json"
+          }
+        },
+        "description": "Deletes a database.",
+        "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": "#/parameters/ServerNameParameter"
+          },
+          {
+            "$ref": "#/parameters/DatabaseNameParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK"
+          },
+          "202": {
+            "description": "Accepted"
+          },
+          "204": {
+            "description": "NoContent"
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/CloudError"
+            }
+          }
+        },
+        "x-ms-long-running-operation": true
+      },
+      "get": {
+        "tags": [
+          "Databases"
+        ],
+        "operationId": "Databases_Get",
+        "x-ms-examples": {
+          "Get a database": {
+            "$ref": "./examples/DatabaseGet.json"
+          }
+        },
+        "description": "Gets information about a database.",
+        "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": "#/parameters/ServerNameParameter"
+          },
+          {
+            "$ref": "#/parameters/DatabaseNameParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/Database"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/CloudError"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBForMySql/flexibleServers/{serverName}/databases": {
+      "get": {
+        "tags": [
+          "Databases"
+        ],
+        "operationId": "Databases_ListByServer",
+        "x-ms-examples": {
+          "List databases in a server": {
+            "$ref": "./examples/DatabasesListByServer.json"
+          }
+        },
+        "description": "List all the databases in a given server.",
+        "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": "#/parameters/ServerNameParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/DatabaseListResult"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/CloudError"
+            }
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBForMySql/flexibleServers/{serverName}/configurations/{configurationName}": {
+      "patch": {
+        "tags": [
+          "Configurations"
+        ],
+        "operationId": "Configurations_Update",
+        "x-ms-examples": {
+          "Update a user configuration": {
+            "$ref": "./examples/ConfigurationUpdate.json"
+          }
+        },
+        "description": "Updates a configuration of a server.",
+        "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": "#/parameters/ServerNameParameter"
+          },
+          {
+            "$ref": "#/parameters/ConfigurationNameParameter"
+          },
+          {
+            "name": "parameters",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/Configuration"
+            },
+            "description": "The required parameters for updating a server configuration."
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/Configuration"
+            }
+          },
+          "202": {
+            "description": "Accepted"
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/CloudError"
+            }
+          }
+        },
+        "x-ms-long-running-operation": true
+      },
+      "get": {
+        "tags": [
+          "Configurations"
+        ],
+        "operationId": "Configurations_Get",
+        "x-ms-examples": {
+          "Get a configuration": {
+            "$ref": "./examples/ConfigurationGet.json"
+          }
+        },
+        "description": "Gets information about a configuration of server.",
+        "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": "#/parameters/ServerNameParameter"
+          },
+          {
+            "$ref": "#/parameters/ConfigurationNameParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/Configuration"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/CloudError"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBForMySql/flexibleServers/{serverName}/configurations": {
+      "get": {
+        "tags": [
+          "Configurations"
+        ],
+        "operationId": "Configurations_ListByServer",
+        "x-ms-examples": {
+          "List all configurations for a server": {
+            "$ref": "./examples/ConfigurationsListByServer.json"
+          }
+        },
+        "description": "List all the configurations in a given server.",
+        "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": "#/parameters/ServerNameParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/ConfigurationListResult"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/CloudError"
+            }
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/providers/Microsoft.DBForMySql/locations/{locationName}/capabilities": {
+      "get": {
+        "tags": [
+          "LocationBasedCapabilities"
+        ],
+        "operationId": "LocationBasedCapabilities_List",
+        "x-ms-examples": {
+          "CapabilitiesList": {
+            "$ref": "./examples/CapabilitiesByLocationList.json"
+          }
+        },
+        "description": "Get capabilities at specified location in a given subscription.",
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/LocationNameParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/CapabilitiesListResult"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/CloudError"
+            }
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/providers/Microsoft.DBForMySql/locations/{locationName}/checkVirtualNetworkSubnetUsage": {
+      "post": {
+        "tags": [
+          "CheckVirtualNetworkSubnetUsage"
+        ],
+        "operationId": "CheckVirtualNetworkSubnetUsage_Execute",
+        "x-ms-examples": {
+          "CapabilitiesList": {
+            "$ref": "./examples/CheckVirtualNetworkSubnetUsage.json"
+          }
+        },
+        "description": "Get virtual network subnet usage for a given vNet resource id.",
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/LocationNameParameter"
+          },
+          {
+            "name": "parameters",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/VirtualNetworkSubnetUsageParameter"
+            },
+            "description": "The required parameters for creating or updating a server."
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/VirtualNetworkSubnetUsageResult"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/CloudError"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/providers/Microsoft.DBForMySql/checkNameAvailability": {
+      "post": {
+        "tags": [
+          "CheckNameAvailability"
+        ],
+        "operationId": "CheckNameAvailability_Execute",
+        "x-ms-examples": {
+          "Check name availability": {
+            "$ref": "./examples/CheckNameAvailability.json"
+          }
+        },
+        "description": "Check the availability of name for server",
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "name": "nameAvailabilityRequest",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/NameAvailabilityRequest"
+            },
+            "description": "The required parameters for checking if server name is available."
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/NameAvailability"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/CloudError"
+            }
+          }
+        }
+      }
+    },
+    "/providers/Microsoft.DBForMySql/operations": {
+      "get": {
+        "tags": [
+          "Operations"
+        ],
+        "operationId": "Operations_List",
+        "x-ms-examples": {
+          "OperationList": {
+            "$ref": "./examples/OperationsList.json"
+          }
+        },
+        "description": "Lists all of the available REST API operations.",
+        "parameters": [
+          {
+            "$ref": "../../../../../common-types/resource-management/v1/types.json#/parameters/ApiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/OperationListResult"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/CloudError"
+            }
+          }
+        }
+      }
+    }
+  },
+  "definitions": {
+    "ServerVersion": {
+      "type": "string",
+      "description": "The version of a server.",
+      "enum": [
+        "5.7"
+      ],
+      "x-ms-enum": {
+        "name": "ServerVersion",
+        "modelAsString": true
+      }
+    },
+    "SslEnforcement": {
+      "type": "string",
+      "description": "Enable ssl enforcement or not when connect to server.",
+      "enum": [
+        "Enabled",
+        "Disabled"
+      ],
+      "x-ms-enum": {
+        "name": "SslEnforcementEnum",
+        "modelAsString": true
+      }
+    },
+    "InfrastructureEncryption": {
+      "type": "string",
+      "description": "Add a second layer of encryption for your data using new encryption algorithm which gives additional data protection. Value is optional but if passed in, must be 'Disabled' or 'Enabled'.",
+      "enum": [
+        "Enabled",
+        "Disabled"
+      ],
+      "x-ms-enum": {
+        "name": "InfrastructureEncryptionEnum",
+        "modelAsString": true
+      }
+    },
+    "PublicNetworkAccess": {
+      "type": "string",
+      "description": "Whether or not public network access is allowed for this server. Value is optional but if passed in, must be 'Enabled' or 'Disabled'",
+      "enum": [
+        "Enabled",
+        "Disabled"
+      ],
+      "x-ms-enum": {
+        "name": "PublicNetworkAccessEnum",
+        "modelAsString": true
+      }
+    },
+    "HaEnabled": {
+      "type": "string",
+      "description": "Whether or not HA is enabled for this server. Value is optional but if passed in, must be 'Enabled' or 'Disabled'",
+      "enum": [
+        "Enabled",
+        "Disabled"
+      ],
+      "x-ms-enum": {
+        "name": "HaEnabledEnum",
+        "modelAsString": true
+      }
+    },
+    "DelegatedSubnetArguments": {
+      "properties": {
+        "subnetArmResourceId": {
+          "type": "string",
+          "description": "delegated subnet arm resource id."
+        }
+      },
+      "description": "Delegated subnet arguments of a server"
+    },
+    "MaintenanceWindow": {
+      "type": "object",
+      "description": "Maintenance window of a server.",
+      "properties": {
+        "customWindow": {
+          "type": "string",
+          "description": "indicates whether custom window is enabled or disabled"
+        },
+        "startHour": {
+          "type": "integer",
+          "format": "int32",
+          "description": "start hour for maintenance window"
+        },
+        "startMinute": {
+          "type": "integer",
+          "format": "int32",
+          "description": "start minute for maintenance window"
+        },
+        "dayOfWeek": {
+          "type": "integer",
+          "format": "int32",
+          "description": "day of week for maintenance window"
+        }
+      }
+    },
+    "StorageProfile": {
+      "properties": {
+        "backupRetentionDays": {
+          "type": "integer",
+          "format": "int32",
+          "description": "Backup retention days for the server."
+        },
+        "storageMB": {
+          "type": "integer",
+          "format": "int32",
+          "description": "Max storage allowed for a server."
+        },
+        "storageIops": {
+          "type": "integer",
+          "format": "int32",
+          "description": "Storage IOPS for a server."
+        },
+        "storageAutogrow": {
+          "type": "string",
+          "description": "Enable Storage Auto Grow.",
+          "enum": [
+            "Enabled",
+            "Disabled"
+          ],
+          "x-ms-enum": {
+            "name": "StorageAutogrow",
+            "modelAsString": true
+          }
+        }
+      },
+      "description": "Storage Profile properties of a server"
+    },
+    "Sku": {
+      "properties": {
+        "name": {
+          "type": "string",
+          "description": "The name of the sku, e.g. Standard_D32s_v3."
+        },
+        "tier": {
+          "type": "string",
+          "description": "The tier of the particular SKU, e.g. GeneralPurpose.",
+          "enum": [
+            "Burstable",
+            "GeneralPurpose",
+            "MemoryOptimized"
+          ],
+          "x-ms-enum": {
+            "name": "SkuTier",
+            "modelAsString": true
+          }
+        }
+      },
+      "required": [
+        "name",
+        "tier"
+      ],
+      "description": "Billing information related properties of a server."
+    },
+    "ServerProperties": {
+      "properties": {
+        "administratorLogin": {
+          "type": "string",
+          "description": "The administrator's login name of a server. Can only be specified when the server is being created (and is required for creation).",
+          "x-ms-mutability": [
+            "create",
+            "read"
+          ]
+        },
+        "administratorLoginPassword": {
+          "type": "string",
+          "x-ms-secret": true,
+          "format": "password",
+          "description": "The password of the administrator login (required for server creation).",
+          "x-ms-mutability": [
+            "create",
+            "update"
+          ]
+        },
+        "version": {
+          "$ref": "#/definitions/ServerVersion",
+          "description": "Server version."
+        },
+        "sslEnforcement": {
+          "$ref": "#/definitions/SslEnforcement",
+          "description": "Enable ssl enforcement or not when connect to server."
+        },
+        "infrastructureEncryption": {
+          "$ref": "#/definitions/InfrastructureEncryption",
+          "description": "Status showing whether the server enabled infrastructure encryption.",
+          "x-ms-mutability": [
+            "create"
+          ]
+        },
+        "state": {
+          "type": "string",
+          "readOnly": true,
+          "description": "The state of a server.",
+          "enum": [
+            "Ready",
+            "Dropping",
+            "Disabled",
+            "Starting",
+            "Stopping",
+            "Stopped",
+            "Updating"
+          ],
+          "x-ms-enum": {
+            "name": "ServerState",
+            "modelAsString": true
+          }
+        },
+        "haState": {
+          "type": "string",
+          "readOnly": true,
+          "description": "The state of a HA server.",
+          "enum": [
+            "NotEnabled",
+            "CreatingStandby",
+            "ReplicatingData",
+            "FailingOver",
+            "Healthy",
+            "RemovingStandby"
+          ],
+          "x-ms-enum": {
+            "name": "ServerHAState",
+            "modelAsString": true
+          }
+        },
+        "haEnabled": {
+          "$ref": "#/definitions/HaEnabled",
+          "description": "Enable HA or not for a server."
+        },
+        "fullyQualifiedDomainName": {
+          "type": "string",
+          "description": "The fully qualified domain name of a server.",
+          "readOnly": true
+        },
+        "earliestRestoreDate": {
+          "type": "string",
+          "format": "date-time",
+          "readOnly": true,
+          "description": "Earliest restore point creation time (ISO8601 format)"
+        },
+        "storageProfile": {
+          "$ref": "#/definitions/StorageProfile",
+          "description": "Storage profile of a server."
+        },
+        "replicationRole": {
+          "type": "string",
+          "description": "The replication role."
+        },
+        "replicaCapacity": {
+          "type": "integer",
+          "format": "int32",
+          "minimum": 0,
+          "readOnly": true,
+          "description": "The maximum number of replicas that a primary server can have."
+        },
+        "publicNetworkAccess": {
+          "$ref": "#/definitions/PublicNetworkAccess",
+          "readOnly": true,
+          "description": "Whether or not public network access is allowed for this server. Value is optional but if passed in, must be 'Enabled' or 'Disabled'"
+        },
+        "maintenanceWindow": {
+          "$ref": "#/definitions/MaintenanceWindow",
+          "description": "Maintenance window of a server."
+        },
+        "sourceServerId": {
+          "type": "string",
+          "description": "The source MySQL server id.",
+          "x-ms-mutability": [
+            "create",
+            "read"
+          ]
+        },
+        "restorePointInTime": {
+          "type": "string",
+          "format": "date-time",
+          "description": "Restore point creation time (ISO8601 format), specifying the time to restore from.",
+          "x-ms-mutability": [
+            "create"
+          ]
+        },
+        "availabilityZone": {
+          "type": "string",
+          "description": "availability Zone information of the server."
+        },
+        "standbyAvailabilityZone": {
+          "type": "string",
+          "description": "availability Zone information of the server.",
+          "readOnly": true
+        },
+        "byokEnforcement": {
+          "type": "string",
+          "description": "Status showing whether the data encryption is enabled with customer-managed keys.",
+          "readOnly": true
+        },
+        "delegatedSubnetArguments": {
+          "$ref": "#/definitions/DelegatedSubnetArguments",
+          "description": "Delegated subnet arguments."
+        },
+        "createMode": {
+          "type": "string",
+          "description": "The mode to create a new MySQL server.",
+          "enum": [
+            "Default",
+            "PointInTimeRestore",
+            "Replica"
+          ],
+          "x-ms-enum": {
+            "name": "CreateMode",
+            "modelAsString": true
+          },
+          "x-ms-mutability": [
+            "create"
+          ]
+        },
+        "tags": {
+          "type": "object",
+          "additionalProperties": {
+            "type": "string"
+          },
+          "description": "Application-specific metadata in the form of key-value pairs."
+        }
+      },
+      "description": "The properties of a server."
+    },
+    "Server": {
+      "properties": {
+        "identity": {
+          "$ref": "../../../../../common-types/resource-management/v1/types.json#/definitions/Identity",
+          "description": "The Azure Active Directory identity of the server."
+        },
+        "sku": {
+          "$ref": "#/definitions/Sku",
+          "description": "The SKU (pricing tier) of the server."
+        },
+        "properties": {
+          "$ref": "#/definitions/ServerProperties",
+          "x-ms-client-flatten": true,
+          "description": "Properties of the server."
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "../../../../../common-types/resource-management/v1/types.json#/definitions/TrackedResource"
+        }
+      ],
+      "description": "Represents a server."
+    },
+    "ServerPropertiesForUpdate": {
+      "properties": {
+        "storageProfile": {
+          "$ref": "#/definitions/StorageProfile",
+          "description": "Storage profile of a server."
+        },
+        "administratorLoginPassword": {
+          "type": "string",
+          "x-ms-secret": true,
+          "format": "password",
+          "description": "The password of the administrator login."
+        },
+        "sslEnforcement": {
+          "$ref": "#/definitions/SslEnforcement",
+          "description": "Enable ssl enforcement or not when connect to server."
+        },
+        "delegatedSubnetArguments": {
+          "$ref": "#/definitions/DelegatedSubnetArguments",
+          "description": "Delegated subnet arguments."
+        },
+        "haEnabled": {
+          "$ref": "#/definitions/HaEnabled",
+          "description": "Enable HA or not for a server."
+        },
+        "maintenanceWindow": {
+          "$ref": "#/definitions/MaintenanceWindow",
+          "description": "Maintenance window of a server."
+        },
+        "replicationRole": {
+          "type": "string",
+          "description": "The replication role of the server."
+        }
+      },
+      "description": "The properties that can be updated for a server."
+    },
+    "ServerForUpdate": {
+      "properties": {
+        "sku": {
+          "$ref": "#/definitions/Sku",
+          "description": "The SKU (pricing tier) of the server."
+        },
+        "properties": {
+          "$ref": "#/definitions/ServerPropertiesForUpdate",
+          "x-ms-client-flatten": true,
+          "description": "The properties that can be updated for a server."
+        },
+        "tags": {
+          "type": "object",
+          "additionalProperties": {
+            "type": "string"
+          },
+          "description": "Application-specific metadata in the form of key-value pairs."
+        }
+      },
+      "description": "Parameters allowed to update for a server."
+    },
+    "ServerListResult": {
+      "type": "object",
+      "properties": {
+        "value": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/Server"
+          },
+          "description": "The list of servers"
+        },
+        "nextLink": {
+          "description": "The link used to get the next page of operations.",
+          "type": "string"
+        }
+      },
+      "description": "A list of servers."
+    },
+    "ServerKeyProperties": {
+      "description": "Properties for a key execution.",
+      "required": [
+        "serverKeyType"
+      ],
+      "type": "object",
+      "properties": {
+        "serverKeyType": {
+          "description": "The key type like 'AzureKeyVault'.",
+          "enum": [
+            "AzureKeyVault"
+          ],
+          "type": "string",
+          "x-ms-enum": {
+            "name": "ServerKeyType",
+            "modelAsString": true
+          }
+        },
+        "uri": {
+          "description": "The URI of the key.",
+          "type": "string"
+        },
+        "creationDate": {
+          "format": "date-time",
+          "description": "The key creation date.",
+          "type": "string",
+          "readOnly": true
+        }
+      }
+    },
+    "ServerKey": {
+      "description": "A MySQL Server key.",
+      "type": "object",
+      "allOf": [
+        {
+          "$ref": "../../../../../common-types/resource-management/v1/types.json#/definitions/ProxyResource"
+        }
+      ],
+      "properties": {
+        "kind": {
+          "description": "Kind of encryption protector used to protect the key.",
+          "type": "string",
+          "readOnly": true
+        },
+        "properties": {
+          "$ref": "#/definitions/ServerKeyProperties",
+          "description": "Properties of the ServerKey Resource.",
+          "x-ms-client-flatten": true
+        }
+      }
+    },
+    "ServerKeyListResult": {
+      "description": "A list of MySQL Server keys.",
+      "type": "object",
+      "properties": {
+        "value": {
+          "description": "A list of MySQL Server keys.",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/ServerKey"
+          },
+          "readOnly": true
+        },
+        "nextLink": {
+          "description": "Link to retrieve next page of results.",
+          "type": "string",
+          "readOnly": true
+        }
+      }
+    },
+    "FirewallRuleProperties": {
+      "properties": {
+        "startIpAddress": {
+          "type": "string",
+          "pattern": "^(([0-9]|[1-9][0-9]|1[0-9]{2}|2[0-4][0-9]|25[0-5])\\.){3}([0-9]|[1-9][0-9]|1[0-9]{2}|2[0-4][0-9]|25[0-5])$",
+          "description": "The start IP address of the server firewall rule. Must be IPv4 format."
+        },
+        "endIpAddress": {
+          "type": "string",
+          "pattern": "^(([0-9]|[1-9][0-9]|1[0-9]{2}|2[0-4][0-9]|25[0-5])\\.){3}([0-9]|[1-9][0-9]|1[0-9]{2}|2[0-4][0-9]|25[0-5])$",
+          "description": "The end IP address of the server firewall rule. Must be IPv4 format."
+        }
+      },
+      "required": [
+        "startIpAddress",
+        "endIpAddress"
+      ],
+      "description": "The properties of a server firewall rule."
+    },
+    "FirewallRule": {
+      "properties": {
+        "properties": {
+          "$ref": "#/definitions/FirewallRuleProperties",
+          "x-ms-client-flatten": true,
+          "description": "The properties of a firewall rule."
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "../../../../../common-types/resource-management/v1/types.json#/definitions/ProxyResource"
+        }
+      ],
+      "required": [
+        "properties"
+      ],
+      "description": "Represents a server firewall rule."
+    },
+    "FirewallRuleListResult": {
+      "type": "object",
+      "properties": {
+        "value": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/FirewallRule"
+          },
+          "description": "The list of firewall rules in a server."
+        },
+        "nextLink": {
+          "description": "The link used to get the next page of operations.",
+          "type": "string"
+        }
+      },
+      "description": "A list of firewall rules."
+    },
+    "DatabaseProperties": {
+      "properties": {
+        "charset": {
+          "type": "string",
+          "description": "The charset of the database."
+        },
+        "collation": {
+          "type": "string",
+          "description": "The collation of the database."
+        }
+      },
+      "description": "The properties of a database."
+    },
+    "Database": {
+      "properties": {
+        "properties": {
+          "$ref": "#/definitions/DatabaseProperties",
+          "x-ms-client-flatten": true,
+          "description": "The properties of a database."
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "../../../../../common-types/resource-management/v1/types.json#/definitions/ProxyResource"
+        }
+      ],
+      "description": "Represents a Database."
+    },
+    "DatabaseListResult": {
+      "type": "object",
+      "properties": {
+        "value": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/Database"
+          },
+          "description": "The list of databases housed in a server"
+        },
+        "nextLink": {
+          "description": "The link used to get the next page of operations.",
+          "type": "string"
+        }
+      },
+      "description": "A List of databases."
+    },
+    "ConfigurationProperties": {
+      "properties": {
+        "value": {
+          "type": "string",
+          "description": "Value of the configuration."
+        },
+        "description": {
+          "type": "string",
+          "readOnly": true,
+          "description": "Description of the configuration."
+        },
+        "defaultValue": {
+          "type": "string",
+          "readOnly": true,
+          "description": "Default value of the configuration."
+        },
+        "dataType": {
+          "type": "string",
+          "readOnly": true,
+          "description": "Data type of the configuration."
+        },
+        "allowedValues": {
+          "type": "string",
+          "readOnly": true,
+          "description": "Allowed values of the configuration."
+        },
+        "source": {
+          "type": "string",
+          "description": "Source of the configuration."
+        },
+        "isReadOnly": {
+          "type": "string",
+          "readOnly": true,
+          "description": "If is the configuration read only.",
+          "enum": [
+            "True",
+            "False"
+          ],
+          "x-ms-enum": {
+            "name": "IsReadOnly",
+            "modelAsString": true
+          }
+        },
+        "isConfigPendingRestart": {
+          "type": "string",
+          "readOnly": true,
+          "description": "If is the configuration pending restart or not.",
+          "enum": [
+            "True",
+            "False"
+          ],
+          "x-ms-enum": {
+            "name": "IsConfigPendingRestart",
+            "modelAsString": true
+          }
+        },
+        "isDynamicConfig": {
+          "type": "string",
+          "readOnly": true,
+          "description": "If is the configuration dynamic.",
+          "enum": [
+            "True",
+            "False"
+          ],
+          "x-ms-enum": {
+            "name": "IsDynamicConfig",
+            "modelAsString": true
+          }
+        }
+      },
+      "description": "The properties of a configuration."
+    },
+    "Configuration": {
+      "properties": {
+        "properties": {
+          "$ref": "#/definitions/ConfigurationProperties",
+          "x-ms-client-flatten": true,
+          "description": "The properties of a configuration."
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "../../../../../common-types/resource-management/v1/types.json#/definitions/ProxyResource"
+        }
+      ],
+      "description": "Represents a Configuration."
+    },
+    "ConfigurationListResult": {
+      "type": "object",
+      "properties": {
+        "value": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/Configuration"
+          },
+          "description": "The list of server configurations."
+        },
+        "nextLink": {
+          "description": "The link used to get the next page of operations.",
+          "type": "string"
+        }
+      },
+      "description": "A list of server configurations."
+    },
+    "VirtualNetworkSubnetUsageParameter": {
+      "type": "object",
+      "properties": {
+        "virtualNetworkArmResourceId": {
+          "type": "string",
+          "description": "Virtual network resource id."
+        }
+      },
+      "description": "Virtual network subnet usage parameter"
+    },
+    "DelegatedSubnetUsage": {
+      "type": "object",
+      "properties": {
+        "subnetName": {
+          "type": "string",
+          "readOnly": true,
+          "description": "name of the subnet"
+        },
+        "usage": {
+          "type": "integer",
+          "format": "int64",
+          "readOnly": true,
+          "description": "Number of used delegated subnets"
+        }
+      },
+      "description": "Delegated subnet usage data."
+    },
+    "VirtualNetworkSubnetUsageResult": {
+      "type": "object",
+      "properties": {
+        "delegatedSubnetsUsage": {
+          "description": "A list of delegated subnet usage",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/DelegatedSubnetUsage"
+          },
+          "readOnly": true
+        }
+      },
+      "description": "Virtual network subnet usage data."
+    },
+    "StorageMBCapability": {
+      "type": "object",
+      "properties": {
+        "name": {
+          "type": "string",
+          "description": "storage MB name",
+          "readOnly": true
+        },
+        "storageSizeMB": {
+          "type": "integer",
+          "format": "int64",
+          "description": "storage size in MB",
+          "readOnly": true
+        }
+      },
+      "description": "storage size in MB capability"
+    },
+    "VcoreCapability": {
+      "type": "object",
+      "properties": {
+        "name": {
+          "type": "string",
+          "description": "vCore name",
+          "readOnly": true
+        },
+        "vCores": {
+          "type": "integer",
+          "format": "int64",
+          "description": "supported vCores",
+          "readOnly": true
+        },
+        "supportedIops": {
+          "type": "integer",
+          "format": "int64",
+          "description": "supported IOPS",
+          "readOnly": true
+        },
+        "supportedMemoryPerVcoreMB": {
+          "type": "integer",
+          "format": "int64",
+          "description": "supported memory per vCore in MB",
+          "readOnly": true
+        }
+      },
+      "description": "Vcores capability"
+    },
+    "ServerVersionCapability": {
+      "type": "object",
+      "properties": {
+        "name": {
+          "type": "string",
+          "description": "server version",
+          "readOnly": true
+        },
+        "supportedVcores": {
+          "description": "A list of supported Vcores",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/VcoreCapability"
+          },
+          "readOnly": true
+        }
+      },
+      "description": "Server version capabilities."
+    },
+    "StorageEditionCapability": {
+      "properties": {
+        "name": {
+          "type": "string",
+          "description": "storage edition name",
+          "readOnly": true
+        },
+        "minStorageSize": {
+          "description": "The minimal supported storage size in MB",
+          "$ref": "#/definitions/StorageMBCapability",
+          "readOnly": true
+        },
+        "maxStorageSize": {
+          "description": "The maximum supported storage size in MB",
+          "$ref": "#/definitions/StorageMBCapability",
+          "readOnly": true
+        },
+        "minBackupRetentionDays": {
+          "type": "integer",
+          "format": "int64",
+          "description": "Minimal backup retention days",
+          "readOnly": true
+        },
+        "maxBackupRetentionDays": {
+          "type": "integer",
+          "format": "int64",
+          "description": "Maximum backup retention days",
+          "readOnly": true
+        }
+      },
+      "description": "storage edition capability"
+    },
+    "ServerEditionCapability": {
+      "properties": {
+        "name": {
+          "type": "string",
+          "description": "Server edition name",
+          "readOnly": true
+        },
+        "supportedStorageEditions": {
+          "description": "A list of supported storage editions",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/StorageEditionCapability"
+          },
+          "readOnly": true
+        },
+        "supportedServerVersions": {
+          "description": "A list of supported server versions.",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/ServerVersionCapability"
+          },
+          "readOnly": true
+        }
+      },
+      "description": "Server edition capabilities."
+    },
+    "CapabilityProperties": {
+      "properties": {
+        "zone": {
+          "type": "string",
+          "description": "zone name",
+          "readOnly": true
+        },
+        "supportedFlexibleServerEditions": {
+          "description": "A list of supported flexible server editions.",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/ServerEditionCapability"
+          },
+          "readOnly": true
+        }
+      },
+      "description": "Location capabilities."
+    },
+    "CapabilitiesListResult": {
+      "type": "object",
+      "properties": {
+        "value": {
+          "description": "A list of supported capabilities.",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/CapabilityProperties"
+          },
+          "readOnly": true
+        },
+        "nextLink": {
+          "description": "Link to retrieve next page of results.",
+          "type": "string",
+          "readOnly": true
+        }
+      },
+      "description": "location capability"
+    },
+    "OperationDisplay": {
+      "properties": {
+        "provider": {
+          "type": "string",
+          "readOnly": true,
+          "description": "Operation resource provider name."
+        },
+        "resource": {
+          "type": "string",
+          "readOnly": true,
+          "description": "Resource on which the operation is performed."
+        },
+        "operation": {
+          "type": "string",
+          "readOnly": true,
+          "description": "Localized friendly name for the operation."
+        },
+        "description": {
+          "type": "string",
+          "readOnly": true,
+          "description": "Operation description."
+        }
+      },
+      "description": "Display metadata associated with the operation."
+    },
+    "Operation": {
+      "properties": {
+        "name": {
+          "type": "string",
+          "readOnly": true,
+          "description": "The name of the operation being performed on this particular object."
+        },
+        "display": {
+          "$ref": "#/definitions/OperationDisplay",
+          "readOnly": true,
+          "description": "The localized display information for this particular operation or action."
+        },
+        "isDataAction": {
+          "description": "Indicates whether the operation is a data action",
+          "type": "boolean"
+        },
+        "origin": {
+          "type": "string",
+          "readOnly": true,
+          "description": "The intended executor of the operation.",
+          "enum": [
+            "NotSpecified",
+            "user",
+            "system"
+          ],
+          "x-ms-enum": {
+            "name": "OperationOrigin",
+            "modelAsString": true
+          }
+        },
+        "properties": {
+          "type": "object",
+          "additionalProperties": {
+            "type": "object"
+          },
+          "readOnly": true,
+          "x-ms-client-flatten": false,
+          "description": "Additional descriptions for the operation."
+        }
+      },
+      "description": "REST API operation definition."
+    },
+    "OperationListResult": {
+      "description": "A list of resource provider operations.",
+      "type": "object",
+      "properties": {
+        "value": {
+          "description": "Collection of available operation details",
+          "uniqueItems": false,
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/Operation"
+          }
+        },
+        "nextLink": {
+          "description": "URL client should use to fetch the next page (per server side paging).\r\nIt's null for now, added for future use.",
+          "type": "string"
+        }
+      }
+    },
+    "NameAvailabilityRequest": {
+      "required": [
+        "name"
+      ],
+      "properties": {
+        "name": {
+          "type": "string",
+          "description": "Resource name to verify."
+        },
+        "type": {
+          "type": "string",
+          "description": "Resource type used for verification."
+        }
+      },
+      "description": "Request from client to check resource name availability."
+    },
+    "NameAvailability": {
+      "properties": {
+        "message": {
+          "type": "string",
+          "description": "Error Message."
+        },
+        "nameAvailable": {
+          "type": "boolean",
+          "description": "Indicates whether the resource name is available."
+        },
+        "reason": {
+          "type": "string",
+          "description": "Reason for name being unavailable."
+        }
+      },
+      "description": "Represents a resource name availability."
+    },
+    "CloudError": {
+      "x-ms-external": true,
+      "properties": {
+        "error": {
+          "$ref": "../../../../../common-types/resource-management/v1/types.json#/definitions/ErrorResponse",
+          "description": "The resource management error response."
+        }
+      },
+      "description": "An error response from the Batch service."
+    }
+  },
+  "parameters": {
+    "ServerNameParameter": {
+      "name": "serverName",
+      "in": "path",
+      "required": true,
+      "type": "string",
+      "description": "The name of the server.",
+      "x-ms-parameter-location": "method"
+    },
+    "FirewallRuleNameParameter": {
+      "name": "firewallRuleName",
+      "in": "path",
+      "required": true,
+      "type": "string",
+      "description": "The name of the server firewall rule.",
+      "x-ms-parameter-location": "method"
+    },
+    "DatabaseNameParameter": {
+      "name": "databaseName",
+      "in": "path",
+      "required": true,
+      "type": "string",
+      "description": "The name of the database.",
+      "x-ms-parameter-location": "method"
+    },
+    "ConfigurationNameParameter": {
+      "name": "configurationName",
+      "in": "path",
+      "required": true,
+      "type": "string",
+      "description": "The name of the server configuration.",
+      "x-ms-parameter-location": "method"
+    },
+    "LocationNameParameter": {
+      "name": "locationName",
+      "in": "path",
+      "required": true,
+      "type": "string",
+      "description": "The name of the location.",
+      "x-ms-parameter-location": "method"
+    },
+    "KeyNameParameter": {
+      "name": "keyName",
+      "in": "path",
+      "required": true,
+      "type": "string",
+      "description": "The name of the server key.",
+      "x-ms-parameter-location": "method"
+    }
+  }
+}
diff --git a/specification/mysql/resource-manager/readme.go.md b/specification/mysql/resource-manager/readme.go.md
index ceb49ca28d81..02c81a7eba72 100644
--- a/specification/mysql/resource-manager/readme.go.md
+++ b/specification/mysql/resource-manager/readme.go.md
@@ -12,18 +12,18 @@ go:
 
 ``` yaml $(go) && $(multiapi)
 batch:
-  - tag: package-2020-07-01-privatepreview
+  - tag: package-2020-07-01-preview
   - tag: package-2020-01-01
   - tag: package-2017-12-01-preview
   - tag: package-2017-12-01
 ```
 
-### Tag: package-2020-07-01-privatepreview and go
+### Tag: package-2020-07-01-preview and go
 
-These settings apply only when `--tag=package-2020-07-01-privatepreview --go` is specified on the command line.
+These settings apply only when `--tag=package-2020-07-01-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-07-01-privatepreview' && $(go)
+``` yaml $(tag) == 'package-2020-07-01-preview' && $(go)
 rpname: mysql
 namespace: mysqlflexibleservers
 output-folder: $(go-sdk-folder)/services/preview/$(rpname)/mgmt/2020-07-01-preview/$(namespace)
diff --git a/specification/mysql/resource-manager/readme.md b/specification/mysql/resource-manager/readme.md
index db837a0271c1..1b824b2c8548 100644
--- a/specification/mysql/resource-manager/readme.md
+++ b/specification/mysql/resource-manager/readme.md
@@ -114,6 +114,15 @@ input-file:
 - Microsoft.DBforMySQL/preview/2020-07-01-privatepreview/mysql.json
 ```
 
+### Tag: package-2020-07-01-preview
+
+These settings apply only when `--tag=package-2020-07-01-preview` is specified on the command line.
+
+``` yaml $(tag) == 'package-2020-07-01-preview'
+input-file:
+- Microsoft.DBforMySQL/preview/2020-07-01-preview/mysql.json
+```
+
 ## Suppression
 ``` yaml
 directive:
diff --git a/specification/mysql/resource-manager/readme.python.md b/specification/mysql/resource-manager/readme.python.md
index 77a340fa1fa1..9b7067fa7b86 100644
--- a/specification/mysql/resource-manager/readme.python.md
+++ b/specification/mysql/resource-manager/readme.python.md
@@ -30,14 +30,14 @@ Generate all API versions currently shipped for this package
 ```yaml !$(track2)
 batch:
   - tag: package-2020-01-01
-  - tag: package-2020-07-01-privatepreview
+  - tag: package-2020-07-01-preview
 ```
 
 ```yaml $(track2)
 clear-output-folder: true
 batch:
   - tag: package-2020-01-01
-  - tag: package-2020-07-01-privatepreview
+  - tag: package-2020-07-01-preview
 ```
 
 ### Tag: package-2020-01-01 and python
@@ -53,12 +53,12 @@ python:
   output-folder: $(python-sdks-folder)/rdbms/azure-mgmt-rdbms/azure/mgmt/rdbms/mysql
 ```
 
-### Tag: package-2020-07-01-privatepreview and python
+### Tag: package-2020-07-01-preview and python
 
-These settings apply only when `--tag=package-2020-07-01-privatepreview --python` is specified on the command line.
+These settings apply only when `--tag=package-2020-07-01-preview --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-07-01-privatepreview' && $(python)
+``` yaml $(tag) == 'package-2020-07-01-preview' && $(python)
 namespace: azure.mgmt.rdbms.mysql_flexibleservers
 output-folder: $(python-sdks-folder)/rdbms/azure-mgmt-rdbms/azure/mgmt/rdbms/mysql_flexibleservers
 python:
diff --git a/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/Accounts_CreateOrUpdate.json b/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/Accounts_CreateOrUpdate.json
new file mode 100644
index 000000000000..aba4960cdd29
--- /dev/null
+++ b/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/Accounts_CreateOrUpdate.json
@@ -0,0 +1,49 @@
+{
+  "parameters": {
+    "subscriptionId": "D633CC2E-722B-4AE1-B636-BBD9E4C60ED9",
+    "resourceGroupName": "myRG",
+    "accountName": "account1",
+    "api-version": "2020-06-01",
+    "body": {
+      "location": "eastus",
+      "properties": {
+        "activeDirectories": [
+          {
+            "site": "SiteName",
+            "username": "ad_user_name",
+            "password": "ad_password",
+            "domain": "10.10.10.3",
+            "dns": "10.10.10.3, 10.10.10.4",
+            "smbServerName": "SMBServer",
+            "organizationalUnit": "Engineering"
+          }
+        ]
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/D633CC2E-722B-4AE1-B636-BBD9E4C60ED9/resourceGroups/myRG/providers/Microsoft.NetApp/netAppAccounts/account1",
+        "name": "account1",
+        "type": "Microsoft.NetApp/netAppAccounts",
+        "location": "eastus",
+        "properties": {
+          "provisioningState": "Succeeded"
+        }
+      }
+    },
+    "201": {
+      "body": {
+        "id": "/subscriptions/D633CC2E-722B-4AE1-B636-BBD9E4C60ED9/resourceGroups/myRG/providers/Microsoft.NetApp/netAppAccounts/account1",
+        "name": "account1",
+        "type": "Microsoft.NetApp/netAppAccounts",
+        "location": "eastus",
+        "properties": {
+          "provisioningState": "Succeeded"
+        }
+      }
+    },
+    "202": {}
+  }
+}
diff --git a/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/Accounts_Delete.json b/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/Accounts_Delete.json
new file mode 100644
index 000000000000..d9604fb9072d
--- /dev/null
+++ b/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/Accounts_Delete.json
@@ -0,0 +1,12 @@
+{
+  "parameters": {
+    "subscriptionId": "D633CC2E-722B-4AE1-B636-BBD9E4C60ED9",
+    "resourceGroupName": "myRG",
+    "accountName": "account1",
+    "api-version": "2020-06-01"
+  },
+  "responses": {
+    "202": {},
+    "204": {}
+  }
+}
diff --git a/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/Accounts_Get.json b/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/Accounts_Get.json
new file mode 100644
index 000000000000..28b862df740f
--- /dev/null
+++ b/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/Accounts_Get.json
@@ -0,0 +1,33 @@
+{
+  "parameters": {
+    "subscriptionId": "D633CC2E-722B-4AE1-B636-BBD9E4C60ED9",
+    "resourceGroupName": "myRG",
+    "accountName": "account1",
+    "api-version": "2020-06-01"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/D633CC2E-722B-4AE1-B636-BBD9E4C60ED9/resourceGroups/myRG/providers/Microsoft.NetApp/netAppAccounts/account1",
+        "name": "account1",
+        "type": "Microsoft.NetApp/netAppAccounts",
+        "location": "eastus",
+        "properties": {
+          "provisioningState": "Succeeded",
+          "activeDirectories": [
+            {
+              "site": "SiteName",
+              "activeDirectoryId": "02da3711-6c58-2d64-098a-e3af7afaf936",
+              "username": "ad_user_name",
+              "domain": "10.10.10.3",
+              "dns": "10.10.10.3, 10.10.10.4",
+              "status": "InUse",
+              "smbServerName": "SMBServer",
+              "organizationalUnit": "Engineering"
+            }
+          ]
+        }
+      }
+    }
+  }
+}
diff --git a/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/Accounts_List.json b/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/Accounts_List.json
new file mode 100644
index 000000000000..7d127ac8075c
--- /dev/null
+++ b/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/Accounts_List.json
@@ -0,0 +1,24 @@
+{
+  "parameters": {
+    "subscriptionId": "D633CC2E-722B-4AE1-B636-BBD9E4C60ED9",
+    "resourceGroupName": "myRG",
+    "api-version": "2020-06-01"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "id": "/subscriptions/D633CC2E-722B-4AE1-B636-BBD9E4C60ED9/resourceGroups/myRG/providers/Microsoft.NetApp/netAppAccounts/account1",
+            "name": "account1",
+            "type": "Microsoft.NetApp/netAppAccounts",
+            "location": "eastus",
+            "properties": {
+              "provisioningState": "Succeeded"
+            }
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/Accounts_Update.json b/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/Accounts_Update.json
new file mode 100644
index 000000000000..789d8913e603
--- /dev/null
+++ b/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/Accounts_Update.json
@@ -0,0 +1,34 @@
+{
+  "parameters": {
+    "subscriptionId": "D633CC2E-722B-4AE1-B636-BBD9E4C60ED9",
+    "resourceGroupName": "myRG",
+    "accountName": "account1",
+    "api-version": "2020-06-01",
+    "body": {}
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/D633CC2E-722B-4AE1-B636-BBD9E4C60ED9/resourceGroups/myRG/providers/Microsoft.NetApp/netAppAccounts/account1",
+        "name": "account1",
+        "type": "Microsoft.NetApp/netAppAccounts",
+        "location": "eastus",
+        "properties": {
+          "provisioningState": "Succeeded"
+        }
+      }
+    },
+    "201": {
+      "body": {
+        "id": "/subscriptions/D633CC2E-722B-4AE1-B636-BBD9E4C60ED9/resourceGroups/myRG/providers/Microsoft.NetApp/netAppAccounts/account1",
+        "name": "account1",
+        "type": "Microsoft.NetApp/netAppAccounts",
+        "location": "eastus",
+        "properties": {
+          "provisioningState": "Succeeded"
+        }
+      }
+    },
+    "202": {}
+  }
+}
diff --git a/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/BackupPolicies_Create.json b/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/BackupPolicies_Create.json
new file mode 100644
index 000000000000..90de6514aefc
--- /dev/null
+++ b/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/BackupPolicies_Create.json
@@ -0,0 +1,51 @@
+{
+  "parameters": {
+    "subscriptionId": "D633CC2E-722B-4AE1-B636-BBD9E4C60ED9",
+    "resourceGroupName": "myRG",
+    "accountName": "account1",
+    "backupPolicyName": "backupPolicyName",
+    "api-version": "2020-06-01",
+    "body": {
+      "location": "westus",
+      "properties": {
+        "dailyBackupsToKeep": 10,
+        "weeklyBackupsToKeep": 10,
+        "monthlyBackupsToKeep": 10,
+        "enabled": true
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/D633CC2E-722B-4AE1-B636-BBD9E4C60ED9/resourceGroups/myRG/providers/Microsoft.NetApp/netAppAccounts/account1/backupPolocies/backupPolicyName",
+        "name": "account1/backupPolicyName",
+        "type": "Microsoft.NetApp/netAppAccounts/backupPolicies",
+        "location": "westus",
+        "properties": {
+          "dailyBackupsToKeep": 10,
+          "weeklyBackupsToKeep": 10,
+          "monthlyBackupsToKeep": 10,
+          "enabled": true,
+          "provisioningState": "creating"
+        }
+      }
+    },
+    "201": {
+      "body": {
+        "id": "/subscriptions/D633CC2E-722B-4AE1-B636-BBD9E4C60ED9/resourceGroups/myRG/providers/Microsoft.NetApp/netAppAccounts/account1/backupPolocies/backupPolicyName",
+        "name": "account1/backupPolicyName",
+        "type": "Microsoft.NetApp/netAppAccounts/backupPolicies",
+        "location": "westus",
+        "properties": {
+          "dailyBackupsToKeep": 10,
+          "weeklyBackupsToKeep": 10,
+          "monthlyBackupsToKeep": 10,
+          "enabled": true,
+          "provisioningState": "creating"
+        }
+      }
+    },
+    "202": {}
+  }
+}
diff --git a/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/BackupPolicies_Delete.json b/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/BackupPolicies_Delete.json
new file mode 100644
index 000000000000..598b534709d6
--- /dev/null
+++ b/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/BackupPolicies_Delete.json
@@ -0,0 +1,14 @@
+{
+  "parameters": {
+    "subscriptionId": "D633CC2E-722B-4AE1-B636-BBD9E4C60ED9",
+    "resourceGroupName": "resourceGroup",
+    "accountName": "accountName",
+    "backupPolicyName": "backupPolicyName",
+    "api-version": "2020-06-01"
+  },
+  "responses": {
+    "204": {},
+    "202": {},
+    "200": {}
+  }
+}
diff --git a/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/BackupPolicies_Get.json b/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/BackupPolicies_Get.json
new file mode 100644
index 000000000000..da4828b8dec9
--- /dev/null
+++ b/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/BackupPolicies_Get.json
@@ -0,0 +1,35 @@
+{
+  "parameters": {
+    "subscriptionId": "D633CC2E-722B-4AE1-B636-BBD9E4C60ED9",
+    "resourceGroupName": "myRG",
+    "accountName": "account1",
+    "backupPolicyName": "backupPolicyName",
+    "api-version": "2020-06-01"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/D633CC2E-722B-4AE1-B636-BBD9E4C60ED9/resourceGroups/myRG/providers/Microsoft.NetApp/netAppAccounts/account1/backupPolocies/backupPolicyName",
+        "name": "account1/backupPolicyName",
+        "type": "Microsoft.NetApp/netAppAccounts/backupPolicies",
+        "location": "eastus",
+        "properties": {
+          "name": "Policy 1",
+          "dailyBackupsToKeep": 10,
+          "weeklyBackupsToKeep": 10,
+          "monthlyBackupsToKeep": 10,
+          "yearlyBackupsToKeep": 10,
+          "volumesAssigned": 0,
+          "enabled": true,
+          "volumeBackups": [
+            {
+              "volumeName": "volume 1",
+              "backupsCount": 5,
+              "policyEnabled": true
+            }
+          ]
+        }
+      }
+    }
+  }
+}
diff --git a/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/BackupPolicies_List.json b/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/BackupPolicies_List.json
new file mode 100644
index 000000000000..232808ad6322
--- /dev/null
+++ b/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/BackupPolicies_List.json
@@ -0,0 +1,31 @@
+{
+  "parameters": {
+    "subscriptionId": "D633CC2E-722B-4AE1-B636-BBD9E4C60ED9",
+    "resourceGroupName": "myRG",
+    "accountName": "account1",
+    "api-version": "2020-06-01"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "id": "/subscriptions/D633CC2E-722B-4AE1-B636-BBD9E4C60ED9/resourceGroups/myRG/providers/Microsoft.NetApp/netAppAccounts/account1/backupPolocies/backupPolicy1",
+            "name": "account1/backupPolicy1",
+            "type": "Microsoft.NetApp/netAppAccounts/backupPolicies",
+            "location": "eastus",
+            "properties": {
+              "name": "Policy 1",
+              "dailyBackupsToKeep": 10,
+              "weeklyBackupsToKeep": 10,
+              "monthlyBackupsToKeep": 10,
+              "yearlyBackupsToKeep": 10,
+              "volumesAssigned": 0,
+              "enabled": true
+            }
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/BackupPolicies_Update.json b/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/BackupPolicies_Update.json
new file mode 100644
index 000000000000..0258711a70a1
--- /dev/null
+++ b/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/BackupPolicies_Update.json
@@ -0,0 +1,44 @@
+{
+  "parameters": {
+    "subscriptionId": "D633CC2E-722B-4AE1-B636-BBD9E4C60ED9",
+    "resourceGroupName": "myRG",
+    "accountName": "account1",
+    "backupPolicyName": "backupPolicyName",
+    "api-version": "2020-06-01",
+    "body": {
+      "location": "westus",
+      "properties": {
+        "dailyBackupsToKeep": 5,
+        "weeklyBackupsToKeep": 10,
+        "monthlyBackupsToKeep": 10,
+        "enabled": false
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/D633CC2E-722B-4AE1-B636-BBD9E4C60ED9/resourceGroups/myRG/providers/Microsoft.NetApp/netAppAccounts/account1/backupPolocies/backupPolicyName",
+        "name": "account1/backupPolicyName",
+        "type": "Microsoft.NetApp/netAppAccounts/backupPolicies",
+        "location": "westus",
+        "properties": {
+          "provisioningState": "Succeeded",
+          "dailyBackupsToKeep": 5,
+          "weeklyBackupsToKeep": 10,
+          "monthlyBackupsToKeep": 10,
+          "yearlyBackupsToKeep": 0,
+          "volumesAssigned": 1,
+          "enabled": false,
+          "volumeBackups": [
+            {
+              "volumeName": "volume 1",
+              "backupsCount": 5,
+              "policyEnabled": true
+            }
+          ]
+        }
+      }
+    }
+  }
+}
diff --git a/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/Backups_Account_Delete.json b/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/Backups_Account_Delete.json
new file mode 100644
index 000000000000..63c3337ab97f
--- /dev/null
+++ b/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/Backups_Account_Delete.json
@@ -0,0 +1,14 @@
+{
+  "parameters": {
+    "subscriptionId": "D633CC2E-722B-4AE1-B636-BBD9E4C60ED9",
+    "resourceGroupName": "resourceGroup",
+    "accountName": "accountName",
+    "backupName": "backupName",
+    "api-version": "2020-06-01"
+  },
+  "responses": {
+    "204": {},
+    "202": {},
+    "200": {}
+  }
+}
diff --git a/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/Backups_Account_Get.json b/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/Backups_Account_Get.json
new file mode 100644
index 000000000000..a1c6de3d81fd
--- /dev/null
+++ b/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/Backups_Account_Get.json
@@ -0,0 +1,26 @@
+{
+  "parameters": {
+    "subscriptionId": "D633CC2E-722B-4AE1-B636-BBD9E4C60ED9",
+    "resourceGroupName": "myRG",
+    "accountName": "account1",
+    "backupName": "backup1",
+    "api-version": "2020-06-01"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/D633CC2E-722B-4AE1-B636-BBD9E4C60ED9/resourceGroups/myRG/providers/Microsoft.NetApp/netAppAccounts/account1/accountBackups/backup1",
+        "name": "account1/backup1",
+        "type": "Microsoft.NetApp/netAppAccounts/accountBackups",
+        "location": "eastus",
+        "properties": {
+          "creationDate": "2017-08-15T13:23:33Z",
+          "provisioningState": "Succeeded",
+          "size": 10011,
+          "label": "myLabel",
+          "backupType": "adhoc"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/Backups_Account_List.json b/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/Backups_Account_List.json
new file mode 100644
index 000000000000..ccec522d23f3
--- /dev/null
+++ b/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/Backups_Account_List.json
@@ -0,0 +1,29 @@
+{
+  "parameters": {
+    "subscriptionId": "D633CC2E-722B-4AE1-B636-BBD9E4C60ED9",
+    "resourceGroupName": "myRG",
+    "accountName": "account1",
+    "api-version": "2020-06-01"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "id": "/subscriptions/D633CC2E-722B-4AE1-B636-BBD9E4C60ED9/resourceGroups/myRG/providers/Microsoft.NetApp/netAppAccounts/account1/accountBackups/backup1",
+            "name": "account1/backup1",
+            "type": "Microsoft.NetApp/netAppAccounts/accountBackups",
+            "location": "eastus",
+            "properties": {
+              "creationDate": "2017-08-15T13:23:33Z",
+              "provisioningState": "Succeeded",
+              "size": 10011,
+              "label": "myLabel",
+              "backupType": "adhoc"
+            }
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/Backups_Create.json b/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/Backups_Create.json
new file mode 100644
index 000000000000..5f2fbb5fe05b
--- /dev/null
+++ b/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/Backups_Create.json
@@ -0,0 +1,50 @@
+{
+  "parameters": {
+    "subscriptionId": "D633CC2E-722B-4AE1-B636-BBD9E4C60ED9",
+    "resourceGroupName": "myRG",
+    "accountName": "account1",
+    "poolName": "pool1",
+    "volumeName": "volume1",
+    "backupName": "backup1",
+    "api-version": "2020-06-01",
+    "body": {
+      "location": "eastus",
+      "properties": {
+        "label": "myLabel"
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/D633CC2E-722B-4AE1-B636-BBD9E4C60ED9/resourceGroups/myRG/providers/Microsoft.NetApp/netAppAccounts/account1/capacityPools/pool1/volumes/volume1/backups/backup1",
+        "name": "account1/pool1/volume1/backup1",
+        "type": "Microsoft.NetApp/netAppAccounts/capacityPools/volumes/backups",
+        "location": "eastus",
+        "properties": {
+          "creationDate": "2017-08-15T13:23:33Z",
+          "provisioningState": "Succeeded",
+          "size": 10011,
+          "label": "myLabel",
+          "backupType": "adhoc"
+        }
+      }
+    },
+    "201": {
+      "body": {
+        "id": "/subscriptions/D633CC2E-722B-4AE1-B636-BBD9E4C60ED9/resourceGroups/myRG/providers/Microsoft.NetApp/netAppAccounts/account1/capacityPools/pool1/volumes/volume1/backups/backup1",
+        "name": "account1/pool1/volume1/backup1",
+        "type": "Microsoft.NetApp/netAppAccounts/capacityPools/volumes/backups",
+        "location": "eastus",
+        "properties": {
+          "creationDate": "2017-08-15T13:23:33Z",
+          "provisioningState": "Succeeded",
+          "size": 10011,
+          "label": "myLabel",
+          "backupType": "adhoc"
+        }
+      }
+    },
+    "202": {}
+  }
+}
diff --git a/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/Backups_Delete.json b/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/Backups_Delete.json
new file mode 100644
index 000000000000..cdfdd661cac9
--- /dev/null
+++ b/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/Backups_Delete.json
@@ -0,0 +1,16 @@
+{
+  "parameters": {
+    "subscriptionId": "D633CC2E-722B-4AE1-B636-BBD9E4C60ED9",
+    "resourceGroupName": "resourceGroup",
+    "accountName": "accountName",
+    "poolName": "poolName",
+    "volumeName": "volumeName",
+    "backupName": "backupName",
+    "api-version": "2020-06-01"
+  },
+  "responses": {
+    "204": {},
+    "202": {},
+    "200": {}
+  }
+}
diff --git a/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/Backups_Get.json b/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/Backups_Get.json
new file mode 100644
index 000000000000..08946493d505
--- /dev/null
+++ b/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/Backups_Get.json
@@ -0,0 +1,28 @@
+{
+  "parameters": {
+    "subscriptionId": "D633CC2E-722B-4AE1-B636-BBD9E4C60ED9",
+    "resourceGroupName": "myRG",
+    "accountName": "account1",
+    "poolName": "pool1",
+    "volumeName": "volume1",
+    "backupName": "backup1",
+    "api-version": "2020-06-01"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/D633CC2E-722B-4AE1-B636-BBD9E4C60ED9/resourceGroups/myRG/providers/Microsoft.NetApp/netAppAccounts/account1/capacityPools/pool1/volumes/volume1/backups/backup1",
+        "name": "account1/pool1/volume1/backup1",
+        "type": "Microsoft.NetApp/netAppAccounts/capacityPools/volumes/backups",
+        "location": "eastus",
+        "properties": {
+          "creationDate": "2017-08-15T13:23:33Z",
+          "provisioningState": "Succeeded",
+          "size": 10011,
+          "label": "myLabel",
+          "backupType": "adhoc"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/Backups_List.json b/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/Backups_List.json
new file mode 100644
index 000000000000..b3a2651411a9
--- /dev/null
+++ b/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/Backups_List.json
@@ -0,0 +1,31 @@
+{
+  "parameters": {
+    "subscriptionId": "D633CC2E-722B-4AE1-B636-BBD9E4C60ED9",
+    "resourceGroupName": "myRG",
+    "accountName": "account1",
+    "poolName": "pool1",
+    "volumeName": "volume1",
+    "api-version": "2020-06-01"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "id": "/subscriptions/D633CC2E-722B-4AE1-B636-BBD9E4C60ED9/resourceGroups/myRG/providers/Microsoft.NetApp/netAppAccounts/account1/capacityPools/pool1/volumes/volume1/backups/backup1",
+            "name": "account1/pool1/volume1/backup1",
+            "type": "Microsoft.NetApp/netAppAccounts/capacityPools/volumes/backups",
+            "location": "eastus",
+            "properties": {
+              "creationDate": "2017-08-15T13:23:33Z",
+              "provisioningState": "Succeeded",
+              "size": 10011,
+              "label": "myLabel",
+              "backupType": "adhoc"
+            }
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/Backups_Update.json b/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/Backups_Update.json
new file mode 100644
index 000000000000..adc5a8cfccf5
--- /dev/null
+++ b/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/Backups_Update.json
@@ -0,0 +1,29 @@
+{
+  "parameters": {
+    "subscriptionId": "D633CC2E-722B-4AE1-B636-BBD9E4C60ED9",
+    "resourceGroupName": "myRG",
+    "accountName": "account1",
+    "poolName": "pool1",
+    "volumeName": "volume1",
+    "backupName": "backup1",
+    "api-version": "2020-06-01",
+    "body": {}
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/D633CC2E-722B-4AE1-B636-BBD9E4C60ED9/resourceGroups/myRG/providers/Microsoft.NetApp/netAppAccounts/account1/capacityPools/pool1/volumes/volume1/backups/backup1",
+        "name": "account1/pool1/volume1/backup1",
+        "type": "Microsoft.NetApp/netAppAccounts/capacityPools/volumes/backups",
+        "location": "eastus",
+        "properties": {
+          "creationDate": "2017-08-15T13:23:33Z",
+          "provisioningState": "Succeeded",
+          "size": 10011,
+          "label": "myLabel",
+          "backupType": "adhoc"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/CheckFilePathAvailability.json b/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/CheckFilePathAvailability.json
new file mode 100644
index 000000000000..cb880e3f0498
--- /dev/null
+++ b/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/CheckFilePathAvailability.json
@@ -0,0 +1,19 @@
+{
+  "parameters": {
+    "subscriptionId": "D633CC2E-722B-4AE1-B636-BBD9E4C60ED9",
+    "location": "eastus",
+    "api-version": "2020-06-01",
+    "body": {
+      "name": "my-exact-filepth",
+      "type": "netAppAccount/capacityPools/volume",
+      "resourceGroup": "myRG"
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "isAvailable": true
+      }
+    }
+  }
+}
diff --git a/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/CheckNameAvailability.json b/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/CheckNameAvailability.json
new file mode 100644
index 000000000000..6e145ad82a8d
--- /dev/null
+++ b/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/CheckNameAvailability.json
@@ -0,0 +1,19 @@
+{
+  "parameters": {
+    "subscriptionId": "D633CC2E-722B-4AE1-B636-BBD9E4C60ED9",
+    "location": "eastus",
+    "api-version": "2020-06-01",
+    "body": {
+      "name": "accName",
+      "type": "netAppAccount",
+      "resourceGroup": "myRG"
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "isAvailable": true
+      }
+    }
+  }
+}
diff --git a/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/CheckQuotaAvailability.json b/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/CheckQuotaAvailability.json
new file mode 100644
index 000000000000..8de7c440d298
--- /dev/null
+++ b/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/CheckQuotaAvailability.json
@@ -0,0 +1,19 @@
+{
+  "parameters": {
+    "subscriptionId": "D633CC2E-722B-4AE1-B636-BBD9E4C60ED9",
+    "location": "eastus",
+    "api-version": "2020-06-01",
+    "body": {
+      "name": "resource1",
+      "type": "Microsoft.NetApp/netAppAccounts",
+      "resourceGroup": "myRG"
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "isAvailable": true
+      }
+    }
+  }
+}
diff --git a/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/Pools_CreateOrUpdate.json b/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/Pools_CreateOrUpdate.json
new file mode 100644
index 000000000000..0b72016b8c3b
--- /dev/null
+++ b/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/Pools_CreateOrUpdate.json
@@ -0,0 +1,47 @@
+{
+  "parameters": {
+    "subscriptionId": "D633CC2E-722B-4AE1-B636-BBD9E4C60ED9",
+    "resourceGroupName": "myRG",
+    "accountName": "account1",
+    "poolName": "pool1",
+    "api-version": "2020-06-01",
+    "body": {
+      "location": "eastus",
+      "properties": {
+        "size": 4398046511104,
+        "serviceLevel": "Premium"
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/D633CC2E-722B-4AE1-B636-BBD9E4C60ED9/resourceGroups/myRG/providers/Microsoft.NetApp/netAppAccounts/account1/capacityPools/pool1",
+        "name": "account1/pool1",
+        "type": "Microsoft.NetApp/netAppAccounts/capacityPools",
+        "location": "eastus",
+        "properties": {
+          "provisioningState": "Succeeded",
+          "poolId": "9760acf5-4638-11e7-9bdb-020073ca7778",
+          "serviceLevel": "Premium",
+          "size": 4398046511104
+        }
+      }
+    },
+    "201": {
+      "body": {
+        "id": "/subscriptions/D633CC2E-722B-4AE1-B636-BBD9E4C60ED9/resourceGroups/myRG/providers/Microsoft.NetApp/netAppAccounts/account1/capacityPools/pool1",
+        "name": "account1/pool1",
+        "type": "Microsoft.NetApp/netAppAccounts/capacityPools",
+        "location": "eastus",
+        "properties": {
+          "provisioningState": "Succeeded",
+          "poolId": "9760acf5-4638-11e7-9bdb-020073ca7778",
+          "serviceLevel": "Premium",
+          "size": 4398046511104
+        }
+      }
+    },
+    "202": {}
+  }
+}
diff --git a/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/Pools_Delete.json b/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/Pools_Delete.json
new file mode 100644
index 000000000000..0f0193626f44
--- /dev/null
+++ b/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/Pools_Delete.json
@@ -0,0 +1,13 @@
+{
+  "parameters": {
+    "subscriptionId": "D633CC2E-722B-4AE1-B636-BBD9E4C60ED9",
+    "resourceGroupName": "myRG",
+    "accountName": "account1",
+    "poolName": "pool1",
+    "api-version": "2020-06-01"
+  },
+  "responses": {
+    "204": {},
+    "202": {}
+  }
+}
diff --git a/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/Pools_Get.json b/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/Pools_Get.json
new file mode 100644
index 000000000000..ec675c2aaaa3
--- /dev/null
+++ b/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/Pools_Get.json
@@ -0,0 +1,25 @@
+{
+  "parameters": {
+    "subscriptionId": "D633CC2E-722B-4AE1-B636-BBD9E4C60ED9",
+    "resourceGroupName": "myRG",
+    "accountName": "account1",
+    "poolName": "pool1",
+    "api-version": "2020-06-01"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/D633CC2E-722B-4AE1-B636-BBD9E4C60ED9/resourceGroups/myRG/providers/Microsoft.NetApp/netAppAccounts/account1/capacityPools/pool1",
+        "name": "account1/pool1",
+        "type": "Microsoft.NetApp/netAppAccounts/capacityPools",
+        "location": "eastus",
+        "properties": {
+          "provisioningState": "Succeeded",
+          "poolId": "9760acf5-4638-11e7-9bdb-020073ca7778",
+          "serviceLevel": "Premium",
+          "size": 4398046511104
+        }
+      }
+    }
+  }
+}
diff --git a/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/Pools_List.json b/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/Pools_List.json
new file mode 100644
index 000000000000..33bc564cb9c0
--- /dev/null
+++ b/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/Pools_List.json
@@ -0,0 +1,28 @@
+{
+  "parameters": {
+    "subscriptionId": "D633CC2E-722B-4AE1-B636-BBD9E4C60ED9",
+    "resourceGroupName": "myRG",
+    "accountName": "account1",
+    "api-version": "2020-06-01"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "id": "/subscriptions/D633CC2E-722B-4AE1-B636-BBD9E4C60ED9/resourceGroups/myRG/providers/Microsoft.NetApp/netAppAccounts/account1/capacityPools/pool1",
+            "name": "account1/pool1",
+            "type": "Microsoft.NetApp/netAppAccounts/capacityPools",
+            "location": "eastus",
+            "properties": {
+              "provisioningState": "Succeeded",
+              "poolId": "9760acf5-4638-11e7-9bdb-020073ca7778",
+              "serviceLevel": "Premium",
+              "size": 4398046511104
+            }
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/Pools_Update.json b/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/Pools_Update.json
new file mode 100644
index 000000000000..0568e91433ef
--- /dev/null
+++ b/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/Pools_Update.json
@@ -0,0 +1,27 @@
+{
+  "parameters": {
+    "subscriptionId": "D633CC2E-722B-4AE1-B636-BBD9E4C60ED9",
+    "resourceGroupName": "myRG",
+    "accountName": "account1",
+    "poolName": "pool1",
+    "api-version": "2020-06-01",
+    "body": {}
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/D633CC2E-722B-4AE1-B636-BBD9E4C60ED9/resourceGroups/myRG/providers/Microsoft.NetApp/netAppAccounts/account1/capacityPools/pool1",
+        "name": "account1/pool1",
+        "type": "Microsoft.NetApp/netAppAccounts/capacityPools",
+        "location": "eastus",
+        "properties": {
+          "provisioningState": "Succeeded",
+          "poolId": "9760acf5-4638-11e7-9bdb-020073ca7778",
+          "serviceLevel": "Premium",
+          "size": 4398046511104
+        }
+      }
+    },
+    "202": {}
+  }
+}
diff --git a/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/SnapshotPolicies_Create.json b/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/SnapshotPolicies_Create.json
new file mode 100644
index 000000000000..ebaa1c23a15b
--- /dev/null
+++ b/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/SnapshotPolicies_Create.json
@@ -0,0 +1,105 @@
+{
+  "parameters": {
+    "subscriptionId": "D633CC2E-722B-4AE1-B636-BBD9E4C60ED9",
+    "resourceGroupName": "myRG",
+    "accountName": "account1",
+    "snapshotPolicyName": "snapshotPolicyName",
+    "api-version": "2020-06-01",
+    "body": {
+      "location": "eastus",
+      "properties": {
+        "hourlySchedule": {
+          "snapshotsToKeep": 2,
+          "minute": 50
+        },
+        "dailySchedule": {
+          "snapshotsToKeep": 4,
+          "hour": 14,
+          "minute": 30
+        },
+        "weeklySchedule": {
+          "snapshotsToKeep": 3,
+          "day": "Wednesday",
+          "hour": 14,
+          "minute": 45
+        },
+        "monthlySchedule": {
+          "snapshotsToKeep": 5,
+          "daysOfMonth": "10,11,12",
+          "hour": 14,
+          "minute": 15
+        }
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "location": "eastus",
+        "id": "/subscriptions/D633CC2E-722B-4AE1-B636-BBD9E4C60ED9/resourceGroups/myRG/providers/Microsoft.NetApp/netAppAccounts/account1/snapshotPolicies/snapshotPolicy1",
+        "name": "account1/snapshotPolicy1",
+        "type": "Microsoft.NetApp/netAppAccounts/snapshotPolicies",
+        "properties": {
+          "name": "sdk-net-tests-snapshotPolicy-1",
+          "enabled": true,
+          "hourlySchedule": {
+            "snapshotsToKeep": 2,
+            "minute": 50
+          },
+          "dailySchedule": {
+            "snapshotsToKeep": 4,
+            "hour": 14,
+            "minute": 30
+          },
+          "weeklySchedule": {
+            "snapshotsToKeep": 3,
+            "day": "Wednesday",
+            "hour": 14,
+            "minute": 45
+          },
+          "monthlySchedule": {
+            "snapshotsToKeep": 5,
+            "daysOfMonth": "10,11,12",
+            "hour": 14,
+            "minute": 15
+          },
+          "provisioningState": "Succeeded"
+        }
+      }
+    },
+    "201": {
+      "body": {
+        "location": "eastus",
+        "id": "/subscriptions/D633CC2E-722B-4AE1-B636-BBD9E4C60ED9/resourceGroups/myRG/providers/Microsoft.NetApp/netAppAccounts/account1/snapshotPolicies/snapshotPolicy1",
+        "name": "account1/snapshotPolicy1",
+        "type": "Microsoft.NetApp/netAppAccounts/snapshotPolicies",
+        "properties": {
+          "name": "sdk-net-tests-snapshotPolicy-1",
+          "enabled": true,
+          "hourlySchedule": {
+            "snapshotsToKeep": 2,
+            "minute": 50
+          },
+          "dailySchedule": {
+            "snapshotsToKeep": 4,
+            "hour": 14,
+            "minute": 30
+          },
+          "weeklySchedule": {
+            "snapshotsToKeep": 3,
+            "day": "Wednesday",
+            "hour": 14,
+            "minute": 45
+          },
+          "monthlySchedule": {
+            "snapshotsToKeep": 5,
+            "daysOfMonth": "10,11,12",
+            "hour": 14,
+            "minute": 15
+          },
+          "provisioningState": "Succeeded"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/SnapshotPolicies_Delete.json b/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/SnapshotPolicies_Delete.json
new file mode 100644
index 000000000000..86283d16571e
--- /dev/null
+++ b/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/SnapshotPolicies_Delete.json
@@ -0,0 +1,14 @@
+{
+  "parameters": {
+    "subscriptionId": "D633CC2E-722B-4AE1-B636-BBD9E4C60ED9",
+    "resourceGroupName": "resourceGroup",
+    "accountName": "accountName",
+    "snapshotPolicyName": "snapshotPolicyName",
+    "api-version": "2020-06-01"
+  },
+  "responses": {
+    "204": {},
+    "202": {},
+    "200": {}
+  }
+}
diff --git a/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/SnapshotPolicies_Get.json b/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/SnapshotPolicies_Get.json
new file mode 100644
index 000000000000..904de0ced731
--- /dev/null
+++ b/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/SnapshotPolicies_Get.json
@@ -0,0 +1,45 @@
+{
+  "parameters": {
+    "subscriptionId": "D633CC2E-722B-4AE1-B636-BBD9E4C60ED9",
+    "resourceGroupName": "myRG",
+    "accountName": "account1",
+    "snapshotPolicyName": "snapshotPolicyName",
+    "api-version": "2020-06-01"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/D633CC2E-722B-4AE1-B636-BBD9E4C60ED9/resourceGroups/myRG/providers/Microsoft.NetApp/netAppAccounts/account1/snapshotPolicies/snapshotPolicy1",
+        "name": "account1/snapshotPolicy1",
+        "type": "Microsoft.NetApp/netAppAccounts/snapshotPolicies",
+        "location": "eastus",
+        "properties": {
+          "name": "sdk-net-tests-snapshotPolicy-1",
+          "enabled": true,
+          "hourlySchedule": {
+            "snapshotsToKeep": 2,
+            "minute": 50
+          },
+          "dailySchedule": {
+            "snapshotsToKeep": 4,
+            "hour": 14,
+            "minute": 30
+          },
+          "weeklySchedule": {
+            "snapshotsToKeep": 3,
+            "day": "Wednesday",
+            "hour": 14,
+            "minute": 45
+          },
+          "monthlySchedule": {
+            "snapshotsToKeep": 5,
+            "daysOfMonth": "10,11,12",
+            "hour": 14,
+            "minute": 15
+          },
+          "provisioningState": "Succeeded"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/SnapshotPolicies_List.json b/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/SnapshotPolicies_List.json
new file mode 100644
index 000000000000..d536acf47c95
--- /dev/null
+++ b/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/SnapshotPolicies_List.json
@@ -0,0 +1,48 @@
+{
+  "parameters": {
+    "subscriptionId": "D633CC2E-722B-4AE1-B636-BBD9E4C60ED9",
+    "resourceGroupName": "myRG",
+    "accountName": "account1",
+    "api-version": "2020-06-01"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "id": "/subscriptions/D633CC2E-722B-4AE1-B636-BBD9E4C60ED9/resourceGroups/myRG/providers/Microsoft.NetApp/netAppAccounts/account1/snapshotPolicies/snapshotPolicy1",
+            "name": "account1/snapshotPolicy1",
+            "location": "eastus",
+            "type": "Microsoft.NetApp/netAppAccounts/snapshotPolicies",
+            "properties": {
+              "name": "sdk-net-tests-snapshotPolicy-1",
+              "enabled": true,
+              "hourlySchedule": {
+                "snapshotsToKeep": 2,
+                "minute": 50
+              },
+              "dailySchedule": {
+                "snapshotsToKeep": 4,
+                "hour": 14,
+                "minute": 30
+              },
+              "weeklySchedule": {
+                "snapshotsToKeep": 3,
+                "day": "Wednesday",
+                "hour": 14,
+                "minute": 45
+              },
+              "monthlySchedule": {
+                "snapshotsToKeep": 5,
+                "daysOfMonth": "10,11,12",
+                "hour": 14,
+                "minute": 15
+              },
+              "provisioningState": "Succeeded"
+            }
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/SnapshotPolicies_ListVolumes.json b/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/SnapshotPolicies_ListVolumes.json
new file mode 100644
index 000000000000..643c3020706e
--- /dev/null
+++ b/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/SnapshotPolicies_ListVolumes.json
@@ -0,0 +1,24 @@
+{
+  "parameters": {
+    "subscriptionId": "D633CC2E-722B-4AE1-B636-BBD9E4C60ED9",
+    "resourceGroupName": "myRG",
+    "accountName": "account1",
+    "snapshotPolicyName": "snapshotPolicyName",
+    "api-version": "2020-06-01",
+    "body": {
+      "location": "eastus",
+      "properties": {}
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "id": "/subscriptions/D633CC2E-722B-4AE1-B636-BBD9E4C60ED9/resourceGroups/myRG/providers/Microsoft.NetApp/netAppAccounts/account1/capacityPools/pool1/volumes/volume1"
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/SnapshotPolicies_Update.json b/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/SnapshotPolicies_Update.json
new file mode 100644
index 000000000000..7df4bc2adcb9
--- /dev/null
+++ b/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/SnapshotPolicies_Update.json
@@ -0,0 +1,72 @@
+{
+  "parameters": {
+    "subscriptionId": "D633CC2E-722B-4AE1-B636-BBD9E4C60ED9",
+    "resourceGroupName": "myRG",
+    "accountName": "account1",
+    "snapshotPolicyName": "snapshotPolicyName",
+    "api-version": "2020-06-01",
+    "body": {
+      "location": "eastus",
+      "properties": {
+        "enabled": true,
+        "hourlySchedule": {
+          "snapshotsToKeep": 2,
+          "minute": 50
+        },
+        "dailySchedule": {
+          "snapshotsToKeep": 4,
+          "hour": 14,
+          "minute": 30
+        },
+        "weeklySchedule": {
+          "snapshotsToKeep": 3,
+          "day": "Wednesday",
+          "hour": 14,
+          "minute": 45
+        },
+        "monthlySchedule": {
+          "snapshotsToKeep": 5,
+          "daysOfMonth": "10,11,12",
+          "hour": 14,
+          "minute": 15
+        }
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/D633CC2E-722B-4AE1-B636-BBD9E4C60ED9/resourceGroups/myRG/providers/Microsoft.NetApp/netAppAccounts/account1/snapshotPolicies/snapshotPolicy1",
+        "name": "account1/snapshotPolicy1",
+        "type": "Microsoft.NetApp/netAppAccounts/snapshotPolicies",
+        "location": "eastus",
+        "properties": {
+          "name": "sdk-net-tests-snapshotPolicy-1",
+          "enabled": true,
+          "hourlySchedule": {
+            "snapshotsToKeep": 2,
+            "minute": 50
+          },
+          "dailySchedule": {
+            "snapshotsToKeep": 4,
+            "hour": 14,
+            "minute": 30
+          },
+          "weeklySchedule": {
+            "snapshotsToKeep": 3,
+            "day": "Wednesday",
+            "hour": 14,
+            "minute": 45
+          },
+          "monthlySchedule": {
+            "snapshotsToKeep": 5,
+            "daysOfMonth": "10,11,12",
+            "hour": 14,
+            "minute": 15
+          },
+          "provisioningState": "Succeeded"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/Snapshots_Create.json b/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/Snapshots_Create.json
new file mode 100644
index 000000000000..ddb759222d07
--- /dev/null
+++ b/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/Snapshots_Create.json
@@ -0,0 +1,30 @@
+{
+  "parameters": {
+    "subscriptionId": "D633CC2E-722B-4AE1-B636-BBD9E4C60ED9",
+    "resourceGroupName": "myRG",
+    "accountName": "account1",
+    "poolName": "pool1",
+    "volumeName": "volume1",
+    "snapshotName": "snapshot1",
+    "api-version": "2020-06-01",
+    "body": {
+      "location": "eastus"
+    }
+  },
+  "responses": {
+    "201": {
+      "body": {
+        "id": "/subscriptions/D633CC2E-722B-4AE1-B636-BBD9E4C60ED9/resourceGroups/myRG/providers/Microsoft.NetApp/netAppAccounts/account1/capacityPools/pool1/volumes/volume1/snapshots/snapshot1",
+        "name": "account1/pool1/volume1/snapshot1",
+        "type": "Microsoft.NetApp/netAppAccounts/capacityPools/volumes/snapshots",
+        "location": "eastus",
+        "properties": {
+          "snapshotId": "9760acf5-4638-11e7-9bdb-020073ca3333",
+          "created": "2017-08-15T13:23:33Z",
+          "provisioningState": "Succeeded"
+        }
+      }
+    },
+    "202": {}
+  }
+}
diff --git a/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/Snapshots_Delete.json b/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/Snapshots_Delete.json
new file mode 100644
index 000000000000..582444cb35b4
--- /dev/null
+++ b/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/Snapshots_Delete.json
@@ -0,0 +1,16 @@
+{
+  "parameters": {
+    "subscriptionId": "D633CC2E-722B-4AE1-B636-BBD9E4C60ED9",
+    "resourceGroupName": "myRG",
+    "accountName": "account1",
+    "poolName": "pool1",
+    "volumeName": "volume1",
+    "snapshotName": "snapshot1",
+    "api-version": "2020-06-01"
+  },
+  "responses": {
+    "204": {},
+    "202": {},
+    "200": {}
+  }
+}
diff --git a/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/Snapshots_Get.json b/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/Snapshots_Get.json
new file mode 100644
index 000000000000..87d49c41a4dd
--- /dev/null
+++ b/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/Snapshots_Get.json
@@ -0,0 +1,26 @@
+{
+  "parameters": {
+    "subscriptionId": "D633CC2E-722B-4AE1-B636-BBD9E4C60ED9",
+    "resourceGroupName": "myRG",
+    "accountName": "account1",
+    "poolName": "pool1",
+    "volumeName": "volume1",
+    "snapshotName": "snapshot1",
+    "api-version": "2020-06-01"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/D633CC2E-722B-4AE1-B636-BBD9E4C60ED9/resourceGroups/myRG/providers/Microsoft.NetApp/netAppAccounts/account1/capacityPools/pool1/volumes/volume1/snapshots/snapshot1",
+        "name": "account1/pool1/volume1/snapshot1",
+        "type": "Microsoft.NetApp/netAppAccounts/capacityPools/volumes/snapshots",
+        "location": "eastus",
+        "properties": {
+          "snapshotId": "9760acf5-4638-11e7-9bdb-020073ca3333",
+          "created": "2017-08-15T13:23:33Z",
+          "provisioningState": "Succeeded"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/Snapshots_List.json b/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/Snapshots_List.json
new file mode 100644
index 000000000000..eb38145e0ce7
--- /dev/null
+++ b/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/Snapshots_List.json
@@ -0,0 +1,29 @@
+{
+  "parameters": {
+    "subscriptionId": "D633CC2E-722B-4AE1-B636-BBD9E4C60ED9",
+    "resourceGroupName": "myRG",
+    "accountName": "account1",
+    "poolName": "pool1",
+    "volumeName": "volume1",
+    "api-version": "2020-06-01"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "id": "/subscriptions/D633CC2E-722B-4AE1-B636-BBD9E4C60ED9/resourceGroups/myRG/providers/Microsoft.NetApp/netAppAccounts/account1/capacityPools/pool1/volumes/volume1/snapshots/snapshot1",
+            "name": "account1/pool1/volume1/snapshot1",
+            "type": "Microsoft.NetApp/netAppAccounts/capacityPools/volumes/snapshots",
+            "location": "eastus",
+            "properties": {
+              "snapshotId": "9760acf5-4638-11e7-9bdb-020073ca3333",
+              "created": "2017-08-15T13:23:33Z",
+              "provisioningState": "Succeeded"
+            }
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/Snapshots_Update.json b/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/Snapshots_Update.json
new file mode 100644
index 000000000000..9af1e3a78dbb
--- /dev/null
+++ b/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/Snapshots_Update.json
@@ -0,0 +1,28 @@
+{
+  "parameters": {
+    "subscriptionId": "D633CC2E-722B-4AE1-B636-BBD9E4C60ED9",
+    "resourceGroupName": "myRG",
+    "accountName": "account1",
+    "poolName": "pool1",
+    "volumeName": "volume1",
+    "snapshotName": "snapshot1",
+    "api-version": "2020-06-01",
+    "body": {}
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/D633CC2E-722B-4AE1-B636-BBD9E4C60ED9/resourceGroups/myRG/providers/Microsoft.NetApp/netAppAccounts/account1/capacityPools/pool1/volumes/volume1/snapshots/snapshot1",
+        "name": "account1/pool1/volume1/snapshot1",
+        "type": "Microsoft.NetApp/netAppAccounts/capacityPools/volumes/snapshots",
+        "location": "eastus",
+        "properties": {
+          "snapshotId": "9760acf5-4638-11e7-9bdb-020073ca3333",
+          "created": "2017-08-15T13:23:33Z",
+          "provisioningState": "Succeeded"
+        }
+      }
+    },
+    "202": {}
+  }
+}
diff --git a/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/Vaults_List.json b/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/Vaults_List.json
new file mode 100644
index 000000000000..52b58165235d
--- /dev/null
+++ b/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/Vaults_List.json
@@ -0,0 +1,25 @@
+{
+  "parameters": {
+    "subscriptionId": "D633CC2E-722B-4AE1-B636-BBD9E4C60ED9",
+    "resourceGroupName": "myRG",
+    "accountName": "account1",
+    "api-version": "2020-06-01"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "id": "/subscriptions/D633CC2E-722B-4AE1-B636-BBD9E4C60ED9/resourceGroups/myRG/providers/Microsoft.NetApp/netAppAccounts/account1/vaults/vault1",
+            "name": "account1/vault1",
+            "type": "Microsoft.NetApp/netAppAccounts/vaults",
+            "location": "eastus",
+            "properties": {
+              "vaultName": "east US"
+            }
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/Volumes_AuthorizeReplication.json b/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/Volumes_AuthorizeReplication.json
new file mode 100644
index 000000000000..283ff746cbe5
--- /dev/null
+++ b/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/Volumes_AuthorizeReplication.json
@@ -0,0 +1,17 @@
+{
+  "parameters": {
+    "subscriptionId": "D633CC2E-722B-4AE1-B636-BBD9E4C60ED9",
+    "resourceGroupName": "myRG",
+    "accountName": "account1",
+    "poolName": "pool1",
+    "volumeName": "volume1",
+    "api-version": "2020-06-01",
+    "body": {
+      "remoteVolumeResourceId": "/subscriptions/D633CC2E-722B-4AE1-B636-BBD9E4C60ED9/resourceGroups/myRemoteRG/providers/Microsoft.NetApp/netAppAccounts/remoteAccount1/capacityPools/remotePool1/volumes/remoteVolume1"
+    }
+  },
+  "responses": {
+    "200": {},
+    "202": {}
+  }
+}
diff --git a/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/Volumes_BreakReplication.json b/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/Volumes_BreakReplication.json
new file mode 100644
index 000000000000..53151656cb63
--- /dev/null
+++ b/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/Volumes_BreakReplication.json
@@ -0,0 +1,17 @@
+{
+  "parameters": {
+    "subscriptionId": "D633CC2E-722B-4AE1-B636-BBD9E4C60ED9",
+    "resourceGroupName": "myRG",
+    "accountName": "account1",
+    "poolName": "pool1",
+    "volumeName": "volume1",
+    "api-version": "2020-06-01",
+    "body": {
+      "forceBreakReplication": false
+    }
+  },
+  "responses": {
+    "200": {},
+    "202": {}
+  }
+}
diff --git a/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/Volumes_CreateOrUpdate.json b/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/Volumes_CreateOrUpdate.json
new file mode 100644
index 000000000000..b6d9873bc2cd
--- /dev/null
+++ b/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/Volumes_CreateOrUpdate.json
@@ -0,0 +1,54 @@
+{
+  "parameters": {
+    "subscriptionId": "D633CC2E-722B-4AE1-B636-BBD9E4C60ED9",
+    "resourceGroupName": "myRG",
+    "accountName": "account1",
+    "poolName": "pool1",
+    "volumeName": "volume1",
+    "api-version": "2020-06-01",
+    "body": {
+      "location": "eastus",
+      "properties": {
+        "creationToken": "my-unique-file-path",
+        "serviceLevel": "Premium",
+        "subnetId": "/subscriptions/9760acf5-4638-11e7-9bdb-020073ca7778/resourceGroups/myRP/providers/Microsoft.Network/virtualNetworks/testvnet3/subnets/testsubnet3",
+        "usageThreshold": 107374182400
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/D633CC2E-722B-4AE1-B636-BBD9E4C60ED9/resourceGroups/myRG/providers/Microsoft.NetApp/netAppAccounts/account1/capacityPools/pool1/volumes/volume1",
+        "location": "eastus",
+        "name": "account1/pool1/volume1",
+        "properties": {
+          "fileSystemId": "9760acf5-4638-11e7-9bdb-020073ca7778",
+          "creationToken": "some-amazing-filepath",
+          "usageThreshold": 107374182400,
+          "serviceLevel": "Premium",
+          "provisioningState": "Succeeded",
+          "subnetId": "/subscriptions/9760acf5-4638-11e7-9bdb-020073ca7778/resourceGroups/myRP/providers/Microsoft.Network/virtualNetworks/testvnet3/subnets/testsubnet3"
+        },
+        "type": "Microsoft.NetApp/netAppAccounts/capacityPools/volumes"
+      }
+    },
+    "201": {
+      "body": {
+        "id": "/subscriptions/D633CC2E-722B-4AE1-B636-BBD9E4C60ED9/resourceGroups/myRG/providers/Microsoft.NetApp/netAppAccounts/account1/capacityPools/pool1/volumes/volume1",
+        "location": "eastus",
+        "name": "account1/pool1/volume1",
+        "properties": {
+          "fileSystemId": "9760acf5-4638-11e7-9bdb-020073ca7778",
+          "creationToken": "some-amazing-filepath",
+          "usageThreshold": 107374182400,
+          "serviceLevel": "Premium",
+          "provisioningState": "Succeeded",
+          "subnetId": "/subscriptions/9760acf5-4638-11e7-9bdb-020073ca7778/resourceGroups/myRP/providers/Microsoft.Network/virtualNetworks/testvnet3/subnets/testsubnet3"
+        },
+        "type": "Microsoft.NetApp/netAppAccounts/capacityPools/volumes"
+      }
+    },
+    "202": {}
+  }
+}
diff --git a/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/Volumes_Delete.json b/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/Volumes_Delete.json
new file mode 100644
index 000000000000..7ae07cec38d6
--- /dev/null
+++ b/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/Volumes_Delete.json
@@ -0,0 +1,14 @@
+{
+  "parameters": {
+    "subscriptionId": "D633CC2E-722B-4AE1-B636-BBD9E4C60ED9",
+    "resourceGroupName": "myRG",
+    "accountName": "account1",
+    "poolName": "pool1",
+    "volumeName": "volume1",
+    "api-version": "2020-06-01"
+  },
+  "responses": {
+    "204": {},
+    "202": {}
+  }
+}
diff --git a/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/Volumes_DeleteReplication.json b/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/Volumes_DeleteReplication.json
new file mode 100644
index 000000000000..50181792855d
--- /dev/null
+++ b/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/Volumes_DeleteReplication.json
@@ -0,0 +1,18 @@
+{
+  "parameters": {
+    "subscriptionId": "D633CC2E-722B-4AE1-B636-BBD9E4C60ED9",
+    "resourceGroupName": "myRG",
+    "accountName": "account1",
+    "poolName": "pool1",
+    "volumeName": "volume1",
+    "api-version": "2020-06-01",
+    "body": {
+      "location": "eastus",
+      "properties": {}
+    }
+  },
+  "responses": {
+    "200": {},
+    "202": {}
+  }
+}
diff --git a/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/Volumes_Get.json b/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/Volumes_Get.json
new file mode 100644
index 000000000000..b5f28d1847b5
--- /dev/null
+++ b/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/Volumes_Get.json
@@ -0,0 +1,28 @@
+{
+  "parameters": {
+    "subscriptionId": "D633CC2E-722B-4AE1-B636-BBD9E4C60ED9",
+    "resourceGroupName": "myRG",
+    "accountName": "account1",
+    "poolName": "pool1",
+    "volumeName": "volume1",
+    "api-version": "2020-06-01"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/D633CC2E-722B-4AE1-B636-BBD9E4C60ED9/resourceGroups/myRG/providers/Microsoft.NetApp/netAppAccounts/account1/capacityPools/pool1/volumes/volume1",
+        "name": "account1/pool1/volume1",
+        "type": "Microsoft.NetApp/netAppAccounts/capacityPools/volumes",
+        "location": "eastus",
+        "properties": {
+          "fileSystemId": "9760acf5-4638-11e7-9bdb-020073ca7778",
+          "creationToken": "some-amazing-filepath",
+          "usageThreshold": 107374182400,
+          "serviceLevel": "Premium",
+          "provisioningState": "Succeeded",
+          "subnetId": "/subscriptions/9760acf5-4638-11e7-9bdb-020073ca7778/resourceGroups/myRP/providers/Microsoft.Network/virtualNetworks/testvnet3/subnets/testsubnet3"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/Volumes_List.json b/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/Volumes_List.json
new file mode 100644
index 000000000000..67200391da0d
--- /dev/null
+++ b/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/Volumes_List.json
@@ -0,0 +1,31 @@
+{
+  "parameters": {
+    "subscriptionId": "D633CC2E-722B-4AE1-B636-BBD9E4C60ED9",
+    "resourceGroupName": "myRG",
+    "accountName": "account1",
+    "poolName": "pool1",
+    "api-version": "2020-06-01"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "id": "/subscriptions/D633CC2E-722B-4AE1-B636-BBD9E4C60ED9/resourceGroups/myRG/providers/Microsoft.NetApp/netAppAccounts/account1/capacityPools/pool1/volumes/volume1",
+            "name": "account1/pool1/volume1",
+            "type": "Microsoft.NetApp/netAppAccounts/capacityPools/volumes",
+            "location": "eastus",
+            "properties": {
+              "fileSystemId": "9760acf5-4638-11e7-9bdb-020073ca7778",
+              "creationToken": "some-amazing-filepath",
+              "usageThreshold": 107374182400,
+              "serviceLevel": "Premium",
+              "provisioningState": "Succeeded",
+              "subnetId": "/subscriptions/9760acf5-4638-11e7-9bdb-020073ca7778/resourceGroups/myRP/providers/Microsoft.Network/virtualNetworks/testvnet3/subnets/testsubnet3"
+            }
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/Volumes_PoolChange.json b/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/Volumes_PoolChange.json
new file mode 100644
index 000000000000..d7e211df1707
--- /dev/null
+++ b/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/Volumes_PoolChange.json
@@ -0,0 +1,17 @@
+{
+  "parameters": {
+    "subscriptionId": "D633CC2E-722B-4AE1-B636-BBD9E4C60ED9",
+    "resourceGroupName": "myRG",
+    "accountName": "account1",
+    "poolName": "pool1",
+    "volumeName": "volume1",
+    "api-version": "2020-06-01",
+    "body": {
+      "newPoolResourceId": "/subscriptions/D633CC2E-722B-4AE1-B636-BBD9E4C60ED9/resourceGroups/myRG/providers/Microsoft.NetApp/netAppAccounts/account1/capacityPools/pool1"
+    }
+  },
+  "responses": {
+    "200": {},
+    "202": {}
+  }
+}
diff --git a/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/Volumes_ReInitializeReplication.json b/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/Volumes_ReInitializeReplication.json
new file mode 100644
index 000000000000..50181792855d
--- /dev/null
+++ b/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/Volumes_ReInitializeReplication.json
@@ -0,0 +1,18 @@
+{
+  "parameters": {
+    "subscriptionId": "D633CC2E-722B-4AE1-B636-BBD9E4C60ED9",
+    "resourceGroupName": "myRG",
+    "accountName": "account1",
+    "poolName": "pool1",
+    "volumeName": "volume1",
+    "api-version": "2020-06-01",
+    "body": {
+      "location": "eastus",
+      "properties": {}
+    }
+  },
+  "responses": {
+    "200": {},
+    "202": {}
+  }
+}
diff --git a/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/Volumes_ReplicationStatus.json b/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/Volumes_ReplicationStatus.json
new file mode 100644
index 000000000000..d117dd6b20a6
--- /dev/null
+++ b/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/Volumes_ReplicationStatus.json
@@ -0,0 +1,25 @@
+{
+  "parameters": {
+    "subscriptionId": "D633CC2E-722B-4AE1-B636-BBD9E4C60ED9",
+    "resourceGroupName": "myRG",
+    "accountName": "account1",
+    "poolName": "pool1",
+    "volumeName": "volume1",
+    "api-version": "2020-06-01",
+    "body": {
+      "location": "eastus",
+      "properties": {}
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "healthy": true,
+        "relationshipStatus": "Idle",
+        "mirrorState": "Mirrored",
+        "totalProgress": "1048576",
+        "errorMessage": ""
+      }
+    }
+  }
+}
diff --git a/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/Volumes_ResyncReplication.json b/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/Volumes_ResyncReplication.json
new file mode 100644
index 000000000000..50181792855d
--- /dev/null
+++ b/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/Volumes_ResyncReplication.json
@@ -0,0 +1,18 @@
+{
+  "parameters": {
+    "subscriptionId": "D633CC2E-722B-4AE1-B636-BBD9E4C60ED9",
+    "resourceGroupName": "myRG",
+    "accountName": "account1",
+    "poolName": "pool1",
+    "volumeName": "volume1",
+    "api-version": "2020-06-01",
+    "body": {
+      "location": "eastus",
+      "properties": {}
+    }
+  },
+  "responses": {
+    "200": {},
+    "202": {}
+  }
+}
diff --git a/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/Volumes_Revert.json b/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/Volumes_Revert.json
new file mode 100644
index 000000000000..285bcc71128f
--- /dev/null
+++ b/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/Volumes_Revert.json
@@ -0,0 +1,17 @@
+{
+  "parameters": {
+    "subscriptionId": "D633CC2E-722B-4AE1-B636-BBD9E4C60ED9",
+    "resourceGroupName": "myRG",
+    "accountName": "account1",
+    "poolName": "pool1",
+    "volumeName": "volume1",
+    "api-version": "2020-06-01",
+    "body": {
+      "snapshotId": "/subscriptions/D633CC2E-722B-4AE1-B636-BBD9E4C60ED9/resourceGroups/myRG/providers/Microsoft.NetApp/netAppAccounts/account1/capacityPools/pool1/volumes/volume1/snapshots/snapshot1"
+    }
+  },
+  "responses": {
+    "200": {},
+    "202": {}
+  }
+}
diff --git a/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/Volumes_Update.json b/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/Volumes_Update.json
new file mode 100644
index 000000000000..3d0cdd1f7202
--- /dev/null
+++ b/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/examples/Volumes_Update.json
@@ -0,0 +1,30 @@
+{
+  "parameters": {
+    "subscriptionId": "D633CC2E-722B-4AE1-B636-BBD9E4C60ED9",
+    "resourceGroupName": "myRG",
+    "accountName": "account1",
+    "poolName": "pool1",
+    "volumeName": "volume1",
+    "api-version": "2020-06-01",
+    "body": {}
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/subscriptionId/resourceGroups/resourceGroup/providers/Microsoft.NetApp/netAppAccounts/account1/capacityPools/pool1/volumes/volume1",
+        "name": "account1/pool1/volume1",
+        "type": "Microsoft.NetApp/netAppAccounts/capacityPools/volumes",
+        "location": "eastus",
+        "properties": {
+          "fileSystemId": "9760acf5-4638-11e7-9bdb-020073ca7778",
+          "creationToken": "some-amazing-filepath",
+          "usageThreshold": 107374182400,
+          "serviceLevel": "Premium",
+          "provisioningState": "Succeeded",
+          "subnetId": "/subscriptions/9760acf5-4638-11e7-9bdb-020073ca7778/resourceGroups/myRP/providers/Microsoft.Network/virtualNetworks/testvnet3/subnets/testsubnet3"
+        }
+      }
+    },
+    "202": {}
+  }
+}
diff --git a/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/netapp.json b/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/netapp.json
new file mode 100644
index 000000000000..85f72bb38178
--- /dev/null
+++ b/specification/netapp/resource-manager/Microsoft.NetApp/stable/2020-05-01/netapp.json
@@ -0,0 +1,4656 @@
+{
+  "swagger": "2.0",
+  "info": {
+    "title": "Microsoft NetApp",
+    "description": "Microsoft NetApp Azure Resource Provider specification",
+    "version": "2020-05-01",
+    "x-ms-code-generation-settings": {
+      "name": "AzureNetAppFilesManagementClient"
+    }
+  },
+  "consumes": [
+    "application/json"
+  ],
+  "produces": [
+    "application/json"
+  ],
+  "schemes": [
+    "https"
+  ],
+  "host": "management.azure.com",
+  "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.NetApp/operations": {
+      "get": {
+        "tags": [
+          "Operations"
+        ],
+        "summary": "Describes the Resource Provider",
+        "description": "Lists all of the available Microsoft.NetApp Rest API operations",
+        "operationId": "Operations_List",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersionParameter"
+          }
+        ],
+        "x-ms-pageable": {
+          "nextLinkName": null
+        },
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/OperationListResult"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed."
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/providers/Microsoft.NetApp/locations/{location}/checkNameAvailability": {
+      "post": {
+        "tags": [
+          "NetApp Resource"
+        ],
+        "summary": "Check resource name availability",
+        "description": "Check if a resource name is available.",
+        "operationId": "NetAppResource_CheckNameAvailability",
+        "parameters": [
+          {
+            "name": "body",
+            "in": "body",
+            "description": "Name availability request.",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/ResourceNameAvailabilityRequest"
+            },
+            "x-ms-client-flatten": true
+          },
+          {
+            "$ref": "#/parameters/SubscriptionId"
+          },
+          {
+            "$ref": "#/parameters/location"
+          },
+          {
+            "$ref": "#/parameters/ApiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/CheckAvailabilityResponse"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed."
+          }
+        },
+        "x-ms-examples": {
+          "CheckNameAvailability": {
+            "$ref": "examples/CheckNameAvailability.json"
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/providers/Microsoft.NetApp/locations/{location}/checkFilePathAvailability": {
+      "post": {
+        "tags": [
+          "NetApp Resource"
+        ],
+        "summary": "Check file path availability",
+        "description": "Check if a file path is available.",
+        "operationId": "NetAppResource_CheckFilePathAvailability",
+        "parameters": [
+          {
+            "name": "body",
+            "in": "body",
+            "description": "File path availability request.",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/ResourceNameAvailabilityRequest"
+            },
+            "x-ms-client-flatten": true
+          },
+          {
+            "$ref": "#/parameters/SubscriptionId"
+          },
+          {
+            "$ref": "#/parameters/location"
+          },
+          {
+            "$ref": "#/parameters/ApiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/CheckAvailabilityResponse"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed."
+          }
+        },
+        "x-ms-examples": {
+          "CheckFilePathAvailability": {
+            "$ref": "examples/CheckFilePathAvailability.json"
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/providers/Microsoft.NetApp/locations/{location}/checkQuotaAvailability": {
+      "post": {
+        "tags": [
+          "NetApp Resource"
+        ],
+        "summary": "Check quota availability",
+        "description": "Check if a quota is available.",
+        "operationId": "NetAppResource_CheckQuotaAvailability",
+        "parameters": [
+          {
+            "name": "body",
+            "in": "body",
+            "description": "Quota availability request.",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/QuotaAvailabilityRequest"
+            },
+            "x-ms-client-flatten": true
+          },
+          {
+            "$ref": "#/parameters/SubscriptionId"
+          },
+          {
+            "$ref": "#/parameters/location"
+          },
+          {
+            "$ref": "#/parameters/ApiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/CheckAvailabilityResponse"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed."
+          }
+        },
+        "x-ms-examples": {
+          "CheckQuotaAvailability": {
+            "$ref": "examples/CheckQuotaAvailability.json"
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetApp/netAppAccounts": {
+      "get": {
+        "summary": "Describe all NetApp Accounts in a resource group",
+        "description": "List and describe all NetApp accounts in the resource group.",
+        "tags": [
+          "NetApp Accounts"
+        ],
+        "operationId": "Accounts_List",
+        "parameters": [
+          {
+            "$ref": "#/parameters/SubscriptionId"
+          },
+          {
+            "$ref": "#/parameters/ResourceGroup"
+          },
+          {
+            "$ref": "#/parameters/ApiVersionParameter"
+          }
+        ],
+        "x-ms-pageable": {
+          "nextLinkName": null
+        },
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/netAppAccountList"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed."
+          }
+        },
+        "x-ms-examples": {
+          "Accounts_List": {
+            "$ref": "examples/Accounts_List.json"
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetApp/netAppAccounts/{accountName}": {
+      "get": {
+        "summary": "Describe a NetApp Account",
+        "description": "Get the NetApp account",
+        "tags": [
+          "NetApp Accounts"
+        ],
+        "operationId": "Accounts_Get",
+        "parameters": [
+          {
+            "$ref": "#/parameters/SubscriptionId"
+          },
+          {
+            "$ref": "#/parameters/ResourceGroup"
+          },
+          {
+            "$ref": "#/parameters/AccountName"
+          },
+          {
+            "$ref": "#/parameters/ApiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/netAppAccount"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed."
+          }
+        },
+        "x-ms-examples": {
+          "Accounts_Get": {
+            "$ref": "examples/Accounts_Get.json"
+          }
+        }
+      },
+      "put": {
+        "tags": [
+          "NetApp Accounts"
+        ],
+        "operationId": "Accounts_CreateOrUpdate",
+        "summary": "Create or update a NetApp account",
+        "description": "Create or update the specified NetApp account within the resource group",
+        "parameters": [
+          {
+            "name": "body",
+            "description": "NetApp Account object supplied in the body of the operation.",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/netAppAccount"
+            }
+          },
+          {
+            "$ref": "#/parameters/SubscriptionId"
+          },
+          {
+            "$ref": "#/parameters/ResourceGroup"
+          },
+          {
+            "$ref": "#/parameters/AccountName"
+          },
+          {
+            "$ref": "#/parameters/ApiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK - account updated",
+            "schema": {
+              "$ref": "#/definitions/netAppAccount"
+            }
+          },
+          "201": {
+            "description": "Account created",
+            "schema": {
+              "$ref": "#/definitions/netAppAccount"
+            }
+          },
+          "202": {
+            "description": "Accepted -- Create, update or delete request accepted; operation will complete asynchronously"
+          },
+          "default": {
+            "description": "Error response describing why the operation failed."
+          }
+        },
+        "x-ms-long-running-operation": true,
+        "x-ms-examples": {
+          "Accounts_CreateOrUpdate": {
+            "$ref": "examples/Accounts_CreateOrUpdate.json"
+          }
+        }
+      },
+      "delete": {
+        "tags": [
+          "NetApp Accounts"
+        ],
+        "operationId": "Accounts_Delete",
+        "summary": "Delete a NetApp account",
+        "parameters": [
+          {
+            "$ref": "#/parameters/SubscriptionId"
+          },
+          {
+            "$ref": "#/parameters/ResourceGroup"
+          },
+          {
+            "$ref": "#/parameters/AccountName"
+          },
+          {
+            "$ref": "#/parameters/ApiVersionParameter"
+          }
+        ],
+        "description": "Delete the specified NetApp account",
+        "responses": {
+          "202": {
+            "description": "Accepted -- Create, update or delete request accepted; operation will complete asynchronously"
+          },
+          "204": {
+            "description": "NoContent -- Resource does not exist."
+          },
+          "default": {
+            "description": "Error response describing why the operation failed."
+          }
+        },
+        "x-ms-long-running-operation": true,
+        "x-ms-examples": {
+          "Accounts_Delete": {
+            "$ref": "examples/Accounts_Delete.json"
+          }
+        }
+      },
+      "patch": {
+        "tags": [
+          "NetApp Accounts"
+        ],
+        "operationId": "Accounts_Update",
+        "summary": "Update a NetApp account",
+        "description": "Patch the specified NetApp account",
+        "parameters": [
+          {
+            "name": "body",
+            "description": "NetApp Account object supplied in the body of the operation.",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/netAppAccountPatch"
+            }
+          },
+          {
+            "$ref": "#/parameters/SubscriptionId"
+          },
+          {
+            "$ref": "#/parameters/ResourceGroup"
+          },
+          {
+            "$ref": "#/parameters/AccountName"
+          },
+          {
+            "$ref": "#/parameters/ApiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK - account updated",
+            "schema": {
+              "$ref": "#/definitions/netAppAccount"
+            }
+          },
+          "201": {
+            "description": "OK - account created",
+            "schema": {
+              "$ref": "#/definitions/netAppAccount"
+            }
+          },
+          "202": {
+            "description": "Accepted -- Create, update or delete request accepted; operation will complete asynchronously"
+          },
+          "default": {
+            "description": "Error response describing why the operation failed."
+          }
+        },
+        "x-ms-long-running-operation": true,
+        "x-ms-examples": {
+          "Accounts_Update": {
+            "$ref": "examples/Accounts_Update.json"
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetApp/netAppAccounts/{accountName}/capacityPools": {
+      "get": {
+        "summary": "Describe all Capacity Pools",
+        "description": "List all capacity pools in the NetApp Account",
+        "tags": [
+          "Capacity Pools"
+        ],
+        "operationId": "Pools_List",
+        "parameters": [
+          {
+            "$ref": "#/parameters/SubscriptionId"
+          },
+          {
+            "$ref": "#/parameters/ResourceGroup"
+          },
+          {
+            "$ref": "#/parameters/AccountName"
+          },
+          {
+            "$ref": "#/parameters/ApiVersionParameter"
+          }
+        ],
+        "x-ms-pageable": {
+          "nextLinkName": null
+        },
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/capacityPoolList"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed."
+          }
+        },
+        "x-ms-examples": {
+          "Pools_List": {
+            "$ref": "examples/Pools_List.json"
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetApp/netAppAccounts/{accountName}/capacityPools/{poolName}": {
+      "get": {
+        "summary": "Describe a Capacity Pool",
+        "description": "Get details of the specified capacity pool",
+        "tags": [
+          "Capacity Pools"
+        ],
+        "operationId": "Pools_Get",
+        "parameters": [
+          {
+            "$ref": "#/parameters/SubscriptionId"
+          },
+          {
+            "$ref": "#/parameters/ResourceGroup"
+          },
+          {
+            "$ref": "#/parameters/AccountName"
+          },
+          {
+            "$ref": "#/parameters/PoolName"
+          },
+          {
+            "$ref": "#/parameters/ApiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/capacityPool"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed."
+          }
+        },
+        "x-ms-examples": {
+          "Pools_Get": {
+            "$ref": "examples/Pools_Get.json"
+          }
+        }
+      },
+      "put": {
+        "tags": [
+          "Capacity Pools"
+        ],
+        "operationId": "Pools_CreateOrUpdate",
+        "summary": "Create or Update the specified capacity pool within the resource group",
+        "description": "Create or Update a capacity pool",
+        "parameters": [
+          {
+            "name": "body",
+            "description": "Capacity pool object supplied in the body of the operation.",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/capacityPool"
+            }
+          },
+          {
+            "$ref": "#/parameters/SubscriptionId"
+          },
+          {
+            "$ref": "#/parameters/ResourceGroup"
+          },
+          {
+            "$ref": "#/parameters/AccountName"
+          },
+          {
+            "$ref": "#/parameters/PoolName"
+          },
+          {
+            "$ref": "#/parameters/ApiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK - pool updated",
+            "schema": {
+              "$ref": "#/definitions/capacityPool"
+            }
+          },
+          "201": {
+            "description": "Pool created",
+            "schema": {
+              "$ref": "#/definitions/capacityPool"
+            }
+          },
+          "202": {
+            "description": "Accepted -- Create, update or delete request accepted; operation will complete asynchronously"
+          },
+          "default": {
+            "description": "Error response describing why the operation failed."
+          }
+        },
+        "x-ms-long-running-operation": true,
+        "x-ms-examples": {
+          "Pools_CreateOrUpdate": {
+            "$ref": "examples/Pools_CreateOrUpdate.json"
+          }
+        }
+      },
+      "patch": {
+        "tags": [
+          "Capacity Pools"
+        ],
+        "operationId": "Pools_Update",
+        "summary": "Update a capacity pool",
+        "description": "Patch the specified capacity pool",
+        "parameters": [
+          {
+            "name": "body",
+            "description": "Capacity pool object supplied in the body of the operation.",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/capacityPoolPatch"
+            }
+          },
+          {
+            "$ref": "#/parameters/SubscriptionId"
+          },
+          {
+            "$ref": "#/parameters/ResourceGroup"
+          },
+          {
+            "$ref": "#/parameters/AccountName"
+          },
+          {
+            "$ref": "#/parameters/PoolName"
+          },
+          {
+            "$ref": "#/parameters/ApiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/capacityPool"
+            }
+          },
+          "202": {
+            "description": "Accepted -- Create, update or delete request accepted; operation will complete asynchronously"
+          },
+          "default": {
+            "description": "Error response describing why the operation failed."
+          }
+        },
+        "x-ms-long-running-operation": true,
+        "x-ms-examples": {
+          "Pools_Update": {
+            "$ref": "examples/Pools_Update.json"
+          }
+        }
+      },
+      "delete": {
+        "tags": [
+          "Capacity Pools"
+        ],
+        "operationId": "Pools_Delete",
+        "summary": "Delete a capacity pool",
+        "description": "Delete the specified capacity pool",
+        "parameters": [
+          {
+            "$ref": "#/parameters/SubscriptionId"
+          },
+          {
+            "$ref": "#/parameters/ResourceGroup"
+          },
+          {
+            "$ref": "#/parameters/AccountName"
+          },
+          {
+            "$ref": "#/parameters/PoolName"
+          },
+          {
+            "$ref": "#/parameters/ApiVersionParameter"
+          }
+        ],
+        "responses": {
+          "202": {
+            "description": "Accepted -- Create, update or delete request accepted; operation will complete asynchronously"
+          },
+          "204": {
+            "description": "NoContent -- Resource does not exist."
+          },
+          "default": {
+            "description": "Error response describing why the operation failed."
+          }
+        },
+        "x-ms-long-running-operation": true,
+        "x-ms-examples": {
+          "Pools_Delete": {
+            "$ref": "examples/Pools_Delete.json"
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetApp/netAppAccounts/{accountName}/capacityPools/{poolName}/volumes": {
+      "get": {
+        "summary": "Describe all volumes",
+        "description": "List all volumes within the capacity pool",
+        "parameters": [
+          {
+            "$ref": "#/parameters/SubscriptionId"
+          },
+          {
+            "$ref": "#/parameters/ResourceGroup"
+          },
+          {
+            "$ref": "#/parameters/AccountName"
+          },
+          {
+            "$ref": "#/parameters/PoolName"
+          },
+          {
+            "$ref": "#/parameters/ApiVersionParameter"
+          }
+        ],
+        "tags": [
+          "Volumes"
+        ],
+        "operationId": "Volumes_List",
+        "x-ms-pageable": {
+          "nextLinkName": null
+        },
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/volumeList"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed."
+          }
+        },
+        "x-ms-examples": {
+          "Volumes_List": {
+            "$ref": "examples/Volumes_List.json"
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetApp/netAppAccounts/{accountName}/capacityPools/{poolName}/volumes/{volumeName}": {
+      "get": {
+        "tags": [
+          "Volumes"
+        ],
+        "operationId": "Volumes_Get",
+        "summary": "Describe a volume",
+        "description": "Get the details of the specified volume",
+        "parameters": [
+          {
+            "$ref": "#/parameters/SubscriptionId"
+          },
+          {
+            "$ref": "#/parameters/ResourceGroup"
+          },
+          {
+            "$ref": "#/parameters/AccountName"
+          },
+          {
+            "$ref": "#/parameters/PoolName"
+          },
+          {
+            "$ref": "#/parameters/VolumeName"
+          },
+          {
+            "$ref": "#/parameters/ApiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/volume"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed."
+          }
+        },
+        "x-ms-examples": {
+          "Volumes_Get": {
+            "$ref": "examples/Volumes_Get.json"
+          }
+        }
+      },
+      "put": {
+        "tags": [
+          "Volumes"
+        ],
+        "operationId": "Volumes_CreateOrUpdate",
+        "summary": "Create or Update a volume",
+        "description": "Create or update the specified volume within the capacity pool",
+        "parameters": [
+          {
+            "name": "body",
+            "description": "Volume object supplied in the body of the operation.",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/volume"
+            }
+          },
+          {
+            "$ref": "#/parameters/SubscriptionId"
+          },
+          {
+            "$ref": "#/parameters/ResourceGroup"
+          },
+          {
+            "$ref": "#/parameters/AccountName"
+          },
+          {
+            "$ref": "#/parameters/PoolName"
+          },
+          {
+            "$ref": "#/parameters/VolumeName"
+          },
+          {
+            "$ref": "#/parameters/ApiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Ok - volume updated",
+            "schema": {
+              "$ref": "#/definitions/volume"
+            }
+          },
+          "201": {
+            "description": "Volume created",
+            "schema": {
+              "$ref": "#/definitions/volume"
+            }
+          },
+          "202": {
+            "description": "Accepted -- Create request accepted; operation will complete asynchronously"
+          },
+          "default": {
+            "description": "Error response describing why the operation failed."
+          }
+        },
+        "x-ms-long-running-operation": true,
+        "x-ms-examples": {
+          "Volumes_CreateOrUpdate": {
+            "$ref": "examples/Volumes_CreateOrUpdate.json"
+          }
+        }
+      },
+      "patch": {
+        "tags": [
+          "Volumes"
+        ],
+        "operationId": "Volumes_Update",
+        "summary": "Update a volume",
+        "description": "Patch the specified volume",
+        "parameters": [
+          {
+            "name": "body",
+            "description": "Volume object supplied in the body of the operation.",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/volumePatch"
+            }
+          },
+          {
+            "$ref": "#/parameters/SubscriptionId"
+          },
+          {
+            "$ref": "#/parameters/ResourceGroup"
+          },
+          {
+            "$ref": "#/parameters/AccountName"
+          },
+          {
+            "$ref": "#/parameters/PoolName"
+          },
+          {
+            "$ref": "#/parameters/VolumeName"
+          },
+          {
+            "$ref": "#/parameters/ApiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/volume"
+            }
+          },
+          "202": {
+            "description": "Accepted -- Create, update or delete request accepted; operation will complete asynchronously"
+          },
+          "default": {
+            "description": "Error response describing why the operation failed."
+          }
+        },
+        "x-ms-long-running-operation": true,
+        "x-ms-examples": {
+          "Volumes_Update": {
+            "$ref": "examples/Volumes_Update.json"
+          }
+        }
+      },
+      "delete": {
+        "tags": [
+          "Volumes"
+        ],
+        "operationId": "Volumes_Delete",
+        "summary": "Delete a volume",
+        "description": "Delete the specified volume",
+        "parameters": [
+          {
+            "$ref": "#/parameters/SubscriptionId"
+          },
+          {
+            "$ref": "#/parameters/ResourceGroup"
+          },
+          {
+            "$ref": "#/parameters/AccountName"
+          },
+          {
+            "$ref": "#/parameters/PoolName"
+          },
+          {
+            "$ref": "#/parameters/VolumeName"
+          },
+          {
+            "$ref": "#/parameters/ApiVersionParameter"
+          }
+        ],
+        "responses": {
+          "202": {
+            "description": "Accepted -- Create, update or delete request accepted; operation will complete asynchronously"
+          },
+          "204": {
+            "description": "NoContent -- Resource does not exist."
+          },
+          "default": {
+            "description": "Error response describing why the operation failed."
+          }
+        },
+        "x-ms-long-running-operation": true,
+        "x-ms-examples": {
+          "Volumes_Delete": {
+            "$ref": "examples/Volumes_Delete.json"
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetApp/netAppAccounts/{accountName}/capacityPools/{poolName}/volumes/{volumeName}/revert": {
+      "post": {
+        "tags": [
+          "Volumes Revert"
+        ],
+        "summary": "Revert a volume to one of its snapshots",
+        "description": "Revert a volume to the snapshot specified in the body",
+        "operationId": "Volumes_Revert",
+        "parameters": [
+          {
+            "$ref": "#/parameters/SubscriptionId"
+          },
+          {
+            "$ref": "#/parameters/ResourceGroup"
+          },
+          {
+            "$ref": "#/parameters/AccountName"
+          },
+          {
+            "$ref": "#/parameters/PoolName"
+          },
+          {
+            "$ref": "#/parameters/VolumeName"
+          },
+          {
+            "$ref": "#/parameters/ApiVersionParameter"
+          },
+          {
+            "name": "body",
+            "description": "Object for snapshot to revert supplied in the body of the operation.",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/volumeRevert"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK - terminal state"
+          },
+          "202": {
+            "description": "Accepted"
+          },
+          "default": {
+            "description": "Error response describing why the operation failed."
+          }
+        },
+        "x-ms-long-running-operation": true,
+        "x-ms-examples": {
+          "Volumes_Revert": {
+            "$ref": "examples/Volumes_Revert.json"
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetApp/netAppAccounts/{accountName}/capacityPools/{poolName}/volumes/{volumeName}/breakReplication": {
+      "post": {
+        "tags": [
+          "Volumes Replication"
+        ],
+        "summary": "Break volume replication",
+        "description": "Break the replication connection on the destination volume",
+        "operationId": "Volumes_BreakReplication",
+        "parameters": [
+          {
+            "$ref": "#/parameters/SubscriptionId"
+          },
+          {
+            "$ref": "#/parameters/ResourceGroup"
+          },
+          {
+            "$ref": "#/parameters/AccountName"
+          },
+          {
+            "$ref": "#/parameters/PoolName"
+          },
+          {
+            "$ref": "#/parameters/VolumeName"
+          },
+          {
+            "$ref": "#/parameters/ApiVersionParameter"
+          },
+          {
+            "name": "body",
+            "description": "Optional body to force break the replication.",
+            "in": "body",
+            "required": false,
+            "schema": {
+              "$ref": "#/definitions/breakReplicationRequest"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK - terminal state"
+          },
+          "202": {
+            "description": "Accepted"
+          },
+          "default": {
+            "description": "Error response describing why the operation failed."
+          }
+        },
+        "x-ms-long-running-operation": true,
+        "x-ms-examples": {
+          "Volumes_BreakReplication": {
+            "$ref": "examples/Volumes_BreakReplication.json"
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetApp/netAppAccounts/{accountName}/capacityPools/{poolName}/volumes/{volumeName}/replicationStatus": {
+      "get": {
+        "tags": [
+          "Volumes Replication"
+        ],
+        "summary": "Get volume replication status",
+        "description": "Get the status of the replication",
+        "operationId": "Volumes_ReplicationStatus",
+        "parameters": [
+          {
+            "$ref": "#/parameters/SubscriptionId"
+          },
+          {
+            "$ref": "#/parameters/ResourceGroup"
+          },
+          {
+            "$ref": "#/parameters/AccountName"
+          },
+          {
+            "$ref": "#/parameters/PoolName"
+          },
+          {
+            "$ref": "#/parameters/VolumeName"
+          },
+          {
+            "$ref": "#/parameters/ApiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/replicationStatus"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed."
+          }
+        },
+        "x-ms-examples": {
+          "Volumes_ReplicationStatus": {
+            "$ref": "examples/Volumes_ReplicationStatus.json"
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetApp/netAppAccounts/{accountName}/capacityPools/{poolName}/volumes/{volumeName}/resyncReplication": {
+      "post": {
+        "tags": [
+          "Volumes Replication"
+        ],
+        "summary": "Resync volume replication",
+        "description": "Resync the connection on the destination volume. If the operation is ran on the source volume it will reverse-resync the connection and sync from source to destination.",
+        "operationId": "Volumes_ResyncReplication",
+        "parameters": [
+          {
+            "$ref": "#/parameters/SubscriptionId"
+          },
+          {
+            "$ref": "#/parameters/ResourceGroup"
+          },
+          {
+            "$ref": "#/parameters/AccountName"
+          },
+          {
+            "$ref": "#/parameters/PoolName"
+          },
+          {
+            "$ref": "#/parameters/VolumeName"
+          },
+          {
+            "$ref": "#/parameters/ApiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK - terminal state"
+          },
+          "202": {
+            "description": "Accepted"
+          },
+          "default": {
+            "description": "Error response describing why the operation failed."
+          }
+        },
+        "x-ms-long-running-operation": true,
+        "x-ms-examples": {
+          "Volumes_ResyncReplication": {
+            "$ref": "examples/Volumes_ResyncReplication.json"
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetApp/netAppAccounts/{accountName}/capacityPools/{poolName}/volumes/{volumeName}/deleteReplication": {
+      "post": {
+        "tags": [
+          "Volumes Replication"
+        ],
+        "summary": "Delete volume replication",
+        "description": "Delete the replication connection on the destination volume, and send release to the source replication",
+        "operationId": "Volumes_DeleteReplication",
+        "parameters": [
+          {
+            "$ref": "#/parameters/SubscriptionId"
+          },
+          {
+            "$ref": "#/parameters/ResourceGroup"
+          },
+          {
+            "$ref": "#/parameters/AccountName"
+          },
+          {
+            "$ref": "#/parameters/PoolName"
+          },
+          {
+            "$ref": "#/parameters/VolumeName"
+          },
+          {
+            "$ref": "#/parameters/ApiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK - terminal state"
+          },
+          "202": {
+            "description": "Accepted"
+          },
+          "default": {
+            "description": "Error response describing why the operation failed."
+          }
+        },
+        "x-ms-long-running-operation": true,
+        "x-ms-examples": {
+          "Volumes_DeleteReplication": {
+            "$ref": "examples/Volumes_DeleteReplication.json"
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetApp/netAppAccounts/{accountName}/capacityPools/{poolName}/volumes/{volumeName}/authorizeReplication": {
+      "post": {
+        "tags": [
+          "Volumes Replication"
+        ],
+        "summary": "Authorize source volume replication",
+        "description": "Authorize the replication connection on the source volume",
+        "operationId": "Volumes_AuthorizeReplication",
+        "parameters": [
+          {
+            "$ref": "#/parameters/SubscriptionId"
+          },
+          {
+            "$ref": "#/parameters/ResourceGroup"
+          },
+          {
+            "$ref": "#/parameters/AccountName"
+          },
+          {
+            "$ref": "#/parameters/PoolName"
+          },
+          {
+            "$ref": "#/parameters/VolumeName"
+          },
+          {
+            "$ref": "#/parameters/ApiVersionParameter"
+          },
+          {
+            "name": "body",
+            "description": "Authorize request object supplied in the body of the operation.",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/authorizeRequest"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK - terminal state"
+          },
+          "202": {
+            "description": "Accepted"
+          },
+          "default": {
+            "description": "Error response describing why the operation failed."
+          }
+        },
+        "x-ms-long-running-operation": true,
+        "x-ms-examples": {
+          "Volumes_AuthorizeReplication": {
+            "$ref": "examples/Volumes_AuthorizeReplication.json"
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetApp/netAppAccounts/{accountName}/capacityPools/{poolName}/volumes/{volumeName}/reinitializeReplication": {
+      "post": {
+        "tags": [
+          "Volumes Replication"
+        ],
+        "summary": "ReInitialize volume replication",
+        "description": "Re-Initializes the replication connection on the destination volume",
+        "operationId": "Volumes_ReInitializeReplication",
+        "parameters": [
+          {
+            "$ref": "#/parameters/SubscriptionId"
+          },
+          {
+            "$ref": "#/parameters/ResourceGroup"
+          },
+          {
+            "$ref": "#/parameters/AccountName"
+          },
+          {
+            "$ref": "#/parameters/PoolName"
+          },
+          {
+            "$ref": "#/parameters/VolumeName"
+          },
+          {
+            "$ref": "#/parameters/ApiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK - terminal state"
+          },
+          "202": {
+            "description": "Accepted"
+          },
+          "default": {
+            "description": "Error response describing why the operation failed."
+          }
+        },
+        "x-ms-long-running-operation": true,
+        "x-ms-examples": {
+          "Volumes_ReInitializeReplication": {
+            "$ref": "examples/Volumes_ReInitializeReplication.json"
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetApp/netAppAccounts/{accountName}/capacityPools/{poolName}/volumes/{volumeName}/poolChange": {
+      "post": {
+        "tags": [
+          "Pool Change"
+        ],
+        "summary": "Change pool for volume",
+        "description": "Moves volume to another pool",
+        "operationId": "Volumes_PoolChange",
+        "parameters": [
+          {
+            "$ref": "#/parameters/SubscriptionId"
+          },
+          {
+            "$ref": "#/parameters/ResourceGroup"
+          },
+          {
+            "$ref": "#/parameters/AccountName"
+          },
+          {
+            "$ref": "#/parameters/PoolName"
+          },
+          {
+            "$ref": "#/parameters/VolumeName"
+          },
+          {
+            "$ref": "#/parameters/ApiVersionParameter"
+          },
+          {
+            "name": "body",
+            "description": "Move volume to the pool supplied in the body of the operation.",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/poolChangeRequest"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK - terminal state"
+          },
+          "202": {
+            "description": "Accepted"
+          },
+          "default": {
+            "description": "Error response describing why the operation failed."
+          }
+        },
+        "x-ms-long-running-operation": true,
+        "x-ms-examples": {
+          "Volumes_AuthorizeReplication": {
+            "$ref": "examples/Volumes_PoolChange.json"
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetApp/netAppAccounts/{accountName}/capacityPools/{poolName}/volumes/{volumeName}/snapshots": {
+      "get": {
+        "tags": [
+          "Snapshots"
+        ],
+        "operationId": "Snapshots_List",
+        "summary": "Describe all snapshots",
+        "parameters": [
+          {
+            "$ref": "#/parameters/SubscriptionId"
+          },
+          {
+            "$ref": "#/parameters/ResourceGroup"
+          },
+          {
+            "$ref": "#/parameters/AccountName"
+          },
+          {
+            "$ref": "#/parameters/PoolName"
+          },
+          {
+            "$ref": "#/parameters/VolumeName"
+          },
+          {
+            "$ref": "#/parameters/ApiVersionParameter"
+          }
+        ],
+        "description": "List all snapshots associated with the volume",
+        "x-ms-pageable": {
+          "nextLinkName": null
+        },
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/snapshotsList"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed."
+          }
+        },
+        "x-ms-examples": {
+          "Snapshots_List": {
+            "$ref": "examples/Snapshots_List.json"
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetApp/netAppAccounts/{accountName}/capacityPools/{poolName}/volumes/{volumeName}/snapshots/{snapshotName}": {
+      "get": {
+        "tags": [
+          "Snapshots"
+        ],
+        "operationId": "Snapshots_Get",
+        "summary": "Describe a snapshot",
+        "description": "Get details of the specified snapshot",
+        "parameters": [
+          {
+            "$ref": "#/parameters/SubscriptionId"
+          },
+          {
+            "$ref": "#/parameters/ResourceGroup"
+          },
+          {
+            "$ref": "#/parameters/AccountName"
+          },
+          {
+            "$ref": "#/parameters/PoolName"
+          },
+          {
+            "$ref": "#/parameters/VolumeName"
+          },
+          {
+            "$ref": "#/parameters/SnapshotName"
+          },
+          {
+            "$ref": "#/parameters/ApiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/snapshot"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed."
+          }
+        },
+        "x-ms-examples": {
+          "Snapshots_Get": {
+            "$ref": "examples/Snapshots_Get.json"
+          }
+        }
+      },
+      "put": {
+        "tags": [
+          "Snapshots"
+        ],
+        "operationId": "Snapshots_Create",
+        "summary": "Create a snapshot",
+        "description": "Create the specified snapshot within the given volume",
+        "parameters": [
+          {
+            "name": "body",
+            "description": "Snapshot object supplied in the body of the operation.",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/snapshot"
+            }
+          },
+          {
+            "$ref": "#/parameters/SubscriptionId"
+          },
+          {
+            "$ref": "#/parameters/ResourceGroup"
+          },
+          {
+            "$ref": "#/parameters/AccountName"
+          },
+          {
+            "$ref": "#/parameters/PoolName"
+          },
+          {
+            "$ref": "#/parameters/VolumeName"
+          },
+          {
+            "$ref": "#/parameters/SnapshotName"
+          },
+          {
+            "$ref": "#/parameters/ApiVersionParameter"
+          }
+        ],
+        "responses": {
+          "201": {
+            "description": "Snapshot created",
+            "schema": {
+              "$ref": "#/definitions/snapshot"
+            }
+          },
+          "202": {
+            "description": "Accepted -- Create request accepted; operation will complete asynchronously"
+          },
+          "default": {
+            "description": "Error response describing why the operation failed."
+          }
+        },
+        "x-ms-long-running-operation": true,
+        "x-ms-examples": {
+          "Snapshots_Create": {
+            "$ref": "examples/Snapshots_Create.json"
+          }
+        }
+      },
+      "patch": {
+        "tags": [
+          "Snapshots"
+        ],
+        "operationId": "Snapshots_Update",
+        "summary": "Update a snapshot",
+        "description": "Patch a snapshot",
+        "parameters": [
+          {
+            "name": "body",
+            "description": "Snapshot object supplied in the body of the operation.",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/snapshotPatch"
+            }
+          },
+          {
+            "$ref": "#/parameters/SubscriptionId"
+          },
+          {
+            "$ref": "#/parameters/ResourceGroup"
+          },
+          {
+            "$ref": "#/parameters/AccountName"
+          },
+          {
+            "$ref": "#/parameters/PoolName"
+          },
+          {
+            "$ref": "#/parameters/VolumeName"
+          },
+          {
+            "$ref": "#/parameters/SnapshotName"
+          },
+          {
+            "$ref": "#/parameters/ApiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/snapshot"
+            }
+          },
+          "202": {
+            "description": "Accepted -- Update request accepted; operation will complete asynchronously"
+          },
+          "default": {
+            "description": "Error response describing why the operation failed."
+          }
+        },
+        "x-ms-long-running-operation": true,
+        "x-ms-examples": {
+          "Snapshots_Update": {
+            "$ref": "examples/Snapshots_Update.json"
+          }
+        }
+      },
+      "delete": {
+        "tags": [
+          "Snapshots"
+        ],
+        "operationId": "Snapshots_Delete",
+        "summary": "Delete a snapshot",
+        "description": "Delete snapshot",
+        "parameters": [
+          {
+            "$ref": "#/parameters/SubscriptionId"
+          },
+          {
+            "$ref": "#/parameters/ResourceGroup"
+          },
+          {
+            "$ref": "#/parameters/AccountName"
+          },
+          {
+            "$ref": "#/parameters/PoolName"
+          },
+          {
+            "$ref": "#/parameters/VolumeName"
+          },
+          {
+            "$ref": "#/parameters/SnapshotName"
+          },
+          {
+            "$ref": "#/parameters/ApiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK"
+          },
+          "202": {
+            "description": "Accepted -- Create, update or delete request accepted; operation will complete asynchronously"
+          },
+          "204": {
+            "description": "NoContent -- Resource does not exist."
+          },
+          "default": {
+            "description": "Error response describing why the operation failed."
+          }
+        },
+        "x-ms-long-running-operation": true,
+        "x-ms-examples": {
+          "Snapshots_Delete": {
+            "$ref": "examples/Snapshots_Delete.json"
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetApp/netAppAccounts/{accountName}/snapshotPolicies": {
+      "parameters": [
+        {
+          "$ref": "#/parameters/SubscriptionId"
+        },
+        {
+          "$ref": "#/parameters/ResourceGroup"
+        },
+        {
+          "$ref": "#/parameters/AccountName"
+        },
+        {
+          "$ref": "#/parameters/ApiVersionParameter"
+        }
+      ],
+      "get": {
+        "tags": [
+          "Snapshot Policy"
+        ],
+        "operationId": "SnapshotPolicies_List",
+        "description": "List snapshot policy",
+        "x-ms-pageable": {
+          "nextLinkName": null
+        },
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/snapshotPoliciesList"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed."
+          }
+        },
+        "x-ms-examples": {
+          "SnapshotPolicies_List": {
+            "$ref": "examples/SnapshotPolicies_List.json"
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetApp/netAppAccounts/{accountName}/snapshotPolicies/{snapshotPolicyName}": {
+      "parameters": [
+        {
+          "$ref": "#/parameters/SubscriptionId"
+        },
+        {
+          "$ref": "#/parameters/ResourceGroup"
+        },
+        {
+          "$ref": "#/parameters/AccountName"
+        },
+        {
+          "$ref": "#/parameters/SnapshotPolicyName"
+        },
+        {
+          "$ref": "#/parameters/ApiVersionParameter"
+        }
+      ],
+      "get": {
+        "tags": [
+          "Snapshot Policy"
+        ],
+        "operationId": "SnapshotPolicies_Get",
+        "description": "Get a snapshot Policy",
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/snapshotPolicy"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed."
+          }
+        },
+        "x-ms-examples": {
+          "SnapshotPolicies_Get": {
+            "$ref": "examples/SnapshotPolicies_Get.json"
+          }
+        }
+      },
+      "put": {
+        "tags": [
+          "Snapshot Policy"
+        ],
+        "operationId": "SnapshotPolicies_Create",
+        "description": "Create a snapshot policy",
+        "parameters": [
+          {
+            "name": "body",
+            "description": "Snapshot policy object supplied in the body of the operation.",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/snapshotPolicy"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK - snapshot Policy updated",
+            "schema": {
+              "$ref": "#/definitions/snapshotPolicy"
+            }
+          },
+          "201": {
+            "description": "Snapshot Policy created",
+            "schema": {
+              "$ref": "#/definitions/snapshotPolicy"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed."
+          }
+        },
+        "x-ms-long-running-operation": false,
+        "x-ms-examples": {
+          "SnapshotPolicies_Create": {
+            "$ref": "examples/SnapshotPolicies_Create.json"
+          }
+        }
+      },
+      "patch": {
+        "tags": [
+          "Snapshot Policy"
+        ],
+        "operationId": "SnapshotPolicies_Update",
+        "description": "Patch a snapshot policy",
+        "parameters": [
+          {
+            "name": "body",
+            "description": "Snapshot policy object supplied in the body of the operation.",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/snapshotPolicyPatch"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/snapshotPolicy"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed."
+          }
+        },
+        "x-ms-examples": {
+          "SnapshotPolicies_Update": {
+            "$ref": "examples/SnapshotPolicies_Update.json"
+          }
+        }
+      },
+      "delete": {
+        "tags": [
+          "Snapshot Policy"
+        ],
+        "operationId": "SnapshotPolicies_Delete",
+        "description": "Delete snapshot policy",
+        "responses": {
+          "200": {
+            "description": "OK"
+          },
+          "202": {
+            "description": "Accepted -- Create or update request accepted; operation will complete asynchronously"
+          },
+          "204": {
+            "description": "NoContent -- Resource does not exist."
+          },
+          "default": {
+            "description": "Error response describing why the operation failed."
+          }
+        },
+        "x-ms-long-running-operation": true,
+        "x-ms-examples": {
+          "SnapshotPolicies_Delete": {
+            "$ref": "examples/SnapshotPolicies_Delete.json"
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetApp/netAppAccounts/{accountName}/snapshotPolicies/{snapshotPolicyName}/listVolumes": {
+      "get": {
+        "tags": [
+          "Snapshot Policy List Volumes"
+        ],
+        "summary": "Get volumes associated with snapshot policy",
+        "description": "Get volumes associated with snapshot policy",
+        "operationId": "SnapshotPolicies_ListVolumes",
+        "parameters": [
+          {
+            "$ref": "#/parameters/SubscriptionId"
+          },
+          {
+            "$ref": "#/parameters/ResourceGroup"
+          },
+          {
+            "$ref": "#/parameters/AccountName"
+          },
+          {
+            "$ref": "#/parameters/SnapshotPolicyName"
+          },
+          {
+            "$ref": "#/parameters/ApiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/snapshotPolicyVolumeList"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed."
+          }
+        },
+        "x-ms-examples": {
+          "SnapshotPolicies_ListVolumes": {
+            "$ref": "examples/SnapshotPolicies_ListVolumes.json"
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetApp/netAppAccounts/{accountName}/accountBackups": {
+      "get": {
+        "tags": [
+          "Backups"
+        ],
+        "summary": "List Backups for a Netapp Account",
+        "description": "List all Backups for a Netapp Account",
+        "operationId": "AccountBackups_List",
+        "parameters": [
+          {
+            "$ref": "#/parameters/SubscriptionId"
+          },
+          {
+            "$ref": "#/parameters/ResourceGroup"
+          },
+          {
+            "$ref": "#/parameters/AccountName"
+          },
+          {
+            "$ref": "#/parameters/ApiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/backupsList"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed."
+          }
+        },
+        "x-ms-examples": {
+          "AccountBackups_List": {
+            "$ref": "examples/Backups_Account_List.json"
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetApp/netAppAccounts/{accountName}/accountBackups/{backupName}": {
+      "get": {
+        "tags": [
+          "Backups"
+        ],
+        "summary": "Get Backup for a Netapp Account",
+        "description": "Get Backup for a Netapp Account",
+        "operationId": "AccountBackups_Get",
+        "parameters": [
+          {
+            "$ref": "#/parameters/SubscriptionId"
+          },
+          {
+            "$ref": "#/parameters/ResourceGroup"
+          },
+          {
+            "$ref": "#/parameters/AccountName"
+          },
+          {
+            "$ref": "#/parameters/BackupName"
+          },
+          {
+            "$ref": "#/parameters/ApiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/backup"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed."
+          }
+        },
+        "x-ms-examples": {
+          "AccountBackups_Get": {
+            "$ref": "examples/Backups_Account_Get.json"
+          }
+        }
+      },
+      "delete": {
+        "tags": [
+          "Backups"
+        ],
+        "summary": "Delete Backup for a Netapp Account",
+        "description": "Delete Backup for a Netapp Account",
+        "operationId": "AccountBackups_Delete",
+        "parameters": [
+          {
+            "$ref": "#/parameters/SubscriptionId"
+          },
+          {
+            "$ref": "#/parameters/ResourceGroup"
+          },
+          {
+            "$ref": "#/parameters/AccountName"
+          },
+          {
+            "$ref": "#/parameters/BackupName"
+          },
+          {
+            "$ref": "#/parameters/ApiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK"
+          },
+          "202": {
+            "description": "Accepted -- Create or update request accepted; operation will complete asynchronously"
+          },
+          "204": {
+            "description": "NoContent -- Resource does not exist."
+          },
+          "default": {
+            "description": "Error response describing why the operation failed."
+          }
+        },
+        "x-ms-long-running-operation": true,
+        "x-ms-examples": {
+          "AccountBackups_Delete": {
+            "$ref": "examples/Backups_Account_Delete.json"
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetApp/netAppAccounts/{accountName}/capacityPools/{poolName}/volumes/{volumeName}/backups": {
+      "get": {
+        "tags": [
+          "Backups"
+        ],
+        "summary": "List Backups",
+        "description": "List all backups for a volume",
+        "operationId": "Backups_List",
+        "parameters": [
+          {
+            "$ref": "#/parameters/SubscriptionId"
+          },
+          {
+            "$ref": "#/parameters/ResourceGroup"
+          },
+          {
+            "$ref": "#/parameters/AccountName"
+          },
+          {
+            "$ref": "#/parameters/PoolName"
+          },
+          {
+            "$ref": "#/parameters/VolumeName"
+          },
+          {
+            "$ref": "#/parameters/ApiVersionParameter"
+          }
+        ],
+        "x-ms-pageable": {
+          "nextLinkName": null
+        },
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/backupsList"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed."
+          }
+        },
+        "x-ms-examples": {
+          "Backups_List": {
+            "$ref": "examples/Backups_List.json"
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetApp/netAppAccounts/{accountName}/capacityPools/{poolName}/volumes/{volumeName}/backups/{backupName}": {
+      "get": {
+        "tags": [
+          "Backups"
+        ],
+        "summary": "Get a backup",
+        "description": "Get a particular backup of the volume",
+        "operationId": "Backups_Get",
+        "parameters": [
+          {
+            "$ref": "#/parameters/SubscriptionId"
+          },
+          {
+            "$ref": "#/parameters/ResourceGroup"
+          },
+          {
+            "$ref": "#/parameters/AccountName"
+          },
+          {
+            "$ref": "#/parameters/PoolName"
+          },
+          {
+            "$ref": "#/parameters/VolumeName"
+          },
+          {
+            "$ref": "#/parameters/BackupName"
+          },
+          {
+            "$ref": "#/parameters/ApiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/backup"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed."
+          }
+        },
+        "x-ms-examples": {
+          "Backups_Get": {
+            "$ref": "examples/Backups_Get.json"
+          }
+        }
+      },
+      "put": {
+        "tags": [
+          "Backups"
+        ],
+        "summary": "Create a backup",
+        "description": "Create a backup for the volume",
+        "operationId": "Backups_Create",
+        "parameters": [
+          {
+            "$ref": "#/parameters/SubscriptionId"
+          },
+          {
+            "$ref": "#/parameters/ResourceGroup"
+          },
+          {
+            "$ref": "#/parameters/AccountName"
+          },
+          {
+            "$ref": "#/parameters/PoolName"
+          },
+          {
+            "$ref": "#/parameters/VolumeName"
+          },
+          {
+            "$ref": "#/parameters/BackupName"
+          },
+          {
+            "$ref": "#/parameters/ApiVersionParameter"
+          },
+          {
+            "name": "body",
+            "description": "Backup object supplied in the body of the operation.",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/backup"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK created",
+            "schema": {
+              "$ref": "#/definitions/backup"
+            }
+          },
+          "201": {
+            "description": "Backup created",
+            "schema": {
+              "$ref": "#/definitions/backup"
+            }
+          },
+          "202": {
+            "description": "Accepted -- Create request accepted; operation will complete asynchronously"
+          },
+          "default": {
+            "description": "Error response describing why the operation failed."
+          }
+        },
+        "x-ms-long-running-operation": true,
+        "x-ms-examples": {
+          "Backups_Create": {
+            "$ref": "examples/Backups_Create.json"
+          }
+        }
+      },
+      "patch": {
+        "tags": [
+          "Backups"
+        ],
+        "summary": "Patch a backup",
+        "description": "Patch a backup for the volume",
+        "operationId": "Backups_Update",
+        "parameters": [
+          {
+            "$ref": "#/parameters/SubscriptionId"
+          },
+          {
+            "$ref": "#/parameters/ResourceGroup"
+          },
+          {
+            "$ref": "#/parameters/AccountName"
+          },
+          {
+            "$ref": "#/parameters/PoolName"
+          },
+          {
+            "$ref": "#/parameters/VolumeName"
+          },
+          {
+            "$ref": "#/parameters/BackupName"
+          },
+          {
+            "$ref": "#/parameters/ApiVersionParameter"
+          },
+          {
+            "name": "body",
+            "description": "Backup object supplied in the body of the operation.",
+            "in": "body",
+            "schema": {
+              "$ref": "#/definitions/backupPatch"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/backup"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed."
+          }
+        },
+        "x-ms-examples": {
+          "Backups_Update": {
+            "$ref": "examples/Backups_Update.json"
+          }
+        }
+      },
+      "delete": {
+        "tags": [
+          "Backups"
+        ],
+        "summary": "Delete backup",
+        "description": "Delete a backup of the volume",
+        "operationId": "Backups_Delete",
+        "parameters": [
+          {
+            "$ref": "#/parameters/SubscriptionId"
+          },
+          {
+            "$ref": "#/parameters/ResourceGroup"
+          },
+          {
+            "$ref": "#/parameters/AccountName"
+          },
+          {
+            "$ref": "#/parameters/PoolName"
+          },
+          {
+            "$ref": "#/parameters/VolumeName"
+          },
+          {
+            "$ref": "#/parameters/BackupName"
+          },
+          {
+            "$ref": "#/parameters/ApiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK"
+          },
+          "202": {
+            "description": "Accepted -- Create or update request accepted; operation will complete asynchronously"
+          },
+          "204": {
+            "description": "NoContent -- Resource does not exist."
+          },
+          "default": {
+            "description": "Error response describing why the operation failed."
+          }
+        },
+        "x-ms-long-running-operation": true,
+        "x-ms-examples": {
+          "Backups_Delete": {
+            "$ref": "examples/Backups_Delete.json"
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetApp/netAppAccounts/{accountName}/backupPolicies": {
+      "get": {
+        "tags": [
+          "Backup Policy"
+        ],
+        "summary": "List backup policies",
+        "description": "List backup policies for Netapp Account",
+        "operationId": "BackupPolicies_List",
+        "parameters": [
+          {
+            "$ref": "#/parameters/SubscriptionId"
+          },
+          {
+            "$ref": "#/parameters/ResourceGroup"
+          },
+          {
+            "$ref": "#/parameters/AccountName"
+          },
+          {
+            "$ref": "#/parameters/ApiVersionParameter"
+          }
+        ],
+        "x-ms-pageable": {
+          "nextLinkName": null
+        },
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/backupPoliciesList"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed."
+          }
+        },
+        "x-ms-examples": {
+          "Backups_List": {
+            "$ref": "examples/BackupPolicies_List.json"
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetApp/netAppAccounts/{accountName}/backupPolicies/{backupPolicyName}": {
+      "get": {
+        "tags": [
+          "Backup Policy"
+        ],
+        "summary": "Get a backup Policy",
+        "description": "Get a particular backup Policy",
+        "operationId": "BackupPolicies_Get",
+        "parameters": [
+          {
+            "$ref": "#/parameters/SubscriptionId"
+          },
+          {
+            "$ref": "#/parameters/ResourceGroup"
+          },
+          {
+            "$ref": "#/parameters/AccountName"
+          },
+          {
+            "$ref": "#/parameters/BackupPolicyName"
+          },
+          {
+            "$ref": "#/parameters/ApiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/backupPolicy"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed."
+          }
+        },
+        "x-ms-examples": {
+          "Backups_Get": {
+            "$ref": "examples/BackupPolicies_Get.json"
+          }
+        }
+      },
+      "put": {
+        "tags": [
+          "Backup Policy"
+        ],
+        "summary": "Create a backup policy",
+        "description": "Create a backup policy for Netapp Account",
+        "operationId": "BackupPolicies_Create",
+        "parameters": [
+          {
+            "$ref": "#/parameters/SubscriptionId"
+          },
+          {
+            "$ref": "#/parameters/ResourceGroup"
+          },
+          {
+            "$ref": "#/parameters/AccountName"
+          },
+          {
+            "$ref": "#/parameters/BackupPolicyName"
+          },
+          {
+            "$ref": "#/parameters/ApiVersionParameter"
+          },
+          {
+            "name": "body",
+            "description": "Backup policy object supplied in the body of the operation.",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/backupPolicy"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Backup Policy created",
+            "schema": {
+              "$ref": "#/definitions/backupPolicy"
+            }
+          },
+          "201": {
+            "description": "Backup created",
+            "schema": {
+              "$ref": "#/definitions/backupPolicy"
+            }
+          },
+          "202": {
+            "description": "Accepted -- Create request accepted; operation will complete asynchronously"
+          },
+          "default": {
+            "description": "Error response describing why the operation failed."
+          }
+        },
+        "x-ms-long-running-operation": true,
+        "x-ms-examples": {
+          "BackupPolicies_Create": {
+            "$ref": "examples/BackupPolicies_Create.json"
+          }
+        }
+      },
+      "patch": {
+        "tags": [
+          "Backup Policy"
+        ],
+        "summary": "Patch a backup policy",
+        "description": "Patch a backup policy for Netapp Account",
+        "operationId": "BackupPolicies_Update",
+        "parameters": [
+          {
+            "$ref": "#/parameters/SubscriptionId"
+          },
+          {
+            "$ref": "#/parameters/ResourceGroup"
+          },
+          {
+            "$ref": "#/parameters/AccountName"
+          },
+          {
+            "$ref": "#/parameters/BackupPolicyName"
+          },
+          {
+            "$ref": "#/parameters/ApiVersionParameter"
+          },
+          {
+            "name": "body",
+            "description": "Backup policy object supplied in the body of the operation.",
+            "in": "body",
+            "required": true,
+            "schema": {
+              "$ref": "#/definitions/backupPolicyPatch"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/backupPolicy"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed."
+          }
+        },
+        "x-ms-examples": {
+          "BackupPolicies_Update": {
+            "$ref": "examples/BackupPolicies_Update.json"
+          }
+        }
+      },
+      "delete": {
+        "tags": [
+          "Backup Policy"
+        ],
+        "summary": "Delete a backup policy",
+        "description": "Delete backup policy",
+        "operationId": "BackupPolicies_Delete",
+        "parameters": [
+          {
+            "$ref": "#/parameters/SubscriptionId"
+          },
+          {
+            "$ref": "#/parameters/ResourceGroup"
+          },
+          {
+            "$ref": "#/parameters/AccountName"
+          },
+          {
+            "$ref": "#/parameters/BackupPolicyName"
+          },
+          {
+            "$ref": "#/parameters/ApiVersionParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK"
+          },
+          "202": {
+            "description": "Accepted -- Create or update request accepted; operation will complete asynchronously"
+          },
+          "204": {
+            "description": "NoContent -- Resource does not exist."
+          },
+          "default": {
+            "description": "Error response describing why the operation failed."
+          }
+        },
+        "x-ms-long-running-operation": true,
+        "x-ms-examples": {
+          "Backups_Delete": {
+            "$ref": "examples/BackupPolicies_Delete.json"
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetApp/netAppAccounts/{accountName}/vaults": {
+      "get": {
+        "tags": [
+          "Vaults"
+        ],
+        "summary": "List vaults",
+        "description": "List vaults for a Netapp Account",
+        "operationId": "Vaults_List",
+        "parameters": [
+          {
+            "$ref": "#/parameters/SubscriptionId"
+          },
+          {
+            "$ref": "#/parameters/ResourceGroup"
+          },
+          {
+            "$ref": "#/parameters/AccountName"
+          },
+          {
+            "$ref": "#/parameters/ApiVersionParameter"
+          }
+        ],
+        "x-ms-pageable": {
+          "nextLinkName": null
+        },
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/vaultList"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed."
+          }
+        },
+        "x-ms-examples": {
+          "Vaults_List": {
+            "$ref": "examples/Vaults_List.json"
+          }
+        }
+      }
+    }
+  },
+  "definitions": {
+    "OperationListResult": {
+      "description": "Result of the request to list Cloud Volume 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 Storage operations supported by the Storage resource provider."
+        }
+      }
+    },
+    "Operation": {
+      "description": "Microsoft.NetApp REST API operation definition.",
+      "type": "object",
+      "properties": {
+        "name": {
+          "description": "Operation name: {provider}/{resource}/{operation}",
+          "type": "string"
+        },
+        "display": {
+          "description": "Display metadata associated with the operation.",
+          "properties": {
+            "provider": {
+              "description": "Service provider: Microsoft NetApp.",
+              "type": "string"
+            },
+            "resource": {
+              "description": "Resource on which the operation is performed etc.",
+              "type": "string"
+            },
+            "operation": {
+              "description": "Type of operation: get, read, delete, etc.",
+              "type": "string"
+            },
+            "description": {
+              "description": "Operation description.",
+              "type": "string"
+            }
+          }
+        },
+        "origin": {
+          "type": "string",
+          "description": "The origin of operations."
+        },
+        "properties": {
+          "$ref": "#/definitions/OperationProperties",
+          "description": "Properties of operation, include metric specifications.",
+          "x-ms-client-flatten": true
+        }
+      }
+    },
+    "OperationProperties": {
+      "description": "Properties of operation, include metric specifications.",
+      "properties": {
+        "serviceSpecification": {
+          "$ref": "#/definitions/ServiceSpecification",
+          "description": "One property of operation, include metric specifications."
+        }
+      }
+    },
+    "ServiceSpecification": {
+      "description": "One property of operation, include metric specifications.",
+      "properties": {
+        "metricSpecifications": {
+          "description": "Metric specifications of operation.",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/MetricSpecification"
+          }
+        }
+      }
+    },
+    "MetricSpecification": {
+      "description": "Metric specification of operation.",
+      "properties": {
+        "name": {
+          "type": "string",
+          "description": "Name of metric specification."
+        },
+        "displayName": {
+          "type": "string",
+          "description": "Display name of metric specification."
+        },
+        "displayDescription": {
+          "type": "string",
+          "description": "Display description of metric specification."
+        },
+        "unit": {
+          "type": "string",
+          "description": "Unit could be Bytes or Count."
+        },
+        "dimensions": {
+          "description": "Dimensions of blobs, including blob type and access tier.",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/Dimension"
+          }
+        },
+        "aggregationType": {
+          "type": "string",
+          "description": "Aggregation type could be Average."
+        },
+        "fillGapWithZero": {
+          "type": "boolean",
+          "description": "The property to decide fill gap with zero or not."
+        },
+        "category": {
+          "type": "string",
+          "description": "The category this metric specification belong to, could be Capacity."
+        },
+        "resourceIdDimensionNameOverride": {
+          "type": "string",
+          "description": "Account Resource Id."
+        }
+      }
+    },
+    "Dimension": {
+      "description": "Dimension of blobs, possibly be blob type or access tier.",
+      "properties": {
+        "name": {
+          "type": "string",
+          "description": "Display name of dimension."
+        },
+        "displayName": {
+          "type": "string",
+          "description": "Display name of dimension."
+        }
+      }
+    },
+    "CheckAvailabilityResponse": {
+      "description": "Information regarding availability of a resource.",
+      "type": "object",
+      "properties": {
+        "isAvailable": {
+          "description": "<code>true</code> indicates name is valid and available. <code>false</code> indicates the name is invalid, unavailable, or both.",
+          "type": "boolean"
+        },
+        "reason": {
+          "description": "<code>Invalid</code> indicates the name provided does not match Azure App Service naming requirements. <code>AlreadyExists</code> indicates that the name is already in use and is therefore unavailable.",
+          "enum": [
+            "Invalid",
+            "AlreadyExists"
+          ],
+          "type": "string",
+          "x-ms-enum": {
+            "name": "InAvailabilityReasonType",
+            "modelAsString": true
+          }
+        },
+        "message": {
+          "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 resource name is already in use, and direct them to select a different name.",
+          "type": "string"
+        }
+      }
+    },
+    "ResourceNameAvailabilityRequest": {
+      "description": "Resource name availability request content.",
+      "required": [
+        "name",
+        "type",
+        "resourceGroup"
+      ],
+      "type": "object",
+      "properties": {
+        "name": {
+          "description": "Resource name to verify.",
+          "type": "string"
+        },
+        "type": {
+          "description": "Resource type used for verification.",
+          "enum": [
+            "Microsoft.NetApp/netAppAccounts",
+            "Microsoft.NetApp/netAppAccounts/capacityPools",
+            "Microsoft.NetApp/netAppAccounts/capacityPools/volumes",
+            "Microsoft.NetApp/netAppAccounts/capacityPools/volumes/snapshots"
+          ],
+          "type": "string",
+          "x-ms-enum": {
+            "name": "CheckNameResourceTypes",
+            "modelAsString": true
+          }
+        },
+        "resourceGroup": {
+          "description": "Resource group name.",
+          "type": "string"
+        }
+      }
+    },
+    "QuotaAvailabilityRequest": {
+      "description": "Quota availability request content.",
+      "required": [
+        "name",
+        "type",
+        "resourceGroup"
+      ],
+      "type": "object",
+      "properties": {
+        "name": {
+          "description": "Name of the resource to verify.",
+          "type": "string"
+        },
+        "type": {
+          "description": "Resource type used for verification.",
+          "enum": [
+            "Microsoft.NetApp/netAppAccounts",
+            "Microsoft.NetApp/netAppAccounts/capacityPools",
+            "Microsoft.NetApp/netAppAccounts/capacityPools/volumes",
+            "Microsoft.NetApp/netAppAccounts/capacityPools/volumes/snapshots"
+          ],
+          "type": "string",
+          "x-ms-enum": {
+            "name": "CheckQuotaNameResourceTypes",
+            "modelAsString": true
+          }
+        },
+        "resourceGroup": {
+          "description": "Resource group name.",
+          "type": "string"
+        }
+      }
+    },
+    "netAppAccountList": {
+      "description": "List of NetApp account resources",
+      "type": "object",
+      "properties": {
+        "value": {
+          "type": "array",
+          "description": "Multiple NetApp accounts",
+          "items": {
+            "$ref": "#/definitions/netAppAccount"
+          }
+        }
+      }
+    },
+    "netAppAccount": {
+      "description": "NetApp account resource",
+      "type": "object",
+      "x-ms-azure-resource": true,
+      "required": [
+        "location"
+      ],
+      "properties": {
+        "location": {
+          "type": "string",
+          "description": "Resource location",
+          "x-ms-mutability": [
+            "read",
+            "create"
+          ]
+        },
+        "id": {
+          "type": "string",
+          "readOnly": true,
+          "description": "Resource Id"
+        },
+        "name": {
+          "type": "string",
+          "readOnly": true,
+          "description": "Resource name"
+        },
+        "type": {
+          "type": "string",
+          "readOnly": true,
+          "description": "Resource type"
+        },
+        "tags": {
+          "description": "Resource tags",
+          "$ref": "#/definitions/resourceTags"
+        },
+        "properties": {
+          "description": "NetApp Account properties",
+          "$ref": "#/definitions/accountProperties",
+          "x-ms-client-flatten": true
+        }
+      }
+    },
+    "netAppAccountPatch": {
+      "description": "NetApp account patch resource",
+      "type": "object",
+      "x-ms-azure-resource": true,
+      "properties": {
+        "location": {
+          "type": "string",
+          "description": "Resource location"
+        },
+        "id": {
+          "type": "string",
+          "readOnly": true,
+          "description": "Resource Id"
+        },
+        "name": {
+          "type": "string",
+          "readOnly": true,
+          "description": "Resource name"
+        },
+        "type": {
+          "type": "string",
+          "readOnly": true,
+          "description": "Resource type"
+        },
+        "tags": {
+          "description": "Resource tags",
+          "$ref": "#/definitions/resourceTags"
+        },
+        "properties": {
+          "description": "NetApp Account properties",
+          "$ref": "#/definitions/accountProperties",
+          "x-ms-client-flatten": true
+        }
+      }
+    },
+    "accountProperties": {
+      "description": "NetApp account properties",
+      "type": "object",
+      "properties": {
+        "provisioningState": {
+          "type": "string",
+          "readOnly": true,
+          "description": "Azure lifecycle management"
+        },
+        "activeDirectories": {
+          "description": "Active Directories",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/activeDirectory"
+          }
+        }
+      }
+    },
+    "activeDirectory": {
+      "description": "Active Directory",
+      "type": "object",
+      "properties": {
+        "activeDirectoryId": {
+          "type": "string",
+          "description": "Id of the Active Directory"
+        },
+        "username": {
+          "type": "string",
+          "description": "Username of Active Directory domain administrator"
+        },
+        "password": {
+          "type": "string",
+          "x-ms-secret": true,
+          "description": "Plain text password of Active Directory domain administrator, value is masked in the response"
+        },
+        "domain": {
+          "type": "string",
+          "description": "Name of the Active Directory domain"
+        },
+        "dns": {
+          "type": "string",
+          "description": "Comma separated list of DNS server IP addresses (IPv4 only) for the Active Directory domain",
+          "pattern": "^(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\\.(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\\.(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\\.(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)((, ?)(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\\.(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\\.(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\\.(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?))*$",
+          "example": "101.102.103.104,101.102.103.105"
+        },
+        "status": {
+          "type": "string",
+          "description": "Status of the Active Directory"
+        },
+        "smbServerName": {
+          "type": "string",
+          "description": "NetBIOS name of the SMB server. This name will be registered as a computer account in the AD and used to mount volumes"
+        },
+        "organizationalUnit": {
+          "type": "string",
+          "description": "The Organizational Unit (OU) within the Windows Active Directory"
+        },
+        "site": {
+          "type": "string",
+          "description": "The Active Directory site the service will limit Domain Controller discovery to"
+        },
+        "backupOperators": {
+          "description": "Users to be added to the Built-in Backup Operator active directory group. A list of unique usernames without domain specifier",
+          "type": "array",
+          "items": {
+            "type": "string",
+            "maxLength": 255,
+            "minLength": 1,
+            "example": [
+              "user1",
+              "user2"
+            ]
+          }
+        },
+        "kdcIP": {
+          "type": "string",
+          "pattern": "^(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\\.(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\\.(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\\.(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)((, ?)(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\\.(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\\.(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\\.(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?))*$",
+          "description": "kdc server IP addresses for the active directory machine. This optional parameter is used only while creating kerberos volume.",
+          "example": "101.102.103.104"
+        },
+        "adName": {
+          "type": "string",
+          "maxLength": 64,
+          "minLength": 1,
+          "description": "Name of the active directory machine. This optional parameter is used only while creating kerberos volume",
+          "example": "ADServerName"
+        }
+      }
+    },
+    "capacityPoolList": {
+      "description": "List of capacity pool resources",
+      "type": "object",
+      "properties": {
+        "value": {
+          "description": "List of Capacity pools",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/capacityPool"
+          }
+        }
+      }
+    },
+    "capacityPool": {
+      "description": "Capacity pool resource",
+      "type": "object",
+      "x-ms-azure-resource": true,
+      "required": [
+        "location",
+        "properties"
+      ],
+      "properties": {
+        "location": {
+          "type": "string",
+          "description": "Resource location",
+          "x-ms-mutability": [
+            "read",
+            "create"
+          ]
+        },
+        "id": {
+          "type": "string",
+          "readOnly": true,
+          "description": "Resource Id"
+        },
+        "name": {
+          "type": "string",
+          "readOnly": true,
+          "description": "Resource name"
+        },
+        "type": {
+          "type": "string",
+          "readOnly": true,
+          "description": "Resource type"
+        },
+        "tags": {
+          "description": "Resource tags",
+          "$ref": "#/definitions/resourceTags"
+        },
+        "properties": {
+          "description": "Capacity pool properties",
+          "$ref": "#/definitions/poolProperties",
+          "x-ms-client-flatten": true
+        }
+      }
+    },
+    "poolProperties": {
+      "description": "Pool properties",
+      "type": "object",
+      "required": [
+        "size",
+        "serviceLevel"
+      ],
+      "properties": {
+        "poolId": {
+          "title": "poolId",
+          "type": "string",
+          "readOnly": true,
+          "description": "UUID v4 used to identify the Pool",
+          "pattern": "^[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}$",
+          "maxLength": 36,
+          "minLength": 36,
+          "example": "9760acf5-4638-11e7-9bdb-020073ca7778"
+        },
+        "size": {
+          "title": "size",
+          "type": "integer",
+          "format": "int64",
+          "description": "Provisioned size of the pool (in bytes). Allowed values are in 4TiB chunks (value must be multiply of 4398046511104).",
+          "minimum": 4398046511104,
+          "maximum": 549755813888000
+        },
+        "serviceLevel": {
+          "title": "serviceLevel",
+          "type": "string",
+          "description": "The service level of the file system",
+          "enum": [
+            "Standard",
+            "Premium",
+            "Ultra"
+          ],
+          "x-ms-enum": {
+            "name": "ServiceLevel",
+            "modelAsString": true,
+            "values": [
+              {
+                "value": "Standard",
+                "description": "Standard service level"
+              },
+              {
+                "value": "Premium",
+                "description": "Premium service level"
+              },
+              {
+                "value": "Ultra",
+                "description": "Ultra service level"
+              }
+            ]
+          },
+          "example": "Ultra",
+          "default": "Premium"
+        },
+        "provisioningState": {
+          "type": "string",
+          "readOnly": true,
+          "description": "Azure lifecycle management"
+        }
+      }
+    },
+    "capacityPoolPatch": {
+      "description": "Capacity pool patch resource",
+      "type": "object",
+      "x-ms-azure-resource": true,
+      "properties": {
+        "location": {
+          "type": "string",
+          "description": "Resource location"
+        },
+        "id": {
+          "type": "string",
+          "readOnly": true,
+          "description": "Resource Id"
+        },
+        "name": {
+          "type": "string",
+          "readOnly": true,
+          "description": "Resource name"
+        },
+        "type": {
+          "type": "string",
+          "readOnly": true,
+          "description": "Resource type"
+        },
+        "tags": {
+          "description": "Resource tags",
+          "$ref": "#/definitions/resourceTags"
+        },
+        "properties": {
+          "description": "Capacity pool properties",
+          "$ref": "#/definitions/poolPatchProperties",
+          "x-ms-client-flatten": true
+        }
+      }
+    },
+    "poolPatchProperties": {
+      "description": "Patchable pool properties",
+      "type": "object",
+      "properties": {
+        "size": {
+          "title": "size",
+          "type": "integer",
+          "format": "int64",
+          "description": "Provisioned size of the pool (in bytes). Allowed values are in 4TiB chunks (value must be multiply of 4398046511104).",
+          "minimum": 4398046511104,
+          "maximum": 549755813888000,
+          "default": 4398046511104
+        },
+        "serviceLevel": {
+          "title": "serviceLevel",
+          "type": "string",
+          "description": "The service level of the file system",
+          "enum": [
+            "Standard",
+            "Premium",
+            "Ultra"
+          ],
+          "x-ms-enum": {
+            "name": "PatchServiceLevel",
+            "modelAsString": true,
+            "values": [
+              {
+                "value": "Standard",
+                "description": "Standard service level"
+              },
+              {
+                "value": "Premium",
+                "description": "Premium service level"
+              },
+              {
+                "value": "Ultra",
+                "description": "Ultra service level"
+              }
+            ]
+          },
+          "example": "Ultra",
+          "default": "Premium"
+        }
+      }
+    },
+    "volumeList": {
+      "description": "List of volume resources",
+      "type": "object",
+      "properties": {
+        "value": {
+          "description": "List of volumes",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/volume"
+          }
+        }
+      }
+    },
+    "volume": {
+      "description": "Volume resource",
+      "type": "object",
+      "x-ms-azure-resource": true,
+      "required": [
+        "location",
+        "properties"
+      ],
+      "properties": {
+        "location": {
+          "type": "string",
+          "description": "Resource location",
+          "x-ms-mutability": [
+            "read",
+            "create"
+          ]
+        },
+        "id": {
+          "type": "string",
+          "readOnly": true,
+          "description": "Resource Id"
+        },
+        "name": {
+          "type": "string",
+          "readOnly": true,
+          "description": "Resource name"
+        },
+        "type": {
+          "type": "string",
+          "readOnly": true,
+          "description": "Resource type"
+        },
+        "tags": {
+          "description": "Resource tags",
+          "$ref": "#/definitions/resourceTags"
+        },
+        "properties": {
+          "description": "Volume properties",
+          "$ref": "#/definitions/volumeProperties",
+          "x-ms-client-flatten": true
+        }
+      }
+    },
+    "resourceTags": {
+      "type": "object",
+      "additionalProperties": {
+        "type": "string"
+      },
+      "description": "Tags are a list of key-value pairs that describe the resource"
+    },
+    "volumeProperties": {
+      "description": "Volume properties",
+      "type": "object",
+      "required": [
+        "creationToken",
+        "usageThreshold",
+        "subnetId"
+      ],
+      "properties": {
+        "fileSystemId": {
+          "title": "FileSystem ID",
+          "type": "string",
+          "readOnly": true,
+          "description": "Unique FileSystem Identifier.",
+          "pattern": "^[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}$",
+          "maxLength": 36,
+          "minLength": 36,
+          "example": "9760acf5-4638-11e7-9bdb-020073ca7778"
+        },
+        "creationToken": {
+          "title": "Creation Token or File Path",
+          "type": "string",
+          "description": "A unique file path for the volume. Used when creating mount targets",
+          "pattern": "^[a-zA-Z][a-zA-Z0-9\\-]{0,79}$",
+          "minLength": 1,
+          "maxLength": 80,
+          "example": "some-amazing-filepath"
+        },
+        "serviceLevel": {
+          "title": "serviceLevel",
+          "type": "string",
+          "description": "The service level of the file system",
+          "enum": [
+            "Standard",
+            "Premium",
+            "Ultra"
+          ],
+          "x-ms-enum": {
+            "name": "ServiceLevel",
+            "modelAsString": true,
+            "values": [
+              {
+                "value": "Standard",
+                "description": "Standard service level"
+              },
+              {
+                "value": "Premium",
+                "description": "Premium service level"
+              },
+              {
+                "value": "Ultra",
+                "description": "Ultra service level"
+              }
+            ]
+          },
+          "example": "Ultra",
+          "default": "Premium"
+        },
+        "usageThreshold": {
+          "title": "usageThreshold",
+          "type": "integer",
+          "format": "int64",
+          "description": "Maximum storage quota allowed for a file system in bytes. This is a soft quota used for alerting only. Minimum size is 100 GiB. Upper limit is 100TiB. Specified in bytes.",
+          "minimum": 107374182400,
+          "maximum": 109951162777600,
+          "default": 107374182400,
+          "example": 107374182400
+        },
+        "exportPolicy": {
+          "title": "exportPolicy",
+          "description": "Set of export policy rules",
+          "properties": {
+            "rules": {
+              "title": "Export policy rule",
+              "description": "Export policy rule",
+              "type": "array",
+              "items": {
+                "$ref": "#/definitions/exportPolicyRule"
+              }
+            }
+          }
+        },
+        "protocolTypes": {
+          "title": "protocolTypes",
+          "description": "Set of protocol types",
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "example": [
+            "NFSv4.1"
+          ]
+        },
+        "provisioningState": {
+          "type": "string",
+          "readOnly": true,
+          "description": "Azure lifecycle management"
+        },
+        "snapshotId": {
+          "title": "Snapshot ID",
+          "type": "string",
+          "description": "UUID v4 or resource identifier used to identify the Snapshot.",
+          "pattern": "^[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}|(\\\\?([^\\/]*[\\/])*)([^\\/]+)$",
+          "maxLength": 36,
+          "minLength": 36,
+          "example": "9760acf5-4638-11e7-9bdb-020073ca3333"
+        },
+        "backupId": {
+          "title": "Backup ID",
+          "type": "string",
+          "description": "UUID v4 or resource identifier used to identify the Backup.",
+          "pattern": "^[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}|(\\\\?([^\\/]*[\\/])*)([^\\/]+)$",
+          "maxLength": 36,
+          "minLength": 36,
+          "example": "9760acf5-4638-11e7-9bdb-020073ca3333"
+        },
+        "baremetalTenantId": {
+          "title": "Baremetal Tenant ID",
+          "type": "string",
+          "readOnly": true,
+          "description": "Unique Baremetal Tenant Identifier.",
+          "pattern": "^[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}$",
+          "maxLength": 36,
+          "minLength": 36,
+          "example": "9560acf5-4e3a-12e7-9bdb-02007cca7779"
+        },
+        "subnetId": {
+          "type": "string",
+          "description": "The Azure Resource URI for a delegated subnet. Must have the delegation Microsoft.NetApp/volumes"
+        },
+        "mountTargets": {
+          "title": "mountTargets",
+          "type": "array",
+          "description": "List of mount targets",
+          "items": {
+            "$ref": "#/definitions/mountTargetProperties"
+          }
+        },
+        "volumeType": {
+          "type": "string",
+          "description": "What type of volume is this",
+          "example": "DataProtection"
+        },
+        "dataProtection": {
+          "title": "DataProtection",
+          "description": "DataProtection type volumes include an object containing details of the replication",
+          "properties": {
+            "backup": {
+              "title": "Backup",
+              "description": "Backup Properties",
+              "type": "object",
+              "$ref": "#/definitions/volumeBackupProperties"
+            },
+            "replication": {
+              "title": "Replication",
+              "description": "Replication properties",
+              "type": "object",
+              "$ref": "#/definitions/replicationObject"
+            },
+            "snapshot": {
+              "title": "Snapshot",
+              "description": "Snapshot properties.",
+              "$ref": "#/definitions/volumeSnapshotProperties"
+            }
+          }
+        },
+        "isRestoring": {
+          "type": "boolean",
+          "description": "Restoring"
+        },
+        "snapshotDirectoryVisible": {
+          "type": "boolean",
+          "description": "If enabled (true) the volume will contain a read-only .snapshot directory which provides access to each of the volume's snapshots (default to true)."
+        },
+        "kerberosEnabled": {
+          "type": "boolean",
+          "description": "Describe if a volume is KerberosEnabled. To be use with swagger version 2020-05-01 or later",
+          "example": false,
+          "default": false
+        }
+      }
+    },
+    "exportPolicyRule": {
+      "description": "Volume Export Policy Rule",
+      "type": "object",
+      "properties": {
+        "ruleIndex": {
+          "type": "integer",
+          "description": "Order index",
+          "format": "int32"
+        },
+        "unixReadOnly": {
+          "type": "boolean",
+          "description": "Read only access"
+        },
+        "unixReadWrite": {
+          "type": "boolean",
+          "description": "Read and write access"
+        },
+        "kerberos5ReadOnly": {
+          "type": "boolean",
+          "description": "Kerberos5 Read only access. To be use with swagger version 2020-05-01 or later",
+          "example": false,
+          "default": false
+        },
+        "kerberos5ReadWrite": {
+          "type": "boolean",
+          "description": "Kerberos5 Read and write access. To be use with swagger version 2020-05-01 or later",
+          "example": true,
+          "default": false
+        },
+        "kerberos5iReadOnly": {
+          "type": "boolean",
+          "description": "Kerberos5i Read only access. To be use with swagger version 2020-05-01 or later",
+          "example": false,
+          "default": false
+        },
+        "kerberos5iReadWrite": {
+          "type": "boolean",
+          "description": "Kerberos5i Read and write access. To be use with swagger version 2020-05-01 or later",
+          "example": true,
+          "default": false
+        },
+        "kerberos5pReadOnly": {
+          "type": "boolean",
+          "description": "Kerberos5p Read only access. To be use with swagger version 2020-05-01 or later",
+          "example": false,
+          "default": false
+        },
+        "kerberos5pReadWrite": {
+          "type": "boolean",
+          "description": "Kerberos5p Read and write access. To be use with swagger version 2020-05-01 or later",
+          "example": true,
+          "default": false
+        },
+        "cifs": {
+          "type": "boolean",
+          "description": "Allows CIFS protocol"
+        },
+        "nfsv3": {
+          "type": "boolean",
+          "description": "Allows NFSv3 protocol. Enable only for NFSv3 type volumes"
+        },
+        "nfsv41": {
+          "type": "boolean",
+          "description": "Allows NFSv4.1 protocol. Enable only for NFSv4.1 type volumes"
+        },
+        "allowedClients": {
+          "type": "string",
+          "description": "Client ingress specification as comma separated string with IPv4 CIDRs, IPv4 host addresses and host names"
+        },
+        "hasRootAccess": {
+          "type": "boolean",
+          "description": "Has root access to volume",
+          "example": true,
+          "default": true
+        }
+      }
+    },
+    "volumeBackupProperties": {
+      "description": "Volume Backup Properties",
+      "type": "object",
+      "properties": {
+        "backupPolicyId": {
+          "type": "string",
+          "description": "Backup Policy Resource ID"
+        },
+        "policyEnforced": {
+          "type": "boolean",
+          "description": "Policy Enforced"
+        },
+        "vaultId": {
+          "type": "string",
+          "description": "Vault Resource ID"
+        },
+        "backupEnabled": {
+          "type": "boolean",
+          "description": "Backup Enabled"
+        }
+      }
+    },
+    "replicationObject": {
+      "description": "Replication properties",
+      "type": "object",
+      "required": [
+        "replicationSchedule",
+        "remoteVolumeResourceId"
+      ],
+      "properties": {
+        "replicationId": {
+          "type": "string",
+          "description": "Id"
+        },
+        "endpointType": {
+          "type": "string",
+          "description": "Indicates whether the local volume is the source or destination for the Volume Replication",
+          "enum": [
+            "src",
+            "dst"
+          ],
+          "x-ms-enum": {
+            "name": "EndpointType",
+            "modelAsString": true
+          }
+        },
+        "replicationSchedule": {
+          "type": "string",
+          "description": "Schedule",
+          "enum": [
+            "_10minutely",
+            "hourly",
+            "daily"
+          ],
+          "x-ms-enum": {
+            "name": "ReplicationSchedule",
+            "modelAsString": true
+          }
+        },
+        "remoteVolumeResourceId": {
+          "type": "string",
+          "description": "The resource ID of the remote volume."
+        },
+        "remoteVolumeRegion": {
+          "type": "string",
+          "description": "The remote region for the other end of the Volume Replication."
+        }
+      }
+    },
+    "volumeSnapshotProperties": {
+      "description": "Volume Snapshot Properties",
+      "type": "object",
+      "properties": {
+        "snapshotPolicyId": {
+          "type": "string",
+          "description": "Snapshot Policy ResourceId"
+        }
+      }
+    },
+    "replicationStatus": {
+      "description": "Replication status",
+      "type": "object",
+      "properties": {
+        "healthy": {
+          "type": "boolean",
+          "description": "Replication health check"
+        },
+        "relationshipStatus": {
+          "type": "string",
+          "description": "Status of the mirror relationship",
+          "enum": [
+            "Idle",
+            "Transferring"
+          ],
+          "x-ms-enum": {
+            "name": "RelationshipStatus",
+            "modelAsString": true
+          }
+        },
+        "mirrorState": {
+          "type": "string",
+          "description": "The status of the replication",
+          "enum": [
+            "Uninitialized",
+            "Mirrored",
+            "Broken"
+          ],
+          "x-ms-enum": {
+            "name": "MirrorState",
+            "modelAsString": true
+          }
+        },
+        "totalProgress": {
+          "type": "string",
+          "description": "The progress of the replication"
+        },
+        "errorMessage": {
+          "type": "string",
+          "description": "Displays error message if the replication is in an error state"
+        }
+      }
+    },
+    "volumePatch": {
+      "description": "Volume patch resource",
+      "type": "object",
+      "x-ms-azure-resource": true,
+      "properties": {
+        "location": {
+          "type": "string",
+          "description": "Resource location"
+        },
+        "id": {
+          "type": "string",
+          "readOnly": true,
+          "description": "Resource Id"
+        },
+        "name": {
+          "type": "string",
+          "readOnly": true,
+          "description": "Resource name"
+        },
+        "type": {
+          "type": "string",
+          "readOnly": true,
+          "description": "Resource type"
+        },
+        "tags": {
+          "description": "Resource tags",
+          "$ref": "#/definitions/resourceTags"
+        },
+        "properties": {
+          "description": "Patchable volume properties",
+          "$ref": "#/definitions/volumePatchProperties",
+          "x-ms-client-flatten": true
+        }
+      }
+    },
+    "volumePatchProperties": {
+      "description": "Patchable volume properties",
+      "type": "object",
+      "properties": {
+        "serviceLevel": {
+          "title": "serviceLevel",
+          "type": "string",
+          "description": "The service level of the file system",
+          "enum": [
+            "Standard",
+            "Premium",
+            "Ultra"
+          ],
+          "x-ms-enum": {
+            "name": "ServiceLevel",
+            "modelAsString": true,
+            "values": [
+              {
+                "value": "Standard",
+                "description": "Standard service level"
+              },
+              {
+                "value": "Premium",
+                "description": "Premium service level"
+              },
+              {
+                "value": "Ultra",
+                "description": "Ultra service level"
+              }
+            ]
+          },
+          "example": "Ultra",
+          "default": "Premium"
+        },
+        "usageThreshold": {
+          "title": "usageThreshold",
+          "type": "integer",
+          "format": "int64",
+          "description": "Maximum storage quota allowed for a file system in bytes. This is a soft quota used for alerting only. Minimum size is 100 GiB. Upper limit is 100TiB. Specified in bytes.",
+          "minimum": 107374182400,
+          "maximum": 109951162777600,
+          "default": 107374182400,
+          "example": 107374182400
+        },
+        "exportPolicy": {
+          "title": "exportPolicy",
+          "description": "Set of export policy rules",
+          "properties": {
+            "rules": {
+              "title": "Export policy rule",
+              "description": "Export policy rule",
+              "type": "array",
+              "items": {
+                "$ref": "#/definitions/exportPolicyRule"
+              }
+            }
+          }
+        },
+        "dataProtection": {
+          "title": "DataProtection",
+          "description": "DataProtection type volumes include an object containing details of the replication",
+          "properties": {
+            "backup": {
+              "title": "Backup",
+              "description": "Backup Properties",
+              "type": "object",
+              "$ref": "#/definitions/volumeBackupProperties"
+            }
+          }
+        }
+      }
+    },
+    "mountTarget": {
+      "description": "Mount Target",
+      "type": "object",
+      "required": [
+        "location",
+        "properties"
+      ],
+      "properties": {
+        "location": {
+          "type": "string",
+          "description": "Resource location"
+        },
+        "id": {
+          "type": "string",
+          "readOnly": true,
+          "description": "Resource Id"
+        },
+        "name": {
+          "type": "string",
+          "readOnly": true,
+          "description": "Resource name"
+        },
+        "type": {
+          "type": "string",
+          "readOnly": true,
+          "description": "Resource type"
+        },
+        "tags": {
+          "description": "Resource tags",
+          "$ref": "#/definitions/resourceTags",
+          "x-ms-client-flatten": true
+        },
+        "properties": {
+          "description": "Mount Target Properties",
+          "$ref": "#/definitions/mountTargetProperties",
+          "x-ms-client-flatten": true
+        }
+      }
+    },
+    "mountTargetProperties": {
+      "description": "Mount target properties",
+      "type": "object",
+      "required": [
+        "fileSystemId"
+      ],
+      "properties": {
+        "mountTargetId": {
+          "title": "mountTargetId",
+          "type": "string",
+          "readOnly": true,
+          "description": "UUID v4 used to identify the MountTarget",
+          "pattern": "^[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}$",
+          "maxLength": 36,
+          "minLength": 36,
+          "example": "9760acf5-4638-11e7-9bdb-020073ca3333"
+        },
+        "fileSystemId": {
+          "title": "fileSystemId",
+          "type": "string",
+          "description": "UUID v4 used to identify the MountTarget",
+          "pattern": "^[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}$",
+          "maxLength": 36,
+          "minLength": 36,
+          "example": "9760acf5-4638-11e7-9bdb-020073ca3333"
+        },
+        "ipAddress": {
+          "title": "ipAddress",
+          "description": "The mount target's IPv4 address",
+          "type": "string",
+          "readOnly": true,
+          "example": "1.2.3.4"
+        },
+        "smbServerFqdn": {
+          "title": "smbServerFQDN",
+          "description": "The SMB server's Fully Qualified Domain Name, FQDN",
+          "type": "string",
+          "example": "fullyqualified.domainname.com"
+        }
+      }
+    },
+    "snapshotsList": {
+      "description": "List of Snapshots",
+      "type": "object",
+      "properties": {
+        "value": {
+          "description": "A list of Snapshots",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/snapshot"
+          }
+        }
+      }
+    },
+    "snapshot": {
+      "description": "Snapshot of a Volume",
+      "type": "object",
+      "x-ms-azure-resource": true,
+      "required": [
+        "location"
+      ],
+      "properties": {
+        "location": {
+          "type": "string",
+          "description": "Resource location",
+          "x-ms-mutability": [
+            "read",
+            "create"
+          ]
+        },
+        "id": {
+          "type": "string",
+          "readOnly": true,
+          "description": "Resource Id"
+        },
+        "name": {
+          "type": "string",
+          "readOnly": true,
+          "description": "Resource name"
+        },
+        "type": {
+          "type": "string",
+          "readOnly": true,
+          "description": "Resource type"
+        },
+        "properties": {
+          "description": "Snapshot Properties",
+          "$ref": "#/definitions/snapshotProperties",
+          "x-ms-client-flatten": true
+        }
+      }
+    },
+    "snapshotPatch": {
+      "description": "Snapshot patch",
+      "type": "object",
+      "x-ms-azure-resource": true,
+      "properties": {}
+    },
+    "snapshotProperties": {
+      "description": "Snapshot properties",
+      "type": "object",
+      "properties": {
+        "snapshotId": {
+          "title": "snapshotId",
+          "type": "string",
+          "readOnly": true,
+          "description": "UUID v4 used to identify the Snapshot",
+          "pattern": "^[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}$",
+          "maxLength": 36,
+          "minLength": 36,
+          "example": "9760acf5-4638-11e7-9bdb-020073ca3333"
+        },
+        "created": {
+          "title": "name",
+          "type": "string",
+          "format": "date-time",
+          "readOnly": true,
+          "description": "The creation date of the snapshot",
+          "example": "2017-08-15 13:23:33"
+        },
+        "provisioningState": {
+          "type": "string",
+          "readOnly": true,
+          "description": "Azure lifecycle management"
+        }
+      }
+    },
+    "snapshotPolicyProperties": {
+      "description": "Snapshot policy properties",
+      "type": "object",
+      "properties": {
+        "name": {
+          "type": "string",
+          "readOnly": true,
+          "description": "Snapshot policy name"
+        },
+        "hourlySchedule": {
+          "title": "hourlySchedule",
+          "description": "Schedule for hourly snapshots",
+          "type": "object",
+          "$ref": "#/definitions/hourlySchedule"
+        },
+        "dailySchedule": {
+          "title": "dailySchedule",
+          "description": "Schedule for daily snapshots",
+          "type": "object",
+          "$ref": "#/definitions/dailySchedule"
+        },
+        "weeklySchedule": {
+          "title": "weeklySchedule",
+          "description": "Schedule for weekly snapshots",
+          "type": "object",
+          "$ref": "#/definitions/weeklySchedule"
+        },
+        "monthlySchedule": {
+          "title": "monthlySchedule",
+          "description": "Schedule for monthly snapshots",
+          "type": "object",
+          "$ref": "#/definitions/monthlySchedule"
+        },
+        "enabled": {
+          "type": "boolean",
+          "description": "The property to decide policy is enabled or not"
+        },
+        "provisioningState": {
+          "type": "string",
+          "readOnly": true,
+          "description": "Azure lifecycle management"
+        }
+      }
+    },
+    "snapshotPolicy": {
+      "description": "Snapshot policy information",
+      "type": "object",
+      "x-ms-azure-resource": true,
+      "required": [
+        "location",
+        "properties"
+      ],
+      "properties": {
+        "location": {
+          "type": "string",
+          "description": "Resource location",
+          "x-ms-mutability": [
+            "read",
+            "create"
+          ]
+        },
+        "id": {
+          "type": "string",
+          "readOnly": true,
+          "description": "Resource Id"
+        },
+        "name": {
+          "type": "string",
+          "readOnly": true,
+          "description": "Resource name"
+        },
+        "type": {
+          "type": "string",
+          "readOnly": true,
+          "description": "Resource type"
+        },
+        "tags": {
+          "description": "Resource tags",
+          "$ref": "#/definitions/resourceTags"
+        },
+        "properties": {
+          "description": "Snapshot policy Properties",
+          "$ref": "#/definitions/snapshotPolicyProperties",
+          "x-ms-client-flatten": true
+        }
+      }
+    },
+    "snapshotPoliciesList": {
+      "description": "List of Snapshot Policies",
+      "type": "object",
+      "properties": {
+        "value": {
+          "description": "A list of snapshot policies",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/snapshotPolicy"
+          }
+        }
+      }
+    },
+    "snapshotPolicyDetails": {
+      "description": "Snapshot policy properties",
+      "type": "object",
+      "properties": {
+        "location": {
+          "type": "string",
+          "description": "Resource location",
+          "x-ms-mutability": [
+            "read",
+            "create"
+          ]
+        },
+        "id": {
+          "type": "string",
+          "readOnly": true,
+          "description": "Resource Id"
+        },
+        "name": {
+          "type": "string",
+          "readOnly": true,
+          "description": "Resource name"
+        },
+        "type": {
+          "type": "string",
+          "readOnly": true,
+          "description": "Resource type"
+        },
+        "tags": {
+          "description": "Resource tags",
+          "$ref": "#/definitions/resourceTags"
+        },
+        "properties": {
+          "description": "Snapshot policy Properties",
+          "$ref": "#/definitions/snapshotPolicyProperties",
+          "x-ms-client-flatten": true
+        }
+      }
+    },
+    "snapshotPolicyPatch": {
+      "description": "Snapshot policy Details for create and update",
+      "type": "object",
+      "properties": {
+        "location": {
+          "type": "string",
+          "description": "Resource location"
+        },
+        "id": {
+          "type": "string",
+          "readOnly": true,
+          "description": "Resource Id"
+        },
+        "name": {
+          "type": "string",
+          "readOnly": true,
+          "description": "Resource name"
+        },
+        "type": {
+          "type": "string",
+          "readOnly": true,
+          "description": "Resource type"
+        },
+        "tags": {
+          "description": "Resource tags",
+          "$ref": "#/definitions/resourceTags"
+        },
+        "properties": {
+          "description": "Snapshot Policy properties",
+          "$ref": "#/definitions/snapshotPolicyProperties",
+          "x-ms-client-flatten": true
+        }
+      }
+    },
+    "snapshotPolicyVolumeList": {
+      "description": "Volumes associated with snapshot policy",
+      "type": "object",
+      "properties": {
+        "value": {
+          "description": "List of volumes",
+          "type": "array",
+          "items": {
+            "type": "object",
+            "readOnly": true,
+            "description": "Associated volume resource Id"
+          }
+        }
+      }
+    },
+    "hourlySchedule": {
+      "description": "Hourly Schedule properties",
+      "type": "object",
+      "properties": {
+        "snapshotsToKeep": {
+          "type": "integer",
+          "description": "Hourly snapshot count to keep",
+          "format": "int32"
+        },
+        "minute": {
+          "type": "integer",
+          "description": "Indicates which minute snapshot should be taken",
+          "example": "30",
+          "format": "int32"
+        },
+        "usedBytes": {
+          "type": "integer",
+          "description": "Resource size in bytes, current storage usage for the volume in bytes",
+          "format": "int64"
+        }
+      }
+    },
+    "dailySchedule": {
+      "description": "Daily Schedule properties",
+      "type": "object",
+      "properties": {
+        "snapshotsToKeep": {
+          "type": "integer",
+          "description": "Daily snapshot count to keep",
+          "format": "int32"
+        },
+        "hour": {
+          "type": "integer",
+          "description": "Indicates which hour in UTC timezone a snapshot should be taken",
+          "example": "11",
+          "format": "int32"
+        },
+        "minute": {
+          "type": "integer",
+          "description": "Indicates which minute snapshot should be taken",
+          "example": "30",
+          "format": "int32"
+        },
+        "usedBytes": {
+          "type": "integer",
+          "description": "Resource size in bytes, current storage usage for the volume in bytes",
+          "format": "int64"
+        }
+      }
+    },
+    "weeklySchedule": {
+      "description": "Weekly Schedule properties, make a snapshot every week at a specific day or days",
+      "type": "object",
+      "properties": {
+        "snapshotsToKeep": {
+          "type": "integer",
+          "description": "Weekly snapshot count to keep",
+          "format": "int32"
+        },
+        "day": {
+          "type": "string",
+          "description": "Indicates which weekdays snapshot should be taken, accepts a comma separated list of week day names in english",
+          "example": "Sunday,Monday"
+        },
+        "hour": {
+          "type": "integer",
+          "description": "Indicates which hour in UTC timezone a snapshot should be taken",
+          "example": "11",
+          "format": "int32"
+        },
+        "minute": {
+          "type": "integer",
+          "description": "Indicates which minute snapshot should be taken",
+          "example": "30",
+          "format": "int32"
+        },
+        "usedBytes": {
+          "type": "integer",
+          "description": "Resource size in bytes, current storage usage for the volume in bytes",
+          "format": "int64"
+        }
+      }
+    },
+    "monthlySchedule": {
+      "description": "Monthly Schedule properties",
+      "type": "object",
+      "properties": {
+        "snapshotsToKeep": {
+          "type": "integer",
+          "description": "Monthly snapshot count to keep",
+          "format": "int32"
+        },
+        "daysOfMonth": {
+          "type": "string",
+          "description": "Indicates which days of the month snapshot should be taken. A comma delimited string.",
+          "example": "1,11,21"
+        },
+        "hour": {
+          "type": "integer",
+          "description": "Indicates which hour in UTC timezone a snapshot should be taken",
+          "example": "11",
+          "format": "int32"
+        },
+        "minute": {
+          "type": "integer",
+          "description": "Indicates which minute snapshot should be taken",
+          "example": "30",
+          "format": "int32"
+        },
+        "usedBytes": {
+          "type": "integer",
+          "description": "Resource size in bytes, current storage usage for the volume in bytes",
+          "format": "int64"
+        }
+      }
+    },
+    "volumeRevert": {
+      "description": "revert a volume to the snapshot",
+      "type": "object",
+      "properties": {
+        "snapshotId": {
+          "type": "string",
+          "description": "Resource id of the snapshot"
+        }
+      }
+    },
+    "authorizeRequest": {
+      "description": "Authorize request",
+      "type": "object",
+      "properties": {
+        "remoteVolumeResourceId": {
+          "type": "string",
+          "description": "Resource id of the remote volume"
+        }
+      }
+    },
+    "breakReplicationRequest": {
+      "description": "Break replication request",
+      "type": "object",
+      "properties": {
+        "forceBreakReplication": {
+          "type": "boolean",
+          "description": "If replication is in status transferring and you want to force break the replication, set to true"
+        }
+      }
+    },
+    "poolChangeRequest": {
+      "description": "Pool change request",
+      "type": "object",
+      "required": [
+        "newPoolResourceId"
+      ],
+      "properties": {
+        "newPoolResourceId": {
+          "type": "string",
+          "description": "Resource id of the pool to move volume to"
+        }
+      }
+    },
+    "backupsList": {
+      "description": "List of Backups",
+      "type": "object",
+      "properties": {
+        "value": {
+          "description": "A list of Backups",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/backup"
+          }
+        }
+      }
+    },
+    "backup": {
+      "description": "Backup of a Volume",
+      "type": "object",
+      "x-ms-azure-resource": true,
+      "required": [
+        "location",
+        "properties"
+      ],
+      "properties": {
+        "location": {
+          "type": "string",
+          "description": "Resource location",
+          "x-ms-mutability": [
+            "read",
+            "create"
+          ]
+        },
+        "id": {
+          "type": "string",
+          "readOnly": true,
+          "description": "Resource Id"
+        },
+        "name": {
+          "type": "string",
+          "readOnly": true,
+          "description": "Resource name"
+        },
+        "type": {
+          "type": "string",
+          "readOnly": true,
+          "description": "Resource type"
+        },
+        "properties": {
+          "description": "Backup Properties",
+          "$ref": "#/definitions/backupProperties",
+          "x-ms-client-flatten": true
+        }
+      }
+    },
+    "backupPatch": {
+      "description": "Backup patch",
+      "type": "object",
+      "x-ms-azure-resource": true,
+      "properties": {
+        "tags": {
+          "description": "Resource tags",
+          "$ref": "#/definitions/resourceTags"
+        },
+        "properties": {
+          "description": "Backup Properties",
+          "$ref": "#/definitions/backupProperties",
+          "x-ms-client-flatten": true
+        }
+      }
+    },
+    "backupProperties": {
+      "description": "Backup properties",
+      "type": "object",
+      "properties": {
+        "creationDate": {
+          "title": "name",
+          "type": "string",
+          "format": "date-time",
+          "readOnly": true,
+          "description": "The creation date of the backup",
+          "example": "2017-08-15 13:23:33"
+        },
+        "provisioningState": {
+          "type": "string",
+          "readOnly": true,
+          "description": "Azure lifecycle management"
+        },
+        "size": {
+          "type": "integer",
+          "readOnly": true,
+          "description": "Size of backup",
+          "format": "int64"
+        },
+        "label": {
+          "type": "string",
+          "description": "Label for backup"
+        },
+        "backupType": {
+          "type": "string",
+          "readOnly": true,
+          "description": "Type of backup adhoc or scheduled"
+        }
+      }
+    },
+    "backupPolicyProperties": {
+      "description": "Backup policy properties",
+      "type": "object",
+      "properties": {
+        "name": {
+          "type": "string",
+          "readOnly": true,
+          "description": "Name of backup policy"
+        },
+        "provisioningState": {
+          "type": "string",
+          "readOnly": true,
+          "description": "Azure lifecycle management"
+        },
+        "dailyBackupsToKeep": {
+          "type": "integer",
+          "description": "Daily backups count to keep",
+          "format": "int32"
+        },
+        "weeklyBackupsToKeep": {
+          "type": "integer",
+          "description": "Weekly backups count to keep",
+          "format": "int32"
+        },
+        "monthlyBackupsToKeep": {
+          "type": "integer",
+          "description": "Monthly backups count to keep",
+          "format": "int32"
+        },
+        "yearlyBackupsToKeep": {
+          "type": "integer",
+          "description": "Yearly backups count to keep",
+          "format": "int32"
+        },
+        "volumesAssigned": {
+          "type": "integer",
+          "description": "Volumes using current backup policy",
+          "format": "int32"
+        },
+        "enabled": {
+          "type": "boolean",
+          "description": "The property to decide policy is enabled or not"
+        },
+        "volumeBackups": {
+          "description": "A list of volumes assigned to this policy",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/volumeBackups"
+          }
+        }
+      }
+    },
+    "backupPolicy": {
+      "description": "Backup policy information",
+      "type": "object",
+      "x-ms-azure-resource": true,
+      "required": [
+        "location",
+        "properties"
+      ],
+      "properties": {
+        "location": {
+          "type": "string",
+          "description": "Resource location",
+          "x-ms-mutability": [
+            "read",
+            "create"
+          ]
+        },
+        "id": {
+          "type": "string",
+          "readOnly": true,
+          "description": "Resource Id"
+        },
+        "name": {
+          "type": "string",
+          "readOnly": true,
+          "description": "Resource name"
+        },
+        "type": {
+          "type": "string",
+          "readOnly": true,
+          "description": "Resource type"
+        },
+        "tags": {
+          "description": "Resource tags",
+          "$ref": "#/definitions/resourceTags"
+        },
+        "properties": {
+          "description": "Backup policy Properties",
+          "$ref": "#/definitions/backupPolicyProperties",
+          "x-ms-client-flatten": true
+        }
+      }
+    },
+    "backupPoliciesList": {
+      "description": "List of Backup Policies",
+      "type": "object",
+      "properties": {
+        "value": {
+          "description": "A list of backup policies",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/backupPolicy"
+          }
+        }
+      }
+    },
+    "backupPolicyDetails": {
+      "description": "Backup policy properties",
+      "x-ms-azure-resource": true,
+      "type": "object",
+      "properties": {
+        "location": {
+          "type": "string",
+          "description": "Resource location",
+          "x-ms-mutability": [
+            "read",
+            "create"
+          ]
+        },
+        "id": {
+          "type": "string",
+          "readOnly": true,
+          "description": "Resource Id"
+        },
+        "name": {
+          "type": "string",
+          "readOnly": true,
+          "description": "Resource name"
+        },
+        "type": {
+          "type": "string",
+          "readOnly": true,
+          "description": "Resource type"
+        },
+        "tags": {
+          "description": "Resource tags",
+          "$ref": "#/definitions/resourceTags"
+        },
+        "properties": {
+          "description": "Backup policy Properties",
+          "$ref": "#/definitions/backupPolicyProperties",
+          "x-ms-client-flatten": true
+        }
+      }
+    },
+    "backupPolicyPatch": {
+      "description": "Backup policy Details for create and update",
+      "type": "object",
+      "properties": {
+        "location": {
+          "type": "string",
+          "description": "Resource location",
+          "x-ms-mutability": [
+            "read",
+            "create"
+          ]
+        },
+        "properties": {
+          "description": "Backup policy Properties",
+          "$ref": "#/definitions/backupPolicyProperties",
+          "x-ms-client-flatten": true
+        }
+      }
+    },
+    "volumeBackups": {
+      "description": "Volume details using the backup policy",
+      "type": "object",
+      "readOnly": true,
+      "properties": {
+        "volumeName": {
+          "type": "string",
+          "description": "Volume name"
+        },
+        "backupsCount": {
+          "type": "integer",
+          "description": "Total count of backups for volume",
+          "format": "int32"
+        },
+        "policyEnabled": {
+          "type": "boolean",
+          "description": "Policy enabled"
+        }
+      }
+    },
+    "vaultList": {
+      "description": "List of Vaults",
+      "type": "object",
+      "properties": {
+        "value": {
+          "description": "A list of vaults",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/vault"
+          }
+        }
+      }
+    },
+    "vault": {
+      "description": "Vault information",
+      "type": "object",
+      "x-ms-azure-resource": true,
+      "required": [
+        "location",
+        "properties"
+      ],
+      "properties": {
+        "location": {
+          "type": "string",
+          "description": "Resource location",
+          "x-ms-mutability": [
+            "read",
+            "create"
+          ]
+        },
+        "id": {
+          "type": "string",
+          "readOnly": true,
+          "description": "Resource Id"
+        },
+        "name": {
+          "type": "string",
+          "readOnly": true,
+          "description": "Resource name"
+        },
+        "type": {
+          "type": "string",
+          "readOnly": true,
+          "description": "Resource type"
+        },
+        "properties": {
+          "description": "Vault Properties",
+          "$ref": "#/definitions/vaultProperties",
+          "x-ms-client-flatten": true
+        }
+      }
+    },
+    "vaultProperties": {
+      "description": "Vault properties",
+      "type": "object",
+      "properties": {
+        "vaultName": {
+          "type": "string",
+          "readOnly": false,
+          "description": "Vault Name"
+        }
+      }
+    }
+  },
+  "parameters": {
+    "SubscriptionId": {
+      "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."
+    },
+    "location": {
+      "name": "location",
+      "description": "The location",
+      "in": "path",
+      "required": true,
+      "type": "string",
+      "x-ms-parameter-location": "method"
+    },
+    "ResourceGroup": {
+      "name": "resourceGroupName",
+      "in": "path",
+      "required": true,
+      "type": "string",
+      "description": "The name of the resource group.",
+      "pattern": "^[-\\w\\._\\(\\)]+$",
+      "minLength": 1,
+      "maxLength": 90,
+      "x-ms-parameter-location": "method"
+    },
+    "AccountName": {
+      "name": "accountName",
+      "type": "string",
+      "in": "path",
+      "required": true,
+      "description": "The name of the NetApp account",
+      "x-ms-parameter-location": "method"
+    },
+    "PoolName": {
+      "name": "poolName",
+      "type": "string",
+      "in": "path",
+      "required": true,
+      "pattern": "^[a-zA-Z0-9][a-zA-Z0-9\\-_]{0,63}$",
+      "minLength": 1,
+      "maxLength": 64,
+      "description": "The name of the capacity pool",
+      "x-ms-parameter-location": "method"
+    },
+    "VolumeName": {
+      "name": "volumeName",
+      "type": "string",
+      "in": "path",
+      "required": true,
+      "pattern": "^[a-zA-Z][a-zA-Z0-9\\-_]{0,63}$",
+      "minLength": 1,
+      "maxLength": 64,
+      "description": "The name of the volume",
+      "x-ms-parameter-location": "method"
+    },
+    "MountTargetName": {
+      "name": "mountTargetName",
+      "type": "string",
+      "in": "path",
+      "required": true,
+      "description": "The name of the mount target",
+      "x-ms-parameter-location": "method"
+    },
+    "SnapshotName": {
+      "name": "snapshotName",
+      "type": "string",
+      "in": "path",
+      "required": true,
+      "description": "The name of the mount target",
+      "x-ms-parameter-location": "method"
+    },
+    "SnapshotPolicyName": {
+      "name": "snapshotPolicyName",
+      "type": "string",
+      "in": "path",
+      "required": true,
+      "description": "The name of the snapshot policy target",
+      "x-ms-parameter-location": "method"
+    },
+    "BackupName": {
+      "name": "backupName",
+      "type": "string",
+      "in": "path",
+      "required": true,
+      "description": "The name of the backup",
+      "x-ms-parameter-location": "method"
+    },
+    "BackupPolicyName": {
+      "name": "backupPolicyName",
+      "in": "path",
+      "required": true,
+      "type": "string",
+      "description": "Backup policy Name which uniquely identify backup policy.",
+      "x-ms-parameter-location": "method"
+    },
+    "ApiVersionParameter": {
+      "name": "api-version",
+      "description": "Version of the API to be used with the client request.",
+      "in": "query",
+      "type": "string",
+      "required": true,
+      "default": "2020-05-01"
+    }
+  }
+}
diff --git a/specification/netapp/resource-manager/readme.go.md b/specification/netapp/resource-manager/readme.go.md
index 721ff76fb2f9..06d8c8a097c7 100644
--- a/specification/netapp/resource-manager/readme.go.md
+++ b/specification/netapp/resource-manager/readme.go.md
@@ -15,6 +15,7 @@ go:
 batch:
   - tag: package-netapp-2020-07-01
   - tag: package-netapp-2020-06-01
+  - tag: package-netapp-2020-05-01  
   - tag: package-netapp-2020-03-01  
   - tag: package-netapp-2020-02-01
   - tag: package-netapp-2019-11-01
@@ -41,6 +42,16 @@ Please also specify `--go-sdk-folder=<path to the root directory of your azure-s
 ``` yaml $(tag) == 'package-netapp-2020-06-01' && $(go)
 output-folder: $(go-sdk-folder)/services/$(namespace)/mgmt/2020-06-01/$(namespace)  
 ```
+
+### Tag: package-netapp-2020-05-01 and go
+
+These settings apply only when `--tag=package-netapp-2020-05-01 --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-netapp-2020-05-01' && $(go)
+output-folder: $(go-sdk-folder)/services/$(namespace)/mgmt/2020-05-01/$(namespace)
+```
+
 ### Tag: package-netapp-2020-03-01 and go
 
 These settings apply only when `--tag=package-netapp-2020-03-01 --go` is specified on the command line.
diff --git a/specification/netapp/resource-manager/readme.java.md b/specification/netapp/resource-manager/readme.java.md
index 0210266d8d4f..683fbddf59eb 100644
--- a/specification/netapp/resource-manager/readme.java.md
+++ b/specification/netapp/resource-manager/readme.java.md
@@ -18,6 +18,7 @@ output-folder: $(azure-libraries-for-java-folder)/azure-mgmt-netapp
 batch:
   - tag: package-netapp-2020-07-01
   - tag: package-netapp-2020-06-01
+  - tag: package-netapp-2020-05-01    
   - tag: package-netapp-2020-03-01  
   - tag: package-netapp-2020-02-01
   - tag: package-netapp-2019-11-01
@@ -33,7 +34,7 @@ batch:
 These settings apply only when `--tag=package-netapp-2020-07-01 --java` is specified on the command line.
 Please also specify the `--azure-libraries-for-java-folder=<path to the root directory of your azure-sdk-for-java clone>`.
 
-``` yaml $(tag) == 'package-netapp-2020-06-01' && $(java) && $(multiapi)
+``` yaml $(tag) == 'package-netapp-2020-07-01' && $(java) && $(multiapi)
 java:
   namespace: com.microsoft.azure.management.netapp.v2020_07_01
   output-folder: $(azure-libraries-for-java-folder)/sdk/netapp/mgmt-v2020_07_01
@@ -54,6 +55,19 @@ regenerate-manager: true
 generate-interface: true
 ```
 
+### Tag: package-netapp-2020-05-01 and java
+
+These settings apply only when `--tag=package-netapp-2020-05-01 --java` is specified on the command line.
+Please also specify the `--azure-libraries-for-java-folder=<path to the root directory of your azure-sdk-for-java clone>`.
+
+``` yaml $(tag) == 'package-netapp-2020-05-01' && $(java) && $(multiapi)
+java:
+  namespace: com.microsoft.azure.management.netapp.v2020_05_01
+  output-folder: $(azure-libraries-for-java-folder)/sdk/netapp/mgmt-v2020_05_01
+regenerate-manager: true
+generate-interface: true
+```
+
 ### Tag: package-netapp-2020-03-01 and java
 
 These settings apply only when `--tag=package-netapp-2020-03-01 --java` is specified on the command line.
diff --git a/specification/netapp/resource-manager/readme.md b/specification/netapp/resource-manager/readme.md
index 624ea4d36f22..d669c3b2597a 100644
--- a/specification/netapp/resource-manager/readme.md
+++ b/specification/netapp/resource-manager/readme.md
@@ -48,6 +48,16 @@ These settings apply only when `--tag=package-netapp-2020-06-01` is specified on
 input-file:
 - Microsoft.NetApp/stable/2020-06-01/netapp.json
 ```
+
+### Tag: package-netapp-2020-05-01
+
+These settings apply only when `--tag=package-netapp-2020-05-01` is specified on the command line.
+
+``` yaml $(tag) == 'package-netapp-2020-05-01'
+input-file:
+- Microsoft.NetApp/stable/2020-05-01/netapp.json
+```
+
 ### Tag: package-netapp-2020-03-01
 
 These settings apply only when `--tag=package-netapp-2020-03-01` is specified on the command line.
diff --git a/specification/network/resource-manager/readme.java.md b/specification/network/resource-manager/readme.java.md
index 19eb6c7ecd1a..e05a5f82adf3 100644
--- a/specification/network/resource-manager/readme.java.md
+++ b/specification/network/resource-manager/readme.java.md
@@ -39,6 +39,7 @@ batch:
   - tag: package-2019-06
   - tag: package-2019-04
   - tag: package-2019-02
+  - tag: package-2018-11
 ```
 
 ### Tag: package-2020-06 and java
@@ -184,6 +185,19 @@ java:
   generate-interface: true
 ```
 
+### Tag: package-2018-11 and java
+
+These settings apply only when `--tag=package-2018-11 --java` is specified on the command line.
+Please also specify `--azure-libraries-for-java-folder=<path to the root directory of your azure-sdk-for-java clone>`.
+
+``` yaml $(tag) == 'package-2018-11' && $(java) && $(multiapi)
+java:
+  namespace: com.microsoft.azure.management.network.v2018_11_01
+  output-folder: $(azure-libraries-for-java-folder)/sdk/network/mgmt-v2018_11_01
+  regenerate-manager: true
+  generate-interface: true
+```
+
 ### Tag: package-2018-08 and java
 
 These settings apply only when `--tag=package-2018-08 --java` is specified on the command line.
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 197cfe9edba2..d04ee8c192f6 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
@@ -581,7 +581,7 @@
       "in": "query",
       "required": true,
       "type": "string",
-      "description": "Client Api Version."
+      "description": "The client API version."
     },
     "ResourceGroupNameParameter": {
       "name": "resourceGroupName",
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
index 745bc549f03b..d34b30b8e4b5 100644
--- 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
@@ -309,7 +309,7 @@
       "in": "query",
       "required": true,
       "type": "string",
-      "description": "Client Api Version."
+      "description": "The client API version."
     },
     "ResourceGroupNameParameter": {
       "name": "resourceGroupName",
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 2a01a76827ae..e025c56880fb 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
@@ -637,7 +637,7 @@
       "in": "path",
       "required": true,
       "type": "string",
-      "description": "The workspace's resource subscription ID."
+      "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",
@@ -652,7 +652,7 @@
       "required": true,
       "type": "string",
       "x-ms-parameter-location": "method",
-      "description": "The workspace's resource group name.",
+      "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/readme.go.md b/specification/operationalinsights/resource-manager/readme.go.md
index e1fe11bf0104..eed49f2b4926 100644
--- a/specification/operationalinsights/resource-manager/readme.go.md
+++ b/specification/operationalinsights/resource-manager/readme.go.md
@@ -15,6 +15,7 @@ go:
 batch:
   - tag: package-2015-03
   - tag: package-2015-11-preview
+  - tag: package-2019-08-preview
   - tag: package-2020-03-preview
   - tag: package-2020-08
 ```
@@ -28,6 +29,15 @@ Please also specify `--go-sdk-folder=<path to the root directory of your azure-s
 output-folder: $(go-sdk-folder)/services/$(namespace)/mgmt/2015-03-20/$(namespace)
 ```
 
+### Tag: package-2019-08-preview and go
+
+These settings apply only when `--tag=package-2019-08-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-2019-08-preview' && $(go)
+output-folder: $(go-sdk-folder)/services/preview/$(namespace)/mgmt/2019-08-01-preview/$(namespace)
+```
+
 ### Tag: package-2015-11-preview and go
 
 These settings apply only when `--tag=package-2015-11-preview --go` is specified on the command line.
diff --git a/specification/reservations/resource-manager/Microsoft.Capacity/preview/2019-04-01/examples/CalculateReservationOrder.json b/specification/reservations/resource-manager/Microsoft.Capacity/preview/2019-04-01/examples/CalculateReservationOrder.json
index 7b653eef3672..f9161a07b3e4 100644
--- a/specification/reservations/resource-manager/Microsoft.Capacity/preview/2019-04-01/examples/CalculateReservationOrder.json
+++ b/specification/reservations/resource-manager/Microsoft.Capacity/preview/2019-04-01/examples/CalculateReservationOrder.json
@@ -11,7 +11,7 @@
         "billingScopeId": "/subscriptions/ed3a1871-612d-abcd-a849-c2542a68be83",
         "term": "P1Y",
         "billingPlan": "Monthly",
-        "quantity": "1",
+        "quantity": 1,
         "displayName": "TestReservationOrder",
         "appliedScopes": null,
         "appliedScopeType": "Shared",
diff --git a/specification/reservations/resource-manager/Microsoft.Capacity/preview/2019-04-01/examples/GetCatalog.json b/specification/reservations/resource-manager/Microsoft.Capacity/preview/2019-04-01/examples/GetCatalog.json
index 9964e3ffff69..d0df20b1593d 100644
--- a/specification/reservations/resource-manager/Microsoft.Capacity/preview/2019-04-01/examples/GetCatalog.json
+++ b/specification/reservations/resource-manager/Microsoft.Capacity/preview/2019-04-01/examples/GetCatalog.json
@@ -59,20 +59,16 @@
             "P1Y",
             "P3Y"
           ],
-          "billingPlans": [
-            {
-              "P1Y": [
-                "Upfront",
-                "Monthly"
-              ]
-            },
-            {
-              "P3Y": [
-                "Upfront",
-                "Monthly"
-              ]
-            }
-          ],
+          "billingPlans": {
+            "P1Y": [
+              "Upfront",
+              "Monthly"
+            ],
+            "P3Y": [
+              "Upfront",
+              "Monthly"
+            ]
+          },
           "locations": [
             "eastus"
           ],
@@ -122,20 +118,16 @@
             "P1Y",
             "P3Y"
           ],
-          "billingPlans": [
-            {
-              "P1Y": [
-                "Upfront",
-                "Monthly"
-              ]
-            },
-            {
-              "P3Y": [
-                "Upfront",
-                "Monthly"
-              ]
-            }
-          ],
+          "billingPlans": {
+            "P1Y": [
+              "Upfront",
+              "Monthly"
+            ],
+            "P3Y": [
+              "Upfront",
+              "Monthly"
+            ]
+          },
           "locations": [
             "eastus"
           ],
diff --git a/specification/reservations/resource-manager/Microsoft.Capacity/preview/2019-04-01/examples/PurchaseReservationOrder.json b/specification/reservations/resource-manager/Microsoft.Capacity/preview/2019-04-01/examples/PurchaseReservationOrder.json
index 1666a037a0cb..11823e427401 100644
--- a/specification/reservations/resource-manager/Microsoft.Capacity/preview/2019-04-01/examples/PurchaseReservationOrder.json
+++ b/specification/reservations/resource-manager/Microsoft.Capacity/preview/2019-04-01/examples/PurchaseReservationOrder.json
@@ -12,7 +12,7 @@
         "billingScopeId": "/subscriptions/ed3a1871-612d-abcd-a849-c2542a68be83",
         "term": "P1Y",
         "billingPlan": "Monthly",
-        "quantity": "1",
+        "quantity": 1,
         "displayName": "TestReservationOrder",
         "appliedScopes": null,
         "appliedScopeType": "Shared",
diff --git a/specification/reservations/resource-manager/Microsoft.Capacity/preview/2020-10-01-preview/examples/CalculateExchange.json b/specification/reservations/resource-manager/Microsoft.Capacity/preview/2020-10-01-preview/examples/CalculateExchange.json
new file mode 100644
index 000000000000..2b03b22a1bb2
--- /dev/null
+++ b/specification/reservations/resource-manager/Microsoft.Capacity/preview/2020-10-01-preview/examples/CalculateExchange.json
@@ -0,0 +1,114 @@
+{
+  "parameters": {
+    "api-version": "2020-10-01-preview",
+    "body": {
+      "properties": {
+        "reservationsToPurchase": [
+          {
+            "sku": {
+              "name": "Standard_B1ls"
+            },
+            "location": "westus",
+            "properties": {
+              "reservedResourceType": "VirtualMachines",
+              "billingScopeId": "/subscriptions/ed3a1871-612d-abcd-a849-c2542a68be83",
+              "term": "P1Y",
+              "billingPlan": "Upfront",
+              "quantity": 1,
+              "displayName": "testDisplayName",
+              "appliedScopeType": "Shared",
+              "appliedScopes": null,
+              "renew": false,
+              "reservedResourceProperties": {
+                "instanceFlexibility": "On"
+              }
+            }
+          }
+        ],
+        "reservationsToExchange": [
+          {
+            "id": "/providers/microsoft.capacity/reservationOrders/1f14354c-dc12-4c8d-8090-6f295a3a34aa",
+            "properties": {
+              "scope": "Reservation",
+              "reservationToReturn": {
+                "reservationId": "/providers/microsoft.capacity/reservationOrders/1f14354c-dc12-4c8d-8090-6f295a3a34aa/reservations/c8c926bd-fc5d-4e29-9d43-b68340ac23a6",
+                "quantity": 1
+              }
+            }
+          }
+        ]
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/providers/microsoft.capacity/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188",
+        "name": "4e2ffff7-b331-4fcb-ab11-b5fa49368188",
+        "status": "Succeeded",
+        "properties": {
+          "sessionId": "66e2ac8f-439e-4345-8235-6fef07608081",
+          "netPayable": {
+            "currencyCode": "EUR",
+            "amount": -688.11
+          },
+          "refundsTotal": {
+            "currencyCode": "EUR",
+            "amount": 2938.11
+          },
+          "purchasesTotal": {
+            "currencyCode": "EUR",
+            "amount": 2250.0
+          },
+          "reservationsToPurchase": [
+            {
+              "billingCurrencyTotal": {
+                "currencyCode": "EUR",
+                "amount": 2250.0
+              }
+            }
+          ],
+          "reservationsToExchange": [
+            {
+              "reservationId": "/providers/microsoft.capacity/reservationOrders/1f14354c-dc12-4c8d-8090-6f295a3a34aa/reservations/c8c926bd-fc5d-4e29-9d43-b68340ac23a6",
+              "quantity": 1,
+              "billingRefundAmount": {
+                "currencyCode": "EUR",
+                "amount": 34.17
+              },
+              "billingInformation": {
+                "billingCurrencyTotalPaidAmount": {
+                  "currencyCode": "EUR",
+                  "amount": 170.82
+                },
+                "billingCurrencyProratedAmount": {
+                  "currencyCode": "EUR",
+                  "amount": 136.65
+                },
+                "billingCurrencyRemainingCommitmentAmount": {
+                  "currencyCode": "EUR",
+                  "amount": 2903.94
+                }
+              }
+            }
+          ],
+          "policyResult": {
+            "policyErrors": [
+              {
+                "code": "RefundsLessThanPurchase",
+                "message": "New purchase amount should be greater than the total refunds."
+              }
+            ]
+          }
+        },
+        "error": null
+      }
+    },
+    "202": {
+      "headers": {
+        "Location": "https://management.azure.com/Microsoft.Capacity/operationResults/8d542218-8bfe-4fd2-b909-0656c610281c?api-version=2019-04-01",
+        "Retry-After": 5
+      }
+    }
+  }
+}
diff --git a/specification/reservations/resource-manager/Microsoft.Capacity/preview/2020-10-01-preview/examples/CalculateReservationOrder.json b/specification/reservations/resource-manager/Microsoft.Capacity/preview/2020-10-01-preview/examples/CalculateReservationOrder.json
new file mode 100644
index 000000000000..6812a7faee0e
--- /dev/null
+++ b/specification/reservations/resource-manager/Microsoft.Capacity/preview/2020-10-01-preview/examples/CalculateReservationOrder.json
@@ -0,0 +1,70 @@
+{
+  "parameters": {
+    "api-version": "2020-10-01-preview",
+    "body": {
+      "sku": {
+        "name": "standard_D1"
+      },
+      "location": "westus",
+      "properties": {
+        "reservedResourceType": "VirtualMachines",
+        "billingScopeId": "/subscriptions/ed3a1871-612d-abcd-a849-c2542a68be83",
+        "term": "P1Y",
+        "billingPlan": "Monthly",
+        "quantity": 1,
+        "displayName": "TestReservationOrder",
+        "appliedScopes": null,
+        "appliedScopeType": "Shared",
+        "reservedResourceProperties": {
+          "instanceFlexibility": "On"
+        }
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "properties": {
+          "billingCurrencyTotal": {
+            "currencyCode": "USD",
+            "amount": 46.0
+          },
+          "reservationOrderId": "6d9cec54-7de8-abcd-9de7-80f5d634f2d2",
+          "skuTitle": "Reserved VM Instance, Standard_D1, US West, 1 Year",
+          "skuDescription": "standard_D1",
+          "pricingCurrencyTotal": {
+            "currencyCode": "USD",
+            "amount": 46.0
+          },
+          "paymentSchedule": [
+            {
+              "dueDate": "2019-05-14",
+              "pricingCurrencyTotal": {
+                "currencyCode": "USD",
+                "amount": 46
+              },
+              "billingCurrencyTotal": {
+                "currencyCode": "EUR",
+                "amount": 40
+              }
+            },
+            {
+              "dueDate": "2019-06-14",
+              "pricingCurrencyTotal": {
+                "currencyCode": "USD",
+                "amount": 46
+              }
+            },
+            {
+              "dueDate": "2019-07-14",
+              "pricingCurrencyTotal": {
+                "currencyCode": "USD",
+                "amount": 46
+              }
+            }
+          ]
+        }
+      }
+    }
+  }
+}
diff --git a/specification/reservations/resource-manager/Microsoft.Capacity/preview/2020-10-01-preview/examples/Exchange.json b/specification/reservations/resource-manager/Microsoft.Capacity/preview/2020-10-01-preview/examples/Exchange.json
new file mode 100644
index 000000000000..6762812a1af6
--- /dev/null
+++ b/specification/reservations/resource-manager/Microsoft.Capacity/preview/2020-10-01-preview/examples/Exchange.json
@@ -0,0 +1,82 @@
+{
+  "parameters": {
+    "api-version": "2020-10-01-preview",
+    "body": {
+      "properties": {
+        "sessionId": "66e2ac8f-439e-4345-8235-6fef07608081"
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/providers/microsoft.capacity/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188",
+        "name": "4e2ffff7-b331-4fcb-ab11-b5fa49368188",
+        "status": "Succeeded",
+        "properties": {
+          "sessionId": "66e2ac8f-439e-4345-8235-6fef07608081",
+          "netPayable": {
+            "currencyCode": "EUR",
+            "amount": -688.11
+          },
+          "refundsTotal": {
+            "currencyCode": "EUR",
+            "amount": 2938.11
+          },
+          "purchasesTotal": {
+            "currencyCode": "EUR",
+            "amount": 2250.0
+          },
+          "reservationsToPurchase": [
+            {
+              "reservationOrderId": "/providers/microsoft.capacity/reservationOrders/1e85c519-b815-4169-8d79-62fc460c608f",
+              "billingCurrencyTotal": {
+                "currencyCode": "EUR",
+                "amount": 2250.0
+              }
+            }
+          ],
+          "reservationsToExchange": [
+            {
+              "reservationId": "/providers/microsoft.capacity/reservationOrders/1f14354c-dc12-4c8d-8090-6f295a3a34aa/reservations/c8c926bd-fc5d-4e29-9d43-b68340ac23a6",
+              "quantity": 1,
+              "billingRefundAmount": {
+                "currencyCode": "EUR",
+                "amount": 34.17
+              },
+              "billingInformation": {
+                "billingCurrencyTotalPaidAmount": {
+                  "currencyCode": "EUR",
+                  "amount": 170.82
+                },
+                "billingCurrencyProratedAmount": {
+                  "currencyCode": "EUR",
+                  "amount": 136.65
+                },
+                "billingCurrencyRemainingCommitmentAmount": {
+                  "currencyCode": "EUR",
+                  "amount": 2903.94
+                }
+              }
+            }
+          ],
+          "policyResult": {
+            "policyErrors": [
+              {
+                "code": "RefundsLessThanPurchase",
+                "message": "New purchase amount should be greater than the total refunds."
+              }
+            ]
+          }
+        },
+        "error": null
+      }
+    },
+    "202": {
+      "headers": {
+        "Location": "https://management.azure.com/Microsoft.Capacity/operationResults/8d542218-8bfe-4fd2-b909-0656c610281c?api-version=2019-04-01",
+        "Retry-After": 5
+      }
+    }
+  }
+}
diff --git a/specification/reservations/resource-manager/Microsoft.Capacity/preview/2020-10-01-preview/examples/GetAppliedReservations.json b/specification/reservations/resource-manager/Microsoft.Capacity/preview/2020-10-01-preview/examples/GetAppliedReservations.json
new file mode 100644
index 000000000000..d6cf2fa56335
--- /dev/null
+++ b/specification/reservations/resource-manager/Microsoft.Capacity/preview/2020-10-01-preview/examples/GetAppliedReservations.json
@@ -0,0 +1,34 @@
+{
+  "parameters": {
+    "api-version": "2020-10-01-preview",
+    "subscriptionId": "23bc208b-083f-4901-ae85-4f98c0c3b4b6"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/23bc208b-083f-4901-ae85-4f98c0c3b4b6/providers/microsoft.capacity/AppliedReservations/default",
+        "type": "Microsoft.Capacity/AppliedReservations",
+        "name": "default",
+        "properties": {
+          "reservationOrderIds": {
+            "value": [
+              "/providers/Microsoft.Capacity/reservationorders/e1eccf0b-2db4-4e84-97e7-98b50e9d46f7",
+              "/providers/Microsoft.Capacity/reservationorders/741a32eb-6158-4cee-9642-a0243ae79fac",
+              "/providers/Microsoft.Capacity/reservationorders/e061223d-fcff-4d10-bd49-56a740cfb96a",
+              "/providers/Microsoft.Capacity/reservationorders/2eeb7234-970e-4663-b60b-85241b515901",
+              "/providers/Microsoft.Capacity/reservationorders/9db2f4c5-b1c5-42a8-bd79-ee56cdde2c7f",
+              "/providers/Microsoft.Capacity/reservationorders/5da7a877-6d6e-44af-8880-ed3f533bf928",
+              "/providers/Microsoft.Capacity/reservationorders/f65b0d0a-f945-4105-821c-d00bc8bacde8",
+              "/providers/Microsoft.Capacity/reservationorders/51304124-e477-4b07-b9fa-03b05c8b924b",
+              "/providers/Microsoft.Capacity/reservationorders/f5409b98-8a42-4dc6-be0a-cc59bef4d0db",
+              "/providers/Microsoft.Capacity/reservationorders/a495550a-80a4-46f8-8843-34d4df46f9a6",
+              "/providers/Microsoft.Capacity/reservationorders/1a966e18-c272-4ce1-a0c2-d4e1039023c3",
+              "/providers/Microsoft.Capacity/reservationorders/939310b4-f9de-4645-9569-ab5b6cfe958e",
+              "/providers/Microsoft.Capacity/reservationorders/4193a889-7c3b-44dc-8b7b-bfd7aad6c723"
+            ]
+          }
+        }
+      }
+    }
+  }
+}
diff --git a/specification/reservations/resource-manager/Microsoft.Capacity/preview/2020-10-01-preview/examples/GetAvailableScope.json b/specification/reservations/resource-manager/Microsoft.Capacity/preview/2020-10-01-preview/examples/GetAvailableScope.json
new file mode 100644
index 000000000000..1ab63999604f
--- /dev/null
+++ b/specification/reservations/resource-manager/Microsoft.Capacity/preview/2020-10-01-preview/examples/GetAvailableScope.json
@@ -0,0 +1,28 @@
+{
+  "parameters": {
+    "api-version": "2020-10-01-preview",
+    "reservationOrderId": "276e7ae4-84d0-4da6-ab4b-d6b94f3557da",
+    "reservationId": "356e7ae4-84d0-4da6-ab4b-d6b94f3557da",
+    "body": {
+      "properties": {
+        "scopes": [
+          "/subscriptions/efc7c997-7700-4a74-b731-55aec16c15e9"
+        ]
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "properties": {
+          "scopes": [
+            {
+              "scope": "/subscriptions/efc7c997-7700-4a74-b731-55aec16c15e9",
+              "valid": true
+            }
+          ]
+        }
+      }
+    }
+  }
+}
diff --git a/specification/reservations/resource-manager/Microsoft.Capacity/preview/2020-10-01-preview/examples/GetCatalog.json b/specification/reservations/resource-manager/Microsoft.Capacity/preview/2020-10-01-preview/examples/GetCatalog.json
new file mode 100644
index 000000000000..dc2d46e8fe65
--- /dev/null
+++ b/specification/reservations/resource-manager/Microsoft.Capacity/preview/2020-10-01-preview/examples/GetCatalog.json
@@ -0,0 +1,169 @@
+{
+  "parameters": {
+    "api-version": "2020-10-01-preview",
+    "subscriptionId": "23bc208b-083f-4901-ae85-4f98c0c3b4b6",
+    "reservedResourceType": "VirtualMachines",
+    "location": "eastus"
+  },
+  "responses": {
+    "200": {
+      "body": [
+        {
+          "resourceType": "VirtualMachines",
+          "name": "Standard_DS5_v2",
+          "terms": [
+            "P1Y",
+            "P3Y"
+          ],
+          "billingPlans": {
+            "P1Y": [
+              "Upfront",
+              "Monthly"
+            ],
+            "P3Y": [
+              "Upfront",
+              "Monthly"
+            ]
+          },
+          "locations": [
+            "eastus"
+          ],
+          "skuProperties": [
+            {
+              "name": "Cores",
+              "value": "16"
+            },
+            {
+              "name": "ProductTitle",
+              "value": "DSv2 Series, DS5"
+            },
+            {
+              "name": "ProductShortName",
+              "value": "DSv2 Series"
+            },
+            {
+              "name": "SKUName",
+              "value": "DS5 v2"
+            },
+            {
+              "name": "MeterId",
+              "value": "12bc208b-083f-4901-ae85-4f98c0c3b4b8"
+            }
+          ],
+          "restrictions": []
+        },
+        {
+          "resourceType": "VirtualMachines",
+          "name": "Standard_D1",
+          "terms": [
+            "P1Y",
+            "P3Y"
+          ],
+          "billingPlans": {
+            "P1Y": [
+              "Upfront",
+              "Monthly"
+            ],
+            "P3Y": [
+              "Upfront",
+              "Monthly"
+            ]
+          },
+          "locations": [
+            "eastus"
+          ],
+          "skuProperties": [
+            {
+              "name": "Cores",
+              "value": "1"
+            },
+            {
+              "name": "ProductTitle",
+              "value": "D Series, D1"
+            },
+            {
+              "name": "ProductShortName",
+              "value": "D Series"
+            },
+            {
+              "name": "SKUName",
+              "value": "D1"
+            },
+            {
+              "name": "MeterId",
+              "value": "12bc208b-083f-4901-ae85-4f98c0c3b4b8"
+            }
+          ],
+          "restrictions": [
+            {
+              "type": "Term",
+              "values": [
+                "P1Y"
+              ],
+              "reasonCode": "NotAvailableForSubscription"
+            },
+            {
+              "type": "Term",
+              "values": [
+                "P3Y"
+              ],
+              "reasonCode": "NotAvailableForSubscription"
+            }
+          ]
+        },
+        {
+          "resourceType": "VirtualMachines",
+          "name": "Standard_F2",
+          "terms": [
+            "P1Y",
+            "P3Y"
+          ],
+          "billingPlans": {
+            "P1Y": [
+              "Upfront",
+              "Monthly"
+            ],
+            "P3Y": [
+              "Upfront",
+              "Monthly"
+            ]
+          },
+          "locations": [
+            "eastus"
+          ],
+          "skuProperties": [
+            {
+              "name": "Cores",
+              "value": "2"
+            },
+            {
+              "name": "ProductTitle",
+              "value": "F Series, F2"
+            },
+            {
+              "name": "ProductShortName",
+              "value": "F Series"
+            },
+            {
+              "name": "SKUName",
+              "value": "F2"
+            },
+            {
+              "name": "MeterId",
+              "value": "12bc208b-083f-4901-ae85-4f98c0c3b4b8"
+            }
+          ],
+          "restrictions": [
+            {
+              "type": "Location",
+              "values": [
+                "eastus"
+              ],
+              "reasonCode": "NotAvailableForSubscription"
+            }
+          ]
+        }
+      ]
+    }
+  }
+}
diff --git a/specification/reservations/resource-manager/Microsoft.Capacity/preview/2020-10-01-preview/examples/GetOperations.json b/specification/reservations/resource-manager/Microsoft.Capacity/preview/2020-10-01-preview/examples/GetOperations.json
new file mode 100644
index 000000000000..0232a3d253ff
--- /dev/null
+++ b/specification/reservations/resource-manager/Microsoft.Capacity/preview/2020-10-01-preview/examples/GetOperations.json
@@ -0,0 +1,103 @@
+{
+  "parameters": {
+    "api-version": "2020-10-01-preview"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "name": "Microsoft.Capacity/reservationorders/read",
+            "display": {
+              "provider": "Microsoft Capacity",
+              "resource": "Reservations",
+              "operation": "Get Reservations",
+              "description": "Read All Reservations"
+            }
+          },
+          {
+            "name": "Microsoft.Capacity/reservationorders/write",
+            "display": {
+              "provider": "Microsoft Capacity",
+              "resource": "Reservations",
+              "operation": "Create Reservations",
+              "description": "Create any Reservation"
+            }
+          },
+          {
+            "name": "Microsoft.Capacity/reservationorders/action",
+            "display": {
+              "provider": "Microsoft Capacity",
+              "resource": "Reservations",
+              "operation": "Update Reservations",
+              "description": "Update any Reservation"
+            }
+          },
+          {
+            "name": "Microsoft.Capacity/reservationorders/delete",
+            "display": {
+              "provider": "Microsoft Capacity",
+              "resource": "Reservations",
+              "operation": "Delete Reservations",
+              "description": "Delete any Reservation"
+            }
+          },
+          {
+            "name": "Microsoft.Capacity/reservationorders/reservations/read",
+            "display": {
+              "provider": "Microsoft Capacity",
+              "resource": "Reservations",
+              "operation": "Get Reservations",
+              "description": "Read All Reservations"
+            }
+          },
+          {
+            "name": "Microsoft.Capacity/reservationorders/reservations/write",
+            "display": {
+              "provider": "Microsoft Capacity",
+              "resource": "Reservations",
+              "operation": "Create Reservations",
+              "description": "Create any Reservation"
+            }
+          },
+          {
+            "name": "Microsoft.Capacity/reservationorders/reservations/action",
+            "display": {
+              "provider": "Microsoft Capacity",
+              "resource": "Reservations",
+              "operation": "Update Reservations",
+              "description": "Update any Reservation"
+            }
+          },
+          {
+            "name": "Microsoft.Capacity/reservationorders/reservations/delete",
+            "display": {
+              "provider": "Microsoft Capacity",
+              "resource": "Reservations",
+              "operation": "Delete Reservations",
+              "description": "Delete any Reservation"
+            }
+          },
+          {
+            "name": "Microsoft.Capacity/reservationorders/reservations/revisions/read",
+            "display": {
+              "provider": "Microsoft Capacity",
+              "resource": "Reservations",
+              "operation": "Get Reservations",
+              "description": "Read All Reservations"
+            }
+          },
+          {
+            "name": "Microsoft.Capacity/register/action",
+            "display": {
+              "provider": "Microsoft Capacity",
+              "resource": "Reservations",
+              "operation": "Registers the Capacity Resource Provider.",
+              "description": "Registers the Capacity resource provider and enables the creation of Capacity resources."
+            }
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/reservations/resource-manager/Microsoft.Capacity/preview/2020-10-01-preview/examples/GetReservationDetails.json b/specification/reservations/resource-manager/Microsoft.Capacity/preview/2020-10-01-preview/examples/GetReservationDetails.json
new file mode 100644
index 000000000000..4921383e79b6
--- /dev/null
+++ b/specification/reservations/resource-manager/Microsoft.Capacity/preview/2020-10-01-preview/examples/GetReservationDetails.json
@@ -0,0 +1,77 @@
+{
+  "parameters": {
+    "api-version": "2020-10-01-preview",
+    "reservationOrderId": "276e7ae4-84d0-4da6-ab4b-d6b94f3557da",
+    "reservationId": "6ef59113-3482-40da-8d79-787f823e34bc",
+    "expand": "renewProperties"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "sku": {
+          "name": "Standard_DS1_v2"
+        },
+        "id": "/providers/microsoft.capacity/reservationOrders/276e7ae4-84d0-4da6-ab4b-d6b94f3557da/reservations/6ef59113-3482-40da-8d79-787f823e34bc",
+        "type": "Microsoft.Capacity/reservationOrders/reservations",
+        "name": "276e7ae4-84d0-4da6-ab4b-d6b94f3557da/6ef59113-3482-40da-8d79-787f823e34bc",
+        "etag": 2,
+        "location": "eastus",
+        "properties": {
+          "appliedScopes": [
+            "/subscriptions/98df3792-7962-4f18-8be2-d5576f122de3"
+          ],
+          "renew": false,
+          "renewSource": "/providers/microsoft.capacity/reservationOrders/276e7ae4-84d0-4da6-ab4b-d6b94f3557da/reservations/00238563-7312-4c20-a134-8c030bf938a7",
+          "renewDestination": "/providers/microsoft.capacity/reservationOrders/276e7ae4-84d0-4da6-ab4b-d6b94f3557da/reservations/00238563-7312-4c20-a134-8c030bf938a7",
+          "billingScopeId": "/subscriptions/19376483-64b8-49e4-a931-d5248828720a",
+          "appliedScopeType": "Single",
+          "billingPlan": "Monthly",
+          "quantity": 3,
+          "provisioningState": "Succeeded",
+          "expiryDate": "2018-09-22",
+          "displayName": "cabri_test",
+          "effectiveDateTime": "2017-09-22T22:46:32.7632798Z",
+          "lastUpdatedDateTime": "2017-09-22T22:46:32.7632798Z",
+          "reservedResourceType": "VirtualMachines",
+          "instanceFlexibility": "Off",
+          "skuDescription": "D1 v2",
+          "term": "P1Y",
+          "mergeProperties": {
+            "mergeSources": [
+              "/providers/microsoft.capacity/reservationOrders/276e7ae4-84d0-4da6-ab4b-d6b94f3557da/reservations/00238563-7312-4c20-a134-8c030bf938a7",
+              "/providers/microsoft.capacity/reservationOrders/276e7ae4-84d0-4da6-ab4b-d6b94f3557da/reservations/e0e4b4f5-77ea-4984-9ee4-6bf9850ee6de"
+            ]
+          },
+          "renewProperties": {
+            "purchaseProperties": {
+              "sku": {
+                "name": "Standard_D1"
+              },
+              "location": "westus",
+              "properties": {
+                "billingScopeId": "/subscriptions/19376483-64b8-49e4-a931-d5248828720a",
+                "term": "P1Y",
+                "quantity": 2,
+                "displayName": "Renew_Test_0618",
+                "appliedScopeType": "Shared",
+                "reservedResourceType": "VirtualMachines",
+                "reservedResourceProperties": {
+                  "instanceFlexibility": "On"
+                },
+                "renew": false
+              }
+            },
+            "billingCurrencyTotal": {
+              "currencyCode": "USD",
+              "amount": 466.0
+            },
+            "pricingCurrencyTotal": {
+              "currencyCode": "USD",
+              "amount": 466.0
+            }
+          }
+        }
+      }
+    }
+  }
+}
diff --git a/specification/reservations/resource-manager/Microsoft.Capacity/preview/2020-10-01-preview/examples/GetReservationOrderDetails.json b/specification/reservations/resource-manager/Microsoft.Capacity/preview/2020-10-01-preview/examples/GetReservationOrderDetails.json
new file mode 100644
index 000000000000..38ee57b5e5d2
--- /dev/null
+++ b/specification/reservations/resource-manager/Microsoft.Capacity/preview/2020-10-01-preview/examples/GetReservationOrderDetails.json
@@ -0,0 +1,31 @@
+{
+  "parameters": {
+    "api-version": "2020-10-01-preview",
+    "reservationOrderId": "a075419f-44cc-497f-b68a-14ee811d48b9"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/providers/microsoft.capacity/reservationOrders/1f14354c-dc12-4c8d-8090-6f295a3a34aa",
+        "type": "Microsoft.Capacity/reservationOrders",
+        "name": "1f14354c-dc12-4c8d-8090-6f295a3a34aa",
+        "etag": 7,
+        "properties": {
+          "displayName": "cabri",
+          "requestDateTime": "2017-08-30T03:49:19.0252126Z",
+          "createdDateTime": "2017-08-30T03:51:49.8083758Z",
+          "expiryDate": "2018-08-30",
+          "term": "P1Y",
+          "billingPlan": "Monthly",
+          "provisioningState": "Succeeded",
+          "reservations": [
+            {
+              "id": "/providers/microsoft.capacity/reservationOrders/1f14354c-dc12-4c8d-8090-6f295a3a34aa/reservations/c8c926bd-fc5d-4e29-9d43-b68340ac23a6"
+            }
+          ],
+          "originalQuantity": 7
+        }
+      }
+    }
+  }
+}
diff --git a/specification/reservations/resource-manager/Microsoft.Capacity/preview/2020-10-01-preview/examples/GetReservationOrderDetailsWithExpandPlanInformation.json b/specification/reservations/resource-manager/Microsoft.Capacity/preview/2020-10-01-preview/examples/GetReservationOrderDetailsWithExpandPlanInformation.json
new file mode 100644
index 000000000000..8bf795789305
--- /dev/null
+++ b/specification/reservations/resource-manager/Microsoft.Capacity/preview/2020-10-01-preview/examples/GetReservationOrderDetailsWithExpandPlanInformation.json
@@ -0,0 +1,130 @@
+{
+  "parameters": {
+    "api-version": "2020-10-01-preview",
+    "reservationOrderId": "a075419f-44cc-497f-b68a-14ee811d48b9",
+    "$expand": "schedule"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/providers/microsoft.capacity/reservationOrders/1f14354c-dc12-4c8d-8090-6f295a3a34aa",
+        "type": "Microsoft.Capacity/reservationOrders",
+        "name": "1f14354c-dc12-4c8d-8090-6f295a3a34aa",
+        "etag": 7,
+        "properties": {
+          "displayName": "cabri",
+          "requestDateTime": "2019-08-30T03:49:19Z",
+          "createdDateTime": "2019-08-30T03:51:49Z",
+          "expiryDate": "2018-08-30",
+          "term": "P1Y",
+          "billingPlan": "Monthly",
+          "provisioningState": "Succeeded",
+          "reservations": [
+            {
+              "id": "/providers/microsoft.capacity/reservationOrders/1f14354c-dc12-4c8d-8090-6f295a3a34aa/reservations/c8c926bd-fc5d-4e29-9d43-b68340ac23a6"
+            }
+          ],
+          "originalQuantity": 7,
+          "planInformation": {
+            "pricingCurrencyTotal": {
+              "currencyCode": "USD",
+              "amount": 466
+            },
+            "startDate": "2019-08-30",
+            "nextPaymentDueDate": "2019-09-30",
+            "transactions": [
+              {
+                "dueDate": "2019-09-30",
+                "paymentDate": "2019-09-30",
+                "status": "Succeeded",
+                "pricingCurrencyTotal": {
+                  "currencyCode": "USD",
+                  "amount": 466
+                },
+                "billingCurrencyTotal": {
+                  "currencyCode": "USD",
+                  "amount": 466
+                },
+                "billingAccount": "23456"
+              },
+              {
+                "dueDate": "2019-10-30",
+                "paymentDate": "2019-10-30",
+                "status": "Failed",
+                "pricingCurrencyTotal": {
+                  "currencyCode": "USD",
+                  "amount": 466
+                },
+                "billingCurrencyTotal": {
+                  "currencyCode": "USD",
+                  "amount": 466
+                },
+                "extendedStatusInfo": {
+                  "statusCode": "PaymentDeclined",
+                  "message": "Credit card charge failed."
+                },
+                "billingAccount": "23456"
+              },
+              {
+                "dueDate": "2019-10-31",
+                "paymentDate": "2019-10-31",
+                "status": "Succeeded",
+                "pricingCurrencyTotal": {
+                  "currencyCode": "USD",
+                  "amount": 466
+                },
+                "billingCurrencyTotal": {
+                  "currencyCode": "USD",
+                  "amount": 466
+                },
+                "billingAccount": "23456"
+              },
+              {
+                "dueDate": "2019-11-30",
+                "paymentDate": "2019-11-30",
+                "status": "Succeeded",
+                "pricingCurrencyTotal": {
+                  "currencyCode": "USD",
+                  "amount": 466
+                },
+                "billingCurrencyTotal": {
+                  "currencyCode": "USD",
+                  "amount": 466
+                },
+                "billingAccount": "23456"
+              },
+              {
+                "dueDate": "2019-07-14",
+                "paymentDate": "2019-06-14",
+                "status": "Scheduled",
+                "pricingCurrencyTotal": {
+                  "currencyCode": "USD",
+                  "amount": 466
+                },
+                "billingCurrencyTotal": {
+                  "currencyCode": "USD",
+                  "amount": 466
+                },
+                "billingAccount": "23456"
+              },
+              {
+                "dueDate": "2019-06-14",
+                "paymentDate": "2019-08-14",
+                "status": "Scheduled",
+                "pricingCurrencyTotal": {
+                  "currencyCode": "USD",
+                  "amount": 466
+                },
+                "billingCurrencyTotal": {
+                  "currencyCode": "USD",
+                  "amount": 466
+                },
+                "billingAccount": "23456"
+              }
+            ]
+          }
+        }
+      }
+    }
+  }
+}
diff --git a/specification/reservations/resource-manager/Microsoft.Capacity/preview/2020-10-01-preview/examples/GetReservationOrders.json b/specification/reservations/resource-manager/Microsoft.Capacity/preview/2020-10-01-preview/examples/GetReservationOrders.json
new file mode 100644
index 000000000000..fb4841314547
--- /dev/null
+++ b/specification/reservations/resource-manager/Microsoft.Capacity/preview/2020-10-01-preview/examples/GetReservationOrders.json
@@ -0,0 +1,77 @@
+{
+  "parameters": {
+    "api-version": "2020-10-01-preview"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "id": "/providers/microsoft.capacity/reservationOrders/1e6407ba-37a5-499f-80ed-a3f0f338e443",
+            "type": "Microsoft.Capacity/reservationOrders",
+            "name": "1e6407ba-37a5-499f-80ed-a3f0f338e443",
+            "etag": 7,
+            "properties": {
+              "displayName": "cabri",
+              "requestDateTime": "2017-08-29T21:20:23.8134834Z",
+              "createdDateTime": "2017-08-29T21:22:56.8541664Z",
+              "expiryDate": "2018-08-29",
+              "term": "P1Y",
+              "billingPlan": "Monthly",
+              "provisioningState": "Succeeded",
+              "reservations": [
+                {
+                  "id": "/providers/microsoft.capacity/reservationOrders/1e6407ba-37a5-499f-80ed-a3f0f338e443/reservations/cae5924e-7a15-419f-a369-124f52d4a106"
+                }
+              ],
+              "originalQuantity": 1
+            }
+          },
+          {
+            "id": "/providers/microsoft.capacity/reservationOrders/1ea6e203-288e-4732-b9e1-da8bbe10c614",
+            "type": "Microsoft.Capacity/reservationOrders",
+            "name": "1ea6e203-288e-4732-b9e1-da8bbe10c614",
+            "etag": 7,
+            "properties": {
+              "displayName": "cabri",
+              "requestDateTime": "2017-08-30T12:55:40.2799114Z",
+              "createdDateTime": "2017-08-30T12:58:20.526Z",
+              "expiryDate": "2018-08-30",
+              "term": "P1Y",
+              "billingPlan": "Monthly",
+              "provisioningState": "Succeeded",
+              "reservations": [
+                {
+                  "id": "/providers/microsoft.capacity/reservationOrders/1ea6e203-288e-4732-b9e1-da8bbe10c614/reservations/d04fd48d-e3f6-42a3-a8f6-1ad0b7513e48"
+                }
+              ],
+              "originalQuantity": 9
+            }
+          },
+          {
+            "id": "/providers/microsoft.capacity/reservationOrders/1f14354c-dc12-4c8d-8090-6f295a3a34aa",
+            "type": "Microsoft.Capacity/reservationOrders",
+            "name": "1f14354c-dc12-4c8d-8090-6f295a3a34aa",
+            "etag": 7,
+            "properties": {
+              "displayName": "cabri",
+              "requestDateTime": "2017-08-30T03:49:19.0252126Z",
+              "createdDateTime": "2017-08-30T03:51:49.8083758Z",
+              "expiryDate": "2018-08-30",
+              "term": "P1Y",
+              "billingPlan": "Monthly",
+              "provisioningState": "Succeeded",
+              "reservations": [
+                {
+                  "id": "/providers/microsoft.capacity/reservationOrders/1f14354c-dc12-4c8d-8090-6f295a3a34aa/reservations/c8c926bd-fc5d-4e29-9d43-b68340ac23a6"
+                }
+              ],
+              "originalQuantity": 7
+            }
+          }
+        ],
+        "nextLink": "https://management.azure.com/providers/Microsoft.Capacity/reservationOrders?api-version=2017-11-01&%24skiptoken=eyJyZyI6IjIwNTkyMzdlLWY3MmYtNDczYi1hNTZiLWExOGJkM2UwMDhlZCIsImlnIjpudWxsLCJzdCI6bnVsbH0%3d"
+      }
+    }
+  }
+}
diff --git a/specification/reservations/resource-manager/Microsoft.Capacity/preview/2020-10-01-preview/examples/GetReservationRevisions.json b/specification/reservations/resource-manager/Microsoft.Capacity/preview/2020-10-01-preview/examples/GetReservationRevisions.json
new file mode 100644
index 000000000000..4aef3b2294d4
--- /dev/null
+++ b/specification/reservations/resource-manager/Microsoft.Capacity/preview/2020-10-01-preview/examples/GetReservationRevisions.json
@@ -0,0 +1,143 @@
+{
+  "parameters": {
+    "api-version": "2020-10-01-preview",
+    "reservationOrderId": "276e7ae4-84d0-4da6-ab4b-d6b94f3557da",
+    "reservationId": "6ef59113-3482-40da-8d79-787f823e34bc"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "sku": {
+              "name": "Standard_DS1_v2"
+            },
+            "id": "/providers/microsoft.capacity/reservationOrders/276e7ae4-84d0-4da6-ab4b-d6b94f3557da/reservations/6ef59113-3482-40da-8d79-787f823e34bc/revisions/4",
+            "type": "Microsoft.Capacity/reservationOrders/reservations/revisions",
+            "name": "276e7ae4-84d0-4da6-ab4b-d6b94f3557da/6ef59113-3482-40da-8d79-787f823e34bc/4",
+            "etag": 4,
+            "location": "eastus",
+            "properties": {
+              "appliedScopeType": "Shared",
+              "quantity": 3,
+              "provisioningState": "Succeeded",
+              "expiryDate": "2018-09-22",
+              "displayName": "cabri_test",
+              "billingPlan": "Monthly",
+              "effectiveDateTime": "2017-09-22T23:57:48.1891638Z",
+              "lastUpdatedDateTime": "2017-09-22T23:57:54.3768768Z",
+              "reservedResourceType": "VirtualMachines",
+              "instanceFlexibility": "On",
+              "skuDescription": "D1 v2",
+              "mergeProperties": {
+                "mergeSources": [
+                  "/providers/microsoft.capacity/reservationOrders/276e7ae4-84d0-4da6-ab4b-d6b94f3557da/reservations/00238563-7312-4c20-a134-8c030bf938a7",
+                  "/providers/microsoft.capacity/reservationOrders/276e7ae4-84d0-4da6-ab4b-d6b94f3557da/reservations/e0e4b4f5-77ea-4984-9ee4-6bf9850ee6de"
+                ]
+              }
+            }
+          },
+          {
+            "sku": {
+              "name": "Standard_DS1_v2"
+            },
+            "id": "/providers/microsoft.capacity/reservationOrders/276e7ae4-84d0-4da6-ab4b-d6b94f3557da/reservations/6ef59113-3482-40da-8d79-787f823e34bc/revisions/3",
+            "type": "Microsoft.Capacity/reservationOrders/reservations/revisions",
+            "name": "276e7ae4-84d0-4da6-ab4b-d6b94f3557da/6ef59113-3482-40da-8d79-787f823e34bc/3",
+            "etag": 3,
+            "location": "eastus",
+            "properties": {
+              "appliedScopes": [
+                "/subscriptions/98df3792-7962-4f18-8be2-d5576f122de3"
+              ],
+              "appliedScopeType": "Single",
+              "quantity": 3,
+              "provisioningState": "Succeeded",
+              "expiryDate": "2018-09-22",
+              "displayName": "cabri_test",
+              "billingPlan": "Monthly",
+              "effectiveDateTime": "2017-09-22T22:46:32.7632798Z",
+              "extendedStatusInfo": {
+                "statusCode": "Pending",
+                "message": "An operation is in progress on your reservation. Please wait for operation to complete before taking further action"
+              },
+              "lastUpdatedDateTime": "2017-09-22T23:57:47.488284Z",
+              "reservedResourceType": "VirtualMachines",
+              "instanceFlexibility": "On",
+              "skuDescription": "D1 v2",
+              "mergeProperties": {
+                "mergeSources": [
+                  "/providers/microsoft.capacity/reservationOrders/276e7ae4-84d0-4da6-ab4b-d6b94f3557da/reservations/00238563-7312-4c20-a134-8c030bf938a7",
+                  "/providers/microsoft.capacity/reservationOrders/276e7ae4-84d0-4da6-ab4b-d6b94f3557da/reservations/e0e4b4f5-77ea-4984-9ee4-6bf9850ee6de"
+                ]
+              }
+            }
+          },
+          {
+            "sku": {
+              "name": "Standard_DS1_v2"
+            },
+            "id": "/providers/microsoft.capacity/reservationOrders/276e7ae4-84d0-4da6-ab4b-d6b94f3557da/reservations/6ef59113-3482-40da-8d79-787f823e34bc/revisions/2",
+            "type": "Microsoft.Capacity/reservationOrders/reservations/revisions",
+            "name": "276e7ae4-84d0-4da6-ab4b-d6b94f3557da/6ef59113-3482-40da-8d79-787f823e34bc/2",
+            "etag": 2,
+            "location": "eastus",
+            "properties": {
+              "appliedScopes": [
+                "/subscriptions/98df3792-7962-4f18-8be2-d5576f122de3"
+              ],
+              "appliedScopeType": "Single",
+              "quantity": 3,
+              "provisioningState": "Succeeded",
+              "expiryDate": "2018-09-22",
+              "displayName": "cabri_test",
+              "billingPlan": "Monthly",
+              "effectiveDateTime": "2017-09-22T22:46:32.7632798Z",
+              "lastUpdatedDateTime": "2017-09-22T22:46:32.7632798Z",
+              "reservedResourceType": "VirtualMachines",
+              "instanceFlexibility": "On",
+              "skuDescription": "D1 v2",
+              "mergeProperties": {
+                "mergeSources": [
+                  "/providers/microsoft.capacity/reservationOrders/276e7ae4-84d0-4da6-ab4b-d6b94f3557da/reservations/00238563-7312-4c20-a134-8c030bf938a7",
+                  "/providers/microsoft.capacity/reservationOrders/276e7ae4-84d0-4da6-ab4b-d6b94f3557da/reservations/e0e4b4f5-77ea-4984-9ee4-6bf9850ee6de"
+                ]
+              }
+            }
+          },
+          {
+            "sku": {
+              "name": "Standard_DS1_v2"
+            },
+            "id": "/providers/microsoft.capacity/reservationOrders/276e7ae4-84d0-4da6-ab4b-d6b94f3557da/reservations/6ef59113-3482-40da-8d79-787f823e34bc/revisions/1",
+            "type": "Microsoft.Capacity/reservationOrders/reservations/revisions",
+            "name": "276e7ae4-84d0-4da6-ab4b-d6b94f3557da/6ef59113-3482-40da-8d79-787f823e34bc/1",
+            "etag": 1,
+            "location": "eastus",
+            "properties": {
+              "appliedScopes": [
+                "/subscriptions/98df3792-7962-4f18-8be2-d5576f122de3"
+              ],
+              "appliedScopeType": "Single",
+              "quantity": 3,
+              "provisioningState": "Creating",
+              "expiryDate": "2018-09-22",
+              "displayName": "cabri_test",
+              "effectiveDateTime": "2017-09-22T22:46:27.3313607Z",
+              "lastUpdatedDateTime": "2017-09-22T22:46:27.3313607Z",
+              "reservedResourceType": "VirtualMachines",
+              "instanceFlexibility": "On",
+              "skuDescription": "D1 v2",
+              "mergeProperties": {
+                "mergeSources": [
+                  "/providers/microsoft.capacity/reservationOrders/276e7ae4-84d0-4da6-ab4b-d6b94f3557da/reservations/00238563-7312-4c20-a134-8c030bf938a7",
+                  "/providers/microsoft.capacity/reservationOrders/276e7ae4-84d0-4da6-ab4b-d6b94f3557da/reservations/e0e4b4f5-77ea-4984-9ee4-6bf9850ee6de"
+                ]
+              }
+            }
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/reservations/resource-manager/Microsoft.Capacity/preview/2020-10-01-preview/examples/GetReservations.json b/specification/reservations/resource-manager/Microsoft.Capacity/preview/2020-10-01-preview/examples/GetReservations.json
new file mode 100644
index 000000000000..297f29b20a54
--- /dev/null
+++ b/specification/reservations/resource-manager/Microsoft.Capacity/preview/2020-10-01-preview/examples/GetReservations.json
@@ -0,0 +1,162 @@
+{
+  "parameters": {
+    "api-version": "2020-10-01-preview",
+    "reservationOrderId": "276e7ae4-84d0-4da6-ab4b-d6b94f3557da"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "sku": {
+              "name": "Standard_DS1_v2"
+            },
+            "id": "/providers/microsoft.capacity/reservationOrders/276e7ae4-84d0-4da6-ab4b-d6b94f3557da/reservations/bcae77cd-3119-4766-919f-b50d36c75c7a",
+            "type": "Microsoft.Capacity/reservationOrders/reservations",
+            "name": "276e7ae4-84d0-4da6-ab4b-d6b94f3557da/bcae77cd-3119-4766-919f-b50d36c75c7a",
+            "etag": 10,
+            "location": "eastus",
+            "properties": {
+              "appliedScopes": [
+                "/subscriptions/98df3792-7962-4f18-8be2-d5576f122de3"
+              ],
+              "renew": false,
+              "billingScopeId": "/subscriptions/19376483-64b8-49e4-a931-d5248828720a",
+              "appliedScopeType": "Single",
+              "quantity": 3,
+              "provisioningState": "Cancelled",
+              "expiryDate": "2018-09-22",
+              "displayName": "cabri_test",
+              "billingPlan": "Monthly",
+              "effectiveDateTime": "2017-09-22T01:00:30.9253826Z",
+              "extendedStatusInfo": {
+                "statusCode": "Split",
+                "message": "This reservation was split and is no longer active."
+              },
+              "lastUpdatedDateTime": "2017-09-22T01:00:36.3191627Z",
+              "reservedResourceType": "VirtualMachines",
+              "instanceFlexibility": "On",
+              "skuDescription": "D1 v2",
+              "splitProperties": {
+                "splitDestinations": [
+                  "/providers/microsoft.capacity/reservationOrders/276e7ae4-84d0-4da6-ab4b-d6b94f3557da/reservations/00238563-7312-4c20-a134-8c030bf938a7",
+                  "/providers/microsoft.capacity/reservationOrders/276e7ae4-84d0-4da6-ab4b-d6b94f3557da/reservations/e0e4b4f5-77ea-4984-9ee4-6bf9850ee6de"
+                ]
+              }
+            }
+          },
+          {
+            "sku": {
+              "name": "Standard_DS1_v2"
+            },
+            "id": "/providers/microsoft.capacity/reservationOrders/276e7ae4-84d0-4da6-ab4b-d6b94f3557da/reservations/00238563-7312-4c20-a134-8c030bf938a7",
+            "type": "Microsoft.Capacity/reservationOrders/reservations",
+            "name": "276e7ae4-84d0-4da6-ab4b-d6b94f3557da/00238563-7312-4c20-a134-8c030bf938a7",
+            "etag": 5,
+            "location": "eastus",
+            "properties": {
+              "appliedScopes": [
+                "/subscriptions/98df3792-7962-4f18-8be2-d5576f122de3"
+              ],
+              "renew": false,
+              "billingScopeId": "/subscriptions/19376483-64b8-49e4-a931-d5248828720a",
+              "appliedScopeType": "Single",
+              "quantity": 1,
+              "provisioningState": "Cancelled",
+              "expiryDate": "2018-09-22",
+              "displayName": "cabri_test",
+              "billingPlan": "Monthly",
+              "effectiveDateTime": "2017-09-22T22:46:32.7632798Z",
+              "extendedStatusInfo": {
+                "statusCode": "Merged",
+                "message": "This reservation was merged and is no longer active."
+              },
+              "lastUpdatedDateTime": "2017-09-22T22:46:32.7632798Z",
+              "reservedResourceType": "VirtualMachines",
+              "instanceFlexibility": "On",
+              "skuDescription": "D1 v2",
+              "splitProperties": {
+                "splitSource": "/providers/microsoft.capacity/reservationOrders/276e7ae4-84d0-4da6-ab4b-d6b94f3557da/reservations/bcae77cd-3119-4766-919f-b50d36c75c7a"
+              },
+              "mergeProperties": {
+                "mergeDestination": "/providers/microsoft.capacity/reservationOrders/276e7ae4-84d0-4da6-ab4b-d6b94f3557da/reservations/6ef59113-3482-40da-8d79-787f823e34bc"
+              }
+            }
+          },
+          {
+            "sku": {
+              "name": "Standard_DS1_v2"
+            },
+            "id": "/providers/microsoft.capacity/reservationOrders/276e7ae4-84d0-4da6-ab4b-d6b94f3557da/reservations/e0e4b4f5-77ea-4984-9ee4-6bf9850ee6de",
+            "type": "Microsoft.Capacity/reservationOrders/reservations",
+            "name": "276e7ae4-84d0-4da6-ab4b-d6b94f3557da/e0e4b4f5-77ea-4984-9ee4-6bf9850ee6de",
+            "etag": 4,
+            "location": "eastus",
+            "properties": {
+              "appliedScopes": [
+                "/subscriptions/98df3792-7962-4f18-8be2-d5576f122de3"
+              ],
+              "renew": false,
+              "billingScopeId": "/subscriptions/19376483-64b8-49e4-a931-d5248828720a",
+              "appliedScopeType": "Single",
+              "quantity": 2,
+              "provisioningState": "Cancelled",
+              "expiryDate": "2018-09-22",
+              "displayName": "cabri_test",
+              "billingPlan": "Monthly",
+              "effectiveDateTime": "2017-09-22T22:46:32.7632798Z",
+              "extendedStatusInfo": {
+                "statusCode": "Merged",
+                "message": "This reservation was merged and is no longer active."
+              },
+              "lastUpdatedDateTime": "2017-09-22T22:46:32.7632798Z",
+              "reservedResourceType": "VirtualMachines",
+              "instanceFlexibility": "On",
+              "skuDescription": "D1 v2",
+              "splitProperties": {
+                "splitSource": "/providers/microsoft.capacity/reservationOrders/276e7ae4-84d0-4da6-ab4b-d6b94f3557da/reservations/bcae77cd-3119-4766-919f-b50d36c75c7a"
+              },
+              "mergeProperties": {
+                "mergeDestination": "/providers/microsoft.capacity/reservationOrders/276e7ae4-84d0-4da6-ab4b-d6b94f3557da/reservations/6ef59113-3482-40da-8d79-787f823e34bc"
+              }
+            }
+          },
+          {
+            "sku": {
+              "name": "Standard_DS1_v2"
+            },
+            "id": "/providers/microsoft.capacity/reservationOrders/276e7ae4-84d0-4da6-ab4b-d6b94f3557da/reservations/6ef59113-3482-40da-8d79-787f823e34bc",
+            "type": "Microsoft.Capacity/reservationOrders/reservations",
+            "name": "276e7ae4-84d0-4da6-ab4b-d6b94f3557da/6ef59113-3482-40da-8d79-787f823e34bc",
+            "etag": 2,
+            "location": "eastus",
+            "properties": {
+              "appliedScopes": [
+                "/subscriptions/98df3792-7962-4f18-8be2-d5576f122de3"
+              ],
+              "renew": false,
+              "billingScopeId": "/subscriptions/19376483-64b8-49e4-a931-d5248828720a",
+              "appliedScopeType": "Single",
+              "quantity": 3,
+              "provisioningState": "Succeeded",
+              "expiryDate": "2018-09-22",
+              "displayName": "cabri_test",
+              "billingPlan": "Monthly",
+              "effectiveDateTime": "2017-09-22T22:46:32.7632798Z",
+              "lastUpdatedDateTime": "2017-09-22T22:46:32.7632798Z",
+              "reservedResourceType": "VirtualMachines",
+              "instanceFlexibility": "On",
+              "skuDescription": "D1 v2",
+              "mergeProperties": {
+                "mergeSources": [
+                  "/providers/microsoft.capacity/reservationOrders/276e7ae4-84d0-4da6-ab4b-d6b94f3557da/reservations/00238563-7312-4c20-a134-8c030bf938a7",
+                  "/providers/microsoft.capacity/reservationOrders/276e7ae4-84d0-4da6-ab4b-d6b94f3557da/reservations/e0e4b4f5-77ea-4984-9ee4-6bf9850ee6de"
+                ]
+              }
+            }
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/reservations/resource-manager/Microsoft.Capacity/preview/2020-10-01-preview/examples/MergeReservations.json b/specification/reservations/resource-manager/Microsoft.Capacity/preview/2020-10-01-preview/examples/MergeReservations.json
new file mode 100644
index 000000000000..2c05fd9c647b
--- /dev/null
+++ b/specification/reservations/resource-manager/Microsoft.Capacity/preview/2020-10-01-preview/examples/MergeReservations.json
@@ -0,0 +1,131 @@
+{
+  "parameters": {
+    "api-version": "2020-10-01-preview",
+    "reservationOrderId": "276e7ae4-84d0-4da6-ab4b-d6b94f3557da",
+    "body": {
+      "properties": {
+        "sources": [
+          "/providers/Microsoft.Capacity/reservationOrders/c0565a8a-4491-4e77-b07b-5e6d66718e1c/reservations/cea04232-932e-47db-acb5-e29a945ecc73",
+          "/providers/Microsoft.Capacity/reservationOrders/c0565a8a-4491-4e77-b07b-5e6d66718e1c/reservations/5bf54dc7-dacd-4f46-a16b-7b78f4a59799"
+        ]
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "body": [
+        {
+          "sku": {
+            "name": "Standard_DS1_v2"
+          },
+          "id": "/providers/microsoft.capacity/reservationOrders/276e7ae4-84d0-4da6-ab4b-d6b94f3557da/reservations/00238563-7312-4c20-a134-8c030bf938a7",
+          "type": "Microsoft.Capacity/reservationOrders/reservations",
+          "name": "276e7ae4-84d0-4da6-ab4b-d6b94f3557da/00238563-7312-4c20-a134-8c030bf938a7",
+          "etag": 5,
+          "location": "eastus",
+          "properties": {
+            "appliedScopes": [
+              "/subscriptions/98df3792-7962-4f18-8be2-d5576f122de3"
+            ],
+            "renew": false,
+            "billingScopeId": "/subscriptions/19376483-64b8-49e4-a931-d5248828720a",
+            "appliedScopeType": "Single",
+            "quantity": 1,
+            "provisioningState": "Cancelled",
+            "expiryDate": "2018-09-22",
+            "displayName": "cabri_test",
+            "billingPlan": "Monthly",
+            "effectiveDateTime": "2017-09-22T22:46:32.7632798Z",
+            "extendedStatusInfo": {
+              "statusCode": "Merged",
+              "message": "This reservation was merged and is no longer active."
+            },
+            "lastUpdatedDateTime": "2017-09-22T22:46:32.7632798Z",
+            "reservedResourceType": "VirtualMachines",
+            "instanceFlexibility": "Off",
+            "skuDescription": "D1 v2",
+            "splitProperties": {
+              "splitSource": "/providers/microsoft.capacity/reservationOrders/276e7ae4-84d0-4da6-ab4b-d6b94f3557da/reservations/bcae77cd-3119-4766-919f-b50d36c75c7a"
+            },
+            "mergeProperties": {
+              "mergeDestination": "/providers/microsoft.capacity/reservationOrders/276e7ae4-84d0-4da6-ab4b-d6b94f3557da/reservations/6ef59113-3482-40da-8d79-787f823e34bc"
+            }
+          }
+        },
+        {
+          "sku": {
+            "name": "Standard_DS1_v2"
+          },
+          "id": "/providers/microsoft.capacity/reservationOrders/276e7ae4-84d0-4da6-ab4b-d6b94f3557da/reservations/e0e4b4f5-77ea-4984-9ee4-6bf9850ee6de",
+          "type": "Microsoft.Capacity/reservationOrders/reservations",
+          "name": "276e7ae4-84d0-4da6-ab4b-d6b94f3557da/e0e4b4f5-77ea-4984-9ee4-6bf9850ee6de",
+          "etag": 4,
+          "location": "eastus",
+          "properties": {
+            "appliedScopes": [
+              "/subscriptions/98df3792-7962-4f18-8be2-d5576f122de3"
+            ],
+            "renew": false,
+            "billingScopeId": "/subscriptions/19376483-64b8-49e4-a931-d5248828720a",
+            "appliedScopeType": "Single",
+            "quantity": 2,
+            "provisioningState": "Cancelled",
+            "expiryDate": "2018-09-22",
+            "displayName": "cabri_test",
+            "billingPlan": "Monthly",
+            "effectiveDateTime": "2017-09-22T22:46:32.7632798Z",
+            "extendedStatusInfo": {
+              "statusCode": "Merged",
+              "message": "This reservation was merged and is no longer active."
+            },
+            "lastUpdatedDateTime": "2017-09-22T22:46:32.7632798Z",
+            "reservedResourceType": "VirtualMachines",
+            "instanceFlexibility": "Off",
+            "skuDescription": "D1 v2",
+            "splitProperties": {
+              "splitSource": "/providers/microsoft.capacity/reservationOrders/276e7ae4-84d0-4da6-ab4b-d6b94f3557da/reservations/bcae77cd-3119-4766-919f-b50d36c75c7a"
+            },
+            "mergeProperties": {
+              "mergeDestination": "/providers/microsoft.capacity/reservationOrders/276e7ae4-84d0-4da6-ab4b-d6b94f3557da/reservations/6ef59113-3482-40da-8d79-787f823e34bc"
+            }
+          }
+        },
+        {
+          "sku": {
+            "name": "Standard_DS1_v2"
+          },
+          "id": "/providers/microsoft.capacity/reservationOrders/276e7ae4-84d0-4da6-ab4b-d6b94f3557da/reservations/6ef59113-3482-40da-8d79-787f823e34bc",
+          "type": "Microsoft.Capacity/reservationOrders/reservations",
+          "name": "276e7ae4-84d0-4da6-ab4b-d6b94f3557da/6ef59113-3482-40da-8d79-787f823e34bc",
+          "etag": 2,
+          "location": "eastus",
+          "properties": {
+            "appliedScopes": [
+              "/subscriptions/98df3792-7962-4f18-8be2-d5576f122de3"
+            ],
+            "renew": false,
+            "billingScopeId": "/subscriptions/19376483-64b8-49e4-a931-d5248828720a",
+            "appliedScopeType": "Single",
+            "quantity": 3,
+            "provisioningState": "Succeeded",
+            "expiryDate": "2018-09-22",
+            "displayName": "cabri_test",
+            "billingPlan": "Monthly",
+            "effectiveDateTime": "2017-09-22T22:46:32.7632798Z",
+            "lastUpdatedDateTime": "2017-09-22T22:46:32.7632798Z",
+            "reservedResourceType": "VirtualMachines",
+            "instanceFlexibility": "Off",
+            "skuDescription": "D1 v2",
+            "mergeProperties": {
+              "mergeSources": [
+                "/providers/microsoft.capacity/reservationOrders/276e7ae4-84d0-4da6-ab4b-d6b94f3557da/reservations/00238563-7312-4c20-a134-8c030bf938a7",
+                "/providers/microsoft.capacity/reservationOrders/276e7ae4-84d0-4da6-ab4b-d6b94f3557da/reservations/e0e4b4f5-77ea-4984-9ee4-6bf9850ee6de"
+              ]
+            }
+          }
+        }
+      ]
+    },
+    "202": {}
+  }
+}
diff --git a/specification/reservations/resource-manager/Microsoft.Capacity/preview/2020-10-01-preview/examples/PurchaseReservationOrder.json b/specification/reservations/resource-manager/Microsoft.Capacity/preview/2020-10-01-preview/examples/PurchaseReservationOrder.json
new file mode 100644
index 000000000000..5546d981dc2d
--- /dev/null
+++ b/specification/reservations/resource-manager/Microsoft.Capacity/preview/2020-10-01-preview/examples/PurchaseReservationOrder.json
@@ -0,0 +1,74 @@
+{
+  "parameters": {
+    "api-version": "2020-10-01-preview",
+    "reservationOrderId": "a075419f-44cc-497f-b68a-14ee811d48b9",
+    "body": {
+      "sku": {
+        "name": "standard_D1"
+      },
+      "location": "westus",
+      "properties": {
+        "reservedResourceType": "VirtualMachines",
+        "billingScopeId": "/subscriptions/ed3a1871-612d-abcd-a849-c2542a68be83",
+        "term": "P1Y",
+        "billingPlan": "Monthly",
+        "quantity": 1,
+        "displayName": "TestReservationOrder",
+        "appliedScopes": null,
+        "appliedScopeType": "Shared",
+        "reservedResourceProperties": {
+          "instanceFlexibility": "On"
+        },
+        "renew": false
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/providers/microsoft.capacity/reservationOrders/1f14354c-dc12-4c8d-8090-6f295a3a34aa",
+        "type": "Microsoft.Capacity/reservationOrders",
+        "name": "1f14354c-dc12-4c8d-8090-6f295a3a34aa",
+        "etag": 7,
+        "properties": {
+          "displayName": "cabri",
+          "requestDateTime": "2017-08-30T03:49:19.0252126Z",
+          "createdDateTime": "2017-08-30T03:51:49.8083758Z",
+          "expiryDate": "2018-08-30",
+          "term": "P1Y",
+          "billingPlan": "Monthly",
+          "provisioningState": "Succeeded",
+          "reservations": [
+            {
+              "id": "/providers/microsoft.capacity/reservationOrders/1f14354c-dc12-4c8d-8090-6f295a3a34aa/reservations/c8c926bd-fc5d-4e29-9d43-b68340ac23a6"
+            }
+          ],
+          "originalQuantity": 7
+        }
+      }
+    },
+    "202": {
+      "body": {
+        "id": "/providers/microsoft.capacity/reservationOrders/1f14354c-dc12-4c8d-8090-6f295a3a34aa",
+        "type": "Microsoft.Capacity/reservationOrders",
+        "name": "1f14354c-dc12-4c8d-8090-6f295a3a34aa",
+        "etag": 7,
+        "properties": {
+          "displayName": "cabri",
+          "billingPlan": "Monthly",
+          "requestDateTime": "2017-08-30T03:49:19.0252126Z",
+          "createdDateTime": "2017-08-30T03:51:49.8083758Z",
+          "expiryDate": "2018-08-30",
+          "term": "P1Y",
+          "provisioningState": "Succeeded",
+          "reservations": [
+            {
+              "id": "/providers/microsoft.capacity/reservationOrders/1f14354c-dc12-4c8d-8090-6f295a3a34aa/reservations/c8c926bd-fc5d-4e29-9d43-b68340ac23a6"
+            }
+          ],
+          "originalQuantity": 7
+        }
+      }
+    }
+  }
+}
diff --git a/specification/reservations/resource-manager/Microsoft.Capacity/preview/2020-10-01-preview/examples/SplitReservation.json b/specification/reservations/resource-manager/Microsoft.Capacity/preview/2020-10-01-preview/examples/SplitReservation.json
new file mode 100644
index 000000000000..36872b55a134
--- /dev/null
+++ b/specification/reservations/resource-manager/Microsoft.Capacity/preview/2020-10-01-preview/examples/SplitReservation.json
@@ -0,0 +1,122 @@
+{
+  "parameters": {
+    "api-version": "2020-10-01-preview",
+    "reservationOrderId": "276e7ae4-84d0-4da6-ab4b-d6b94f3557da",
+    "body": {
+      "properties": {
+        "quantities": [
+          1,
+          2
+        ],
+        "reservationId": "/providers/Microsoft.Capacity/reservationOrders/276e7ae4-84d0-4da6-ab4b-d6b94f3557da/reservations/bcae77cd-3119-4766-919f-b50d36c75c7a"
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "body": [
+        {
+          "sku": {
+            "name": "Standard_DS1_v2"
+          },
+          "id": "/providers/microsoft.capacity/reservationOrders/276e7ae4-84d0-4da6-ab4b-d6b94f3557da/reservations/00238563-7312-4c20-a134-8c030bf938a7",
+          "type": "Microsoft.Capacity/reservationOrders/reservations",
+          "name": "276e7ae4-84d0-4da6-ab4b-d6b94f3557da/00238563-7312-4c20-a134-8c030bf938a7",
+          "etag": 2,
+          "location": "eastus",
+          "properties": {
+            "appliedScopes": [
+              "/subscriptions/98df3792-7962-4f18-8be2-d5576f122de3"
+            ],
+            "renew": false,
+            "billingScopeId": "/subscriptions/19376483-64b8-49e4-a931-d5248828720a",
+            "appliedScopeType": "Single",
+            "quantity": 1,
+            "provisioningState": "Succeeded",
+            "expiryDate": "2018-09-22",
+            "displayName": "cabri_test",
+            "billingPlan": "Monthly",
+            "effectiveDateTime": "2017-09-22T01:00:30.9253826Z",
+            "lastUpdatedDateTime": "2017-09-22T01:00:36.3191627Z",
+            "reservedResourceType": "VirtualMachines",
+            "instanceFlexibility": "Off",
+            "skuDescription": "D1 v2",
+            "splitProperties": {
+              "splitSource": "/providers/microsoft.capacity/reservationOrders/276e7ae4-84d0-4da6-ab4b-d6b94f3557da/reservations/bcae77cd-3119-4766-919f-b50d36c75c7a"
+            }
+          }
+        },
+        {
+          "sku": {
+            "name": "Standard_DS1_v2"
+          },
+          "id": "/providers/microsoft.capacity/reservationOrders/276e7ae4-84d0-4da6-ab4b-d6b94f3557da/reservations/e0e4b4f5-77ea-4984-9ee4-6bf9850ee6de",
+          "type": "Microsoft.Capacity/reservationOrders/reservations",
+          "name": "276e7ae4-84d0-4da6-ab4b-d6b94f3557da/e0e4b4f5-77ea-4984-9ee4-6bf9850ee6de",
+          "etag": 2,
+          "location": "eastus",
+          "properties": {
+            "appliedScopes": [
+              "/subscriptions/98df3792-7962-4f18-8be2-d5576f122de3"
+            ],
+            "renew": false,
+            "billingScopeId": "/subscriptions/19376483-64b8-49e4-a931-d5248828720a",
+            "appliedScopeType": "Single",
+            "quantity": 2,
+            "provisioningState": "Succeeded",
+            "expiryDate": "2018-09-22",
+            "displayName": "cabri_test",
+            "billingPlan": "Monthly",
+            "effectiveDateTime": "2017-09-22T01:00:30.9253826Z",
+            "lastUpdatedDateTime": "2017-09-22T01:00:36.3191627Z",
+            "reservedResourceType": "VirtualMachines",
+            "instanceFlexibility": "Off",
+            "skuDescription": "D1 v2",
+            "splitProperties": {
+              "splitSource": "/providers/microsoft.capacity/reservationOrders/276e7ae4-84d0-4da6-ab4b-d6b94f3557da/reservations/bcae77cd-3119-4766-919f-b50d36c75c7a"
+            }
+          }
+        },
+        {
+          "sku": {
+            "name": "Standard_DS1_v2"
+          },
+          "id": "/providers/microsoft.capacity/reservationOrders/276e7ae4-84d0-4da6-ab4b-d6b94f3557da/reservations/bcae77cd-3119-4766-919f-b50d36c75c7a",
+          "type": "Microsoft.Capacity/reservationOrders/reservations",
+          "name": "276e7ae4-84d0-4da6-ab4b-d6b94f3557da/bcae77cd-3119-4766-919f-b50d36c75c7a",
+          "etag": 10,
+          "location": "eastus",
+          "properties": {
+            "appliedScopes": [
+              "/subscriptions/98df3792-7962-4f18-8be2-d5576f122de3"
+            ],
+            "renew": false,
+            "billingScopeId": "/subscriptions/19376483-64b8-49e4-a931-d5248828720a",
+            "appliedScopeType": "Single",
+            "quantity": 3,
+            "provisioningState": "Cancelled",
+            "expiryDate": "2018-09-22",
+            "displayName": "cabri_test",
+            "billingPlan": "Monthly",
+            "effectiveDateTime": "2017-09-22T01:00:30.9253826Z",
+            "extendedStatusInfo": {
+              "statusCode": "Split",
+              "message": "This reservation was split and is no longer active."
+            },
+            "lastUpdatedDateTime": "2017-09-22T01:00:36.3191627Z",
+            "reservedResourceType": "VirtualMachines",
+            "instanceFlexibility": "Off",
+            "skuDescription": "D1 v2",
+            "splitProperties": {
+              "splitDestinations": [
+                "/providers/microsoft.capacity/reservationOrders/276e7ae4-84d0-4da6-ab4b-d6b94f3557da/reservations/00238563-7312-4c20-a134-8c030bf938a7",
+                "/providers/microsoft.capacity/reservationOrders/276e7ae4-84d0-4da6-ab4b-d6b94f3557da/reservations/e0e4b4f5-77ea-4984-9ee4-6bf9850ee6de"
+              ]
+            }
+          }
+        }
+      ]
+    },
+    "202": {}
+  }
+}
diff --git a/specification/reservations/resource-manager/Microsoft.Capacity/preview/2020-10-01-preview/examples/UpdateReservation.json b/specification/reservations/resource-manager/Microsoft.Capacity/preview/2020-10-01-preview/examples/UpdateReservation.json
new file mode 100644
index 000000000000..28fe38baaef2
--- /dev/null
+++ b/specification/reservations/resource-manager/Microsoft.Capacity/preview/2020-10-01-preview/examples/UpdateReservation.json
@@ -0,0 +1,49 @@
+{
+  "parameters": {
+    "api-version": "2020-10-01-preview",
+    "reservationOrderId": "276e7ae4-84d0-4da6-ab4b-d6b94f3557da",
+    "reservationId": "6ef59113-3482-40da-8d79-787f823e34bc",
+    "parameters": {
+      "properties": {
+        "appliedScopeType": "Shared",
+        "instanceFlexibility": "Off"
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "sku": {
+          "name": "Standard_DS1_v2"
+        },
+        "id": "/providers/microsoft.capacity/reservationOrders/276e7ae4-84d0-4da6-ab4b-d6b94f3557da/reservations/6ef59113-3482-40da-8d79-787f823e34bc",
+        "type": "Microsoft.Capacity/reservationOrders/reservations",
+        "name": "276e7ae4-84d0-4da6-ab4b-d6b94f3557da/6ef59113-3482-40da-8d79-787f823e34bc",
+        "etag": 4,
+        "location": "eastus",
+        "properties": {
+          "appliedScopeType": "Shared",
+          "renew": false,
+          "billingScopeId": "/subscriptions/19376483-64b8-49e4-a931-d5248828720a",
+          "quantity": 3,
+          "provisioningState": "Succeeded",
+          "expiryDate": "2018-09-22",
+          "displayName": "cabri_test",
+          "billingPlan": "Monthly",
+          "effectiveDateTime": "2017-09-22T23:57:48.1891638Z",
+          "lastUpdatedDateTime": "2017-09-22T23:57:54.3768768Z",
+          "reservedResourceType": "VirtualMachines",
+          "instanceFlexibility": "Off",
+          "skuDescription": "D1 v2",
+          "mergeProperties": {
+            "mergeSources": [
+              "/providers/microsoft.capacity/reservationOrders/276e7ae4-84d0-4da6-ab4b-d6b94f3557da/reservations/00238563-7312-4c20-a134-8c030bf938a7",
+              "/providers/microsoft.capacity/reservationOrders/276e7ae4-84d0-4da6-ab4b-d6b94f3557da/reservations/e0e4b4f5-77ea-4984-9ee4-6bf9850ee6de"
+            ]
+          }
+        }
+      }
+    },
+    "202": {}
+  }
+}
diff --git a/specification/reservations/resource-manager/Microsoft.Capacity/preview/2020-10-01-preview/reservations.json b/specification/reservations/resource-manager/Microsoft.Capacity/preview/2020-10-01-preview/reservations.json
new file mode 100644
index 000000000000..65ffe539d6a2
--- /dev/null
+++ b/specification/reservations/resource-manager/Microsoft.Capacity/preview/2020-10-01-preview/reservations.json
@@ -0,0 +1,2242 @@
+{
+  "swagger": "2.0",
+  "info": {
+    "title": "Azure Reservation API",
+    "description": "This API describe Azure Reservation",
+    "version": "2020-10-01-preview"
+  },
+  "host": "management.azure.com",
+  "schemes": [
+    "https"
+  ],
+  "produces": [
+    "application/json"
+  ],
+  "consumes": [
+    "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": {
+    "/providers/Microsoft.Capacity/reservationOrders/{reservationOrderId}/reservations/{reservationId}/availableScopes": {
+      "post": {
+        "summary": "Get Available Scopes for `Reservation`.",
+        "description": "Get Available Scopes for `Reservation`.\n",
+        "operationId": "Reservation_AvailableScopes",
+        "x-ms-examples": {
+          "AvailableScopes": {
+            "$ref": "./examples/GetAvailableScope.json"
+          }
+        },
+        "x-ms-long-running-operation": true,
+        "parameters": [
+          {
+            "$ref": "#/parameters/ReservationOrderIdParameter"
+          },
+          {
+            "$ref": "#/parameters/ReservationIdParameter"
+          },
+          {
+            "$ref": "#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "#/parameters/ScopeParameter"
+          }
+        ],
+        "tags": [
+          "Reservation, AvailableScopes"
+        ],
+        "responses": {
+          "200": {
+            "description": "List of `Subscription`s created after the filter.",
+            "schema": {
+              "$ref": "#/definitions/AvailableScopeProperties"
+            }
+          },
+          "default": {
+            "description": "Unexpected error",
+            "schema": {
+              "$ref": "#/definitions/Error"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/providers/Microsoft.Capacity/catalogs": {
+      "get": {
+        "summary": "Get the regions and skus that are available for RI purchase for the specified Azure subscription.",
+        "operationId": "GetCatalog",
+        "x-ms-examples": {
+          "Catalog": {
+            "$ref": "./examples/GetCatalog.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "#/parameters/SubscriptionIdParameter"
+          },
+          {
+            "$ref": "#/parameters/ReservedResourceTypeIdParameter"
+          },
+          {
+            "$ref": "#/parameters/LocationIdParameter"
+          }
+        ],
+        "tags": [
+          "Catalog"
+        ],
+        "responses": {
+          "200": {
+            "description": "List of available resources",
+            "schema": {
+              "type": "array",
+              "items": {
+                "$ref": "#/definitions/Catalog"
+              }
+            }
+          },
+          "default": {
+            "description": "Unexpected error",
+            "schema": {
+              "$ref": "#/definitions/Error"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/providers/Microsoft.Capacity/appliedReservations": {
+      "get": {
+        "summary": "Get list of applicable `Reservation`s.",
+        "description": "Get applicable `Reservation`s that are applied to this subscription or a resource group under this subscription.",
+        "operationId": "GetAppliedReservationList",
+        "x-ms-examples": {
+          "AppliedReservationList": {
+            "$ref": "./examples/GetAppliedReservations.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "tags": [
+          "AppliedReservation"
+        ],
+        "responses": {
+          "200": {
+            "description": "Applicable `Reservation`s.",
+            "schema": {
+              "$ref": "#/definitions/AppliedReservations"
+            }
+          },
+          "default": {
+            "description": "Unexpected error",
+            "schema": {
+              "$ref": "#/definitions/Error"
+            }
+          }
+        }
+      }
+    },
+    "/providers/Microsoft.Capacity/calculatePrice": {
+      "post": {
+        "summary": "Calculate price for a `ReservationOrder`.",
+        "description": "Calculate price for placing a `ReservationOrder`.",
+        "operationId": "ReservationOrder_Calculate",
+        "x-ms-examples": {
+          "Purchase": {
+            "$ref": "./examples/CalculateReservationOrder.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "#/parameters/PurchaseParameter"
+          }
+        ],
+        "tags": [
+          "Reservation, Calculate"
+        ],
+        "responses": {
+          "200": {
+            "description": "Detailed price info for purchasing `ReservationOrder`",
+            "schema": {
+              "$ref": "#/definitions/CalculatePriceResponse"
+            }
+          },
+          "default": {
+            "description": "Unexpected error",
+            "schema": {
+              "$ref": "#/definitions/Error"
+            }
+          }
+        }
+      }
+    },
+    "/providers/Microsoft.Capacity/reservationOrders": {
+      "get": {
+        "summary": "Get all `ReservationOrder`s.",
+        "description": "List of all the `ReservationOrder`s that the user has access to in the current tenant.",
+        "operationId": "ReservationOrder_List",
+        "x-ms-examples": {
+          "ReservationOrderList": {
+            "$ref": "./examples/GetReservationOrders.json"
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersionParameter"
+          }
+        ],
+        "tags": [
+          "Reservation"
+        ],
+        "responses": {
+          "200": {
+            "description": "List of `ReservationOrder`s",
+            "schema": {
+              "$ref": "#/definitions/ReservationOrderList"
+            }
+          },
+          "default": {
+            "description": "Unexpected error",
+            "schema": {
+              "$ref": "#/definitions/Error"
+            }
+          }
+        }
+      }
+    },
+    "/providers/Microsoft.Capacity/reservationOrders/{reservationOrderId}": {
+      "put": {
+        "summary": "Purchase `ReservationOrder`",
+        "description": "Purchase `ReservationOrder` and create resource under the specified URI.",
+        "operationId": "ReservationOrder_Purchase",
+        "x-ms-examples": {
+          "Purchase": {
+            "$ref": "./examples/PurchaseReservationOrder.json"
+          }
+        },
+        "x-ms-long-running-operation": true,
+        "x-ms-long-running-operation-options": {
+          "final-state-via": "location"
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/ReservationOrderIdParameter"
+          },
+          {
+            "$ref": "#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "#/parameters/PurchaseParameter"
+          }
+        ],
+        "tags": [
+          "Reservation, Purchase"
+        ],
+        "responses": {
+          "200": {
+            "description": "The resource has been created",
+            "schema": {
+              "$ref": "#/definitions/ReservationOrderResponse"
+            }
+          },
+          "202": {
+            "description": "The request is accepted and is being processed. Operation result link is in location header.",
+            "schema": {
+              "$ref": "#/definitions/ReservationOrderResponse"
+            }
+          },
+          "default": {
+            "description": "Unexpected error",
+            "schema": {
+              "$ref": "#/definitions/Error"
+            }
+          }
+        }
+      },
+      "get": {
+        "summary": "Get a specific `ReservationOrder`.",
+        "description": "Get the details of the `ReservationOrder`.",
+        "operationId": "ReservationOrder_Get",
+        "x-ms-examples": {
+          "GetReservation": {
+            "$ref": "./examples/GetReservationOrderDetails.json"
+          },
+          "GetReservationWithExpandPayments": {
+            "$ref": "./examples/GetReservationOrderDetailsWithExpandPlanInformation.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/ReservationOrderIdParameter"
+          },
+          {
+            "$ref": "#/parameters/ApiVersionParameter"
+          },
+          {
+            "name": "$expand",
+            "description": "May be used to expand the planInformation.",
+            "in": "query",
+            "required": false,
+            "type": "string"
+          }
+        ],
+        "tags": [
+          "Reservation"
+        ],
+        "responses": {
+          "200": {
+            "description": "Get the details of the `ReservationOrder`.",
+            "schema": {
+              "$ref": "#/definitions/ReservationOrderResponse"
+            }
+          },
+          "default": {
+            "description": "Unexpected error",
+            "schema": {
+              "$ref": "#/definitions/Error"
+            }
+          }
+        }
+      }
+    },
+    "/providers/Microsoft.Capacity/reservationOrders/{reservationOrderId}/split": {
+      "post": {
+        "summary": "Split the `Reservation`.",
+        "description": "Split a `Reservation` into two `Reservation`s with specified quantity distribution.",
+        "operationId": "Reservation_Split",
+        "x-ms-examples": {
+          "Split": {
+            "$ref": "./examples/SplitReservation.json"
+          }
+        },
+        "x-ms-long-running-operation": true,
+        "x-ms-long-running-operation-options": {
+          "final-state-via": "location"
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/ReservationOrderIdParameter"
+          },
+          {
+            "$ref": "#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "#/parameters/SplitParameter"
+          }
+        ],
+        "tags": [
+          "Reservation, Split"
+        ],
+        "responses": {
+          "200": {
+            "description": "List of `Reservation`s created after the split operation.",
+            "schema": {
+              "type": "array",
+              "items": {
+                "$ref": "#/definitions/ReservationResponse"
+              }
+            }
+          },
+          "202": {
+            "description": "The request is accepted and is being processed"
+          },
+          "default": {
+            "description": "Unexpected error",
+            "schema": {
+              "$ref": "#/definitions/Error"
+            }
+          }
+        }
+      }
+    },
+    "/providers/Microsoft.Capacity/reservationOrders/{reservationOrderId}/merge": {
+      "post": {
+        "summary": "Merges two `Reservation`s.",
+        "description": "Merge the specified `Reservation`s into a new `Reservation`. The two `Reservation`s being merged must have same properties.",
+        "operationId": "Reservation_Merge",
+        "x-ms-examples": {
+          "Merge": {
+            "$ref": "./examples/MergeReservations.json"
+          }
+        },
+        "x-ms-long-running-operation": true,
+        "x-ms-long-running-operation-options": {
+          "final-state-via": "location"
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/ReservationOrderIdParameter"
+          },
+          {
+            "$ref": "#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "#/parameters/MergeParameter"
+          }
+        ],
+        "tags": [
+          "Reservation, Merge"
+        ],
+        "responses": {
+          "200": {
+            "description": "Returns the `Reservation` created after the merge.",
+            "schema": {
+              "type": "array",
+              "items": {
+                "$ref": "#/definitions/ReservationResponse"
+              }
+            }
+          },
+          "202": {
+            "description": "The request is accepted and is being processed"
+          },
+          "default": {
+            "description": "Unexpected error",
+            "schema": {
+              "$ref": "#/definitions/Error"
+            }
+          }
+        }
+      }
+    },
+    "/providers/Microsoft.Capacity/reservationOrders/{reservationOrderId}/reservations": {
+      "get": {
+        "summary": "Get `Reservation`s in a given reservation Order",
+        "description": "List `Reservation`s within a single `ReservationOrder`.",
+        "operationId": "Reservation_List",
+        "x-ms-examples": {
+          "ReservationList": {
+            "$ref": "./examples/GetReservations.json"
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/ReservationOrderIdParameter"
+          },
+          {
+            "$ref": "#/parameters/ApiVersionParameter"
+          }
+        ],
+        "tags": [
+          "Reservation"
+        ],
+        "responses": {
+          "200": {
+            "description": "List `Reservation`s within a single `ReservationOrder`.",
+            "schema": {
+              "$ref": "#/definitions/ReservationList"
+            }
+          },
+          "default": {
+            "description": "Unexpected error",
+            "schema": {
+              "$ref": "#/definitions/Error"
+            }
+          }
+        }
+      }
+    },
+    "/providers/Microsoft.Capacity/reservationOrders/{reservationOrderId}/reservations/{reservationId}": {
+      "get": {
+        "summary": "Get `Reservation` details.",
+        "description": "Get specific `Reservation` details.",
+        "operationId": "Reservation_Get",
+        "x-ms-examples": {
+          "GetReservation": {
+            "$ref": "./examples/GetReservationDetails.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/ReservationIdParameter"
+          },
+          {
+            "$ref": "#/parameters/ReservationOrderIdParameter"
+          },
+          {
+            "$ref": "#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "#/parameters/ExpandRenewPropertiesParameter"
+          }
+        ],
+        "tags": [
+          "Reservation"
+        ],
+        "responses": {
+          "200": {
+            "description": "Get `Reservation` details.",
+            "schema": {
+              "$ref": "#/definitions/ReservationResponse"
+            }
+          },
+          "default": {
+            "description": "Unexpected error",
+            "schema": {
+              "$ref": "#/definitions/Error"
+            }
+          }
+        }
+      },
+      "patch": {
+        "summary": "Updates a `Reservation`.",
+        "description": "Updates the applied scopes of the `Reservation`.",
+        "operationId": "Reservation_Update",
+        "x-ms-examples": {
+          "PatchReservation": {
+            "$ref": "./examples/UpdateReservation.json"
+          }
+        },
+        "x-ms-long-running-operation": true,
+        "parameters": [
+          {
+            "$ref": "#/parameters/ReservationOrderIdParameter"
+          },
+          {
+            "$ref": "#/parameters/ReservationIdParameter"
+          },
+          {
+            "$ref": "#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "#/parameters/PatchParameter"
+          }
+        ],
+        "tags": [
+          "Reservation",
+          "ApplyScope"
+        ],
+        "responses": {
+          "200": {
+            "description": "Returns the updated `Reservation`.",
+            "schema": {
+              "$ref": "#/definitions/ReservationResponse"
+            }
+          },
+          "202": {
+            "description": "The request is accepted and is being processed"
+          },
+          "default": {
+            "description": "Unexpected error",
+            "schema": {
+              "$ref": "#/definitions/Error"
+            }
+          }
+        }
+      }
+    },
+    "/providers/Microsoft.Capacity/reservationOrders/{reservationOrderId}/reservations/{reservationId}/revisions": {
+      "get": {
+        "summary": "Get `Reservation` revisions.",
+        "description": "List of all the revisions for the `Reservation`.",
+        "operationId": "Reservation_ListRevisions",
+        "x-ms-examples": {
+          "ReservationRevisions": {
+            "$ref": "./examples/GetReservationRevisions.json"
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/ReservationIdParameter"
+          },
+          {
+            "$ref": "#/parameters/ReservationOrderIdParameter"
+          },
+          {
+            "$ref": "#/parameters/ApiVersionParameter"
+          }
+        ],
+        "tags": [
+          "Reservation"
+        ],
+        "responses": {
+          "200": {
+            "description": "List of all the revisions for the `Reservation`.",
+            "schema": {
+              "$ref": "#/definitions/ReservationList"
+            }
+          },
+          "default": {
+            "description": "Unexpected error",
+            "schema": {
+              "$ref": "#/definitions/Error"
+            }
+          }
+        }
+      }
+    },
+    "/providers/Microsoft.Capacity/operations": {
+      "get": {
+        "summary": "Get operations.",
+        "description": "List all the operations.",
+        "operationId": "Operation_List",
+        "x-ms-examples": {
+          "GetOperations": {
+            "$ref": "./examples/GetOperations.json"
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersionParameter"
+          }
+        ],
+        "tags": [
+          "Operation"
+        ],
+        "responses": {
+          "200": {
+            "description": "List all the operations.",
+            "schema": {
+              "$ref": "#/definitions/OperationList"
+            }
+          },
+          "default": {
+            "description": "Unexpected error",
+            "schema": {
+              "$ref": "#/definitions/Error"
+            }
+          }
+        }
+      }
+    },
+    "/providers/Microsoft.Capacity/calculateExchange": {
+      "post": {
+        "summary": "Calculates the refund amounts and price of the new purchases.",
+        "description": "Calculates price for exchanging `Reservations` if there are no policy errors.\n",
+        "operationId": "CalculateExchange_Post",
+        "x-ms-examples": {
+          "CalculateExchange": {
+            "$ref": "./examples/CalculateExchange.json"
+          }
+        },
+        "x-ms-long-running-operation": true,
+        "x-ms-long-running-operation-options": {
+          "final-state-via": "location"
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "#/parameters/CalculateExchangeRequestParameter"
+          }
+        ],
+        "tags": [
+          "Exchange"
+        ],
+        "responses": {
+          "200": {
+            "description": "The request is completed.",
+            "schema": {
+              "$ref": "#/definitions/CalculateExchangeOperationResultResponse"
+            }
+          },
+          "202": {
+            "description": "The request is accepted and is being processed.",
+            "headers": {
+              "Location": {
+                "type": "string",
+                "description": "URL to query for the status of the operation."
+              },
+              "Retry-After": {
+                "type": "integer",
+                "format": "int32",
+                "description": "Clients should wait for the Retry-After interval before polling again"
+              }
+            }
+          },
+          "default": {
+            "description": "Unexpected error",
+            "schema": {
+              "$ref": "#/definitions/Error"
+            }
+          }
+        }
+      }
+    },
+    "/providers/Microsoft.Capacity/exchange": {
+      "post": {
+        "summary": "Exchange Reservation(s)",
+        "description": "Returns one or more `Reservations` in exchange for one or more `Reservation` purchases.\n",
+        "operationId": "Exchange_Post",
+        "x-ms-examples": {
+          "Exchange": {
+            "$ref": "./examples/Exchange.json"
+          }
+        },
+        "x-ms-long-running-operation": true,
+        "x-ms-long-running-operation-options": {
+          "final-state-via": "location"
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "#/parameters/ExchangeRequestParameter"
+          }
+        ],
+        "tags": [
+          "Exchange"
+        ],
+        "responses": {
+          "200": {
+            "description": "The request is completed.",
+            "schema": {
+              "$ref": "#/definitions/ExchangeOperationResultResponse"
+            }
+          },
+          "202": {
+            "description": "The request is accepted and is being processed.",
+            "headers": {
+              "Location": {
+                "type": "string",
+                "description": "URL to query for the status of the operation."
+              },
+              "Retry-After": {
+                "type": "integer",
+                "format": "int32",
+                "description": "Clients should wait for the Retry-After interval before polling again"
+              }
+            }
+          },
+          "default": {
+            "description": "Unexpected error",
+            "schema": {
+              "$ref": "#/definitions/Error"
+            }
+          }
+        }
+      }
+    }
+  },
+  "definitions": {
+    "AvailableScopeRequest": {
+      "type": "object",
+      "description": "Available scope",
+      "properties": {
+        "properties": {
+          "$ref": "#/definitions/AvailableScopeRequestProperties"
+        }
+      }
+    },
+    "AvailableScopeRequestProperties": {
+      "type": "object",
+      "description": "Available scope request properties",
+      "properties": {
+        "scopes": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        }
+      }
+    },
+    "CalculateExchangeRequest": {
+      "type": "object",
+      "description": "Calculate exchange request",
+      "properties": {
+        "properties": {
+          "$ref": "#/definitions/CalculateExchangeRequestProperties"
+        }
+      }
+    },
+    "ExchangeRequest": {
+      "type": "object",
+      "description": "Exchange request",
+      "properties": {
+        "properties": {
+          "$ref": "#/definitions/ExchangeRequestProperties"
+        }
+      }
+    },
+    "CalculateExchangeRequestProperties": {
+      "type": "object",
+      "description": "Calculate exchange request properties",
+      "properties": {
+        "reservationsToPurchase": {
+          "type": "array",
+          "description": "List of reservations that are being purchased in this exchange.",
+          "items": {
+            "$ref": "#/definitions/PurchaseRequest"
+          }
+        },
+        "reservationsToExchange": {
+          "type": "array",
+          "description": "List of reservations that are being returned in this exchange.",
+          "items": {
+            "$ref": "#/definitions/ReturnRequest"
+          }
+        }
+      }
+    },
+    "ExchangeRequestProperties": {
+      "type": "object",
+      "description": "Exchange request properties",
+      "properties": {
+        "sessionId": {
+          "type": "string",
+          "description": "SessionId that was returned by CalculateExchange API."
+        }
+      }
+    },
+    "ReturnRequest": {
+      "type": "object",
+      "description": "Return request",
+      "properties": {
+        "id": {
+          "type": "string",
+          "description": "Fully qualified identifier of the ReservationOrder being returned"
+        },
+        "properties": {
+          "$ref": "#/definitions/ReturnRequestProperties"
+        }
+      }
+    },
+    "ReturnRequestProperties": {
+      "type": "object",
+      "description": "Return request properties",
+      "properties": {
+        "scope": {
+          "$ref": "#/definitions/ReturnRequestScope"
+        },
+        "reservationToReturn": {
+          "$ref": "#/definitions/ReservationToReturn"
+        }
+      }
+    },
+    "ReturnRequestScope": {
+      "type": "string",
+      "description": "Indicates whether it is a reservation return or entire order return",
+      "enum": [
+        "Reservation"
+      ]
+    },
+    "ReservationToReturn": {
+      "type": "object",
+      "description": "To be present only if ReturnRequestScope = Reservation and null otherwise",
+      "properties": {
+        "reservationId": {
+          "type": "string",
+          "description": "Fully qualified identifier of the Reservation being returned"
+        },
+        "quantity": {
+          "type": "integer",
+          "format": "int32",
+          "description": "Quantity to be returned. Must be greater than zero."
+        }
+      }
+    },
+    "ReservationStatusCode": {
+      "type": "string",
+      "enum": [
+        "None",
+        "Pending",
+        "Active",
+        "PurchaseError",
+        "PaymentInstrumentError",
+        "Split",
+        "Merged",
+        "Expired",
+        "Succeeded"
+      ],
+      "x-ms-enum": {
+        "name": "ReservationStatusCode",
+        "modelAsString": true
+      }
+    },
+    "ErrorResponseCode": {
+      "type": "string",
+      "enum": [
+        "NotSpecified",
+        "InternalServerError",
+        "ServerTimeout",
+        "AuthorizationFailed",
+        "BadRequest",
+        "ClientCertificateThumbprintNotSet",
+        "InvalidRequestContent",
+        "OperationFailed",
+        "HttpMethodNotSupported",
+        "InvalidRequestUri",
+        "MissingTenantId",
+        "InvalidTenantId",
+        "InvalidReservationOrderId",
+        "InvalidReservationId",
+        "ReservationIdNotInReservationOrder",
+        "ReservationOrderNotFound",
+        "InvalidSubscriptionId",
+        "InvalidAccessToken",
+        "InvalidLocationId",
+        "UnauthenticatedRequestsThrottled",
+        "InvalidHealthCheckType",
+        "Forbidden",
+        "BillingScopeIdCannotBeChanged",
+        "AppliedScopesNotAssociatedWithCommerceAccount",
+        "PatchValuesSameAsExisting",
+        "RoleAssignmentCreationFailed",
+        "ReservationOrderCreationFailed",
+        "ReservationOrderNotEnabled",
+        "CapacityUpdateScopesFailed",
+        "UnsupportedReservationTerm",
+        "ReservationOrderIdAlreadyExists",
+        "RiskCheckFailed",
+        "CreateQuoteFailed",
+        "ActivateQuoteFailed",
+        "NonsupportedAccountId",
+        "PaymentInstrumentNotFound",
+        "MissingAppliedScopesForSingle",
+        "NoValidReservationsToReRate",
+        "ReRateOnlyAllowedForEA",
+        "OperationCannotBePerformedInCurrentState",
+        "InvalidSingleAppliedScopesCount",
+        "InvalidFulfillmentRequestParameters",
+        "NotSupportedCountry",
+        "InvalidRefundQuantity",
+        "PurchaseError",
+        "BillingCustomerInputError",
+        "BillingPaymentInstrumentSoftError",
+        "BillingPaymentInstrumentHardError",
+        "BillingTransientError",
+        "BillingError",
+        "FulfillmentConfigurationError",
+        "FulfillmentOutOfStockError",
+        "FulfillmentTransientError",
+        "FulfillmentError",
+        "CalculatePriceFailed"
+      ],
+      "x-ms-enum": {
+        "name": "ErrorResponseCode",
+        "modelAsString": true
+      }
+    },
+    "SkuName": {
+      "type": "object",
+      "properties": {
+        "name": {
+          "type": "string"
+        }
+      }
+    },
+    "CalculateExchangeOperationResultResponse": {
+      "type": "object",
+      "description": "CalculateExchange operation result",
+      "properties": {
+        "id": {
+          "type": "string",
+          "description": "It should match what is used to GET the operation result."
+        },
+        "name": {
+          "type": "string",
+          "description": "It must match the last segment of the id field, and will typically be a GUID / system generated value."
+        },
+        "status": {
+          "type": "string",
+          "description": "Status of the operation.",
+          "enum": [
+            "Succeeded",
+            "Failed",
+            "Cancelled",
+            "Pending"
+          ],
+          "x-ms-enum": {
+            "name": "CalculateExchangeOperationResultStatus",
+            "modelAsString": true
+          }
+        },
+        "properties": {
+          "$ref": "#/definitions/CalculateExchangeResponseProperties"
+        },
+        "error": {
+          "$ref": "#/definitions/OperationResultError"
+        }
+      }
+    },
+    "ExchangeOperationResultResponse": {
+      "type": "object",
+      "description": "Exchange operation result",
+      "properties": {
+        "id": {
+          "type": "string",
+          "description": "It should match what is used to GET the operation result."
+        },
+        "name": {
+          "type": "string",
+          "description": "It must match the last segment of the id field, and will typically be a GUID / system generated value."
+        },
+        "status": {
+          "type": "string",
+          "description": "Status of the operation.",
+          "enum": [
+            "Succeeded",
+            "Failed",
+            "Cancelled",
+            "PendingRefunds",
+            "PendingPurchases"
+          ],
+          "x-ms-enum": {
+            "name": "ExchangeOperationResultStatus",
+            "modelAsString": true
+          }
+        },
+        "properties": {
+          "$ref": "#/definitions/ExchangeResponseProperties"
+        },
+        "error": {
+          "$ref": "#/definitions/OperationResultError"
+        }
+      }
+    },
+    "OperationResultError": {
+      "type": "object",
+      "description": "Required if status == failed or status == canceled.",
+      "properties": {
+        "code": {
+          "type": "string",
+          "description": "Required if status == failed or status == cancelled. If status == failed, provide an invariant error code used for error troubleshooting, aggregation, and analysis."
+        },
+        "message": {
+          "type": "string",
+          "description": "Required if status == failed. Localized. If status == failed, provide an actionable error message indicating what error occurred, and what the user can do to address the issue."
+        }
+      }
+    },
+    "CalculateExchangeResponseProperties": {
+      "type": "object",
+      "description": "CalculateExchange response properties",
+      "properties": {
+        "sessionId": {
+          "type": "string",
+          "description": "Exchange session identifier"
+        },
+        "netPayable": {
+          "$ref": "#/definitions/Price"
+        },
+        "refundsTotal": {
+          "$ref": "#/definitions/Price"
+        },
+        "purchasesTotal": {
+          "$ref": "#/definitions/Price"
+        },
+        "reservationsToPurchase": {
+          "type": "array",
+          "description": "Details of the reservations being purchased",
+          "items": {
+            "$ref": "#/definitions/ReservationToPurchaseCalculateExchange"
+          }
+        },
+        "reservationsToExchange": {
+          "type": "array",
+          "description": "Details of the reservations being returned",
+          "items": {
+            "$ref": "#/definitions/ReservationToExchange"
+          }
+        },
+        "policyResult": {
+          "$ref": "#/definitions/ExchangePolicyErrors"
+        }
+      }
+    },
+    "ExchangeResponseProperties": {
+      "type": "object",
+      "description": "Exchange response properties",
+      "properties": {
+        "sessionId": {
+          "type": "string",
+          "description": "Exchange session identifier"
+        },
+        "netPayable": {
+          "$ref": "#/definitions/Price"
+        },
+        "refundsTotal": {
+          "$ref": "#/definitions/Price"
+        },
+        "purchasesTotal": {
+          "$ref": "#/definitions/Price"
+        },
+        "reservationsToPurchase": {
+          "type": "array",
+          "description": "Details of the reservations being purchased",
+          "items": {
+            "$ref": "#/definitions/ReservationToPurchaseExchange"
+          }
+        },
+        "reservationsToExchange": {
+          "type": "array",
+          "description": "Details of the reservations being returned",
+          "items": {
+            "$ref": "#/definitions/ReservationToExchange"
+          }
+        },
+        "policyResult": {
+          "$ref": "#/definitions/ExchangePolicyErrors"
+        }
+      }
+    },
+    "ExchangePolicyErrors": {
+      "type": "object",
+      "description": "Exchange policy errors",
+      "properties": {
+        "policyErrors": {
+          "type": "array",
+          "description": "Exchange Policy errors",
+          "items": {
+            "$ref": "#/definitions/ExchangePolicyError"
+          }
+        }
+      }
+    },
+    "ExchangePolicyError": {
+      "type": "object",
+      "description": "error details",
+      "properties": {
+        "code": {
+          "type": "string"
+        },
+        "message": {
+          "type": "string"
+        }
+      }
+    },
+    "ReservationToExchange": {
+      "type": "object",
+      "description": "Reservation refund details",
+      "properties": {
+        "reservationId": {
+          "type": "string",
+          "description": "Fully qualified id of the Reservation being returned."
+        },
+        "quantity": {
+          "type": "integer",
+          "format": "int32",
+          "description": "Quantity to be returned"
+        },
+        "billingRefundAmount": {
+          "$ref": "#/definitions/Price"
+        },
+        "billingInformation": {
+          "$ref": "#/definitions/BillingInformation"
+        }
+      }
+    },
+    "BillingInformation": {
+      "type": "object",
+      "description": "billing information",
+      "properties": {
+        "billingCurrencyTotalPaidAmount": {
+          "$ref": "#/definitions/Price"
+        },
+        "billingCurrencyProratedAmount": {
+          "$ref": "#/definitions/Price"
+        },
+        "billingCurrencyRemainingCommitmentAmount": {
+          "$ref": "#/definitions/Price"
+        }
+      }
+    },
+    "ReservationToPurchaseCalculateExchange": {
+      "type": "object",
+      "description": "Reservation purchase details",
+      "properties": {
+        "billingCurrencyTotal": {
+          "$ref": "#/definitions/Price"
+        }
+      }
+    },
+    "ReservationToPurchaseExchange": {
+      "type": "object",
+      "description": "Reservation purchase details",
+      "properties": {
+        "reservationOrderId": {
+          "type": "string",
+          "description": "Fully qualified id of the ReservationOrder being purchased"
+        },
+        "billingCurrencyTotal": {
+          "$ref": "#/definitions/Price"
+        }
+      }
+    },
+    "Catalog": {
+      "type": "object",
+      "properties": {
+        "resourceType": {
+          "type": "string",
+          "description": "The type of resource the SKU applies to.",
+          "readOnly": true
+        },
+        "name": {
+          "type": "string",
+          "description": "The name of SKU",
+          "readOnly": true
+        },
+        "billingPlans": {
+          "type": "object",
+          "description": "The billing plan options available for this SKU.",
+          "additionalProperties": {
+            "type": "array",
+            "items": {
+              "$ref": "#/definitions/ReservationBillingPlan"
+            }
+          }
+        },
+        "terms": {
+          "type": "array",
+          "readOnly": true,
+          "description": "Available reservation terms for this resource",
+          "items": {
+            "$ref": "#/definitions/ReservationTerm"
+          }
+        },
+        "locations": {
+          "type": "array",
+          "readOnly": true,
+          "items": {
+            "type": "string",
+            "description": "The set of locations that the SKU is available. If not specified, the SKU is available in all locations."
+          }
+        },
+        "skuProperties": {
+          "type": "array",
+          "readOnly": true,
+          "items": {
+            "$ref": "#/definitions/SkuProperty"
+          }
+        },
+        "restrictions": {
+          "type": "array",
+          "readOnly": true,
+          "items": {
+            "$ref": "#/definitions/SkuRestriction"
+          }
+        }
+      }
+    },
+    "SkuProperty": {
+      "type": "object",
+      "properties": {
+        "name": {
+          "type": "string",
+          "description": "An invariant to describe the feature."
+        },
+        "value": {
+          "type": "string",
+          "description": "An invariant if the feature is measured by quantity."
+        }
+      }
+    },
+    "SkuRestriction": {
+      "type": "object",
+      "properties": {
+        "type": {
+          "type": "string",
+          "description": "The type of restrictions."
+        },
+        "values": {
+          "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",
+          "description": "The reason for restriction."
+        }
+      }
+    },
+    "ReservationOrderResponse": {
+      "type": "object",
+      "x-ms-azure-resource": true,
+      "properties": {
+        "etag": {
+          "type": "integer"
+        },
+        "id": {
+          "type": "string",
+          "readOnly": true,
+          "description": "Identifier of the reservation"
+        },
+        "name": {
+          "type": "string",
+          "readOnly": true,
+          "description": "Name of the reservation"
+        },
+        "properties": {
+          "x-ms-client-flatten": true,
+          "$ref": "#/definitions/ReservationOrderProperties"
+        },
+        "type": {
+          "type": "string",
+          "readOnly": true,
+          "description": "Type of resource. \"Microsoft.Capacity/reservations\""
+        }
+      }
+    },
+    "ReservationBillingPlan": {
+      "type": "string",
+      "description": "Represent the billing plans.",
+      "enum": [
+        "Upfront",
+        "Monthly"
+      ],
+      "x-ms-enum": {
+        "name": "ReservationBillingPlan",
+        "modelAsString": true
+      }
+    },
+    "ReservationTerm": {
+      "type": "string",
+      "description": "Represent the term of Reservation.",
+      "enum": [
+        "P1Y",
+        "P3Y"
+      ],
+      "x-ms-enum": {
+        "name": "ReservationTerm",
+        "modelAsString": true
+      }
+    },
+    "PaymentStatus": {
+      "type": "string",
+      "description": "Describes whether the payment is completed, failed, cancelled or scheduled in the future.",
+      "enum": [
+        "Succeeded",
+        "Failed",
+        "Scheduled",
+        "Cancelled"
+      ],
+      "x-ms-enum": {
+        "name": "PaymentStatus",
+        "modelAsString": true
+      }
+    },
+    "PaymentDetail": {
+      "type": "object",
+      "description": "Information about payment related to a reservation order.",
+      "properties": {
+        "dueDate": {
+          "type": "string",
+          "format": "date",
+          "description": "Date when the payment needs to be done."
+        },
+        "paymentDate": {
+          "type": "string",
+          "format": "date",
+          "description": "Date when the transaction is completed. Is null when it is scheduled."
+        },
+        "pricingCurrencyTotal": {
+          "$ref": "#/definitions/Price",
+          "description": "Amount in pricing currency. Tax not included."
+        },
+        "billingCurrencyTotal": {
+          "$ref": "#/definitions/Price",
+          "description": "Amount charged in Billing currency. Tax not included. Is null for future payments"
+        },
+        "billingAccount": {
+          "type": "string",
+          "description": "Shows the Account that is charged for this payment."
+        },
+        "status": {
+          "$ref": "#/definitions/PaymentStatus"
+        },
+        "extendedStatusInfo": {
+          "$ref": "#/definitions/ExtendedStatusInfo"
+        }
+      }
+    },
+    "ReservationOrderBillingPlanInformation": {
+      "type": "object",
+      "description": "Information describing the type of billing plan for this reservation.",
+      "properties": {
+        "pricingCurrencyTotal": {
+          "$ref": "#/definitions/Price",
+          "description": "Amount of money to be paid for the Order. Tax is not included."
+        },
+        "startDate": {
+          "type": "string",
+          "format": "date",
+          "description": "Date when the billing plan has started."
+        },
+        "nextPaymentDueDate": {
+          "type": "string",
+          "format": "date",
+          "description": "For recurring billing plans, indicates the date when next payment will be processed. Null when total is paid off."
+        },
+        "transactions": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/PaymentDetail"
+          }
+        }
+      }
+    },
+    "ReservationOrderProperties": {
+      "type": "object",
+      "properties": {
+        "displayName": {
+          "type": "string",
+          "description": "Friendly name for user to easily identified the reservation."
+        },
+        "requestDateTime": {
+          "type": "string",
+          "format": "date-time",
+          "description": "This is the DateTime when the reservation was initially requested for purchase."
+        },
+        "createdDateTime": {
+          "type": "string",
+          "format": "date-time",
+          "description": "This is the DateTime when the reservation was created."
+        },
+        "expiryDate": {
+          "type": "string",
+          "format": "date",
+          "description": "This is the date when the Reservation will expire."
+        },
+        "originalQuantity": {
+          "$ref": "#/definitions/ReservationQuantity"
+        },
+        "term": {
+          "$ref": "#/definitions/ReservationTerm"
+        },
+        "provisioningState": {
+          "type": "string",
+          "description": "Current state of the reservation."
+        },
+        "billingPlan": {
+          "$ref": "#/definitions/ReservationBillingPlan"
+        },
+        "planInformation": {
+          "$ref": "#/definitions/ReservationOrderBillingPlanInformation"
+        },
+        "reservations": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/ReservationResponse"
+          }
+        }
+      }
+    },
+    "ReservationResponse": {
+      "type": "object",
+      "x-ms-azure-resource": true,
+      "properties": {
+        "location": {
+          "type": "string",
+          "readOnly": true,
+          "description": "The Azure Region where the reserved resource lives."
+        },
+        "etag": {
+          "type": "integer"
+        },
+        "id": {
+          "type": "string",
+          "readOnly": true,
+          "description": "Identifier of the reservation"
+        },
+        "name": {
+          "type": "string",
+          "readOnly": true,
+          "description": "Name of the reservation"
+        },
+        "sku": {
+          "$ref": "#/definitions/SkuName"
+        },
+        "properties": {
+          "$ref": "#/definitions/ReservationProperties"
+        },
+        "type": {
+          "type": "string",
+          "readOnly": true,
+          "description": "Type of resource. \"Microsoft.Capacity/reservationOrders/reservations\""
+        }
+      }
+    },
+    "RenewPropertiesResponse": {
+      "type": "object",
+      "properties": {
+        "purchaseProperties": {
+          "$ref": "#/definitions/PurchaseRequest"
+        },
+        "pricingCurrencyTotal": {
+          "type": "object",
+          "description": "Amount that Microsoft uses for record. Used during refund for calculating refund limit. Tax is not included. This is locked price 30 days before expiry.",
+          "properties": {
+            "currencyCode": {
+              "type": "string"
+            },
+            "amount": {
+              "type": "number"
+            }
+          }
+        },
+        "billingCurrencyTotal": {
+          "type": "object",
+          "description": "Currency and amount that customer will be charged in customer's local currency for renewal purchase. Tax is not included.",
+          "properties": {
+            "currencyCode": {
+              "type": "string"
+            },
+            "amount": {
+              "type": "number"
+            }
+          }
+        }
+      }
+    },
+    "CalculatePriceResponse": {
+      "type": "object",
+      "properties": {
+        "properties": {
+          "$ref": "#/definitions/CalculatePriceResponseProperties"
+        }
+      }
+    },
+    "CalculatePriceResponseProperties": {
+      "type": "object",
+      "properties": {
+        "billingCurrencyTotal": {
+          "type": "object",
+          "description": "Currency and amount that customer will be charged in customer's local currency. Tax is not included.",
+          "properties": {
+            "currencyCode": {
+              "type": "string"
+            },
+            "amount": {
+              "type": "number"
+            }
+          }
+        },
+        "isBillingPartnerManaged": {
+          "description": "True if billing is managed by Microsoft Partner. Used only for CSP accounts.",
+          "type": "boolean"
+        },
+        "reservationOrderId": {
+          "description": "GUID that represents reservation order that can be placed after calculating price.",
+          "type": "string"
+        },
+        "skuTitle": {
+          "description": "Title of SKU that is being purchased.",
+          "type": "string"
+        },
+        "skuDescription": {
+          "description": "Description of SKU that is being purchased.",
+          "type": "string"
+        },
+        "pricingCurrencyTotal": {
+          "type": "object",
+          "description": "Amount that Microsoft uses for record. Used during refund for calculating refund limit. Tax is not included.",
+          "properties": {
+            "currencyCode": {
+              "type": "string"
+            },
+            "amount": {
+              "type": "number"
+            }
+          }
+        },
+        "paymentSchedule": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/PaymentDetail"
+          }
+        }
+      }
+    },
+    "ReservationProperties": {
+      "type": "object",
+      "properties": {
+        "reservedResourceType": {
+          "$ref": "#/definitions/ReservedResourceType"
+        },
+        "instanceFlexibility": {
+          "$ref": "#/definitions/InstanceFlexibility"
+        },
+        "displayName": {
+          "type": "string",
+          "description": "Friendly name for user to easily identify the reservation"
+        },
+        "appliedScopes": {
+          "$ref": "#/definitions/AppliedScopes"
+        },
+        "appliedScopeType": {
+          "$ref": "#/definitions/AppliedScopeType"
+        },
+        "quantity": {
+          "$ref": "#/definitions/ReservationQuantity"
+        },
+        "provisioningState": {
+          "type": "string",
+          "description": "Current state of the reservation."
+        },
+        "effectiveDateTime": {
+          "type": "string",
+          "format": "date-time",
+          "description": "DateTime of the Reservation starting when this version is effective from."
+        },
+        "lastUpdatedDateTime": {
+          "type": "string",
+          "format": "date-time",
+          "description": "DateTime of the last time the Reservation was updated.",
+          "readOnly": true
+        },
+        "expiryDate": {
+          "type": "string",
+          "format": "date",
+          "description": "This is the date when the Reservation will expire."
+        },
+        "skuDescription": {
+          "type": "string",
+          "description": "Description of the SKU in english."
+        },
+        "extendedStatusInfo": {
+          "$ref": "#/definitions/ExtendedStatusInfo"
+        },
+        "billingPlan": {
+          "$ref": "#/definitions/ReservationBillingPlan"
+        },
+        "splitProperties": {
+          "$ref": "#/definitions/ReservationSplitProperties"
+        },
+        "mergeProperties": {
+          "$ref": "#/definitions/ReservationMergeProperties"
+        },
+        "billingScopeId": {
+          "$ref": "#/definitions/BillingScopeId"
+        },
+        "renew": {
+          "$ref": "#/definitions/Renew"
+        },
+        "renewSource": {
+          "type": "string",
+          "description": "Reservation Id of the reservation from which this reservation is renewed. Format of the resource Id is /providers/Microsoft.Capacity/reservationOrders/{reservationOrderId}/reservations/{reservationId}."
+        },
+        "renewDestination": {
+          "type": "string",
+          "description": "Reservation Id of the reservation which is purchased because of renew. Format of the resource Id is /providers/Microsoft.Capacity/reservationOrders/{reservationOrderId}/reservations/{reservationId}."
+        },
+        "renewProperties": {
+          "$ref": "#/definitions/RenewPropertiesResponse"
+        },
+        "term": {
+          "$ref": "#/definitions/ReservationTerm"
+        }
+      }
+    },
+    "ReservationSplitProperties": {
+      "type": "object",
+      "properties": {
+        "splitDestinations": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "List of destination Resource Id that are created due to split. Format of the resource Id is /providers/Microsoft.Capacity/reservationOrders/{reservationOrderId}/reservations/{reservationId}"
+        },
+        "splitSource": {
+          "type": "string",
+          "description": "Resource Id of the Reservation from which this is split. Format of the resource Id is /providers/Microsoft.Capacity/reservationOrders/{reservationOrderId}/reservations/{reservationId}"
+        }
+      }
+    },
+    "ReservationMergeProperties": {
+      "type": "object",
+      "properties": {
+        "mergeDestination": {
+          "type": "string",
+          "description": "Reservation Resource Id Created due to the merge. Format of the resource Id is /providers/Microsoft.Capacity/reservationOrders/{reservationOrderId}/reservations/{reservationId}"
+        },
+        "mergeSources": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Resource Ids of the Source Reservation's merged to form this Reservation. Format of the resource Id is /providers/Microsoft.Capacity/reservationOrders/{reservationOrderId}/reservations/{reservationId}"
+        }
+      }
+    },
+    "PurchaseRequestProperties": {
+      "type": "object",
+      "properties": {
+        "reservedResourceType": {
+          "$ref": "#/definitions/ReservedResourceType"
+        },
+        "billingScopeId": {
+          "$ref": "#/definitions/BillingScopeId"
+        },
+        "term": {
+          "$ref": "#/definitions/ReservationTerm"
+        },
+        "billingPlan": {
+          "$ref": "#/definitions/ReservationBillingPlan"
+        },
+        "quantity": {
+          "$ref": "#/definitions/ReservationQuantity"
+        },
+        "displayName": {
+          "type": "string",
+          "description": "Friendly name of the Reservation"
+        },
+        "appliedScopeType": {
+          "$ref": "#/definitions/AppliedScopeType"
+        },
+        "appliedScopes": {
+          "$ref": "#/definitions/AppliedScopes"
+        },
+        "renew": {
+          "$ref": "#/definitions/Renew"
+        },
+        "reservedResourceProperties": {
+          "type": "object",
+          "description": "Properties specific to each reserved resource type. Not required if not applicable.",
+          "properties": {
+            "instanceFlexibility": {
+              "$ref": "#/definitions/InstanceFlexibility"
+            }
+          }
+        }
+      }
+    },
+    "PatchProperties": {
+      "type": "object",
+      "properties": {
+        "appliedScopeType": {
+          "$ref": "#/definitions/AppliedScopeType"
+        },
+        "appliedScopes": {
+          "$ref": "#/definitions/AppliedScopes"
+        },
+        "instanceFlexibility": {
+          "$ref": "#/definitions/InstanceFlexibility"
+        },
+        "name": {
+          "type": "string",
+          "description": "Name of the Reservation"
+        },
+        "renew": {
+          "$ref": "#/definitions/Renew"
+        },
+        "renewProperties": {
+          "type": "object",
+          "properties": {
+            "purchaseProperties": {
+              "$ref": "#/definitions/PurchaseRequest"
+            }
+          }
+        }
+      }
+    },
+    "SplitProperties": {
+      "type": "object",
+      "properties": {
+        "quantities": {
+          "type": "array",
+          "description": "List of the quantities in the new reservations to create.",
+          "items": {
+            "type": "integer",
+            "minItems": 2,
+            "maxItems": 2
+          }
+        },
+        "reservationId": {
+          "type": "string",
+          "description": "Resource id of the reservation to be split. Format of the resource id should be /providers/Microsoft.Capacity/reservationOrders/{reservationOrderId}/reservations/{reservationId}"
+        }
+      }
+    },
+    "MergeProperties": {
+      "type": "object",
+      "properties": {
+        "sources": {
+          "type": "array",
+          "description": "Format of the resource id should be /providers/Microsoft.Capacity/reservationOrders/{reservationOrderId}/reservations/{reservationId}",
+          "items": {
+            "type": "string"
+          }
+        }
+      }
+    },
+    "MergeRequest": {
+      "type": "object",
+      "properties": {
+        "properties": {
+          "x-ms-client-flatten": true,
+          "$ref": "#/definitions/MergeProperties"
+        }
+      }
+    },
+    "PurchaseRequest": {
+      "type": "object",
+      "properties": {
+        "sku": {
+          "$ref": "#/definitions/SkuName"
+        },
+        "location": {
+          "type": "string",
+          "description": "The Azure Region where the reserved resource lives."
+        },
+        "properties": {
+          "x-ms-client-flatten": true,
+          "$ref": "#/definitions/PurchaseRequestProperties"
+        }
+      }
+    },
+    "Patch": {
+      "type": "object",
+      "properties": {
+        "properties": {
+          "x-ms-client-flatten": true,
+          "$ref": "#/definitions/PatchProperties"
+        }
+      }
+    },
+    "SplitRequest": {
+      "type": "object",
+      "properties": {
+        "properties": {
+          "x-ms-client-flatten": true,
+          "$ref": "#/definitions/SplitProperties"
+        }
+      }
+    },
+    "Error": {
+      "type": "object",
+      "properties": {
+        "error": {
+          "$ref": "#/definitions/ExtendedErrorInfo"
+        }
+      }
+    },
+    "ExtendedErrorInfo": {
+      "type": "object",
+      "properties": {
+        "code": {
+          "$ref": "#/definitions/ErrorResponseCode"
+        },
+        "message": {
+          "type": "string"
+        }
+      }
+    },
+    "ExtendedStatusInfo": {
+      "type": "object",
+      "properties": {
+        "statusCode": {
+          "$ref": "#/definitions/ReservationStatusCode"
+        },
+        "message": {
+          "type": "string",
+          "description": "The message giving detailed information about the status code."
+        }
+      }
+    },
+    "ReservationOrderList": {
+      "type": "object",
+      "properties": {
+        "value": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/ReservationOrderResponse"
+          }
+        },
+        "nextLink": {
+          "type": "string",
+          "description": "Url to get the next page of reservationOrders."
+        }
+      }
+    },
+    "ReservationList": {
+      "type": "object",
+      "properties": {
+        "value": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/ReservationResponse"
+          }
+        },
+        "nextLink": {
+          "type": "string",
+          "description": "Url to get the next page of reservations."
+        }
+      }
+    },
+    "AppliedReservations": {
+      "type": "object",
+      "properties": {
+        "id": {
+          "type": "string",
+          "description": "Identifier of the applied reservations",
+          "readOnly": true
+        },
+        "name": {
+          "type": "string",
+          "description": "Name of resource",
+          "readOnly": true
+        },
+        "type": {
+          "type": "string",
+          "description": "Type of resource. \"Microsoft.Capacity/AppliedReservations\"",
+          "readOnly": true
+        },
+        "properties": {
+          "x-ms-client-flatten": true,
+          "$ref": "#/definitions/AppliedReservationsProperties"
+        }
+      }
+    },
+    "AppliedReservationsProperties": {
+      "type": "object",
+      "properties": {
+        "reservationOrderIds": {
+          "$ref": "#/definitions/AppliedReservationList"
+        }
+      }
+    },
+    "AppliedReservationList": {
+      "type": "object",
+      "properties": {
+        "value": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "description": "Reservation resource Id. \"/providers/Microsoft.Capacity/reservationOrders/{reservationOrderId}\""
+          }
+        },
+        "nextLink": {
+          "type": "string",
+          "description": "Url to get the next page of reservations"
+        }
+      }
+    },
+    "OperationList": {
+      "type": "object",
+      "properties": {
+        "value": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/OperationResponse"
+          }
+        },
+        "nextLink": {
+          "type": "string",
+          "description": "Url to get the next page of items."
+        }
+      }
+    },
+    "OperationResponse": {
+      "type": "object",
+      "properties": {
+        "name": {
+          "type": "string"
+        },
+        "display": {
+          "$ref": "#/definitions/OperationDisplay"
+        },
+        "origin": {
+          "type": "string"
+        }
+      }
+    },
+    "OperationDisplay": {
+      "type": "object",
+      "properties": {
+        "provider": {
+          "type": "string"
+        },
+        "resource": {
+          "type": "string"
+        },
+        "operation": {
+          "type": "string"
+        },
+        "description": {
+          "type": "string"
+        }
+      }
+    },
+    "InstanceFlexibility": {
+      "type": "string",
+      "description": "Turning this on will apply the reservation discount to other VMs in the same VM size group. Only specify for VirtualMachines reserved resource type.",
+      "enum": [
+        "On",
+        "Off"
+      ],
+      "x-ms-enum": {
+        "name": "InstanceFlexibility",
+        "modelAsString": true
+      }
+    },
+    "AppliedScopeType": {
+      "type": "string",
+      "description": "Type of the Applied Scope.",
+      "enum": [
+        "Single",
+        "Shared"
+      ],
+      "x-ms-enum": {
+        "name": "AppliedScopeType",
+        "modelAsString": true
+      }
+    },
+    "AppliedScopes": {
+      "type": "array",
+      "description": "List of the subscriptions that the benefit will be applied. Do not specify if AppliedScopeType is Shared.",
+      "items": {
+        "type": "string",
+        "minItems": 1,
+        "maxItems": 1
+      }
+    },
+    "BillingScopeId": {
+      "type": "string",
+      "description": "Subscription that will be charged for purchasing Reservation"
+    },
+    "Renew": {
+      "type": "boolean",
+      "default": false,
+      "description": "Setting this to true will automatically purchase a new reservation on the expiration date time."
+    },
+    "ReservationQuantity": {
+      "type": "integer",
+      "format": "int32",
+      "description": "Quantity of the SKUs that are part of the Reservation. Must be greater than zero."
+    },
+    "AvailableScopeProperties": {
+      "type": "object",
+      "properties": {
+        "properties": {
+          "$ref": "#/definitions/SubscriptionScopeProperties"
+        }
+      }
+    },
+    "SubscriptionScopeProperties": {
+      "type": "object",
+      "properties": {
+        "scopes": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/ScopeProperties"
+          }
+        }
+      }
+    },
+    "ScopeProperties": {
+      "type": "object",
+      "properties": {
+        "scope": {
+          "type": "string"
+        },
+        "valid": {
+          "type": "boolean"
+        }
+      }
+    },
+    "ReservedResourceType": {
+      "type": "string",
+      "description": "The type of the resource that is being reserved.",
+      "enum": [
+        "VirtualMachines",
+        "SqlDatabases",
+        "SuseLinux",
+        "CosmosDb",
+        "RedHat",
+        "SqlDataWarehouse",
+        "VMwareCloudSimple",
+        "RedHatOsa",
+        "Databricks",
+        "AppService",
+        "ManagedDisk",
+        "BlockBlob",
+        "RedisCache",
+        "AzureDataExplorer",
+        "MySql",
+        "MariaDb",
+        "PostgreSql",
+        "DedicatedHost",
+        "SapHana",
+        "SqlAzureHybridBenefit"
+      ],
+      "x-ms-enum": {
+        "name": "ReservedResourceType",
+        "modelAsString": true
+      }
+    },
+    "Price": {
+      "type": "object",
+      "properties": {
+        "currencyCode": {
+          "type": "string",
+          "description": "The ISO 4217 3-letter currency code for the currency used by this purchase record."
+        },
+        "amount": {
+          "type": "number",
+          "format": "double"
+        }
+      }
+    }
+  },
+  "parameters": {
+    "CalculateExchangeRequestParameter": {
+      "name": "body",
+      "x-ms-parameter-location": "method",
+      "in": "body",
+      "required": true,
+      "description": "Request containing purchases and refunds that need to be executed.",
+      "schema": {
+        "$ref": "#/definitions/CalculateExchangeRequest"
+      }
+    },
+    "ExchangeRequestParameter": {
+      "name": "body",
+      "x-ms-parameter-location": "method",
+      "in": "body",
+      "required": true,
+      "description": "Request containing the refunds and purchases that need to be executed.",
+      "schema": {
+        "$ref": "#/definitions/ExchangeRequest"
+      }
+    },
+    "ScopeParameter": {
+      "name": "body",
+      "x-ms-parameter-location": "method",
+      "in": "body",
+      "required": true,
+      "schema": {
+        "$ref": "#/definitions/AvailableScopeRequest"
+      }
+    },
+    "PurchaseParameter": {
+      "name": "body",
+      "x-ms-parameter-location": "method",
+      "in": "body",
+      "required": true,
+      "description": "Information needed for calculate or purchase reservation",
+      "schema": {
+        "$ref": "#/definitions/PurchaseRequest"
+      }
+    },
+    "ReservationIdParameter": {
+      "name": "reservationId",
+      "x-ms-parameter-location": "method",
+      "in": "path",
+      "required": true,
+      "type": "string",
+      "description": "Id of the Reservation Item"
+    },
+    "MergeParameter": {
+      "name": "body",
+      "x-ms-parameter-location": "method",
+      "in": "body",
+      "required": true,
+      "description": "Information needed for commercial request for a reservation",
+      "schema": {
+        "$ref": "#/definitions/MergeRequest"
+      }
+    },
+    "PatchParameter": {
+      "name": "parameters",
+      "x-ms-parameter-location": "method",
+      "in": "body",
+      "required": true,
+      "description": "Information needed to patch a reservation item",
+      "schema": {
+        "$ref": "#/definitions/Patch"
+      }
+    },
+    "SplitParameter": {
+      "name": "body",
+      "x-ms-parameter-location": "method",
+      "in": "body",
+      "required": true,
+      "description": "Information needed to Split a reservation item",
+      "schema": {
+        "$ref": "#/definitions/SplitRequest"
+      }
+    },
+    "ApiVersionParameter": {
+      "name": "api-version",
+      "in": "query",
+      "description": "Supported version for this document is 2020-10-01-preview",
+      "required": true,
+      "type": "string"
+    },
+    "ExpandRenewPropertiesParameter": {
+      "name": "expand",
+      "x-ms-parameter-location": "method",
+      "in": "query",
+      "description": "Supported value of this query is renewProperties",
+      "required": false,
+      "type": "string"
+    },
+    "SubscriptionIdParameter": {
+      "name": "subscriptionId",
+      "x-ms-parameter-location": "method",
+      "in": "path",
+      "required": true,
+      "type": "string",
+      "description": "Id of the subscription"
+    },
+    "ReservedResourceTypeIdParameter": {
+      "name": "reservedResourceType",
+      "x-ms-parameter-location": "method",
+      "in": "query",
+      "required": true,
+      "type": "string",
+      "description": "The type of the resource for which the skus should be provided."
+    },
+    "LocationIdParameter": {
+      "name": "location",
+      "x-ms-parameter-location": "method",
+      "in": "query",
+      "required": false,
+      "type": "string",
+      "description": "Filters the skus based on the location specified in this parameter. This can be an azure region or global"
+    },
+    "ReservationOrderIdParameter": {
+      "name": "reservationOrderId",
+      "x-ms-parameter-location": "method",
+      "in": "path",
+      "required": true,
+      "type": "string",
+      "description": "Order Id of the reservation"
+    },
+    "OperationResultIdParameter": {
+      "name": "operationResultId",
+      "x-ms-parameter-location": "method",
+      "in": "path",
+      "required": true,
+      "type": "string",
+      "description": "OperationResult identifier"
+    }
+  }
+}
diff --git a/specification/reservations/resource-manager/readme.md b/specification/reservations/resource-manager/readme.md
index 66a5dd8d25f3..df5d162954de 100644
--- a/specification/reservations/resource-manager/readme.md
+++ b/specification/reservations/resource-manager/readme.md
@@ -26,7 +26,17 @@ These are the global settings for the Reservations API.
 
 ``` yaml
 openapi-type: arm
-tag: package-preview-2019-07-19
+tag: package-2020-10-preview
+```
+
+### Tag: package-2020-10-preview
+
+These settings apply only when `--tag=package-2020-10-preview` is specified on the command line.
+
+```yaml $(tag) == 'package-2020-10-preview'
+input-file:
+  - Microsoft.Capacity/preview/2019-07-19/quota.json
+  - Microsoft.Capacity/preview/2020-10-01-preview/reservations.json
 ```
 
 ### Tag: package-preview-2019-07-19
diff --git a/specification/regionmove/resource-manager/Microsoft.Migrate/preview/2019-10-01-preview/examples/MoveCollections_Commit.json b/specification/resourcemover/resource-manager/Microsoft.Migrate/preview/2019-10-01-preview/examples/MoveCollections_BulkRemove.json
similarity index 100%
rename from specification/regionmove/resource-manager/Microsoft.Migrate/preview/2019-10-01-preview/examples/MoveCollections_Commit.json
rename to specification/resourcemover/resource-manager/Microsoft.Migrate/preview/2019-10-01-preview/examples/MoveCollections_BulkRemove.json
diff --git a/specification/regionmove/resource-manager/Microsoft.Migrate/preview/2019-10-01-preview/examples/MoveCollections_Discard.json b/specification/resourcemover/resource-manager/Microsoft.Migrate/preview/2019-10-01-preview/examples/MoveCollections_Commit.json
similarity index 100%
rename from specification/regionmove/resource-manager/Microsoft.Migrate/preview/2019-10-01-preview/examples/MoveCollections_Discard.json
rename to specification/resourcemover/resource-manager/Microsoft.Migrate/preview/2019-10-01-preview/examples/MoveCollections_Commit.json
diff --git a/specification/regionmove/resource-manager/Microsoft.Migrate/preview/2019-10-01-preview/examples/MoveCollections_Create.json b/specification/resourcemover/resource-manager/Microsoft.Migrate/preview/2019-10-01-preview/examples/MoveCollections_Create.json
similarity index 100%
rename from specification/regionmove/resource-manager/Microsoft.Migrate/preview/2019-10-01-preview/examples/MoveCollections_Create.json
rename to specification/resourcemover/resource-manager/Microsoft.Migrate/preview/2019-10-01-preview/examples/MoveCollections_Create.json
diff --git a/specification/regionmove/resource-manager/Microsoft.Migrate/preview/2019-10-01-preview/examples/MoveCollections_Delete.json b/specification/resourcemover/resource-manager/Microsoft.Migrate/preview/2019-10-01-preview/examples/MoveCollections_Delete.json
similarity index 100%
rename from specification/regionmove/resource-manager/Microsoft.Migrate/preview/2019-10-01-preview/examples/MoveCollections_Delete.json
rename to specification/resourcemover/resource-manager/Microsoft.Migrate/preview/2019-10-01-preview/examples/MoveCollections_Delete.json
diff --git a/specification/regionmove/resource-manager/Microsoft.Migrate/preview/2019-10-01-preview/examples/MoveCollections_InitiateMove.json b/specification/resourcemover/resource-manager/Microsoft.Migrate/preview/2019-10-01-preview/examples/MoveCollections_Discard.json
similarity index 100%
rename from specification/regionmove/resource-manager/Microsoft.Migrate/preview/2019-10-01-preview/examples/MoveCollections_InitiateMove.json
rename to specification/resourcemover/resource-manager/Microsoft.Migrate/preview/2019-10-01-preview/examples/MoveCollections_Discard.json
diff --git a/specification/regionmove/resource-manager/Microsoft.Migrate/preview/2019-10-01-preview/examples/MoveCollections_Get.json b/specification/resourcemover/resource-manager/Microsoft.Migrate/preview/2019-10-01-preview/examples/MoveCollections_Get.json
similarity index 100%
rename from specification/regionmove/resource-manager/Microsoft.Migrate/preview/2019-10-01-preview/examples/MoveCollections_Get.json
rename to specification/resourcemover/resource-manager/Microsoft.Migrate/preview/2019-10-01-preview/examples/MoveCollections_Get.json
diff --git a/specification/regionmove/resource-manager/Microsoft.Migrate/preview/2019-10-01-preview/examples/MoveCollections_Prepare.json b/specification/resourcemover/resource-manager/Microsoft.Migrate/preview/2019-10-01-preview/examples/MoveCollections_InitiateMove.json
similarity index 100%
rename from specification/regionmove/resource-manager/Microsoft.Migrate/preview/2019-10-01-preview/examples/MoveCollections_Prepare.json
rename to specification/resourcemover/resource-manager/Microsoft.Migrate/preview/2019-10-01-preview/examples/MoveCollections_InitiateMove.json
diff --git a/specification/regionmove/resource-manager/Microsoft.Migrate/preview/2019-10-01-preview/examples/MoveCollections_ListMoveCollectionsByResourceGroup.json b/specification/resourcemover/resource-manager/Microsoft.Migrate/preview/2019-10-01-preview/examples/MoveCollections_ListMoveCollectionsByResourceGroup.json
similarity index 100%
rename from specification/regionmove/resource-manager/Microsoft.Migrate/preview/2019-10-01-preview/examples/MoveCollections_ListMoveCollectionsByResourceGroup.json
rename to specification/resourcemover/resource-manager/Microsoft.Migrate/preview/2019-10-01-preview/examples/MoveCollections_ListMoveCollectionsByResourceGroup.json
diff --git a/specification/regionmove/resource-manager/Microsoft.Migrate/preview/2019-10-01-preview/examples/MoveCollections_ListMoveCollectionsBySubscription.json b/specification/resourcemover/resource-manager/Microsoft.Migrate/preview/2019-10-01-preview/examples/MoveCollections_ListMoveCollectionsBySubscription.json
similarity index 100%
rename from specification/regionmove/resource-manager/Microsoft.Migrate/preview/2019-10-01-preview/examples/MoveCollections_ListMoveCollectionsBySubscription.json
rename to specification/resourcemover/resource-manager/Microsoft.Migrate/preview/2019-10-01-preview/examples/MoveCollections_ListMoveCollectionsBySubscription.json
diff --git a/specification/regionmove/resource-manager/Microsoft.Migrate/preview/2019-10-01-preview/examples/MoveCollections_BulkRemove.json b/specification/resourcemover/resource-manager/Microsoft.Migrate/preview/2019-10-01-preview/examples/MoveCollections_Prepare.json
similarity index 77%
rename from specification/regionmove/resource-manager/Microsoft.Migrate/preview/2019-10-01-preview/examples/MoveCollections_BulkRemove.json
rename to specification/resourcemover/resource-manager/Microsoft.Migrate/preview/2019-10-01-preview/examples/MoveCollections_Prepare.json
index 03877882ade2..82d11f9f57bd 100644
--- a/specification/regionmove/resource-manager/Microsoft.Migrate/preview/2019-10-01-preview/examples/MoveCollections_BulkRemove.json
+++ b/specification/resourcemover/resource-manager/Microsoft.Migrate/preview/2019-10-01-preview/examples/MoveCollections_Prepare.json
@@ -4,10 +4,12 @@
     "subscriptionId": "subid",
     "resourceGroupName": "rg1",
     "api-version": "2019-10-01-preview",
-    "validateOnly": false,
-    "moveResources": [
-      "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Migrate/MoveCollections/movecollection1/MoveResources/moveresource1"
-    ]
+    "body": {
+      "validateOnly": false,
+      "moveResources": [
+        "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Migrate/MoveCollections/movecollection1/MoveResources/moveresource1"
+      ]
+    }
   },
   "responses": {
     "200": {
diff --git a/specification/regionmove/resource-manager/Microsoft.Migrate/preview/2019-10-01-preview/examples/MoveCollections_ResolveDependencies.json b/specification/resourcemover/resource-manager/Microsoft.Migrate/preview/2019-10-01-preview/examples/MoveCollections_ResolveDependencies.json
similarity index 100%
rename from specification/regionmove/resource-manager/Microsoft.Migrate/preview/2019-10-01-preview/examples/MoveCollections_ResolveDependencies.json
rename to specification/resourcemover/resource-manager/Microsoft.Migrate/preview/2019-10-01-preview/examples/MoveCollections_ResolveDependencies.json
diff --git a/specification/regionmove/resource-manager/Microsoft.Migrate/preview/2019-10-01-preview/examples/MoveCollections_Update.json b/specification/resourcemover/resource-manager/Microsoft.Migrate/preview/2019-10-01-preview/examples/MoveCollections_Update.json
similarity index 100%
rename from specification/regionmove/resource-manager/Microsoft.Migrate/preview/2019-10-01-preview/examples/MoveCollections_Update.json
rename to specification/resourcemover/resource-manager/Microsoft.Migrate/preview/2019-10-01-preview/examples/MoveCollections_Update.json
diff --git a/specification/regionmove/resource-manager/Microsoft.Migrate/preview/2019-10-01-preview/examples/MoveResources_Create.json b/specification/resourcemover/resource-manager/Microsoft.Migrate/preview/2019-10-01-preview/examples/MoveResources_Create.json
similarity index 100%
rename from specification/regionmove/resource-manager/Microsoft.Migrate/preview/2019-10-01-preview/examples/MoveResources_Create.json
rename to specification/resourcemover/resource-manager/Microsoft.Migrate/preview/2019-10-01-preview/examples/MoveResources_Create.json
diff --git a/specification/regionmove/resource-manager/Microsoft.Migrate/preview/2019-10-01-preview/examples/MoveResources_Delete.json b/specification/resourcemover/resource-manager/Microsoft.Migrate/preview/2019-10-01-preview/examples/MoveResources_Delete.json
similarity index 100%
rename from specification/regionmove/resource-manager/Microsoft.Migrate/preview/2019-10-01-preview/examples/MoveResources_Delete.json
rename to specification/resourcemover/resource-manager/Microsoft.Migrate/preview/2019-10-01-preview/examples/MoveResources_Delete.json
diff --git a/specification/regionmove/resource-manager/Microsoft.Migrate/preview/2019-10-01-preview/examples/MoveResources_Get.json b/specification/resourcemover/resource-manager/Microsoft.Migrate/preview/2019-10-01-preview/examples/MoveResources_Get.json
similarity index 100%
rename from specification/regionmove/resource-manager/Microsoft.Migrate/preview/2019-10-01-preview/examples/MoveResources_Get.json
rename to specification/resourcemover/resource-manager/Microsoft.Migrate/preview/2019-10-01-preview/examples/MoveResources_Get.json
diff --git a/specification/regionmove/resource-manager/Microsoft.Migrate/preview/2019-10-01-preview/examples/MoveResources_List.json b/specification/resourcemover/resource-manager/Microsoft.Migrate/preview/2019-10-01-preview/examples/MoveResources_List.json
similarity index 100%
rename from specification/regionmove/resource-manager/Microsoft.Migrate/preview/2019-10-01-preview/examples/MoveResources_List.json
rename to specification/resourcemover/resource-manager/Microsoft.Migrate/preview/2019-10-01-preview/examples/MoveResources_List.json
diff --git a/specification/regionmove/resource-manager/Microsoft.Migrate/preview/2019-10-01-preview/examples/OperationsDiscovery_Get.json b/specification/resourcemover/resource-manager/Microsoft.Migrate/preview/2019-10-01-preview/examples/OperationsDiscovery_Get.json
similarity index 100%
rename from specification/regionmove/resource-manager/Microsoft.Migrate/preview/2019-10-01-preview/examples/OperationsDiscovery_Get.json
rename to specification/resourcemover/resource-manager/Microsoft.Migrate/preview/2019-10-01-preview/examples/OperationsDiscovery_Get.json
diff --git a/specification/regionmove/resource-manager/Microsoft.Migrate/preview/2019-10-01-preview/examples/UnresolvedDependencies_Get.json b/specification/resourcemover/resource-manager/Microsoft.Migrate/preview/2019-10-01-preview/examples/UnresolvedDependencies_Get.json
similarity index 100%
rename from specification/regionmove/resource-manager/Microsoft.Migrate/preview/2019-10-01-preview/examples/UnresolvedDependencies_Get.json
rename to specification/resourcemover/resource-manager/Microsoft.Migrate/preview/2019-10-01-preview/examples/UnresolvedDependencies_Get.json
diff --git a/specification/regionmove/resource-manager/Microsoft.Migrate/preview/2019-10-01-preview/regionmovecollection.json b/specification/resourcemover/resource-manager/Microsoft.Migrate/preview/2019-10-01-preview/resourcemovercollection.json
similarity index 99%
rename from specification/regionmove/resource-manager/Microsoft.Migrate/preview/2019-10-01-preview/regionmovecollection.json
rename to specification/resourcemover/resource-manager/Microsoft.Migrate/preview/2019-10-01-preview/resourcemovercollection.json
index 380c436e6d19..90496e1c0ba0 100644
--- a/specification/regionmove/resource-manager/Microsoft.Migrate/preview/2019-10-01-preview/regionmovecollection.json
+++ b/specification/resourcemover/resource-manager/Microsoft.Migrate/preview/2019-10-01-preview/resourcemovercollection.json
@@ -1610,6 +1610,10 @@
           "description": "Gets or sets Name of the API.\r\nThe name of the operation being performed on this particular object. It should\r\nmatch the action name that appears in RBAC / the event service.\r\nExamples of operations include:\r\n* Microsoft.Compute/virtualMachine/capture/action\r\n* Microsoft.Compute/virtualMachine/restart/action\r\n* Microsoft.Compute/virtualMachine/write\r\n* Microsoft.Compute/virtualMachine/read\r\n* Microsoft.Compute/virtualMachine/delete\r\nEach action should include, in order:\r\n(1) Resource Provider Namespace\r\n(2) Type hierarchy for which the action applies (e.g. server/databases for a SQL\r\nAzure database)\r\n(3) Read, Write, Action or Delete indicating which type applies. If it is a PUT/PATCH\r\non a collection or named value, Write should be used.\r\nIf it is a GET, Read should be used. If it is a DELETE, Delete should be used. If it\r\nis a POST, Action should be used.\r\nAs a note: all resource providers would need to include the \"{Resource Provider\r\nNamespace}/register/action\" operation in their response.\r\nThis API is used to register for their service, and should include details about the\r\noperation (e.g. a localized name for the resource provider + any special\r\nconsiderations like PII release).",
           "type": "string"
         },
+        "isDataAction": {
+          "description": "Indicates whether the operation is a data action",
+          "type": "boolean"
+        },
         "display": {
           "$ref": "#/definitions/Display"
         },
diff --git a/specification/regionmove/resource-manager/readme.azureresourceschema.md b/specification/resourcemover/resource-manager/readme.azureresourceschema.md
similarity index 89%
rename from specification/regionmove/resource-manager/readme.azureresourceschema.md
rename to specification/resourcemover/resource-manager/readme.azureresourceschema.md
index ea58f5848a08..7c95e06ea160 100644
--- a/specification/regionmove/resource-manager/readme.azureresourceschema.md
+++ b/specification/resourcemover/resource-manager/readme.azureresourceschema.md
@@ -19,6 +19,6 @@ output-folder: $(azureresourceschema-folder)/schemas
 
 # all the input files in this apiVersion
 input-file:
-  - Microsoft.Migrate/preview/2019-10-01-preview/regionmovecollection.json
+  - Microsoft.Migrate/preview/2019-10-01-preview/resourcemovercollection.json
 
 ```
diff --git a/specification/regionmove/resource-manager/readme.csharp.md b/specification/resourcemover/resource-manager/readme.csharp.md
similarity index 100%
rename from specification/regionmove/resource-manager/readme.csharp.md
rename to specification/resourcemover/resource-manager/readme.csharp.md
diff --git a/specification/regionmove/resource-manager/readme.go.md b/specification/resourcemover/resource-manager/readme.go.md
similarity index 100%
rename from specification/regionmove/resource-manager/readme.go.md
rename to specification/resourcemover/resource-manager/readme.go.md
diff --git a/specification/regionmove/resource-manager/readme.md b/specification/resourcemover/resource-manager/readme.md
similarity index 96%
rename from specification/regionmove/resource-manager/readme.md
rename to specification/resourcemover/resource-manager/readme.md
index 3cd4a59bfc1b..4b90d3d5e982 100644
--- a/specification/regionmove/resource-manager/readme.md
+++ b/specification/resourcemover/resource-manager/readme.md
@@ -35,7 +35,7 @@ These settings apply only when `--tag=package-2019-10-01-preview` is specified o
 
 ```yaml $(tag) == 'package-2019-10-01-preview'
 input-file:
-  - Microsoft.Migrate/preview/2019-10-01-preview/regionmovecollection.json
+  - Microsoft.Migrate/preview/2019-10-01-preview/resourcemovercollection.json
 ```
 
 ---
diff --git a/specification/regionmove/resource-manager/readme.python.md b/specification/resourcemover/resource-manager/readme.python.md
similarity index 100%
rename from specification/regionmove/resource-manager/readme.python.md
rename to specification/resourcemover/resource-manager/readme.python.md
diff --git a/specification/regionmove/resource-manager/readme.ruby.md b/specification/resourcemover/resource-manager/readme.ruby.md
similarity index 100%
rename from specification/regionmove/resource-manager/readme.ruby.md
rename to specification/resourcemover/resource-manager/readme.ruby.md
diff --git a/specification/regionmove/resource-manager/readme.typescript.md b/specification/resourcemover/resource-manager/readme.typescript.md
similarity index 100%
rename from specification/regionmove/resource-manager/readme.typescript.md
rename to specification/resourcemover/resource-manager/readme.typescript.md
diff --git a/specification/resources/resource-manager/Microsoft.Resources/preview/2019-06-01-preview/templateSpecs.json b/specification/resources/resource-manager/Microsoft.Resources/preview/2019-06-01-preview/templateSpecs.json
index dd273dcb47bf..e275be2dd62a 100644
--- a/specification/resources/resource-manager/Microsoft.Resources/preview/2019-06-01-preview/templateSpecs.json
+++ b/specification/resources/resource-manager/Microsoft.Resources/preview/2019-06-01-preview/templateSpecs.json
@@ -159,6 +159,9 @@
           {
             "$ref": "#/parameters/TemplateSpecNameParameter"
           },
+          {
+            "$ref": "#/parameters/TemplateSpecExpandParameter"
+          },
           {
             "$ref": "#/parameters/ApiVersionParameter"
           }
@@ -235,6 +238,9 @@
           {
             "$ref": "#/parameters/SubscriptionIdParameter"
           },
+          {
+            "$ref": "#/parameters/TemplateSpecExpandParameter"
+          },
           {
             "$ref": "#/parameters/ApiVersionParameter"
           }
@@ -277,6 +283,9 @@
           {
             "$ref": "#/parameters/ResourceGroupNameParameter"
           },
+          {
+            "$ref": "#/parameters/TemplateSpecExpandParameter"
+          },
           {
             "$ref": "#/parameters/ApiVersionParameter"
           }
@@ -591,6 +600,14 @@
           "type": "string",
           "maxLength": 64,
           "description": "Template Spec display name."
+        },
+        "versions": {
+          "type": "object",
+          "readOnly": true,
+          "description": "High-level information about the versions within this Template Spec. The keys are the version names. Only populated if the $expand query parameter is set to 'versions'.",
+          "additionalProperties": {
+            "$ref": "#/definitions/TemplateSpecVersionInfo"
+          }
         }
       }
     },
@@ -800,6 +817,29 @@
         }
       ]
     },
+    "TemplateSpecVersionInfo": {
+      "type": "object",
+      "description": "High-level information about a Template Spec version.",
+      "properties": {
+        "description": {
+          "type": "string",
+          "readOnly": true,
+          "description": "Template Spec version description."
+        },
+        "timeCreated": {
+          "type": "string",
+          "readOnly": true,
+          "format": "date-time",
+          "description": "The timestamp of when the version was created."
+        },
+        "timeModified": {
+          "type": "string",
+          "readOnly": true,
+          "format": "date-time",
+          "description": "The timestamp of when the version was last modified."
+        }
+      }
+    },
     "TemplateSpecsError": {
       "properties": {
         "error": {
@@ -851,6 +891,27 @@
       "maxLength": 90,
       "x-ms-parameter-location": "method"
     },
+    "TemplateSpecExpandParameter": {
+      "name": "$expand",
+      "in": "query",
+      "required": false,
+      "type": "string",
+      "description": "Allows for expansion of additional Template Spec details in the response. Optional.",
+      "x-ms-parameter-location": "method",
+      "enum": [
+        "versions"
+      ],
+      "x-ms-enum": {
+        "name": "TemplateSpecExpandKind",
+        "modelAsString": true,
+        "values": [
+          {
+            "value": "versions",
+            "description": "Includes version information with the Template Spec."
+          }
+        ]
+      }
+    },
     "ApiVersionParameter": {
       "name": "api-version",
       "in": "query",
diff --git a/specification/resources/resource-manager/Microsoft.Resources/preview/2020-10-01-preview/examples/TemplateSpecVersionsCreate.json b/specification/resources/resource-manager/Microsoft.Resources/preview/2020-10-01-preview/examples/TemplateSpecVersionsCreate.json
deleted file mode 100644
index 8871f54c9fc0..000000000000
--- a/specification/resources/resource-manager/Microsoft.Resources/preview/2020-10-01-preview/examples/TemplateSpecVersionsCreate.json
+++ /dev/null
@@ -1,73 +0,0 @@
-{
-  "parameters": {
-    "api-version": "2020-10-01-preview",
-    "subscriptionId": "00000000-0000-0000-0000-000000000000",
-    "resourceGroupName": "templateSpecRG",
-    "templateSpecName": "simpleTemplateSpec",
-    "templateSpecVersion": "v1.0",
-    "templateSpecVersionModel": {
-      "location": "eastus",
-      "properties": {
-        "description": "This is version v1.0 of our template content",
-        "template": {
-          "$schema": "http://schema.management.azure.com/schemas/2015-01-01/deploymentTemplate.json#",
-          "contentVersion": "1.0.0.0",
-          "parameters": {},
-          "resources": []
-        }
-      }
-    }
-  },
-  "responses": {
-    "200": {
-      "body": {
-        "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/templateSpecRG/providers/Microsoft.Resources/templateSpecs/simpleTemplateSpec/versions/v1.0",
-        "type": "Microsoft.Resources/templateSpecs/versions",
-        "name": "v1.0",
-        "location": "eastus",
-        "systemData": {
-          "createdBy": "string",
-          "createdByType": "Application",
-          "createdAt": "2020-02-01T01:01:01.1075056Z",
-          "lastModifiedBy": "string",
-          "lastModifiedByType": "Application",
-          "lastModifiedAt": "2020-02-02T02:03:01.1974346Z"
-        },
-        "properties": {
-          "description": "This is version v1.0 of our template content",
-          "template": {
-            "$schema": "http://schema.management.azure.com/schemas/2015-01-01/deploymentTemplate.json#",
-            "contentVersion": "1.0.0.0",
-            "parameters": {},
-            "resources": []
-          }
-        }
-      }
-    },
-    "201": {
-      "body": {
-        "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/templateSpecRG/providers/Microsoft.Resources/templateSpecs/simpleTemplateSpec/versions/v1.0",
-        "type": "Microsoft.Resources/templateSpecs/versions",
-        "name": "v1.0",
-        "location": "eastus",
-        "systemData": {
-          "createdBy": "string",
-          "createdByType": "Application",
-          "createdAt": "2020-02-01T01:01:01.1075056Z",
-          "lastModifiedBy": "string",
-          "lastModifiedByType": "Application",
-          "lastModifiedAt": "2020-02-01T01:01:01.1075056Z"
-        },
-        "properties": {
-          "description": "This is version v1.0 of our template content",
-          "template": {
-            "$schema": "http://schema.management.azure.com/schemas/2015-01-01/deploymentTemplate.json#",
-            "contentVersion": "1.0.0.0",
-            "parameters": {},
-            "resources": []
-          }
-        }
-      }
-    }
-  }
-}
diff --git a/specification/resources/resource-manager/Microsoft.Resources/preview/2020-10-01-preview/examples/TemplateSpecVersionsDelete.json b/specification/resources/resource-manager/Microsoft.Resources/preview/2020-10-01-preview/examples/TemplateSpecVersionsDelete.json
deleted file mode 100644
index 944606a6e958..000000000000
--- a/specification/resources/resource-manager/Microsoft.Resources/preview/2020-10-01-preview/examples/TemplateSpecVersionsDelete.json
+++ /dev/null
@@ -1,13 +0,0 @@
-{
-  "parameters": {
-    "api-version": "2020-10-01-preview",
-    "subscriptionId": "00000000-0000-0000-0000-000000000000",
-    "resourceGroupName": "templateSpecRG",
-    "templateSpecName": "simpleTemplateSpec",
-    "templateSpecVersion": "v1.0"
-  },
-  "responses": {
-    "200": {},
-    "204": {}
-  }
-}
diff --git a/specification/resources/resource-manager/Microsoft.Resources/preview/2020-10-01-preview/examples/TemplateSpecVersionsGet.json b/specification/resources/resource-manager/Microsoft.Resources/preview/2020-10-01-preview/examples/TemplateSpecVersionsGet.json
deleted file mode 100644
index 358d16cbb79e..000000000000
--- a/specification/resources/resource-manager/Microsoft.Resources/preview/2020-10-01-preview/examples/TemplateSpecVersionsGet.json
+++ /dev/null
@@ -1,36 +0,0 @@
-{
-  "parameters": {
-    "api-version": "2020-10-01-preview",
-    "subscriptionId": "00000000-0000-0000-0000-000000000000",
-    "resourceGroupName": "templateSpecRG",
-    "templateSpecName": "simpleTemplateSpec",
-    "templateSpecVersion": "v1.0"
-  },
-  "responses": {
-    "200": {
-      "body": {
-        "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/templateSpecRG/providers/Microsoft.Resources/templateSpecs/simpleTemplateSpec/versions/v1.0",
-        "type": "Microsoft.Resources/templateSpecs/versions",
-        "name": "v1.0",
-        "location": "eastus",
-        "systemData": {
-          "createdBy": "string",
-          "createdByType": "Application",
-          "createdAt": "2020-02-01T01:01:01.1075056Z",
-          "lastModifiedBy": "string",
-          "lastModifiedByType": "Application",
-          "lastModifiedAt": "2020-02-02T02:03:01.1974346Z"
-        },
-        "properties": {
-          "description": "This is version v1.0 of our template content",
-          "template": {
-            "$schema": "http://schema.management.azure.com/schemas/2015-01-01/deploymentTemplate.json#",
-            "contentVersion": "1.0.0.0",
-            "parameters": {},
-            "resources": []
-          }
-        }
-      }
-    }
-  }
-}
diff --git a/specification/resources/resource-manager/Microsoft.Resources/preview/2020-10-01-preview/examples/TemplateSpecVersionsList.json b/specification/resources/resource-manager/Microsoft.Resources/preview/2020-10-01-preview/examples/TemplateSpecVersionsList.json
deleted file mode 100644
index 78a7dfff1101..000000000000
--- a/specification/resources/resource-manager/Microsoft.Resources/preview/2020-10-01-preview/examples/TemplateSpecVersionsList.json
+++ /dev/null
@@ -1,50 +0,0 @@
-{
-  "parameters": {
-    "api-version": "2020-10-01-preview",
-    "subscriptionId": "00000000-0000-0000-0000-000000000000",
-    "resourceGroupName": "templateSpecRG",
-    "templateSpecName": "simpleTemplateSpec"
-  },
-  "responses": {
-    "200": {
-      "body": {
-        "value": [
-          {
-            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/templateSpecRG/providers/Microsoft.Resources/templateSpecs/simpleTemplateSpec/versions/v1.0",
-            "type": "Microsoft.Resources/templateSpecs/versions",
-            "name": "v1.0",
-            "location": "eastus",
-            "systemData": {
-              "createdBy": "string",
-              "createdByType": "Application",
-              "createdAt": "2020-02-01T01:01:01.1075056Z",
-              "lastModifiedBy": "string",
-              "lastModifiedByType": "Application",
-              "lastModifiedAt": "2020-02-02T02:03:01.1974346Z"
-            },
-            "properties": {
-              "description": "This is version v1.0"
-            }
-          },
-          {
-            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/templateSpecRG/providers/Microsoft.Resources/templateSpecs/simpleTemplateSpec/versions/v2.0",
-            "type": "Microsoft.Resources/templateSpecs/versions",
-            "name": "v2.0",
-            "location": "eastus",
-            "systemData": {
-              "createdBy": "string",
-              "createdByType": "Application",
-              "createdAt": "2020-02-03T01:01:01.1075056Z",
-              "lastModifiedBy": "string",
-              "lastModifiedByType": "Application",
-              "lastModifiedAt": "2020-02-04T02:03:01.1974346Z"
-            },
-            "properties": {
-              "description": "This is another version (v2.0)"
-            }
-          }
-        ]
-      }
-    }
-  }
-}
diff --git a/specification/resources/resource-manager/Microsoft.Resources/preview/2020-10-01-preview/examples/TemplateSpecVersionsPatch.json b/specification/resources/resource-manager/Microsoft.Resources/preview/2020-10-01-preview/examples/TemplateSpecVersionsPatch.json
deleted file mode 100644
index 2da272aeb19c..000000000000
--- a/specification/resources/resource-manager/Microsoft.Resources/preview/2020-10-01-preview/examples/TemplateSpecVersionsPatch.json
+++ /dev/null
@@ -1,44 +0,0 @@
-{
-  "parameters": {
-    "api-version": "2020-10-01-preview",
-    "subscriptionId": "00000000-0000-0000-0000-000000000000",
-    "resourceGroupName": "templateSpecRG",
-    "templateSpecName": "simpleTemplateSpec",
-    "templateSpecVersion": "v1.0",
-    "templateSpecVersionUpdateModel": {
-      "tags": {
-        "myTag": "My Value"
-      }
-    }
-  },
-  "responses": {
-    "200": {
-      "body": {
-        "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/templateSpecRG/providers/Microsoft.Resources/templateSpecs/simpleTemplateSpec/versions/v1.0",
-        "type": "Microsoft.Resources/templateSpecs/versions",
-        "name": "v1.0",
-        "location": "eastus",
-        "systemData": {
-          "createdBy": "string",
-          "createdByType": "Application",
-          "createdAt": "2020-02-01T01:01:01.1075056Z",
-          "lastModifiedBy": "string",
-          "lastModifiedByType": "Application",
-          "lastModifiedAt": "2020-02-02T02:03:01.1974346Z"
-        },
-        "properties": {
-          "description": "This is version v1.0 of our template content",
-          "template": {
-            "$schema": "http://schema.management.azure.com/schemas/2015-01-01/deploymentTemplate.json#",
-            "contentVersion": "1.0.0.0",
-            "parameters": {},
-            "resources": []
-          }
-        },
-        "tags": {
-          "myTag": "My Value"
-        }
-      }
-    }
-  }
-}
diff --git a/specification/resources/resource-manager/Microsoft.Resources/preview/2020-10-01-preview/examples/TemplateSpecsCreate.json b/specification/resources/resource-manager/Microsoft.Resources/preview/2020-10-01-preview/examples/TemplateSpecsCreate.json
deleted file mode 100644
index c08c0ac3d1d6..000000000000
--- a/specification/resources/resource-manager/Microsoft.Resources/preview/2020-10-01-preview/examples/TemplateSpecsCreate.json
+++ /dev/null
@@ -1,54 +0,0 @@
-{
-  "parameters": {
-    "api-version": "2020-10-01-preview",
-    "subscriptionId": "00000000-0000-0000-0000-000000000000",
-    "resourceGroupName": "templateSpecRG",
-    "templateSpecName": "simpleTemplateSpec",
-    "templateSpec": {
-      "location": "eastus",
-      "properties": {
-        "description": "A very simple Template Spec"
-      }
-    }
-  },
-  "responses": {
-    "200": {
-      "body": {
-        "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/templateSpecRG/providers/Microsoft.Resources/templateSpecs/simpleTemplateSpec",
-        "type": "Microsoft.Resources/templateSpecs",
-        "name": "simpleTemplateSpec",
-        "location": "eastus",
-        "systemData": {
-          "createdBy": "string",
-          "createdByType": "Application",
-          "createdAt": "2020-02-01T01:01:01.1075056Z",
-          "lastModifiedBy": "string",
-          "lastModifiedByType": "Application",
-          "lastModifiedAt": "2020-02-01T01:01:01.1075056Z"
-        },
-        "properties": {
-          "description": "A very simple Template Spec"
-        }
-      }
-    },
-    "201": {
-      "body": {
-        "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/templateSpecRG/providers/Microsoft.Resources/templateSpecs/simpleTemplateSpec",
-        "type": "Microsoft.Resources/templateSpecs",
-        "name": "simpleTemplateSpec",
-        "location": "eastus",
-        "systemData": {
-          "createdBy": "string",
-          "createdByType": "Application",
-          "createdAt": "2020-02-01T01:01:01.1075056Z",
-          "lastModifiedBy": "string",
-          "lastModifiedByType": "Application",
-          "lastModifiedAt": "2020-02-02T02:03:01.1974346Z"
-        },
-        "properties": {
-          "description": "A very simple Template Spec"
-        }
-      }
-    }
-  }
-}
diff --git a/specification/resources/resource-manager/Microsoft.Resources/preview/2020-10-01-preview/examples/TemplateSpecsDelete.json b/specification/resources/resource-manager/Microsoft.Resources/preview/2020-10-01-preview/examples/TemplateSpecsDelete.json
deleted file mode 100644
index d8bbbb09f471..000000000000
--- a/specification/resources/resource-manager/Microsoft.Resources/preview/2020-10-01-preview/examples/TemplateSpecsDelete.json
+++ /dev/null
@@ -1,12 +0,0 @@
-{
-  "parameters": {
-    "api-version": "2020-10-01-preview",
-    "subscriptionId": "00000000-0000-0000-0000-000000000000",
-    "resourceGroupName": "templateSpecRG",
-    "templateSpecName": "simpleTemplateSpec"
-  },
-  "responses": {
-    "200": {},
-    "204": {}
-  }
-}
diff --git a/specification/resources/resource-manager/Microsoft.Resources/preview/2020-10-01-preview/examples/TemplateSpecsGet.json b/specification/resources/resource-manager/Microsoft.Resources/preview/2020-10-01-preview/examples/TemplateSpecsGet.json
deleted file mode 100644
index 4a712621bde8..000000000000
--- a/specification/resources/resource-manager/Microsoft.Resources/preview/2020-10-01-preview/examples/TemplateSpecsGet.json
+++ /dev/null
@@ -1,29 +0,0 @@
-{
-  "parameters": {
-    "api-version": "2020-10-01-preview",
-    "subscriptionId": "00000000-0000-0000-0000-000000000000",
-    "resourceGroupName": "templateSpecRG",
-    "templateSpecName": "simpleTemplateSpec"
-  },
-  "responses": {
-    "200": {
-      "body": {
-        "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/templateSpecRG/providers/Microsoft.Resources/templateSpecs/simpleTemplateSpec",
-        "type": "Microsoft.Resources/templateSpecs",
-        "name": "simpleTemplateSpec",
-        "location": "eastus",
-        "systemData": {
-          "createdBy": "string",
-          "createdByType": "Application",
-          "createdAt": "2020-02-01T01:01:01.1075056Z",
-          "lastModifiedBy": "string",
-          "lastModifiedByType": "Application",
-          "lastModifiedAt": "2020-02-02T02:03:01.1974346Z"
-        },
-        "properties": {
-          "description": "A very simple Template Spec"
-        }
-      }
-    }
-  }
-}
diff --git a/specification/resources/resource-manager/Microsoft.Resources/preview/2020-10-01-preview/examples/TemplateSpecsListByResourceGroup.json b/specification/resources/resource-manager/Microsoft.Resources/preview/2020-10-01-preview/examples/TemplateSpecsListByResourceGroup.json
deleted file mode 100644
index 0c700fbcf888..000000000000
--- a/specification/resources/resource-manager/Microsoft.Resources/preview/2020-10-01-preview/examples/TemplateSpecsListByResourceGroup.json
+++ /dev/null
@@ -1,49 +0,0 @@
-{
-  "parameters": {
-    "api-version": "2020-10-01-preview",
-    "subscriptionId": "00000000-0000-0000-0000-000000000000",
-    "resourceGroupName": "templateSpecRG"
-  },
-  "responses": {
-    "200": {
-      "body": {
-        "value": [
-          {
-            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/templateSpecRG/providers/Microsoft.Resources/templateSpecs/simpleTemplateSpec",
-            "type": "Microsoft.Resources/templateSpecs",
-            "name": "simpleTemplateSpec",
-            "location": "eastus",
-            "systemData": {
-              "createdBy": "string",
-              "createdByType": "Application",
-              "createdAt": "2020-02-01T01:01:01.1075056Z",
-              "lastModifiedBy": "string",
-              "lastModifiedByType": "Application",
-              "lastModifiedAt": "2020-02-02T02:03:01.1974346Z"
-            },
-            "properties": {
-              "description": "A very simple Template Spec"
-            }
-          },
-          {
-            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/templateSpecRG/providers/Microsoft.Resources/templateSpecs/anotherSimpleTemplateSpec",
-            "type": "Microsoft.Resources/templateSpecs",
-            "name": "anotherSimpleTemplateSpec",
-            "location": "westus",
-            "systemData": {
-              "createdBy": "string",
-              "createdByType": "Application",
-              "createdAt": "2020-02-02T01:01:01.1075056Z",
-              "lastModifiedBy": "string",
-              "lastModifiedByType": "Application",
-              "lastModifiedAt": "2020-02-03T02:03:01.1974346Z"
-            },
-            "properties": {
-              "description": "Another very simple Template Spec"
-            }
-          }
-        ]
-      }
-    }
-  }
-}
diff --git a/specification/resources/resource-manager/Microsoft.Resources/preview/2020-10-01-preview/examples/TemplateSpecsListBySubscription.json b/specification/resources/resource-manager/Microsoft.Resources/preview/2020-10-01-preview/examples/TemplateSpecsListBySubscription.json
deleted file mode 100644
index 7509ac9c90fc..000000000000
--- a/specification/resources/resource-manager/Microsoft.Resources/preview/2020-10-01-preview/examples/TemplateSpecsListBySubscription.json
+++ /dev/null
@@ -1,48 +0,0 @@
-{
-  "parameters": {
-    "api-version": "2020-10-01-preview",
-    "subscriptionId": "00000000-0000-0000-0000-000000000000"
-  },
-  "responses": {
-    "200": {
-      "body": {
-        "value": [
-          {
-            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/templateSpecRG/providers/Microsoft.Resources/templateSpecs/simpleTemplateSpec",
-            "type": "Microsoft.Resources/templateSpecs",
-            "name": "simpleTemplateSpec",
-            "location": "eastus",
-            "systemData": {
-              "createdBy": "string",
-              "createdByType": "Application",
-              "createdAt": "2020-02-01T01:01:01.1075056Z",
-              "lastModifiedBy": "string",
-              "lastModifiedByType": "Application",
-              "lastModifiedAt": "2020-02-02T02:03:01.1974346Z"
-            },
-            "properties": {
-              "description": "A very simple Template Spec"
-            }
-          },
-          {
-            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/templateSpecRG2/providers/Microsoft.Resources/templateSpecs/anotherSimpleTemplateSpec",
-            "type": "Microsoft.Resources/templateSpecs",
-            "name": "anotherSimpleTemplateSpec",
-            "location": "westus",
-            "systemData": {
-              "createdBy": "string",
-              "createdByType": "Application",
-              "createdAt": "2020-02-02T01:01:01.1075056Z",
-              "lastModifiedBy": "string",
-              "lastModifiedByType": "Application",
-              "lastModifiedAt": "2020-02-03T02:03:01.1974346Z"
-            },
-            "properties": {
-              "description": "Another very simple Template Spec"
-            }
-          }
-        ]
-      }
-    }
-  }
-}
diff --git a/specification/resources/resource-manager/Microsoft.Resources/preview/2020-10-01-preview/examples/TemplateSpecsPatch.json b/specification/resources/resource-manager/Microsoft.Resources/preview/2020-10-01-preview/examples/TemplateSpecsPatch.json
deleted file mode 100644
index 94593a2913d3..000000000000
--- a/specification/resources/resource-manager/Microsoft.Resources/preview/2020-10-01-preview/examples/TemplateSpecsPatch.json
+++ /dev/null
@@ -1,37 +0,0 @@
-{
-  "parameters": {
-    "api-version": "2020-10-01-preview",
-    "subscriptionId": "00000000-0000-0000-0000-000000000000",
-    "resourceGroupName": "templateSpecRG",
-    "templateSpecName": "simpleTemplateSpec",
-    "templateSpec": {
-      "tags": {
-        "myTag": "My Value"
-      }
-    }
-  },
-  "responses": {
-    "200": {
-      "body": {
-        "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/templateSpecRG/providers/Microsoft.Resources/templateSpecs/simpleTemplateSpec",
-        "type": "Microsoft.Resources/templateSpecs",
-        "name": "simpleTemplateSpec",
-        "location": "eastus",
-        "systemData": {
-          "createdBy": "string",
-          "createdByType": "Application",
-          "createdAt": "2020-02-01T01:01:01.1075056Z",
-          "lastModifiedBy": "string",
-          "lastModifiedByType": "Application",
-          "lastModifiedAt": "2020-02-02T02:03:01.1974346Z"
-        },
-        "properties": {
-          "description": "A very simple Template Spec"
-        },
-        "tags": {
-          "myTag": "My Value"
-        }
-      }
-    }
-  }
-}
diff --git a/specification/resources/resource-manager/Microsoft.Resources/preview/2020-10-01-preview/templateSpecs.json b/specification/resources/resource-manager/Microsoft.Resources/preview/2020-10-01-preview/templateSpecs.json
deleted file mode 100644
index ae2b1b39d302..000000000000
--- a/specification/resources/resource-manager/Microsoft.Resources/preview/2020-10-01-preview/templateSpecs.json
+++ /dev/null
@@ -1,867 +0,0 @@
-{
-  "swagger": "2.0",
-  "info": {
-    "title": "TemplateSpecsClient",
-    "description": "The APIs listed in this specification can be used to manage Template Spec resources through the Azure Resource Manager.",
-    "version": "2020-10-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.Resources/templateSpecs/{templateSpecName}": {
-      "put": {
-        "tags": [
-          "TemplateSpecs"
-        ],
-        "operationId": "TemplateSpecs_CreateOrUpdate",
-        "description": "Creates or updates a Template Spec.",
-        "x-ms-examples": {
-          "TemplateSpecsCreateUpdate": {
-            "$ref": "./examples/TemplateSpecsCreate.json"
-          }
-        },
-        "parameters": [
-          {
-            "$ref": "#/parameters/SubscriptionIdParameter"
-          },
-          {
-            "$ref": "#/parameters/ResourceGroupNameParameter"
-          },
-          {
-            "$ref": "#/parameters/TemplateSpecNameParameter"
-          },
-          {
-            "$ref": "#/parameters/ApiVersionParameter"
-          },
-          {
-            "name": "templateSpec",
-            "in": "body",
-            "required": true,
-            "schema": {
-              "$ref": "#/definitions/TemplateSpec"
-            },
-            "description": "Template Spec supplied to the operation."
-          }
-        ],
-        "responses": {
-          "200": {
-            "description": "OK - The Template Spec update request has succeeded.",
-            "schema": {
-              "$ref": "#/definitions/TemplateSpec"
-            }
-          },
-          "201": {
-            "description": "Template Spec created.",
-            "schema": {
-              "$ref": "#/definitions/TemplateSpec"
-            }
-          },
-          "default": {
-            "description": "Error response describing why the operation failed.",
-            "schema": {
-              "$ref": "#/definitions/TemplateSpecsError"
-            }
-          }
-        }
-      },
-      "patch": {
-        "tags": [
-          "TemplateSpecs"
-        ],
-        "operationId": "TemplateSpecs_Update",
-        "description": "Updates Template Spec tags with specified values.",
-        "x-ms-examples": {
-          "TemplateSpecsPatch": {
-            "$ref": "./examples/TemplateSpecsPatch.json"
-          }
-        },
-        "parameters": [
-          {
-            "$ref": "#/parameters/SubscriptionIdParameter"
-          },
-          {
-            "$ref": "#/parameters/ResourceGroupNameParameter"
-          },
-          {
-            "$ref": "#/parameters/TemplateSpecNameParameter"
-          },
-          {
-            "$ref": "#/parameters/ApiVersionParameter"
-          },
-          {
-            "name": "templateSpec",
-            "in": "body",
-            "schema": {
-              "$ref": "#/definitions/TemplateSpecUpdateModel"
-            },
-            "description": "Template Spec resource with the tags to be updated."
-          }
-        ],
-        "responses": {
-          "200": {
-            "description": "OK -- Template Spec tags are updated.",
-            "schema": {
-              "$ref": "#/definitions/TemplateSpec"
-            }
-          },
-          "default": {
-            "description": "Error response describing why the operation failed.",
-            "schema": {
-              "$ref": "#/definitions/TemplateSpecsError"
-            }
-          }
-        }
-      },
-      "get": {
-        "tags": [
-          "TemplateSpecs"
-        ],
-        "operationId": "TemplateSpecs_Get",
-        "description": "Gets a Template Spec with a given name.",
-        "x-ms-examples": {
-          "TemplateSpecsGet": {
-            "$ref": "./examples/TemplateSpecsGet.json"
-          }
-        },
-        "parameters": [
-          {
-            "$ref": "#/parameters/SubscriptionIdParameter"
-          },
-          {
-            "$ref": "#/parameters/ResourceGroupNameParameter"
-          },
-          {
-            "$ref": "#/parameters/TemplateSpecNameParameter"
-          },
-          {
-            "$ref": "#/parameters/ApiVersionParameter"
-          }
-        ],
-        "responses": {
-          "200": {
-            "description": "OK - Returns information about the Template Spec.",
-            "schema": {
-              "$ref": "#/definitions/TemplateSpec"
-            }
-          },
-          "default": {
-            "description": "Error response describing why the operation failed.",
-            "schema": {
-              "$ref": "#/definitions/TemplateSpecsError"
-            }
-          }
-        }
-      },
-      "delete": {
-        "tags": [
-          "TemplateSpecs"
-        ],
-        "operationId": "TemplateSpecs_Delete",
-        "description": "Deletes a Template Spec by name. When operation completes, status code 200 returned without content.",
-        "x-ms-examples": {
-          "TemplateSpecsDelete": {
-            "$ref": "./examples/TemplateSpecsDelete.json"
-          }
-        },
-        "parameters": [
-          {
-            "$ref": "#/parameters/SubscriptionIdParameter"
-          },
-          {
-            "$ref": "#/parameters/ResourceGroupNameParameter"
-          },
-          {
-            "$ref": "#/parameters/TemplateSpecNameParameter"
-          },
-          {
-            "$ref": "#/parameters/ApiVersionParameter"
-          }
-        ],
-        "responses": {
-          "200": {
-            "description": "OK - Template Spec deleted."
-          },
-          "204": {
-            "description": "Template Spec does not exist."
-          },
-          "default": {
-            "description": "Error response describing why the operation failed.",
-            "schema": {
-              "$ref": "#/definitions/TemplateSpecsError"
-            }
-          }
-        }
-      }
-    },
-    "/subscriptions/{subscriptionId}/providers/Microsoft.Resources/templateSpecs/": {
-      "get": {
-        "tags": [
-          "TemplateSpecs"
-        ],
-        "operationId": "TemplateSpecs_ListBySubscription",
-        "description": "Lists all the Template Specs within the specified subscriptions.",
-        "x-ms-examples": {
-          "TemplatesSpecsListBySubscription": {
-            "$ref": "./examples/TemplateSpecsListBySubscription.json"
-          }
-        },
-        "parameters": [
-          {
-            "$ref": "#/parameters/SubscriptionIdParameter"
-          },
-          {
-            "$ref": "#/parameters/ApiVersionParameter"
-          }
-        ],
-        "responses": {
-          "200": {
-            "description": "OK - Returns an array of Template Specs.",
-            "schema": {
-              "$ref": "#/definitions/TemplateSpecsListResult"
-            }
-          },
-          "default": {
-            "description": "Error response describing why the operation failed.",
-            "schema": {
-              "$ref": "#/definitions/TemplateSpecsError"
-            }
-          }
-        },
-        "x-ms-pageable": {
-          "nextLinkName": "nextLink"
-        }
-      }
-    },
-    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Resources/templateSpecs/": {
-      "get": {
-        "tags": [
-          "TemplateSpecs"
-        ],
-        "operationId": "TemplateSpecs_ListByResourceGroup",
-        "description": "Lists all the Template Specs within the specified resource group.",
-        "x-ms-examples": {
-          "TemplateSpecsListByResourceGroup": {
-            "$ref": "./examples/TemplateSpecsListByResourceGroup.json"
-          }
-        },
-        "parameters": [
-          {
-            "$ref": "#/parameters/SubscriptionIdParameter"
-          },
-          {
-            "$ref": "#/parameters/ResourceGroupNameParameter"
-          },
-          {
-            "$ref": "#/parameters/ApiVersionParameter"
-          }
-        ],
-        "responses": {
-          "200": {
-            "description": "OK - Returns an array of Template Specs.",
-            "schema": {
-              "$ref": "#/definitions/TemplateSpecsListResult"
-            }
-          },
-          "default": {
-            "description": "Error response describing why the operation failed.",
-            "schema": {
-              "$ref": "#/definitions/TemplateSpecsError"
-            }
-          }
-        },
-        "x-ms-pageable": {
-          "nextLinkName": "nextLink"
-        }
-      }
-    },
-    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Resources/templateSpecs/{templateSpecName}/versions/{templateSpecVersion}": {
-      "put": {
-        "tags": [
-          "TemplateSpecVersions"
-        ],
-        "operationId": "TemplateSpecVersions_CreateOrUpdate",
-        "description": "Creates or updates a Template Spec version.",
-        "x-ms-examples": {
-          "TemplateSpecVersionsCreateUpdate": {
-            "$ref": "./examples/TemplateSpecVersionsCreate.json"
-          }
-        },
-        "parameters": [
-          {
-            "$ref": "#/parameters/SubscriptionIdParameter"
-          },
-          {
-            "$ref": "#/parameters/ResourceGroupNameParameter"
-          },
-          {
-            "$ref": "#/parameters/TemplateSpecNameParameter"
-          },
-          {
-            "$ref": "#/parameters/TemplateSpecVersionParameter"
-          },
-          {
-            "$ref": "#/parameters/ApiVersionParameter"
-          },
-          {
-            "name": "templateSpecVersionModel",
-            "in": "body",
-            "required": true,
-            "schema": {
-              "$ref": "#/definitions/TemplateSpecVersion"
-            },
-            "description": "Template Spec Version supplied to the operation."
-          }
-        ],
-        "responses": {
-          "200": {
-            "description": "OK - The Template Spec Version has been successfully updated.",
-            "schema": {
-              "$ref": "#/definitions/TemplateSpecVersion"
-            }
-          },
-          "201": {
-            "description": "Template Spec Version created.",
-            "schema": {
-              "$ref": "#/definitions/TemplateSpecVersion"
-            }
-          },
-          "default": {
-            "description": "Error response describing why the operation failed.",
-            "schema": {
-              "$ref": "#/definitions/TemplateSpecsError"
-            }
-          }
-        }
-      },
-      "patch": {
-        "tags": [
-          "TemplateSpecVersions"
-        ],
-        "operationId": "TemplateSpecVersions_Update",
-        "description": "Updates Template Spec Version tags with specified values.",
-        "x-ms-examples": {
-          "TemplateSpecsPatch": {
-            "$ref": "./examples/TemplateSpecVersionsPatch.json"
-          }
-        },
-        "parameters": [
-          {
-            "$ref": "#/parameters/SubscriptionIdParameter"
-          },
-          {
-            "$ref": "#/parameters/ResourceGroupNameParameter"
-          },
-          {
-            "$ref": "#/parameters/TemplateSpecNameParameter"
-          },
-          {
-            "$ref": "#/parameters/ApiVersionParameter"
-          },
-          {
-            "$ref": "#/parameters/TemplateSpecVersionParameter"
-          },
-          {
-            "name": "templateSpecVersionUpdateModel",
-            "in": "body",
-            "schema": {
-              "$ref": "#/definitions/TemplateSpecVersionUpdateModel"
-            },
-            "description": "Template Spec Version resource with the tags to be updated."
-          }
-        ],
-        "responses": {
-          "200": {
-            "description": "OK -- Template Spec Version tags are updated.",
-            "schema": {
-              "$ref": "#/definitions/TemplateSpecVersion"
-            }
-          },
-          "default": {
-            "description": "Error response describing why the operation failed.",
-            "schema": {
-              "$ref": "#/definitions/TemplateSpecsError"
-            }
-          }
-        }
-      },
-      "get": {
-        "tags": [
-          "TemplateSpecVersions"
-        ],
-        "operationId": "TemplateSpecVersions_Get",
-        "description": "Gets a Template Spec version from a specific Template Spec.",
-        "x-ms-examples": {
-          "TemplateSpecVersionsGet": {
-            "$ref": "./examples/TemplateSpecVersionsGet.json"
-          }
-        },
-        "parameters": [
-          {
-            "$ref": "#/parameters/SubscriptionIdParameter"
-          },
-          {
-            "$ref": "#/parameters/ResourceGroupNameParameter"
-          },
-          {
-            "$ref": "#/parameters/TemplateSpecNameParameter"
-          },
-          {
-            "$ref": "#/parameters/ApiVersionParameter"
-          },
-          {
-            "$ref": "#/parameters/TemplateSpecVersionParameter"
-          }
-        ],
-        "responses": {
-          "200": {
-            "description": "OK - Returns information about the Template Spec version.",
-            "schema": {
-              "$ref": "#/definitions/TemplateSpecVersion"
-            }
-          },
-          "default": {
-            "description": "Error response describing why the operation failed.",
-            "schema": {
-              "$ref": "#/definitions/TemplateSpecsError"
-            }
-          }
-        }
-      },
-      "delete": {
-        "tags": [
-          "TemplateSpecVersions"
-        ],
-        "operationId": "TemplateSpecVersions_Delete",
-        "description": "Deletes a specific version from a Template Spec. When operation completes, status code 200 returned without content.",
-        "x-ms-examples": {
-          "TemplateSpecVersionsDelete": {
-            "$ref": "./examples/TemplateSpecVersionsDelete.json"
-          }
-        },
-        "parameters": [
-          {
-            "$ref": "#/parameters/SubscriptionIdParameter"
-          },
-          {
-            "$ref": "#/parameters/ResourceGroupNameParameter"
-          },
-          {
-            "$ref": "#/parameters/TemplateSpecNameParameter"
-          },
-          {
-            "$ref": "#/parameters/ApiVersionParameter"
-          },
-          {
-            "$ref": "#/parameters/TemplateSpecVersionParameter"
-          }
-        ],
-        "responses": {
-          "200": {
-            "description": "OK - Template Spec Version deleted."
-          },
-          "204": {
-            "description": "Template Spec Version does not exist."
-          },
-          "default": {
-            "description": "Error response describing why the operation failed.",
-            "schema": {
-              "$ref": "#/definitions/TemplateSpecsError"
-            }
-          }
-        }
-      }
-    },
-    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Resources/templateSpecs/{templateSpecName}/versions": {
-      "get": {
-        "tags": [
-          "TemplateSpecVersions"
-        ],
-        "operationId": "TemplateSpecVersions_List",
-        "description": "Lists all the Template Spec versions in the specified Template Spec.",
-        "x-ms-examples": {
-          "TemplateSpecVersions_List": {
-            "$ref": "./examples/TemplateSpecVersionsList.json"
-          }
-        },
-        "parameters": [
-          {
-            "$ref": "#/parameters/SubscriptionIdParameter"
-          },
-          {
-            "$ref": "#/parameters/ResourceGroupNameParameter"
-          },
-          {
-            "$ref": "#/parameters/TemplateSpecNameParameter"
-          },
-          {
-            "$ref": "#/parameters/ApiVersionParameter"
-          }
-        ],
-        "responses": {
-          "200": {
-            "description": "OK - Returns an array of Template Spec versions.",
-            "schema": {
-              "$ref": "#/definitions/TemplateSpecVersionsListResult"
-            }
-          },
-          "default": {
-            "description": "Error response describing why the operation failed.",
-            "schema": {
-              "$ref": "#/definitions/TemplateSpecsError"
-            }
-          }
-        },
-        "x-ms-pageable": {
-          "nextLinkName": "nextLink"
-        }
-      }
-    }
-  },
-  "definitions": {
-    "TemplateSpec": {
-      "required": [
-        "location"
-      ],
-      "type": "object",
-      "description": "Template Spec object.",
-      "allOf": [
-        {
-          "$ref": "#/definitions/AzureResourceBase"
-        }
-      ],
-      "properties": {
-        "location": {
-          "type": "string",
-          "x-ms-mutability": [
-            "read",
-            "create"
-          ],
-          "description": "The location of the Template Spec. It cannot be changed after Template Spec creation. It must be one of the supported Azure locations."
-        },
-        "properties": {
-          "description": "Template Spec properties.",
-          "x-ms-client-flatten": true,
-          "$ref": "#/definitions/TemplateSpecProperties"
-        },
-        "tags": {
-          "type": "object",
-          "description": "Resource tags.",
-          "additionalProperties": {
-            "type": "string"
-          }
-        }
-      }
-    },
-    "TemplateSpecProperties": {
-      "type": "object",
-      "description": "Template Spec properties.",
-      "properties": {
-        "description": {
-          "type": "string",
-          "maxLength": 4096,
-          "description": "Template Spec description."
-        },
-        "displayName": {
-          "type": "string",
-          "maxLength": 64,
-          "description": "Template Spec display name."
-        }
-      }
-    },
-    "TemplateSpecsListResult": {
-      "description": "List of Template Specs.",
-      "properties": {
-        "value": {
-          "type": "array",
-          "items": {
-            "$ref": "#/definitions/TemplateSpec"
-          },
-          "description": "An array of Template Specs."
-        },
-        "nextLink": {
-          "readOnly": true,
-          "type": "string",
-          "description": "The URL to use for getting the next set of results."
-        }
-      }
-    },
-    "TemplateSpecUpdateModel": {
-      "type": "object",
-      "description": "Template Spec properties to be updated (only tags are currently supported).",
-      "properties": {
-        "tags": {
-          "type": "object",
-          "description": "Resource tags.",
-          "additionalProperties": {
-            "type": "string"
-          }
-        }
-      },
-      "allOf": [
-        {
-          "$ref": "#/definitions/AzureResourceBase"
-        }
-      ]
-    },
-    "TemplateSpecVersionUpdateModel": {
-      "type": "object",
-      "description": "Template Spec Version properties to be updated (only tags are currently supported).",
-      "properties": {
-        "tags": {
-          "type": "object",
-          "description": "Resource tags.",
-          "additionalProperties": {
-            "type": "string"
-          }
-        }
-      },
-      "allOf": [
-        {
-          "$ref": "#/definitions/AzureResourceBase"
-        }
-      ]
-    },
-    "AzureResourceBase": {
-      "x-ms-azure-resource": true,
-      "type": "object",
-      "description": "Common properties for all Azure resources.",
-      "properties": {
-        "id": {
-          "readOnly": true,
-          "type": "string",
-          "description": "String Id used to locate any resource on Azure."
-        },
-        "name": {
-          "readOnly": true,
-          "type": "string",
-          "description": "Name of this resource."
-        },
-        "type": {
-          "readOnly": true,
-          "type": "string",
-          "description": "Type of this resource."
-        },
-        "systemData": {
-          "readOnly": true,
-          "type": "object",
-          "description": "Azure Resource Manager metadata containing createdBy and modifiedBy information.",
-          "$ref": "../../../../../common-types/resource-management/v1/types.json#/definitions/systemData"
-        }
-      }
-    },
-    "TemplateSpecVersion": {
-      "required": [
-        "properties",
-        "location"
-      ],
-      "type": "object",
-      "description": "Template Spec Version object.",
-      "allOf": [
-        {
-          "$ref": "#/definitions/AzureResourceBase"
-        }
-      ],
-      "properties": {
-        "location": {
-          "type": "string",
-          "x-ms-mutability": [
-            "read",
-            "create"
-          ],
-          "description": "The location of the Template Spec Version. It must match the location of the parent Template Spec."
-        },
-        "properties": {
-          "description": "Template Spec Version properties.",
-          "x-ms-client-flatten": true,
-          "$ref": "#/definitions/TemplateSpecVersionProperties"
-        },
-        "tags": {
-          "type": "object",
-          "description": "Resource tags.",
-          "additionalProperties": {
-            "type": "string"
-          }
-        }
-      }
-    },
-    "TemplateSpecVersionProperties": {
-      "type": "object",
-      "description": "Template Spec Version properties.",
-      "properties": {
-        "artifacts": {
-          "type": "array",
-          "items": {
-            "$ref": "#/definitions/TemplateSpecArtifact"
-          },
-          "description": "An array of Template Spec artifacts."
-        },
-        "description": {
-          "type": "string",
-          "maxLength": 4096,
-          "description": "Template Spec version description."
-        },
-        "template": {
-          "type": "object",
-          "description": "The Azure Resource Manager template content."
-        },
-        "uiDefinition": {
-          "type": "object",
-          "description": "The Azure Resource Manager template UI definition content"
-        }
-      }
-    },
-    "TemplateSpecVersionsListResult": {
-      "description": "List of Template Specs versions",
-      "properties": {
-        "value": {
-          "type": "array",
-          "items": {
-            "$ref": "#/definitions/TemplateSpecVersion"
-          },
-          "description": "An array of Template Spec versions."
-        },
-        "nextLink": {
-          "readOnly": true,
-          "type": "string",
-          "description": "The URL to use for getting the next set of results."
-        }
-      }
-    },
-    "TemplateSpecArtifact": {
-      "type": "object",
-      "discriminator": "kind",
-      "description": "Represents a Template Spec artifact.",
-      "properties": {
-        "path": {
-          "type": "string",
-          "description": "A filesystem safe relative path of the artifact."
-        },
-        "kind": {
-          "type": "string",
-          "description": "The kind of artifact.",
-          "enum": [
-            "template"
-          ],
-          "x-ms-enum": {
-            "name": "TemplateSpecArtifactKind",
-            "modelAsString": true,
-            "values": [
-              {
-                "value": "template",
-                "description": "The artifact represents an embedded Azure Resource Manager template."
-              }
-            ]
-          }
-        }
-      },
-      "required": [
-        "kind",
-        "path"
-      ]
-    },
-    "TemplateSpecTemplateArtifact": {
-      "type": "object",
-      "x-ms-discriminator-value": "template",
-      "description": "Represents a Template Spec artifact containing an embedded Azure Resource Manager template.",
-      "properties": {
-        "template": {
-          "type": "object",
-          "description": "The Azure Resource Manager template."
-        }
-      },
-      "required": [
-        "template"
-      ],
-      "allOf": [
-        {
-          "$ref": "#/definitions/TemplateSpecArtifact"
-        }
-      ]
-    },
-    "TemplateSpecsError": {
-      "properties": {
-        "error": {
-          "$ref": "../../../../../common-types/resource-management/v1/types.json#/definitions/ErrorResponse"
-        }
-      },
-      "description": "Template Specs error response."
-    }
-  },
-  "parameters": {
-    "SubscriptionIdParameter": {
-      "name": "subscriptionId",
-      "in": "path",
-      "required": true,
-      "type": "string",
-      "x-ms-parameter-location": "client",
-      "description": "Subscription Id which 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. The name is case insensitive.",
-      "pattern": "^[-\\w\\._\\(\\)]+$",
-      "minLength": 1,
-      "maxLength": 90,
-      "x-ms-parameter-location": "method"
-    },
-    "TemplateSpecNameParameter": {
-      "name": "templateSpecName",
-      "in": "path",
-      "required": true,
-      "type": "string",
-      "pattern": "^[-\\w\\._\\(\\)]+$",
-      "description": "Name of the Template Spec.",
-      "minLength": 1,
-      "maxLength": 90,
-      "x-ms-parameter-location": "method"
-    },
-    "TemplateSpecVersionParameter": {
-      "name": "templateSpecVersion",
-      "in": "path",
-      "required": true,
-      "type": "string",
-      "pattern": "^[-\\w\\._\\(\\)]+$",
-      "description": "The version of the Template Spec.",
-      "minLength": 1,
-      "maxLength": 90,
-      "x-ms-parameter-location": "method"
-    },
-    "ApiVersionParameter": {
-      "name": "api-version",
-      "in": "query",
-      "required": true,
-      "type": "string",
-      "x-ms-parameter-location": "client",
-      "description": "Client Api version."
-    }
-  }
-}
diff --git a/specification/resources/resource-manager/Microsoft.Resources/stable/2020-06-01/resources.json b/specification/resources/resource-manager/Microsoft.Resources/stable/2020-06-01/resources.json
index 988e044bbe05..70d4e1b3d9e1 100644
--- a/specification/resources/resource-manager/Microsoft.Resources/stable/2020-06-01/resources.json
+++ b/specification/resources/resource-manager/Microsoft.Resources/stable/2020-06-01/resources.json
@@ -4476,6 +4476,10 @@
         "onErrorDeployment": {
           "$ref": "#/definitions/OnErrorDeployment",
           "description": "The deployment on error behavior."
+        },
+        "expressionEvaluationOptions": {
+          "$ref": "#/definitions/ExpressionEvaluationOptions",
+          "description": "Specifies whether template expressions are evaluated within the scope of the parent template or nested template. Only applicable to nested templates. If not specified, default value is outer."
         }
       },
       "required": [
@@ -6184,6 +6188,24 @@
           "description": "The error reported by the operation."
         }
       }
+    },
+    "ExpressionEvaluationOptions": {
+      "properties": {
+        "scope": {
+          "type": "string",
+          "description": "The scope to be used for evaluation of parameters, variables and functions in a nested template.",
+          "enum": [
+            "NotSpecified",
+            "Outer",
+            "Inner"
+          ],
+          "x-ms-enum": {
+            "name": "ExpressionEvaluationOptionsScopeType",
+            "modelAsString": true
+          }
+        }
+      },
+      "description": "Specifies whether template expressions are evaluated within the scope of the parent template or nested template."
     }
   },
   "parameters": {
diff --git a/specification/resources/resource-manager/readme.java.md b/specification/resources/resource-manager/readme.java.md
index 304ceb45ad50..d30e39917517 100644
--- a/specification/resources/resource-manager/readme.java.md
+++ b/specification/resources/resource-manager/readme.java.md
@@ -60,6 +60,7 @@ batch:
   - tag: package-policy-2018-03
   - tag: package-policy-2016-12
   - tag: package-resources-2020-06
+  - tag: package-resources-2019-10
   - tag: package-resources-2019-08
   - tag: package-resources-2019-07
   - tag: package-resources-2019-0510
@@ -235,6 +236,19 @@ regenerate-manager: true
 generate-interface: true
 ```
 
+### Tag: package-resources-2019-10 and java
+
+These settings apply only when `--tag=package-resources-2019-10 --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 $(tag) == 'package-resources-2019-10' && $(java) && $(multiapi)
+java:
+  namespace: com.microsoft.azure.management.resources.v2019_10_01
+  output-folder: $(azure-libraries-for-java-folder)/sdk/resources/mgmt-v2019_10_01
+regenerate-manager: true
+generate-interface: true
+```
+
 ### Tag: package-resources-2019-08 and java
 
 These settings apply only when `--tag=package-resources-2019-08 --java` is specified on the command line.
diff --git a/specification/resources/resource-manager/readme.md b/specification/resources/resource-manager/readme.md
index 7bbe66ddb62a..4a866de90b49 100644
--- a/specification/resources/resource-manager/readme.md
+++ b/specification/resources/resource-manager/readme.md
@@ -265,15 +265,6 @@ input-file:
 - Microsoft.Resources/preview/2019-06-01-preview/templateSpecs.json
 ```
 
-### Tag: package-templatespecs-2020-10-preview
-
-These settings apply only when `--tag=package-templatespecs-2020-10-preview` is specified on the command line.
-
-``` yaml $(tag) == 'package-templatespecs-2020-10-preview'
-input-file:
-- Microsoft.Resources/preview/2020-10-01-preview/templateSpecs.json
-```
-
 ### Tag: package-policy-2016-12
 
 These settings apply only when `--tag=package-policy-2016-12` is specified on the command line.
diff --git a/specification/resources/resource-manager/readme.python.md b/specification/resources/resource-manager/readme.python.md
index 3d6c205a40fb..fc83b036dc42 100644
--- a/specification/resources/resource-manager/readme.python.md
+++ b/specification/resources/resource-manager/readme.python.md
@@ -60,7 +60,6 @@ batch:
   - tag: package-deploymentscripts-2020-10
   - tag: package-deploymentscripts-2019-10-preview  
   - tag: package-templatespecs-2019-06-preview 
-  - tag: package-templatespecs-2020-10-preview 
 ```
 
 ```yaml $(multiapi) && $(track2)
@@ -106,7 +105,6 @@ batch:
   - tag: package-deploymentscripts-2019-10-preview  
   - multiapiscript-deploymentscripts: true
   - tag: package-templatespecs-2019-06-preview 
-  - tag: package-templatespecs-2020-10-preview 
   - multiapiscript-templatespecs: true
 ```
 
@@ -596,16 +594,3 @@ python:
   namespace: azure.mgmt.resource.templatespecs.v2019_06_01_preview
   output-folder: $(python-sdks-folder)/resources/azure-mgmt-resource/azure/mgmt/resource/templatespecs/v2019_06_01_preview
 ```
-
-### Tag: package-templatespecs-2020-10-preview and python
-
-These settings apply only when `--tag=package-templatespecs-2020-10-preview` 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-templatespecs-2020-10-preview'
-namespace: azure.mgmt.resource.templatespecs.v2020_10_01_preview
-output-folder: $(python-sdks-folder)/resources/azure-mgmt-resource/azure/mgmt/resource/templatespecs/v2020_10_01_preview
-python:
-  namespace: azure.mgmt.resource.templatespecs.v2020_10_01_preview
-  output-folder: $(python-sdks-folder)/resources/azure-mgmt-resource/azure/mgmt/resource/templatespecs/v2020_10_01_preview
-```
diff --git a/specification/security/resource-manager/Microsoft.Security/preview/2020-01-01-preview/connectors.json b/specification/security/resource-manager/Microsoft.Security/preview/2020-01-01-preview/connectors.json
index 665e132c03d2..802d023d718e 100644
--- a/specification/security/resource-manager/Microsoft.Security/preview/2020-01-01-preview/connectors.json
+++ b/specification/security/resource-manager/Microsoft.Security/preview/2020-01-01-preview/connectors.json
@@ -37,7 +37,7 @@
     "/subscriptions/{subscriptionId}/providers/Microsoft.Security/connectors": {
       "get": {
         "x-ms-examples": {
-          "Get all Cloud accounts connectors of a subscription": {
+          "Get all cloud accounts connectors of a subscription": {
             "$ref": "./examples/Connectors/GetListConnectorSubscription_example.json"
           }
         },
@@ -62,7 +62,7 @@
             }
           },
           "default": {
-            "description": "Error response describing why the operation failed.",
+            "description": "Error response describing why the operation failed",
             "schema": {
               "$ref": "../../../common/v1/types.json#/definitions/CloudError"
             }
@@ -113,7 +113,7 @@
       },
       "put": {
         "x-ms-examples": {
-          "AwsCred -  Create a cloud account connector for a subscription": {
+          "AwsCred - Create a cloud account connector for a subscription": {
             "$ref": "./examples/Connectors/CreateUpdateAwsCredConnectorSubscription_example.json"
           },
           "AwsAssumeRole - Create a cloud account connector for a subscription": {
@@ -126,7 +126,7 @@
         "tags": [
           "Connectors"
         ],
-        "description": "Create a cloud account connector or update an existing one. Connect to your AWS cloud account using either account credentials or role-based authentication.",
+        "description": "Create a cloud account connector or update an existing one. Connect to your cloud account. For AWS, use either account credentials or role-based authentication. For GCP, use account organization credentials.",
         "operationId": "Connectors_CreateOrUpdate",
         "parameters": [
           {
@@ -233,10 +233,10 @@
     },
     "ConnectorSettingProperties": {
       "type": "object",
-      "description": "Describes properties of an connector setting",
+      "description": "Describes properties of a connector setting",
       "properties": {
         "hybridComputeSettings": {
-          "description": "Settings for hybrid compute management, these settings are relevant only Arc autoProvision (Hybrid Compute).",
+          "description": "Settings for hybrid compute management. These settings are relevant only for Arc autoProvision (Hybrid Compute).",
           "type": "object",
           "$ref": "#/definitions/HybridComputeSettingsProperties"
         },
@@ -292,11 +292,11 @@
             "values": [
               {
                 "value": "On",
-                "description": "Install missing Azure Arc agent on VMs automatically"
+                "description": "Install missing Azure Arc agents on machines automatically"
               },
               {
                 "value": "Off",
-                "description": "Do not install Azure Arc agent on the VMs automatically"
+                "description": "Do not install Azure Arc agent on the machines automatically"
               }
             ]
           }
@@ -307,7 +307,7 @@
         },
         "region": {
           "type": "string",
-          "description": "The location where the meta data of machines will be stored",
+          "description": "The location where the metadata of machines will be stored",
           "x-ms-mutability": [
             "create",
             "read"
@@ -334,7 +334,7 @@
       "properties": {
         "applicationId": {
           "type": "string",
-          "description": "Application id of service principal."
+          "description": "Application ID of service principal."
         },
         "secret": {
           "type": "string",
@@ -371,7 +371,7 @@
               },
               {
                 "value": "Expired",
-                "description": "the connection is expired"
+                "description": "the connection has expired"
               },
               {
                 "value": "IncorrectPolicy",
@@ -422,7 +422,7 @@
     },
     "AwsCredsAuthenticationDetailsProperties": {
       "type": "object",
-      "description": "AWS cloud account connector based credentials, the credentials is composed of access key id and secret key, for more details, refer to <a href=\"https://docs.aws.amazon.com/IAM/latest/UserGuide/id_users_create.html\">Creating an IAM User in Your AWS Account (write only)</a>",
+      "description": "AWS cloud account connector based credentials, the credentials is composed of access key ID and secret key, for more details, refer to <a href=\"https://docs.aws.amazon.com/IAM/latest/UserGuide/id_users_create.html\">Creating an IAM User in Your AWS Account (write only)</a>",
       "x-ms-discriminator-value": "awsCreds",
       "allOf": [
         {
@@ -451,7 +451,7 @@
     },
     "AwAssumeRoleAuthenticationDetailsProperties": {
       "type": "object",
-      "description": "AWS cloud account connector based assume role, the role enables delegating access to your AWS resources. The role is composed of role arn and external id, for more details, refer to <a href=\"https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create_for-user.html\">Creating a Role to Delegate Permissions to an IAM User (write only)</a>",
+      "description": "AWS cloud account connector based assume role, the role enables delegating access to your AWS resources. The role is composed of role Amazon Resource Name (ARN) and external ID. For more details, refer to <a href=\"https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create_for-user.html\">Creating a Role to Delegate Permissions to an IAM User (write only)</a>",
       "x-ms-discriminator-value": "awsAssumeRole",
       "allOf": [
         {
@@ -480,7 +480,7 @@
     },
     "GcpCredentialsDetailsProperties": {
       "type": "object",
-      "description": "GCP cloud account connector based service to service credentials, the credentials is composed of organization id and json api key (write only)</a>",
+      "description": "GCP cloud account connector based service to service credentials, the credentials are composed of the organization ID and a JSON API key (write only)",
       "x-ms-discriminator-value": "gcpCredentials",
       "allOf": [
         {
@@ -489,7 +489,7 @@
       ],
       "properties": {
         "organizationId": {
-          "description": "The Organization ID of the GCP cloud account",
+          "description": "The organization ID of the GCP cloud account",
           "type": "string"
         },
         "type": {
@@ -498,11 +498,11 @@
         },
         "projectId": {
           "type": "string",
-          "description": "Project Id field of the API key (write only)"
+          "description": "Project ID field of the API key (write only)"
         },
         "privateKeyId": {
           "type": "string",
-          "description": "Private key Id field of the API key (write only)"
+          "description": "Private key ID field of the API key (write only)"
         },
         "privateKey": {
           "type": "string",
@@ -514,23 +514,23 @@
         },
         "clientId": {
           "type": "string",
-          "description": "Client Id field of the API key (write only)"
+          "description": "Client ID field of the API key (write only)"
         },
         "authUri": {
           "type": "string",
-          "description": "Auth Uri field of the API key (write only)"
+          "description": "Auth URI field of the API key (write only)"
         },
         "tokenUri": {
           "type": "string",
-          "description": "Token Uri field of the API key (write only)"
+          "description": "Token URI field of the API key (write only)"
         },
         "authProviderX509CertUrl": {
           "type": "string",
-          "description": "Auth provider x509 certificate url field of the API key (write only)"
+          "description": "Auth provider x509 certificate URL field of the API key (write only)"
         },
         "clientX509CertUrl": {
           "type": "string",
-          "description": "Client x509 certificate url field of the API key (write only)"
+          "description": "Client x509 certificate URL field of the API key (write only)"
         }
       },
       "required": [
diff --git a/specification/security/resource-manager/Microsoft.Security/preview/2020-07-01-preview/examples/sqlVulnerabilityAssessmentScanOperations/ArcMachineScans_Get.json b/specification/security/resource-manager/Microsoft.Security/preview/2020-07-01-preview/examples/sqlVulnerabilityAssessmentScanOperations/ArcMachineScans_Get.json
new file mode 100644
index 000000000000..c8f04a5824c7
--- /dev/null
+++ b/specification/security/resource-manager/Microsoft.Security/preview/2020-07-01-preview/examples/sqlVulnerabilityAssessmentScanOperations/ArcMachineScans_Get.json
@@ -0,0 +1,33 @@
+{
+  "parameters": {
+    "scanId": "Scheduled-20200623",
+    "workspaceId": "55555555-6666-7777-8888-999999999999",
+    "api-version": "2020-07-01-preview",
+    "resourceId": "subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Rg/providers/Microsoft.HybridCompute/machines/MyMachine/sqlServers/server1/databases/master"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Rg/providers/Microsoft.HybridCompute/machines/MyMachine/sqlServers/server1/databases/master/providers/Microsoft.Security/sqlVulnerabilityAssessments/default/scans/Scheduled-20200623",
+        "name": "Scheduled-20200623",
+        "type": "Microsoft.Security/sqlVulnerabilityAssessments/scans",
+        "properties": {
+          "triggerType": "Recurring",
+          "state": "Failed",
+          "server": "server1",
+          "database": "master",
+          "sqlVersion": "15.0.2000",
+          "startTime": "2020-06-23T06:49:00.6455136+00:00",
+          "endTime": "2020-06-23T06:49:00.7236217Z",
+          "highSeverityFailedRulesCount": 3,
+          "mediumSeverityFailedRulesCount": 2,
+          "lowSeverityFailedRulesCount": 1,
+          "totalPassedRulesCount": 20,
+          "totalFailedRulesCount": 6,
+          "totalRulesCount": 26,
+          "isBaselineApplied": false
+        }
+      }
+    }
+  }
+}
diff --git a/specification/security/resource-manager/Microsoft.Security/preview/2020-07-01-preview/examples/sqlVulnerabilityAssessmentScanOperations/ArcMachineScans_GetLatest.json b/specification/security/resource-manager/Microsoft.Security/preview/2020-07-01-preview/examples/sqlVulnerabilityAssessmentScanOperations/ArcMachineScans_GetLatest.json
new file mode 100644
index 000000000000..7c2ff86ab55b
--- /dev/null
+++ b/specification/security/resource-manager/Microsoft.Security/preview/2020-07-01-preview/examples/sqlVulnerabilityAssessmentScanOperations/ArcMachineScans_GetLatest.json
@@ -0,0 +1,33 @@
+{
+  "parameters": {
+    "scanId": "latest",
+    "workspaceId": "55555555-6666-7777-8888-999999999999",
+    "api-version": "2020-07-01-preview",
+    "resourceId": "subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Rg/providers/Microsoft.HybridCompute/machines/MyMachine/sqlServers/server1/databases/master"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Rg/providers/Microsoft.HybridCompute/machines/MyMachine/sqlServers/server1/databases/master/providers/Microsoft.Security/sqlVulnerabilityAssessments/default/scans/Scheduled-20200623",
+        "name": "Scheduled-20200623",
+        "type": "Microsoft.Security/sqlVulnerabilityAssessments/scans",
+        "properties": {
+          "triggerType": "Recurring",
+          "state": "Failed",
+          "server": "server1",
+          "database": "master",
+          "sqlVersion": "15.0.2000",
+          "startTime": "2020-06-23T06:49:00.6455136+00:00",
+          "endTime": "2020-06-23T06:49:00.7236217Z",
+          "highSeverityFailedRulesCount": 3,
+          "mediumSeverityFailedRulesCount": 2,
+          "lowSeverityFailedRulesCount": 1,
+          "totalPassedRulesCount": 20,
+          "totalFailedRulesCount": 6,
+          "totalRulesCount": 26,
+          "isBaselineApplied": false
+        }
+      }
+    }
+  }
+}
diff --git a/specification/security/resource-manager/Microsoft.Security/preview/2020-07-01-preview/examples/sqlVulnerabilityAssessmentScanOperations/ArcMachineScans_List.json b/specification/security/resource-manager/Microsoft.Security/preview/2020-07-01-preview/examples/sqlVulnerabilityAssessmentScanOperations/ArcMachineScans_List.json
new file mode 100644
index 000000000000..f5406e2aaaff
--- /dev/null
+++ b/specification/security/resource-manager/Microsoft.Security/preview/2020-07-01-preview/examples/sqlVulnerabilityAssessmentScanOperations/ArcMachineScans_List.json
@@ -0,0 +1,57 @@
+{
+  "parameters": {
+    "workspaceId": "55555555-6666-7777-8888-999999999999",
+    "api-version": "2020-07-01-preview",
+    "resourceId": "subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Rg/providers/Microsoft.HybridCompute/machines/MyMachine/sqlServers/server1/databases/master"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Rg/providers/Microsoft.HybridCompute/machines/MyMachine/sqlServers/server1/databases/master/providers/Microsoft.Security/sqlVulnerabilityAssessments/default/scans/Scheduled-20200225",
+            "name": "Scheduled-20200225",
+            "type": "Microsoft.Security/sqlVulnerabilityAssessments/scans",
+            "properties": {
+              "triggerType": "Recurring",
+              "state": "Failed",
+              "server": "server1",
+              "database": "master",
+              "sqlVersion": "15.0.2000",
+              "startTime": "2020-02-25T11:34:29.1399864Z",
+              "endTime": "2020-02-25T11:38:07.8606151Z",
+              "highSeverityFailedRulesCount": 3,
+              "mediumSeverityFailedRulesCount": 2,
+              "lowSeverityFailedRulesCount": 1,
+              "totalPassedRulesCount": 20,
+              "totalFailedRulesCount": 6,
+              "totalRulesCount": 26,
+              "isBaselineApplied": false
+            }
+          },
+          {
+            "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Rg/providers/Microsoft.HybridCompute/machines/MyMachine/sqlServers/server1/databases/master/providers/Microsoft.Security/sqlVulnerabilityAssessments/default/scans/scan_20200226_113429",
+            "name": "scan_20200226_113429",
+            "type": "Microsoft.Security/sqlVulnerabilityAssessments/scans",
+            "properties": {
+              "triggerType": "OnDemand",
+              "state": "Passed",
+              "server": "server1",
+              "database": "master",
+              "sqlVersion": "15.0.2000",
+              "startTime": "2020-02-26T11:34:29.1399864Z",
+              "endTime": "2020-02-26T11:38:07.8606151Z",
+              "highSeverityFailedRulesCount": 0,
+              "mediumSeverityFailedRulesCount": 0,
+              "lowSeverityFailedRulesCount": 0,
+              "totalPassedRulesCount": 26,
+              "totalFailedRulesCount": 0,
+              "totalRulesCount": 26,
+              "isBaselineApplied": true
+            }
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/security/resource-manager/Microsoft.Security/preview/2020-07-01-preview/examples/sqlVulnerabilityAssessmentsBaselineRuleOperations/ArcMachineBaselineRules_Add.json b/specification/security/resource-manager/Microsoft.Security/preview/2020-07-01-preview/examples/sqlVulnerabilityAssessmentsBaselineRuleOperations/ArcMachineBaselineRules_Add.json
new file mode 100644
index 000000000000..e6577270110b
--- /dev/null
+++ b/specification/security/resource-manager/Microsoft.Security/preview/2020-07-01-preview/examples/sqlVulnerabilityAssessmentsBaselineRuleOperations/ArcMachineBaselineRules_Add.json
@@ -0,0 +1,69 @@
+{
+  "parameters": {
+    "ruleId": "VA1234",
+    "workspaceId": "55555555-6666-7777-8888-999999999999",
+    "api-version": "2020-07-01-preview",
+    "resourceId": "subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Rg/providers/Microsoft.HybridCompute/machines/MyMachine/sqlServers/server1/databases/master",
+    "body": {
+      "latestScan": false,
+      "results": {
+        "VA1234": [
+          [
+            "userA",
+            "SELECT"
+          ],
+          [
+            "userB",
+            "SELECT"
+          ]
+        ],
+        "VA5678": [
+          [
+            "Test",
+            "0.0.0.0",
+            "125.125.125.125"
+          ]
+        ]
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Rg/providers/Microsoft.HybridCompute/machines/MyMachine/sqlServers/server1/databases/master/providers/Microsoft.Security/sqlVulnerabilityAssessments/default/baselineRules/VA1234",
+            "name": "VA1234",
+            "type": "Microsoft.Security/sqlVulnerabilityAssessments/baselineRules",
+            "properties": {
+              "results": [
+                [
+                  "userA",
+                  "SELECT"
+                ],
+                [
+                  "userB",
+                  "SELECT"
+                ]
+              ]
+            }
+          },
+          {
+            "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Rg/providers/Microsoft.HybridCompute/machines/MyMachine/sqlServers/server1/databases/master/providers/Microsoft.Security/sqlVulnerabilityAssessments/default/baselineRules/VA5678",
+            "name": "VA5678",
+            "type": "Microsoft.Security/sqlVulnerabilityAssessments/baselineRules",
+            "properties": {
+              "results": [
+                [
+                  "Test",
+                  "0.0.0.0",
+                  "125.125.125.125"
+                ]
+              ]
+            }
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/security/resource-manager/Microsoft.Security/preview/2020-07-01-preview/examples/sqlVulnerabilityAssessmentsBaselineRuleOperations/ArcMachineBaselineRules_AddLatest.json b/specification/security/resource-manager/Microsoft.Security/preview/2020-07-01-preview/examples/sqlVulnerabilityAssessmentsBaselineRuleOperations/ArcMachineBaselineRules_AddLatest.json
new file mode 100644
index 000000000000..cfd21bb9f2e5
--- /dev/null
+++ b/specification/security/resource-manager/Microsoft.Security/preview/2020-07-01-preview/examples/sqlVulnerabilityAssessmentsBaselineRuleOperations/ArcMachineBaselineRules_AddLatest.json
@@ -0,0 +1,51 @@
+{
+  "parameters": {
+    "ruleId": "VA1234",
+    "workspaceId": "55555555-6666-7777-8888-999999999999",
+    "api-version": "2020-07-01-preview",
+    "resourceId": "subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Rg/providers/Microsoft.HybridCompute/machines/MyMachine/sqlServers/server1/databases/master",
+    "body": {
+      "latestScan": true,
+      "results": {}
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Rg/providers/Microsoft.HybridCompute/machines/MyMachine/sqlServers/server1/databases/master/providers/Microsoft.Security/sqlVulnerabilityAssessments/default/baselineRules/VA1234",
+            "name": "VA1234",
+            "type": "Microsoft.Security/sqlVulnerabilityAssessments/baselineRules",
+            "properties": {
+              "results": [
+                [
+                  "userA",
+                  "SELECT"
+                ],
+                [
+                  "userB",
+                  "SELECT"
+                ]
+              ]
+            }
+          },
+          {
+            "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Rg/providers/Microsoft.HybridCompute/machines/MyMachine/sqlServers/server1/databases/master/providers/Microsoft.Security/sqlVulnerabilityAssessments/default/baselineRules/VA5678",
+            "name": "VA5678",
+            "type": "Microsoft.Security/sqlVulnerabilityAssessments/baselineRules",
+            "properties": {
+              "results": [
+                [
+                  "Test",
+                  "0.0.0.0",
+                  "125.125.125.125"
+                ]
+              ]
+            }
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/security/resource-manager/Microsoft.Security/preview/2020-07-01-preview/examples/sqlVulnerabilityAssessmentsBaselineRuleOperations/ArcMachineBaselineRules_Delete.json b/specification/security/resource-manager/Microsoft.Security/preview/2020-07-01-preview/examples/sqlVulnerabilityAssessmentsBaselineRuleOperations/ArcMachineBaselineRules_Delete.json
new file mode 100644
index 000000000000..99721025a616
--- /dev/null
+++ b/specification/security/resource-manager/Microsoft.Security/preview/2020-07-01-preview/examples/sqlVulnerabilityAssessmentsBaselineRuleOperations/ArcMachineBaselineRules_Delete.json
@@ -0,0 +1,12 @@
+{
+  "parameters": {
+    "ruleId": "VA1234",
+    "workspaceId": "55555555-6666-7777-8888-999999999999",
+    "api-version": "2020-07-01-preview",
+    "resourceId": "subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Rg/providers/Microsoft.HybridCompute/machines/MyMachine/sqlServers/server1/databases/master"
+  },
+  "responses": {
+    "200": {},
+    "204": {}
+  }
+}
diff --git a/specification/security/resource-manager/Microsoft.Security/preview/2020-07-01-preview/examples/sqlVulnerabilityAssessmentsBaselineRuleOperations/ArcMachineBaselineRules_Get.json b/specification/security/resource-manager/Microsoft.Security/preview/2020-07-01-preview/examples/sqlVulnerabilityAssessmentsBaselineRuleOperations/ArcMachineBaselineRules_Get.json
new file mode 100644
index 000000000000..9a7009d46b9e
--- /dev/null
+++ b/specification/security/resource-manager/Microsoft.Security/preview/2020-07-01-preview/examples/sqlVulnerabilityAssessmentsBaselineRuleOperations/ArcMachineBaselineRules_Get.json
@@ -0,0 +1,29 @@
+{
+  "parameters": {
+    "ruleId": "VA1234",
+    "workspaceId": "55555555-6666-7777-8888-999999999999",
+    "api-version": "2020-07-01-preview",
+    "resourceId": "subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Rg/providers/Microsoft.HybridCompute/machines/MyMachine/sqlServers/server1/databases/master"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Rg/providers/Microsoft.HybridCompute/machines/MyMachine/sqlServers/server1/databases/master/providers/Microsoft.Security/sqlVulnerabilityAssessments/default/baselineRules/VA1234",
+        "name": "VA1234",
+        "type": "Microsoft.Security/sqlVulnerabilityAssessments/baselineRules",
+        "properties": {
+          "results": [
+            [
+              "userA",
+              "SELECT"
+            ],
+            [
+              "userB",
+              "SELECT"
+            ]
+          ]
+        }
+      }
+    }
+  }
+}
diff --git a/specification/security/resource-manager/Microsoft.Security/preview/2020-07-01-preview/examples/sqlVulnerabilityAssessmentsBaselineRuleOperations/ArcMachineBaselineRules_List.json b/specification/security/resource-manager/Microsoft.Security/preview/2020-07-01-preview/examples/sqlVulnerabilityAssessmentsBaselineRuleOperations/ArcMachineBaselineRules_List.json
new file mode 100644
index 000000000000..760d38acecd6
--- /dev/null
+++ b/specification/security/resource-manager/Microsoft.Security/preview/2020-07-01-preview/examples/sqlVulnerabilityAssessmentsBaselineRuleOperations/ArcMachineBaselineRules_List.json
@@ -0,0 +1,46 @@
+{
+  "parameters": {
+    "workspaceId": "55555555-6666-7777-8888-999999999999",
+    "api-version": "2020-07-01-preview",
+    "resourceId": "subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Rg/providers/Microsoft.HybridCompute/machines/MyMachine/sqlServers/server1/databases/master"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Rg/providers/Microsoft.HybridCompute/machines/MyMachine/sqlServers/server1/databases/master/providers/Microsoft.Security/sqlVulnerabilityAssessments/default/baselineRules/VA1234",
+            "name": "VA1234",
+            "type": "Microsoft.Security/sqlVulnerabilityAssessments/baselineRules",
+            "properties": {
+              "results": [
+                [
+                  "userA",
+                  "SELECT"
+                ],
+                [
+                  "userB",
+                  "SELECT"
+                ]
+              ]
+            }
+          },
+          {
+            "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Rg/providers/Microsoft.HybridCompute/machines/MyMachine/sqlServers/server1/databases/master/providers/Microsoft.Security/sqlVulnerabilityAssessments/default/baselineRules/VA5678",
+            "name": "VA5678",
+            "type": "Microsoft.Security/sqlVulnerabilityAssessments/baselineRules",
+            "properties": {
+              "results": [
+                [
+                  "Test",
+                  "0.0.0.0",
+                  "125.125.125.125"
+                ]
+              ]
+            }
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/security/resource-manager/Microsoft.Security/preview/2020-07-01-preview/examples/sqlVulnerabilityAssessmentsBaselineRuleOperations/ArcMachineBaselineRules_Put.json b/specification/security/resource-manager/Microsoft.Security/preview/2020-07-01-preview/examples/sqlVulnerabilityAssessmentsBaselineRuleOperations/ArcMachineBaselineRules_Put.json
new file mode 100644
index 000000000000..126a59175bca
--- /dev/null
+++ b/specification/security/resource-manager/Microsoft.Security/preview/2020-07-01-preview/examples/sqlVulnerabilityAssessmentsBaselineRuleOperations/ArcMachineBaselineRules_Put.json
@@ -0,0 +1,42 @@
+{
+  "parameters": {
+    "ruleId": "VA1234",
+    "workspaceId": "55555555-6666-7777-8888-999999999999",
+    "api-version": "2020-07-01-preview",
+    "resourceId": "subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Rg/providers/Microsoft.HybridCompute/machines/MyMachine/sqlServers/server1/databases/master",
+    "body": {
+      "latestScan": false,
+      "results": [
+        [
+          "userA",
+          "SELECT"
+        ],
+        [
+          "userB",
+          "SELECT"
+        ]
+      ]
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Rg/providers/Microsoft.HybridCompute/machines/MyMachine/sqlServers/server1/databases/master/providers/Microsoft.Security/sqlVulnerabilityAssessments/default/baselineRules/VA1234",
+        "name": "VA1234",
+        "type": "Microsoft.Security/sqlVulnerabilityAssessments/baselineRules",
+        "properties": {
+          "results": [
+            [
+              "userA",
+              "SELECT"
+            ],
+            [
+              "userB",
+              "SELECT"
+            ]
+          ]
+        }
+      }
+    }
+  }
+}
diff --git a/specification/security/resource-manager/Microsoft.Security/preview/2020-07-01-preview/examples/sqlVulnerabilityAssessmentsBaselineRuleOperations/ArcMachineBaselineRules_PutLatest.json b/specification/security/resource-manager/Microsoft.Security/preview/2020-07-01-preview/examples/sqlVulnerabilityAssessmentsBaselineRuleOperations/ArcMachineBaselineRules_PutLatest.json
new file mode 100644
index 000000000000..22bcefce9657
--- /dev/null
+++ b/specification/security/resource-manager/Microsoft.Security/preview/2020-07-01-preview/examples/sqlVulnerabilityAssessmentsBaselineRuleOperations/ArcMachineBaselineRules_PutLatest.json
@@ -0,0 +1,33 @@
+{
+  "parameters": {
+    "ruleId": "VA1234",
+    "workspaceId": "55555555-6666-7777-8888-999999999999",
+    "api-version": "2020-07-01-preview",
+    "resourceId": "subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Rg/providers/Microsoft.HybridCompute/machines/MyMachine/sqlServers/server1/databases/master",
+    "body": {
+      "latestScan": true,
+      "results": []
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Rg/providers/Microsoft.HybridCompute/machines/MyMachine/sqlServers/server1/databases/master/providers/Microsoft.Security/sqlVulnerabilityAssessments/default/baselineRules/VA1234",
+        "name": "VA1234",
+        "type": "Microsoft.Security/sqlVulnerabilityAssessments/baselineRules",
+        "properties": {
+          "results": [
+            [
+              "userA",
+              "SELECT"
+            ],
+            [
+              "userB",
+              "SELECT"
+            ]
+          ]
+        }
+      }
+    }
+  }
+}
diff --git a/specification/security/resource-manager/Microsoft.Security/preview/2020-07-01-preview/examples/sqlVulnerabilityAssessmentsScanResultsOperations/ArcMachineScanResults_Get.json b/specification/security/resource-manager/Microsoft.Security/preview/2020-07-01-preview/examples/sqlVulnerabilityAssessmentsScanResultsOperations/ArcMachineScanResults_Get.json
new file mode 100644
index 000000000000..5aa776984cfd
--- /dev/null
+++ b/specification/security/resource-manager/Microsoft.Security/preview/2020-07-01-preview/examples/sqlVulnerabilityAssessmentsScanResultsOperations/ArcMachineScanResults_Get.json
@@ -0,0 +1,72 @@
+{
+  "parameters": {
+    "scanId": "Scheduled-20200623",
+    "scanResultId": "VA2063",
+    "workspaceId": "55555555-6666-7777-8888-999999999999",
+    "api-version": "2020-07-01-preview",
+    "resourceId": "subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Rg/providers/Microsoft.HybridCompute/machines/MyMachine/sqlServers/server1/databases/master"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Rg/providers/Microsoft.HybridCompute/machines/MyMachine/sqlServers/server1/databases/master/providers/Microsoft.Security/sqlVulnerabilityAssessments/default/scans/Scheduled-20200623/scanResults/VA2063",
+        "name": "VA2063",
+        "type": "Microsoft.Security/sqlVulnerabilityAssessments/scans/scanResults",
+        "properties": {
+          "ruleId": "VA2063",
+          "status": "Finding",
+          "isTrimmed": false,
+          "queryResults": [
+            [
+              "Test",
+              "0.0.0.0",
+              "125.125.125.125"
+            ]
+          ],
+          "remediation": {
+            "description": "Remove server firewall rules that grant excessive access",
+            "scripts": [
+              "EXECUTE sp_delete_firewall_rule N'Test';"
+            ],
+            "automated": false,
+            "portalLink": "ReviewServerFirewallRules"
+          },
+          "baselineAdjustedResult": {
+            "baseline": {
+              "expectedResults": [
+                [
+                  "Test",
+                  "0.0.0.0",
+                  "125.125.125.125"
+                ]
+              ],
+              "updatedTime": "2020-02-04T12:49:41.027771+00:00"
+            },
+            "status": "NonFinding",
+            "resultsNotInBaseline": [],
+            "resultsOnlyInBaseline": []
+          },
+          "ruleMetadata": {
+            "ruleId": "VA2063",
+            "severity": "High",
+            "category": "SurfaceAreaReduction",
+            "ruleType": "NegativeList",
+            "title": "Server-level firewall rules should not grant excessive access",
+            "description": "The Azure SQL server-level firewall helps protect your server by preventing all access to your databases until you specify which IP addresses have permission. Server-level firewall rules grant access to all databases that belong to the server based on the originating IP address of each request.\n\nServer-level firewall rules can only be created and managed through Transact-SQL as well as through the Azure portal or PowerShell. For more details please see: https://docs.microsoft.com/en-us/azure/sql-database/sql-database-firewall-configure\n\nThis check verifies that server-level firewall rules do not grant excessive access.",
+            "rationale": "Often, administrators add rules that grant excessive access as part of a troubleshooting process � to eliminate the firewall as the source of a problem, they simply create a rule that allows all traffic to pass to the affected server.\n\nGranting excessive access using server firewall rules is a clear security concern, as it violates the principle of least privilege by allowing unnecessary access to your databases. In fact, it's the equivalent of placing the server outside of the firewall.",
+            "queryCheck": {
+              "query": "SELECT name\n    ,start_ip_address\n    ,end_ip_address\nFROM sys.firewall_rules\nWHERE ( \n        (CONVERT(bigint, parsename(end_ip_address, 1)) +\n         CONVERT(bigint, parsename(end_ip_address, 2)) * 256 + \n         CONVERT(bigint, parsename(end_ip_address, 3)) * 65536 + \n         CONVERT(bigint, parsename(end_ip_address, 4)) * 16777216 ) \n        - \n        (CONVERT(bigint, parsename(start_ip_address, 1)) +\n         CONVERT(bigint, parsename(start_ip_address, 2)) * 256 + \n         CONVERT(bigint, parsename(start_ip_address, 3)) * 65536 + \n         CONVERT(bigint, parsename(start_ip_address, 4)) * 16777216 )\n      ) > 255;",
+              "expectedResult": [],
+              "columnNames": [
+                "Firewall Rule Name",
+                "Start Address",
+                "End Address"
+              ]
+            },
+            "benchmarkReferences": []
+          }
+        }
+      }
+    }
+  }
+}
diff --git a/specification/security/resource-manager/Microsoft.Security/preview/2020-07-01-preview/examples/sqlVulnerabilityAssessmentsScanResultsOperations/ArcMachineScanResults_GetLatest.json b/specification/security/resource-manager/Microsoft.Security/preview/2020-07-01-preview/examples/sqlVulnerabilityAssessmentsScanResultsOperations/ArcMachineScanResults_GetLatest.json
new file mode 100644
index 000000000000..dd566b960b02
--- /dev/null
+++ b/specification/security/resource-manager/Microsoft.Security/preview/2020-07-01-preview/examples/sqlVulnerabilityAssessmentsScanResultsOperations/ArcMachineScanResults_GetLatest.json
@@ -0,0 +1,72 @@
+{
+  "parameters": {
+    "scanId": "latest",
+    "scanResultId": "VA2063",
+    "workspaceId": "55555555-6666-7777-8888-999999999999",
+    "api-version": "2020-07-01-preview",
+    "resourceId": "subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Rg/providers/Microsoft.HybridCompute/machines/MyMachine/sqlServers/server1/databases/master"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Rg/providers/Microsoft.HybridCompute/machines/MyMachine/sqlServers/server1/databases/master/providers/Microsoft.Security/sqlVulnerabilityAssessments/default/scans/Scheduled-20200623/scanResults/VA2063",
+        "name": "VA2063",
+        "type": "Microsoft.Security/sqlVulnerabilityAssessments/scans/scanResults",
+        "properties": {
+          "ruleId": "VA2063",
+          "status": "Finding",
+          "isTrimmed": false,
+          "queryResults": [
+            [
+              "Test",
+              "0.0.0.0",
+              "125.125.125.125"
+            ]
+          ],
+          "remediation": {
+            "description": "Remove server firewall rules that grant excessive access",
+            "scripts": [
+              "EXECUTE sp_delete_firewall_rule N'Test';"
+            ],
+            "automated": false,
+            "portalLink": "ReviewServerFirewallRules"
+          },
+          "baselineAdjustedResult": {
+            "baseline": {
+              "expectedResults": [
+                [
+                  "Test",
+                  "0.0.0.0",
+                  "125.125.125.125"
+                ]
+              ],
+              "updatedTime": "2020-02-04T12:49:41.027771+00:00"
+            },
+            "status": "NonFinding",
+            "resultsNotInBaseline": [],
+            "resultsOnlyInBaseline": []
+          },
+          "ruleMetadata": {
+            "ruleId": "VA2063",
+            "severity": "High",
+            "category": "SurfaceAreaReduction",
+            "ruleType": "NegativeList",
+            "title": "Server-level firewall rules should not grant excessive access",
+            "description": "The Azure SQL server-level firewall helps protect your server by preventing all access to your databases until you specify which IP addresses have permission. Server-level firewall rules grant access to all databases that belong to the server based on the originating IP address of each request.\n\nServer-level firewall rules can only be created and managed through Transact-SQL as well as through the Azure portal or PowerShell. For more details please see: https://docs.microsoft.com/en-us/azure/sql-database/sql-database-firewall-configure\n\nThis check verifies that server-level firewall rules do not grant excessive access.",
+            "rationale": "Often, administrators add rules that grant excessive access as part of a troubleshooting process � to eliminate the firewall as the source of a problem, they simply create a rule that allows all traffic to pass to the affected server.\n\nGranting excessive access using server firewall rules is a clear security concern, as it violates the principle of least privilege by allowing unnecessary access to your databases. In fact, it's the equivalent of placing the server outside of the firewall.",
+            "queryCheck": {
+              "query": "SELECT name\n    ,start_ip_address\n    ,end_ip_address\nFROM sys.firewall_rules\nWHERE ( \n        (CONVERT(bigint, parsename(end_ip_address, 1)) +\n         CONVERT(bigint, parsename(end_ip_address, 2)) * 256 + \n         CONVERT(bigint, parsename(end_ip_address, 3)) * 65536 + \n         CONVERT(bigint, parsename(end_ip_address, 4)) * 16777216 ) \n        - \n        (CONVERT(bigint, parsename(start_ip_address, 1)) +\n         CONVERT(bigint, parsename(start_ip_address, 2)) * 256 + \n         CONVERT(bigint, parsename(start_ip_address, 3)) * 65536 + \n         CONVERT(bigint, parsename(start_ip_address, 4)) * 16777216 )\n      ) > 255;",
+              "expectedResult": [],
+              "columnNames": [
+                "Firewall Rule Name",
+                "Start Address",
+                "End Address"
+              ]
+            },
+            "benchmarkReferences": []
+          }
+        }
+      }
+    }
+  }
+}
diff --git a/specification/security/resource-manager/Microsoft.Security/preview/2020-07-01-preview/examples/sqlVulnerabilityAssessmentsScanResultsOperations/ArcMachineScanResults_List.json b/specification/security/resource-manager/Microsoft.Security/preview/2020-07-01-preview/examples/sqlVulnerabilityAssessmentsScanResultsOperations/ArcMachineScanResults_List.json
new file mode 100644
index 000000000000..d5162da4832c
--- /dev/null
+++ b/specification/security/resource-manager/Microsoft.Security/preview/2020-07-01-preview/examples/sqlVulnerabilityAssessmentsScanResultsOperations/ArcMachineScanResults_List.json
@@ -0,0 +1,112 @@
+{
+  "parameters": {
+    "scanId": "Scheduled-20200623",
+    "workspaceId": "55555555-6666-7777-8888-999999999999",
+    "api-version": "2020-07-01-preview",
+    "resourceId": "subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Rg/providers/Microsoft.HybridCompute/machines/MyMachine/sqlServers/server1/databases/master"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Rg/providers/Microsoft.HybridCompute/machines/MyMachine/sqlServers/server1/databases/master/providers/Microsoft.Security/sqlVulnerabilityAssessments/default/scans/Scheduled-20200623/scanResults/VA2062",
+            "name": "VA2062",
+            "type": "Microsoft.Security/sqlVulnerabilityAssessments/scans/scanResults",
+            "properties": {
+              "ruleId": "VA2062",
+              "status": "NonFinding",
+              "isTrimmed": false,
+              "queryResults": [],
+              "remediation": {
+                "description": "Remove database firewall rules that grant excessive access",
+                "scripts": [],
+                "automated": false,
+                "portalLink": ""
+              },
+              "baselineAdjustedResult": null,
+              "ruleMetadata": {
+                "ruleId": "VA2062",
+                "severity": "High",
+                "category": "SurfaceAreaReduction",
+                "ruleType": "NegativeList",
+                "title": "Database-level firewall rules should not grant excessive access",
+                "description": "The Azure SQL Database-level firewall helps protect your data by preventing all access to your database until you specify which IP addresses have permission. Database-level firewall rules grant access to the specific database based on the originating IP address of each request.\n\nDatabase-level firewall rules for master and user databases can only be created and managed through Transact-SQL (unlike server-level firewall rules which can also be created and managed using the Azure portal or PowerShell). For more details please see: https://docs.microsoft.com/en-us/azure/sql-database/sql-database-firewall-configure\n\nThis check verifies that database-level firewall rules do not grant excessive access.",
+                "rationale": "Often, administrators add rules that grant excessive access as part of a troubleshooting process - to eliminate the firewall as the source of a problem, they simply create a rule that allows all traffic to pass to the affected database.\n\nGranting excessive access using database firewall rules is a clear security concern, as it violates the principle of least privilege by allowing unnecessary access to your database. In fact, it's the equivalent of placing the database outside of the firewall.",
+                "queryCheck": {
+                  "query": "SELECT name\n    ,start_ip_address\n    ,end_ip_address\nFROM sys.database_firewall_rules\nWHERE ( \n        (CONVERT(bigint, parsename(end_ip_address, 1)) +\n         CONVERT(bigint, parsename(end_ip_address, 2)) * 256 + \n         CONVERT(bigint, parsename(end_ip_address, 3)) * 65536 + \n         CONVERT(bigint, parsename(end_ip_address, 4)) * 16777216 ) \n        - \n        (CONVERT(bigint, parsename(start_ip_address, 1)) +\n         CONVERT(bigint, parsename(start_ip_address, 2)) * 256 + \n         CONVERT(bigint, parsename(start_ip_address, 3)) * 65536 + \n         CONVERT(bigint, parsename(start_ip_address, 4)) * 16777216 )\n      ) > 255;",
+                  "expectedResult": [],
+                  "columnNames": [
+                    "Firewall Rule Name",
+                    "Start Address",
+                    "End Address"
+                  ]
+                },
+                "benchmarkReferences": []
+              }
+            }
+          },
+          {
+            "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Rg/providers/Microsoft.HybridCompute/machines/MyMachine/sqlServers/server1/databases/master/providers/Microsoft.Security/sqlVulnerabilityAssessments/default/scans/Scheduled-20200623/scanResults/VA2063",
+            "name": "VA2063",
+            "type": "Microsoft.Security/sqlVulnerabilityAssessments/scans/scanResults",
+            "properties": {
+              "ruleId": "VA2063",
+              "status": "Finding",
+              "isTrimmed": false,
+              "queryResults": [
+                [
+                  "Test",
+                  "0.0.0.0",
+                  "125.125.125.125"
+                ]
+              ],
+              "remediation": {
+                "description": "Remove server firewall rules that grant excessive access",
+                "scripts": [
+                  "EXECUTE sp_delete_firewall_rule N'Test';"
+                ],
+                "automated": false,
+                "portalLink": "ReviewServerFirewallRules"
+              },
+              "baselineAdjustedResult": {
+                "baseline": {
+                  "expectedResults": [
+                    [
+                      "Test",
+                      "0.0.0.0",
+                      "125.125.125.125"
+                    ]
+                  ],
+                  "updatedTime": "2020-02-04T12:49:41.027771+00:00"
+                },
+                "status": "NonFinding",
+                "resultsNotInBaseline": [],
+                "resultsOnlyInBaseline": []
+              },
+              "ruleMetadata": {
+                "ruleId": "VA2063",
+                "severity": "High",
+                "category": "SurfaceAreaReduction",
+                "ruleType": "NegativeList",
+                "title": "Server-level firewall rules should not grant excessive access",
+                "description": "The Azure SQL server-level firewall helps protect your server by preventing all access to your databases until you specify which IP addresses have permission. Server-level firewall rules grant access to all databases that belong to the server based on the originating IP address of each request.\n\nServer-level firewall rules can only be created and managed through Transact-SQL as well as through the Azure portal or PowerShell. For more details please see: https://docs.microsoft.com/en-us/azure/sql-database/sql-database-firewall-configure\n\nThis check verifies that server-level firewall rules do not grant excessive access.",
+                "rationale": "Often, administrators add rules that grant excessive access as part of a troubleshooting process � to eliminate the firewall as the source of a problem, they simply create a rule that allows all traffic to pass to the affected server.\n\nGranting excessive access using server firewall rules is a clear security concern, as it violates the principle of least privilege by allowing unnecessary access to your databases. In fact, it's the equivalent of placing the server outside of the firewall.",
+                "queryCheck": {
+                  "query": "SELECT name\n    ,start_ip_address\n    ,end_ip_address\nFROM sys.firewall_rules\nWHERE ( \n        (CONVERT(bigint, parsename(end_ip_address, 1)) +\n         CONVERT(bigint, parsename(end_ip_address, 2)) * 256 + \n         CONVERT(bigint, parsename(end_ip_address, 3)) * 65536 + \n         CONVERT(bigint, parsename(end_ip_address, 4)) * 16777216 ) \n        - \n        (CONVERT(bigint, parsename(start_ip_address, 1)) +\n         CONVERT(bigint, parsename(start_ip_address, 2)) * 256 + \n         CONVERT(bigint, parsename(start_ip_address, 3)) * 65536 + \n         CONVERT(bigint, parsename(start_ip_address, 4)) * 16777216 )\n      ) > 255;",
+                  "expectedResult": [],
+                  "columnNames": [
+                    "Firewall Rule Name",
+                    "Start Address",
+                    "End Address"
+                  ]
+                },
+                "benchmarkReferences": []
+              }
+            }
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/security/resource-manager/Microsoft.Security/preview/2020-07-01-preview/examples/sqlVulnerabilityAssessmentsScanResultsOperations/ArcMachineScanResults_ListLatest.json b/specification/security/resource-manager/Microsoft.Security/preview/2020-07-01-preview/examples/sqlVulnerabilityAssessmentsScanResultsOperations/ArcMachineScanResults_ListLatest.json
new file mode 100644
index 000000000000..cfc44451420f
--- /dev/null
+++ b/specification/security/resource-manager/Microsoft.Security/preview/2020-07-01-preview/examples/sqlVulnerabilityAssessmentsScanResultsOperations/ArcMachineScanResults_ListLatest.json
@@ -0,0 +1,112 @@
+{
+  "parameters": {
+    "scanId": "latest",
+    "workspaceId": "55555555-6666-7777-8888-999999999999",
+    "api-version": "2020-07-01-preview",
+    "resourceId": "subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Rg/providers/Microsoft.HybridCompute/machines/MyMachine/sqlServers/server1/databases/master"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Rg/providers/Microsoft.HybridCompute/machines/MyMachine/sqlServers/server1/databases/master/providers/Microsoft.Security/sqlVulnerabilityAssessments/default/scans/Scheduled-20200623/scanResults/VA2062",
+            "name": "VA2062",
+            "type": "Microsoft.Security/sqlVulnerabilityAssessments/scans/scanResults",
+            "properties": {
+              "ruleId": "VA2062",
+              "status": "NonFinding",
+              "isTrimmed": false,
+              "queryResults": [],
+              "remediation": {
+                "description": "Remove database firewall rules that grant excessive access",
+                "scripts": [],
+                "automated": false,
+                "portalLink": ""
+              },
+              "baselineAdjustedResult": null,
+              "ruleMetadata": {
+                "ruleId": "VA2062",
+                "severity": "High",
+                "category": "SurfaceAreaReduction",
+                "ruleType": "NegativeList",
+                "title": "Database-level firewall rules should not grant excessive access",
+                "description": "The Azure SQL Database-level firewall helps protect your data by preventing all access to your database until you specify which IP addresses have permission. Database-level firewall rules grant access to the specific database based on the originating IP address of each request.\n\nDatabase-level firewall rules for master and user databases can only be created and managed through Transact-SQL (unlike server-level firewall rules which can also be created and managed using the Azure portal or PowerShell). For more details please see: https://docs.microsoft.com/en-us/azure/sql-database/sql-database-firewall-configure\n\nThis check verifies that database-level firewall rules do not grant excessive access.",
+                "rationale": "Often, administrators add rules that grant excessive access as part of a troubleshooting process - to eliminate the firewall as the source of a problem, they simply create a rule that allows all traffic to pass to the affected database.\n\nGranting excessive access using database firewall rules is a clear security concern, as it violates the principle of least privilege by allowing unnecessary access to your database. In fact, it's the equivalent of placing the database outside of the firewall.",
+                "queryCheck": {
+                  "query": "SELECT name\n    ,start_ip_address\n    ,end_ip_address\nFROM sys.database_firewall_rules\nWHERE ( \n        (CONVERT(bigint, parsename(end_ip_address, 1)) +\n         CONVERT(bigint, parsename(end_ip_address, 2)) * 256 + \n         CONVERT(bigint, parsename(end_ip_address, 3)) * 65536 + \n         CONVERT(bigint, parsename(end_ip_address, 4)) * 16777216 ) \n        - \n        (CONVERT(bigint, parsename(start_ip_address, 1)) +\n         CONVERT(bigint, parsename(start_ip_address, 2)) * 256 + \n         CONVERT(bigint, parsename(start_ip_address, 3)) * 65536 + \n         CONVERT(bigint, parsename(start_ip_address, 4)) * 16777216 )\n      ) > 255;",
+                  "expectedResult": [],
+                  "columnNames": [
+                    "Firewall Rule Name",
+                    "Start Address",
+                    "End Address"
+                  ]
+                },
+                "benchmarkReferences": []
+              }
+            }
+          },
+          {
+            "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Rg/providers/Microsoft.HybridCompute/machines/MyMachine/sqlServers/server1/databases/master/providers/Microsoft.Security/sqlVulnerabilityAssessments/default/scans/Scheduled-20200623/scanResults/VA2063",
+            "name": "VA2063",
+            "type": "Microsoft.Security/sqlVulnerabilityAssessments/scans/scanResults",
+            "properties": {
+              "ruleId": "VA2063",
+              "status": "Finding",
+              "isTrimmed": false,
+              "queryResults": [
+                [
+                  "Test",
+                  "0.0.0.0",
+                  "125.125.125.125"
+                ]
+              ],
+              "remediation": {
+                "description": "Remove server firewall rules that grant excessive access",
+                "scripts": [
+                  "EXECUTE sp_delete_firewall_rule N'Test';"
+                ],
+                "automated": false,
+                "portalLink": "ReviewServerFirewallRules"
+              },
+              "baselineAdjustedResult": {
+                "baseline": {
+                  "expectedResults": [
+                    [
+                      "Test",
+                      "0.0.0.0",
+                      "125.125.125.125"
+                    ]
+                  ],
+                  "updatedTime": "2020-02-04T12:49:41.027771+00:00"
+                },
+                "status": "NonFinding",
+                "resultsNotInBaseline": [],
+                "resultsOnlyInBaseline": []
+              },
+              "ruleMetadata": {
+                "ruleId": "VA2063",
+                "severity": "High",
+                "category": "SurfaceAreaReduction",
+                "ruleType": "NegativeList",
+                "title": "Server-level firewall rules should not grant excessive access",
+                "description": "The Azure SQL server-level firewall helps protect your server by preventing all access to your databases until you specify which IP addresses have permission. Server-level firewall rules grant access to all databases that belong to the server based on the originating IP address of each request.\n\nServer-level firewall rules can only be created and managed through Transact-SQL as well as through the Azure portal or PowerShell. For more details please see: https://docs.microsoft.com/en-us/azure/sql-database/sql-database-firewall-configure\n\nThis check verifies that server-level firewall rules do not grant excessive access.",
+                "rationale": "Often, administrators add rules that grant excessive access as part of a troubleshooting process � to eliminate the firewall as the source of a problem, they simply create a rule that allows all traffic to pass to the affected server.\n\nGranting excessive access using server firewall rules is a clear security concern, as it violates the principle of least privilege by allowing unnecessary access to your databases. In fact, it's the equivalent of placing the server outside of the firewall.",
+                "queryCheck": {
+                  "query": "SELECT name\n    ,start_ip_address\n    ,end_ip_address\nFROM sys.firewall_rules\nWHERE ( \n        (CONVERT(bigint, parsename(end_ip_address, 1)) +\n         CONVERT(bigint, parsename(end_ip_address, 2)) * 256 + \n         CONVERT(bigint, parsename(end_ip_address, 3)) * 65536 + \n         CONVERT(bigint, parsename(end_ip_address, 4)) * 16777216 ) \n        - \n        (CONVERT(bigint, parsename(start_ip_address, 1)) +\n         CONVERT(bigint, parsename(start_ip_address, 2)) * 256 + \n         CONVERT(bigint, parsename(start_ip_address, 3)) * 65536 + \n         CONVERT(bigint, parsename(start_ip_address, 4)) * 16777216 )\n      ) > 255;",
+                  "expectedResult": [],
+                  "columnNames": [
+                    "Firewall Rule Name",
+                    "Start Address",
+                    "End Address"
+                  ]
+                },
+                "benchmarkReferences": []
+              }
+            }
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/security/resource-manager/Microsoft.Security/preview/2020-07-01-preview/sqlVulnerabilityAssessmentsBaselineRuleOperations.json b/specification/security/resource-manager/Microsoft.Security/preview/2020-07-01-preview/sqlVulnerabilityAssessmentsBaselineRuleOperations.json
new file mode 100644
index 000000000000..c48ce34bd212
--- /dev/null
+++ b/specification/security/resource-manager/Microsoft.Security/preview/2020-07-01-preview/sqlVulnerabilityAssessmentsBaselineRuleOperations.json
@@ -0,0 +1,412 @@
+{
+  "swagger": "2.0",
+  "info": {
+    "title": "Security Center",
+    "version": "2020-07-01-preview"
+  },
+  "host": "management.azure.com",
+  "schemes": [
+    "https"
+  ],
+  "paths": {
+    "/{resourceId}/providers/Microsoft.Security/sqlVulnerabilityAssessments/default/baselineRules/{ruleId}": {
+      "put": {
+        "tags": [
+          "Sql Vulnerability Assessment Baseline Rules"
+        ],
+        "summary": "Creates a Baseline for a rule in a database. Will overwrite any previously existing results.",
+        "operationId": "SqlVulnerabilityAssessmentBaselineRules_CreateOrUpdate",
+        "consumes": [
+          "application/json"
+        ],
+        "produces": [
+          "application/json"
+        ],
+        "parameters": [
+          {
+            "in": "path",
+            "name": "ruleId",
+            "description": "The rule Id.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "in": "query",
+            "name": "workspaceId",
+            "description": "The workspace Id.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "in": "query",
+            "name": "api-version",
+            "description": "The api version.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "$ref": "../../../common/v1/types.json#/parameters/ResourceId"
+          },
+          {
+            "in": "body",
+            "name": "body",
+            "description": "The baseline results for this rule.",
+            "schema": {
+              "$ref": "#/definitions/RuleResultsInput"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Successfully set the vulnerability assessment rule baseline.",
+            "schema": {
+              "$ref": "#/definitions/RuleResults"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "../../../common/v1/types.json#/definitions/CloudError"
+            }
+          }
+        },
+        "x-ms-examples": {
+          "Create a baseline": {
+            "$ref": "./examples/sqlVulnerabilityAssessmentsBaselineRuleOperations/ArcMachineBaselineRules_Put.json"
+          },
+          "Create a baseline using the latest scan results": {
+            "$ref": "./examples/sqlVulnerabilityAssessmentsBaselineRuleOperations/ArcMachineBaselineRules_PutLatest.json"
+          }
+        }
+      },
+      "get": {
+        "tags": [
+          "Sql Vulnerability Assessment Baseline Rules"
+        ],
+        "summary": "Gets the results for a given rule in the Baseline.",
+        "operationId": "SqlVulnerabilityAssessmentBaselineRules_Get",
+        "produces": [
+          "application/json"
+        ],
+        "parameters": [
+          {
+            "in": "path",
+            "name": "ruleId",
+            "description": "The rule Id.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "in": "query",
+            "name": "workspaceId",
+            "description": "The workspace Id.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "in": "query",
+            "name": "api-version",
+            "description": "The api version.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "$ref": "../../../common/v1/types.json#/parameters/ResourceId"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Successfully got the vulnerability assessment rule baseline.",
+            "schema": {
+              "$ref": "#/definitions/RuleResults"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "../../../common/v1/types.json#/definitions/CloudError"
+            }
+          }
+        },
+        "x-ms-examples": {
+          "Get the baseline": {
+            "$ref": "./examples/sqlVulnerabilityAssessmentsBaselineRuleOperations/ArcMachineBaselineRules_Get.json"
+          }
+        }
+      },
+      "delete": {
+        "tags": [
+          "Sql Vulnerability Assessment Baseline Rules"
+        ],
+        "summary": "Deletes a rule from the Baseline of a given database.",
+        "operationId": "SqlVulnerabilityAssessmentBaselineRules_Delete",
+        "produces": [
+          "application/json"
+        ],
+        "parameters": [
+          {
+            "in": "path",
+            "name": "ruleId",
+            "description": "The rule Id.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "in": "query",
+            "name": "workspaceId",
+            "description": "The workspace Id.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "in": "query",
+            "name": "api-version",
+            "description": "The api version.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "$ref": "../../../common/v1/types.json#/parameters/ResourceId"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Successfully removed the database vulnerability assessment rule baseline."
+          },
+          "204": {
+            "description": "Rule baseline doesn't exist."
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "../../../common/v1/types.json#/definitions/CloudError"
+            }
+          }
+        },
+        "x-ms-examples": {
+          "Delete the baseline": {
+            "$ref": "./examples/sqlVulnerabilityAssessmentsBaselineRuleOperations/ArcMachineBaselineRules_Delete.json"
+          }
+        }
+      }
+    },
+    "/{resourceId}/providers/Microsoft.Security/sqlVulnerabilityAssessments/default/baselineRules": {
+      "get": {
+        "tags": [
+          "Sql Vulnerability Assessment Baseline Rules"
+        ],
+        "summary": "Gets the results for all rules in the Baseline.",
+        "operationId": "SqlVulnerabilityAssessmentBaselineRules_List",
+        "produces": [
+          "application/json"
+        ],
+        "parameters": [
+          {
+            "in": "query",
+            "name": "workspaceId",
+            "description": "The workspace Id.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "in": "query",
+            "name": "api-version",
+            "description": "The api version.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "$ref": "../../../common/v1/types.json#/parameters/ResourceId"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Successfully removed the database vulnerability assessment rule baseline.",
+            "schema": {
+              "$ref": "#/definitions/RulesResults"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "../../../common/v1/types.json#/definitions/CloudError"
+            }
+          }
+        },
+        "x-ms-examples": {
+          "List baseline for all rules": {
+            "$ref": "./examples/sqlVulnerabilityAssessmentsBaselineRuleOperations/ArcMachineBaselineRules_List.json"
+          }
+        }
+      },
+      "post": {
+        "tags": [
+          "Sql Vulnerability Assessment Baseline Rules"
+        ],
+        "summary": "Add a list of baseline rules. Will overwrite any previously existing results (for all rules).",
+        "operationId": "SqlVulnerabilityAssessmentBaselineRules_Add",
+        "consumes": [
+          "application/json"
+        ],
+        "produces": [
+          "application/json"
+        ],
+        "parameters": [
+          {
+            "in": "query",
+            "name": "workspaceId",
+            "description": "The workspace Id.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "in": "query",
+            "name": "api-version",
+            "description": "The api version.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "$ref": "../../../common/v1/types.json#/parameters/ResourceId"
+          },
+          {
+            "in": "body",
+            "name": "body",
+            "description": "The baseline rules.",
+            "schema": {
+              "$ref": "#/definitions/RulesResultsInput"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Successfully removed the database vulnerability assessment rule baseline.",
+            "schema": {
+              "$ref": "#/definitions/RulesResults"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "../../../common/v1/types.json#/definitions/CloudError"
+            }
+          }
+        },
+        "x-ms-examples": {
+          "Create a baseline for all rules": {
+            "$ref": "./examples/sqlVulnerabilityAssessmentsBaselineRuleOperations/ArcMachineBaselineRules_Add.json"
+          },
+          "Create a baseline for all rules using the latest scan results": {
+            "$ref": "./examples/sqlVulnerabilityAssessmentsBaselineRuleOperations/ArcMachineBaselineRules_AddLatest.json"
+          }
+        }
+      }
+    }
+  },
+  "definitions": {
+    "RuleResultsInput": {
+      "description": "Rule results input.",
+      "type": "object",
+      "properties": {
+        "latestScan": {
+          "description": "Take results from latest scan.",
+          "type": "boolean"
+        },
+        "results": {
+          "description": "Expected results to be inserted into the baseline.\r\nLeave this field empty it LatestScan == true.",
+          "type": "array",
+          "items": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          }
+        }
+      }
+    },
+    "RuleResultsProperties": {
+      "description": "Rule results properties.",
+      "type": "object",
+      "properties": {
+        "results": {
+          "description": "Expected results in the baseline.",
+          "type": "array",
+          "items": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          }
+        }
+      }
+    },
+    "RuleResults": {
+      "description": "Rule results.",
+      "type": "object",
+      "allOf": [
+        {
+          "$ref": "../../../common/v1/types.json#/definitions/Resource"
+        }
+      ],
+      "properties": {
+        "properties": {
+          "$ref": "#/definitions/RuleResultsProperties"
+        }
+      }
+    },
+    "RulesResults": {
+      "description": "A list of rules results.",
+      "type": "object",
+      "properties": {
+        "value": {
+          "description": "List of rule results.",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/RuleResults"
+          }
+        }
+      }
+    },
+    "RulesResultsInput": {
+      "description": "Rules results input.",
+      "type": "object",
+      "properties": {
+        "latestScan": {
+          "description": "Take results from latest scan.",
+          "type": "boolean"
+        },
+        "results": {
+          "description": "Expected results to be inserted into the baseline.\r\nLeave this field empty it LatestScan == true.",
+          "type": "object",
+          "additionalProperties": {
+            "type": "array",
+            "items": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            }
+          }
+        }
+      }
+    }
+  },
+  "securityDefinitions": {
+    "azure_auth": {
+      "type": "oauth2",
+      "flow": "implicit",
+      "authorizationUrl": "https://login.microsoftonline.com/common/oauth2/authorize",
+      "scopes": {
+        "user_impersonation": "impersonate your user account"
+      },
+      "description": "Azure Active Directory OAuth2 Flow"
+    }
+  },
+  "security": [
+    {
+      "azure_auth": [
+        "user_impersonation"
+      ]
+    }
+  ]
+}
diff --git a/specification/security/resource-manager/Microsoft.Security/preview/2020-07-01-preview/sqlVulnerabilityAssessmentsScanOperations.json b/specification/security/resource-manager/Microsoft.Security/preview/2020-07-01-preview/sqlVulnerabilityAssessmentsScanOperations.json
new file mode 100644
index 000000000000..2ea38333fe25
--- /dev/null
+++ b/specification/security/resource-manager/Microsoft.Security/preview/2020-07-01-preview/sqlVulnerabilityAssessmentsScanOperations.json
@@ -0,0 +1,292 @@
+{
+  "swagger": "2.0",
+  "info": {
+    "title": "Security Center",
+    "version": "2020-07-01-preview"
+  },
+  "host": "management.azure.com",
+  "schemes": [
+    "https"
+  ],
+  "paths": {
+    "/{resourceId}/providers/Microsoft.Security/sqlVulnerabilityAssessments/default/scans/{scanId}": {
+      "get": {
+        "tags": [
+          "Sql Vulnerability Assessment Scans"
+        ],
+        "summary": "Gets the scan details of a single scan record.",
+        "operationId": "SqlVulnerabilityAssessmentScans_Get",
+        "produces": [
+          "application/json"
+        ],
+        "parameters": [
+          {
+            "in": "path",
+            "name": "scanId",
+            "description": "The scan Id. Type 'latest' to get the scan record for the latest scan.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "in": "query",
+            "name": "workspaceId",
+            "description": "The workspace Id.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "in": "query",
+            "name": "api-version",
+            "description": "The api version.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "$ref": "../../../common/v1/types.json#/parameters/ResourceId"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Returns the scan record details.",
+            "schema": {
+              "$ref": "#/definitions/Scan"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "../../../common/v1/types.json#/definitions/CloudError"
+            }
+          }
+        },
+        "x-ms-examples": {
+          "Get scan details of a scan record": {
+            "$ref": "./examples/sqlVulnerabilityAssessmentScanOperations/ArcMachineScans_Get.json"
+          },
+          "Get scan details of the latest scan record": {
+            "$ref": "./examples/sqlVulnerabilityAssessmentScanOperations/ArcMachineScans_GetLatest.json"
+          }
+        }
+      }
+    },
+    "/{resourceId}/providers/Microsoft.Security/sqlVulnerabilityAssessments/default/scans": {
+      "get": {
+        "tags": [
+          "Sql Vulnerability Assessment Scans"
+        ],
+        "summary": "Gets a list of scan records.",
+        "operationId": "SqlVulnerabilityAssessmentScans_List",
+        "produces": [
+          "application/json"
+        ],
+        "parameters": [
+          {
+            "in": "query",
+            "name": "workspaceId",
+            "description": "The workspace Id.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "in": "query",
+            "name": "api-version",
+            "description": "The api version.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "$ref": "../../../common/v1/types.json#/parameters/ResourceId"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Returns the list of scan records.",
+            "schema": {
+              "$ref": "#/definitions/Scans"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "../../../common/v1/types.json#/definitions/CloudError"
+            }
+          }
+        },
+        "x-ms-examples": {
+          "List scan details": {
+            "$ref": "./examples/sqlVulnerabilityAssessmentScanOperations/ArcMachineScans_List.json"
+          }
+        }
+      }
+    }
+  },
+  "definitions": {
+    "ScanTriggerType": {
+      "description": "The scan trigger type.",
+      "enum": [
+        "OnDemand",
+        "Recurring"
+      ],
+      "type": "string",
+      "x-ms-enum": {
+        "name": "ScanTriggerType",
+        "modelAsString": true,
+        "values": [
+          {
+            "value": "OnDemand",
+            "description": "OnDemand"
+          },
+          {
+            "value": "Recurring",
+            "description": "Recurring"
+          }
+        ]
+      }
+    },
+    "ScanState": {
+      "description": "The scan status.",
+      "enum": [
+        "Failed",
+        "FailedToRun",
+        "InProgress",
+        "Passed"
+      ],
+      "type": "string",
+      "x-ms-enum": {
+        "name": "ScanState",
+        "modelAsString": true,
+        "values": [
+          {
+            "value": "Failed",
+            "description": "Failed"
+          },
+          {
+            "value": "FailedToRun",
+            "description": "FailedToRun"
+          },
+          {
+            "value": "InProgress",
+            "description": "InProgress"
+          },
+          {
+            "value": "Passed",
+            "description": "Passed"
+          }
+        ]
+      }
+    },
+    "ScanProperties": {
+      "description": "A vulnerability assessment scan record properties.",
+      "type": "object",
+      "properties": {
+        "triggerType": {
+          "$ref": "#/definitions/ScanTriggerType"
+        },
+        "state": {
+          "$ref": "#/definitions/ScanState"
+        },
+        "server": {
+          "description": "The server name.",
+          "type": "string"
+        },
+        "database": {
+          "description": "The database name.",
+          "type": "string"
+        },
+        "sqlVersion": {
+          "description": "The SQL version.",
+          "type": "string"
+        },
+        "startTime": {
+          "format": "date-time",
+          "description": "The scan start time (UTC).",
+          "type": "string"
+        },
+        "endTime": {
+          "format": "date-time",
+          "description": "Scan results are valid until end time (UTC).",
+          "type": "string"
+        },
+        "highSeverityFailedRulesCount": {
+          "format": "int32",
+          "description": "The number of failed rules with high severity.",
+          "type": "integer"
+        },
+        "mediumSeverityFailedRulesCount": {
+          "format": "int32",
+          "description": "The number of failed rules with medium severity.",
+          "type": "integer"
+        },
+        "lowSeverityFailedRulesCount": {
+          "format": "int32",
+          "description": "The number of failed rules with low severity.",
+          "type": "integer"
+        },
+        "totalPassedRulesCount": {
+          "format": "int32",
+          "description": "The number of total passed rules.",
+          "type": "integer"
+        },
+        "totalFailedRulesCount": {
+          "format": "int32",
+          "description": "The number of total failed rules.",
+          "type": "integer"
+        },
+        "totalRulesCount": {
+          "format": "int32",
+          "description": "The number of total rules assessed.",
+          "type": "integer"
+        },
+        "isBaselineApplied": {
+          "description": "Baseline created for this database, and has one or more rules.",
+          "type": "boolean"
+        }
+      }
+    },
+    "Scan": {
+      "description": "A vulnerability assessment scan record.",
+      "type": "object",
+      "allOf": [
+        {
+          "$ref": "../../../common/v1/types.json#/definitions/Resource"
+        }
+      ],
+      "properties": {
+        "properties": {
+          "$ref": "#/definitions/ScanProperties"
+        }
+      }
+    },
+    "Scans": {
+      "description": "A list of vulnerability assessment scan records.",
+      "type": "object",
+      "properties": {
+        "value": {
+          "description": "List of vulnerability assessment scan records.",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/Scan"
+          }
+        }
+      }
+    }
+  },
+  "securityDefinitions": {
+    "azure_auth": {
+      "type": "oauth2",
+      "flow": "implicit",
+      "authorizationUrl": "https://login.microsoftonline.com/common/oauth2/authorize",
+      "scopes": {
+        "user_impersonation": "impersonate your user account"
+      },
+      "description": "Azure Active Directory OAuth2 Flow"
+    }
+  },
+  "security": [
+    {
+      "azure_auth": [
+        "user_impersonation"
+      ]
+    }
+  ]
+}
diff --git a/specification/security/resource-manager/Microsoft.Security/preview/2020-07-01-preview/sqlVulnerabilityAssessmentsScanResultsOperations.json b/specification/security/resource-manager/Microsoft.Security/preview/2020-07-01-preview/sqlVulnerabilityAssessmentsScanResultsOperations.json
new file mode 100644
index 000000000000..de9d8bc3aed9
--- /dev/null
+++ b/specification/security/resource-manager/Microsoft.Security/preview/2020-07-01-preview/sqlVulnerabilityAssessmentsScanResultsOperations.json
@@ -0,0 +1,480 @@
+{
+  "swagger": "2.0",
+  "info": {
+    "title": "Security Center",
+    "version": "2020-07-01-preview"
+  },
+  "host": "management.azure.com",
+  "schemes": [
+    "https"
+  ],
+  "paths": {
+    "/{resourceId}/providers/Microsoft.Security/sqlVulnerabilityAssessments/default/scans/{scanId}/scanResults/{scanResultId}": {
+      "get": {
+        "tags": [
+          "Sql Vulnerability Assessment Scan Results"
+        ],
+        "summary": "Gets the scan results of a single rule in a scan record.",
+        "operationId": "SqlVulnerabilityAssessmentScanResults_Get",
+        "produces": [
+          "application/json"
+        ],
+        "parameters": [
+          {
+            "in": "path",
+            "name": "scanId",
+            "description": "The scan Id. Type 'latest' to get the scan results for the latest scan.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "in": "path",
+            "name": "scanResultId",
+            "description": "The rule Id of the results.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "in": "query",
+            "name": "workspaceId",
+            "description": "The workspace Id.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "in": "query",
+            "name": "api-version",
+            "description": "The api version.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "$ref": "../../../common/v1/types.json#/parameters/ResourceId"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Returns the scan results.",
+            "schema": {
+              "$ref": "#/definitions/ScanResult"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "../../../common/v1/types.json#/definitions/CloudError"
+            }
+          }
+        },
+        "x-ms-examples": {
+          "Get scan details of a scan record": {
+            "$ref": "./examples/sqlVulnerabilityAssessmentsScanResultsOperations/ArcMachineScanResults_Get.json"
+          },
+          "Get scan details of the latest scan record": {
+            "$ref": "./examples/sqlVulnerabilityAssessmentsScanResultsOperations/ArcMachineScanResults_GetLatest.json"
+          }
+        }
+      }
+    },
+    "/{resourceId}/providers/Microsoft.Security/sqlVulnerabilityAssessments/default/scans/{scanId}/scanResults": {
+      "get": {
+        "tags": [
+          "Sql Vulnerability Assessment Scan Results"
+        ],
+        "summary": "Gets a list of scan results for a single scan record.",
+        "operationId": "SqlVulnerabilityAssessmentScanResults_List",
+        "produces": [
+          "application/json"
+        ],
+        "parameters": [
+          {
+            "in": "path",
+            "name": "scanId",
+            "description": "The scan Id. Type 'latest' to get the scan results for the latest scan.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "in": "query",
+            "name": "workspaceId",
+            "description": "The workspace Id.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "in": "query",
+            "name": "api-version",
+            "description": "The api version.",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "$ref": "../../../common/v1/types.json#/parameters/ResourceId"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Returns the list of scan results.",
+            "schema": {
+              "$ref": "#/definitions/ScanResults"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "../../../common/v1/types.json#/definitions/CloudError"
+            }
+          }
+        },
+        "x-ms-examples": {
+          "List scan results": {
+            "$ref": "./examples/sqlVulnerabilityAssessmentsScanResultsOperations/ArcMachineScanResults_List.json"
+          },
+          "List scan results of the latest scan": {
+            "$ref": "./examples/sqlVulnerabilityAssessmentsScanResultsOperations/ArcMachineScanResults_ListLatest.json"
+          }
+        }
+      }
+    }
+  },
+  "definitions": {
+    "RuleStatus": {
+      "description": "The rule result status.",
+      "enum": [
+        "NonFinding",
+        "Finding",
+        "InternalError"
+      ],
+      "type": "string",
+      "x-ms-enum": {
+        "name": "RuleStatus",
+        "modelAsString": true,
+        "values": [
+          {
+            "value": "NonFinding",
+            "description": "NonFinding"
+          },
+          {
+            "value": "Finding",
+            "description": "Finding"
+          },
+          {
+            "value": "InternalError",
+            "description": "InternalError"
+          }
+        ]
+      }
+    },
+    "Remediation": {
+      "description": "Remediation details.",
+      "type": "object",
+      "properties": {
+        "description": {
+          "description": "Remediation description.",
+          "type": "string"
+        },
+        "scripts": {
+          "description": "Remediation script.",
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "automated": {
+          "description": "Is remediation automated.",
+          "type": "boolean"
+        },
+        "portalLink": {
+          "description": "Optional link to remediate in Azure Portal.",
+          "type": "string"
+        }
+      }
+    },
+    "Baseline": {
+      "description": "Baseline details.",
+      "type": "object",
+      "properties": {
+        "expectedResults": {
+          "description": "Expected results.",
+          "type": "array",
+          "items": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          }
+        },
+        "updatedTime": {
+          "format": "date-time",
+          "description": "Baseline update time (UTC).",
+          "type": "string"
+        }
+      }
+    },
+    "BaselineAdjustedResult": {
+      "description": "The rule result adjusted with baseline.",
+      "type": "object",
+      "properties": {
+        "baseline": {
+          "$ref": "#/definitions/Baseline"
+        },
+        "status": {
+          "$ref": "#/definitions/RuleStatus"
+        },
+        "resultsNotInBaseline": {
+          "description": "Results the are not in baseline.",
+          "type": "array",
+          "items": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          }
+        },
+        "resultsOnlyInBaseline": {
+          "description": "Results the are in baseline.",
+          "type": "array",
+          "items": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          }
+        }
+      }
+    },
+    "RuleSeverity": {
+      "description": "The rule severity.",
+      "enum": [
+        "High",
+        "Medium",
+        "Low",
+        "Informational",
+        "Obsolete"
+      ],
+      "type": "string",
+      "x-ms-enum": {
+        "name": "RuleSeverity",
+        "modelAsString": true,
+        "values": [
+          {
+            "value": "High",
+            "description": "High"
+          },
+          {
+            "value": "Medium",
+            "description": "Medium"
+          },
+          {
+            "value": "Low",
+            "description": "Low"
+          },
+          {
+            "value": "Informational",
+            "description": "Informational"
+          },
+          {
+            "value": "Obsolete",
+            "description": "Obsolete"
+          }
+        ]
+      }
+    },
+    "RuleType": {
+      "description": "The rule type.",
+      "enum": [
+        "Binary",
+        "BaselineExpected",
+        "PositiveList",
+        "NegativeList"
+      ],
+      "type": "string",
+      "x-ms-enum": {
+        "name": "RuleType",
+        "modelAsString": true,
+        "values": [
+          {
+            "value": "Binary",
+            "description": "Binary"
+          },
+          {
+            "value": "BaselineExpected",
+            "description": "BaselineExpected"
+          },
+          {
+            "value": "PositiveList",
+            "description": "PositiveList"
+          },
+          {
+            "value": "NegativeList",
+            "description": "NegativeList"
+          }
+        ]
+      }
+    },
+    "QueryCheck": {
+      "description": "The rule query details.",
+      "type": "object",
+      "properties": {
+        "query": {
+          "description": "The rule query.",
+          "type": "string"
+        },
+        "expectedResult": {
+          "description": "Expected result.",
+          "type": "array",
+          "items": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          }
+        },
+        "columnNames": {
+          "description": "Column names of expected result.",
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        }
+      }
+    },
+    "BenchmarkReference": {
+      "description": "The benchmark references.",
+      "type": "object",
+      "properties": {
+        "benchmark": {
+          "description": "The benchmark name.",
+          "type": "string"
+        },
+        "reference": {
+          "description": "The benchmark reference.",
+          "type": "string"
+        }
+      }
+    },
+    "VaRule": {
+      "description": "vulnerability assessment rule metadata details.",
+      "type": "object",
+      "properties": {
+        "ruleId": {
+          "description": "The rule Id.",
+          "type": "string"
+        },
+        "severity": {
+          "$ref": "#/definitions/RuleSeverity"
+        },
+        "category": {
+          "description": "The rule category.",
+          "type": "string"
+        },
+        "ruleType": {
+          "$ref": "#/definitions/RuleType"
+        },
+        "title": {
+          "description": "The rule title.",
+          "type": "string"
+        },
+        "description": {
+          "description": "The rule description.",
+          "type": "string"
+        },
+        "rationale": {
+          "description": "The rule rationale.",
+          "type": "string"
+        },
+        "queryCheck": {
+          "$ref": "#/definitions/QueryCheck"
+        },
+        "benchmarkReferences": {
+          "description": "The benchmark references.",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/BenchmarkReference"
+          }
+        }
+      }
+    },
+    "ScanResultProperties": {
+      "description": "A vulnerability assessment scan result properties for a single rule.",
+      "type": "object",
+      "properties": {
+        "ruleId": {
+          "description": "The rule Id.",
+          "type": "string"
+        },
+        "status": {
+          "$ref": "#/definitions/RuleStatus"
+        },
+        "isTrimmed": {
+          "description": "Indicated whether the results specified here are trimmed.",
+          "type": "boolean"
+        },
+        "queryResults": {
+          "description": "The results of the query that was run.",
+          "type": "array",
+          "items": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          }
+        },
+        "remediation": {
+          "$ref": "#/definitions/Remediation"
+        },
+        "baselineAdjustedResult": {
+          "$ref": "#/definitions/BaselineAdjustedResult"
+        },
+        "ruleMetadata": {
+          "$ref": "#/definitions/VaRule"
+        }
+      }
+    },
+    "ScanResult": {
+      "description": "A vulnerability assessment scan result for a single rule.",
+      "type": "object",
+      "allOf": [
+        {
+          "$ref": "../../../common/v1/types.json#/definitions/Resource"
+        }
+      ],
+      "properties": {
+        "properties": {
+          "$ref": "#/definitions/ScanResultProperties"
+        }
+      }
+    },
+    "ScanResults": {
+      "description": "A list of vulnerability assessment scan results.",
+      "type": "object",
+      "properties": {
+        "value": {
+          "description": "List of vulnerability assessment scan results.",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/ScanResult"
+          }
+        }
+      }
+    }
+  },
+  "securityDefinitions": {
+    "azure_auth": {
+      "type": "oauth2",
+      "flow": "implicit",
+      "authorizationUrl": "https://login.microsoftonline.com/common/oauth2/authorize",
+      "scopes": {
+        "user_impersonation": "impersonate your user account"
+      },
+      "description": "Azure Active Directory OAuth2 Flow"
+    }
+  },
+  "security": [
+    {
+      "azure_auth": [
+        "user_impersonation"
+      ]
+    }
+  ]
+}
diff --git a/specification/security/resource-manager/Microsoft.Security/preview/2020-08-06-preview/devices.json b/specification/security/resource-manager/Microsoft.Security/preview/2020-08-06-preview/devices.json
new file mode 100644
index 000000000000..be173e7e497b
--- /dev/null
+++ b/specification/security/resource-manager/Microsoft.Security/preview/2020-08-06-preview/devices.json
@@ -0,0 +1,616 @@
+{
+  "swagger": "2.0",
+  "info": {
+    "title": "Security Center",
+    "description": "API spec for Microsoft.Security (Azure Security Center) resource provider",
+    "version": "2020-08-06-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.Security/devices": {
+      "get": {
+        "x-ms-examples": {
+          "Get Devices": {
+            "$ref": "./examples/Devices/GetDevicesListForSubscription.json"
+          }
+        },
+        "tags": [
+          "Device Inventory"
+        ],
+        "description": "Get list of the devices by their subscription.",
+        "operationId": "DevicesForSubscription_List",
+        "parameters": [
+          {
+            "$ref": "../../../common/v1/types.json#/parameters/ApiVersion"
+          },
+          {
+            "$ref": "../../../common/v1/types.json#/parameters/SubscriptionId"
+          },
+          {
+            "in": "query",
+            "name": "$limit",
+            "required": false,
+            "type": "integer",
+            "format": "int32",
+            "description": "Limit the number of items returned in a single page"
+          },
+          {
+            "in": "query",
+            "name": "$skipToken",
+            "required": false,
+            "type": "string",
+            "description": "Skip token used for pagination"
+          },
+          {
+            "in": "query",
+            "name": "deviceManagementType",
+            "required": false,
+            "type": "string",
+            "enum": [
+              "Managed",
+              "Unmanaged"
+            ],
+            "description": "Get devices only from specific type, Managed or Unmanaged.",
+            "x-ms-enum": {
+              "name": "ManagementState",
+              "modelAsString": true
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/DeviceList"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "../../../common/v1/types.json#/definitions/CloudError"
+            }
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        }
+      }
+    },
+    "/{resourceId}/providers/Microsoft.Security/devices": {
+      "get": {
+        "x-ms-examples": {
+          "Get Devices": {
+            "$ref": "./examples/Devices/GetDevicesListForHub.json"
+          }
+        },
+        "tags": [
+          "Device Inventory"
+        ],
+        "description": "Get list of the devices for the specified IoT Hub resource.",
+        "operationId": "DevicesForHub_List",
+        "parameters": [
+          {
+            "$ref": "../../../common/v1/types.json#/parameters/ApiVersion"
+          },
+          {
+            "$ref": "../../../common/v1/types.json#/parameters/ResourceId"
+          },
+          {
+            "in": "query",
+            "name": "$limit",
+            "required": false,
+            "type": "integer",
+            "format": "int32",
+            "description": "Limit the number of items returned in a single page"
+          },
+          {
+            "in": "query",
+            "name": "$skipToken",
+            "required": false,
+            "type": "string",
+            "description": "Skip token used for pagination"
+          },
+          {
+            "in": "query",
+            "name": "deviceManagementType",
+            "required": false,
+            "type": "string",
+            "enum": [
+              "Managed",
+              "Unmanaged"
+            ],
+            "description": "Get devices only from specific type, Managed or Unmanaged.",
+            "x-ms-enum": {
+              "name": "ManagementState",
+              "modelAsString": true
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/DeviceList"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "../../../common/v1/types.json#/definitions/CloudError"
+            }
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        }
+      }
+    },
+    "/{resourceId}/providers/Microsoft.Security/devices/{deviceId}": {
+      "get": {
+        "x-ms-examples": {
+          "Get Device": {
+            "$ref": "./examples/Devices/GetDevice.json"
+          }
+        },
+        "tags": [
+          "Device Inventory"
+        ],
+        "description": "Get device.",
+        "operationId": "Device_Get",
+        "parameters": [
+          {
+            "$ref": "../../../common/v1/types.json#/parameters/ApiVersion"
+          },
+          {
+            "$ref": "../../../common/v1/types.json#/parameters/ResourceId"
+          },
+          {
+            "$ref": "#/parameters/DeviceId"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/Device"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "../../../common/v1/types.json#/definitions/CloudError"
+            }
+          }
+        }
+      }
+    }
+  },
+  "definitions": {
+    "DeviceList": {
+      "description": "List of Devices",
+      "required": [
+        "value"
+      ],
+      "properties": {
+        "value": {
+          "type": "array",
+          "description": "List of devices",
+          "items": {
+            "$ref": "#/definitions/Device"
+          }
+        },
+        "nextLink": {
+          "readOnly": true,
+          "type": "string",
+          "description": "When there are too many devices for one page, use this URI to fetch the next page."
+        }
+      }
+    },
+    "Device": {
+      "type": "object",
+      "description": "Device model",
+      "properties": {
+        "properties": {
+          "x-ms-client-flatten": true,
+          "description": "Device data",
+          "$ref": "#/definitions/DeviceProperties"
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "../../../common/v1/types.json#/definitions/Resource"
+        }
+      ]
+    },
+    "DeviceProperties": {
+      "type": "object",
+      "description": "Device Information",
+      "properties": {
+        "displayName": {
+          "type": "string",
+          "description": "Device display name given by the collector"
+        },
+        "deviceType": {
+          "type": "string",
+          "description": "Device type."
+        },
+        "sourceName": {
+          "readOnly": true,
+          "type": "string",
+          "description": "The source that created the device"
+        },
+        "networkInterfaces": {
+          "readOnly": true,
+          "type": "array",
+          "description": "List of network interfaces.",
+          "items": {
+            "$ref": "#/definitions/NetworkInterface"
+          }
+        },
+        "vendor": {
+          "readOnly": true,
+          "type": "string",
+          "description": "Device vendor"
+        },
+        "osName": {
+          "description": "Device operating system name.",
+          "type": "string"
+        },
+        "protocols": {
+          "readOnly": true,
+          "type": "array",
+          "description": "List of protocols.",
+          "items": {
+            "$ref": "#/definitions/Protocol"
+          }
+        },
+        "lastActiveTime": {
+          "readOnly": true,
+          "type": "string",
+          "format": "date-time",
+          "description": "last time the device was active in the network"
+        },
+        "lastUpdateTime": {
+          "readOnly": true,
+          "type": "string",
+          "format": "date-time",
+          "description": "last time the device was updated"
+        },
+        "managementState": {
+          "readOnly": true,
+          "type": "string",
+          "enum": [
+            "Managed",
+            "Unmanaged"
+          ],
+          "description": "Managed state of the device.",
+          "x-ms-enum": {
+            "name": "ManagementState",
+            "modelAsString": true
+          }
+        },
+        "authorizationState": {
+          "type": "string",
+          "enum": [
+            "Authorized",
+            "Unauthorized"
+          ],
+          "default": "Unauthorized",
+          "description": "Authorized state of the device.",
+          "x-ms-enum": {
+            "name": "AuthorizationState",
+            "modelAsString": true
+          }
+        },
+        "deviceCriticality": {
+          "type": "string",
+          "enum": [
+            "Important",
+            "Standard"
+          ],
+          "default": "Standard",
+          "x-ms-enum": {
+            "name": "DeviceCriticality",
+            "modelAsString": true
+          },
+          "description": "Device criticality."
+        },
+        "purdueLevel": {
+          "type": "string",
+          "enum": [
+            "ProcessControl",
+            "Supervisory",
+            "Enterprise"
+          ],
+          "default": "ProcessControl",
+          "x-ms-enum": {
+            "name": "PurdueLevel",
+            "modelAsString": true
+          },
+          "description": "Purdue level of the device."
+        },
+        "notes": {
+          "type": "string",
+          "description": "user notes for the device, up to 300 characters."
+        },
+        "firmwares": {
+          "readOnly": true,
+          "type": "array",
+          "description": "List of device firmwares.",
+          "items": {
+            "$ref": "#/definitions/Firmware"
+          }
+        },
+        "discoveryTime": {
+          "readOnly": true,
+          "type": "string",
+          "format": "date-time",
+          "description": "Discovered time of the device."
+        },
+        "programmingState": {
+          "readOnly": true,
+          "type": "string",
+          "enum": [
+            "ProgrammingDevice",
+            "NotProgrammingDevice"
+          ],
+          "x-ms-enum": {
+            "name": "ProgrammingState",
+            "modelAsString": true
+          },
+          "description": "Indicates whether this device is programming"
+        },
+        "lastProgrammingTime": {
+          "readOnly": true,
+          "type": "string",
+          "format": "date-time",
+          "description": "last time the device was programming or programed."
+        },
+        "scanningFunctionality": {
+          "readOnly": true,
+          "type": "string",
+          "enum": [
+            "ScannerDevice",
+            "NotScannerDevice"
+          ],
+          "x-ms-enum": {
+            "name": "ScanningFunctionality",
+            "modelAsString": true
+          },
+          "description": "Indicates whether the device is a scanner"
+        },
+        "lastScanTime": {
+          "readOnly": true,
+          "type": "string",
+          "format": "date-time",
+          "description": "last time the device was scanning."
+        },
+        "riskScore": {
+          "readOnly": true,
+          "type": "integer",
+          "format": "int32",
+          "minimum": 0,
+          "maximum": 100,
+          "description": "risk score of the device."
+        },
+        "sensorName": {
+          "readOnly": true,
+          "type": "string",
+          "description": "When the device is unmanaged, the sensor that scanned this device."
+        },
+        "siteName": {
+          "readOnly": true,
+          "type": "string",
+          "description": "The sensor site name."
+        },
+        "zoneName": {
+          "readOnly": true,
+          "type": "string",
+          "description": "The sensor zone name."
+        },
+        "deviceStatus": {
+          "readOnly": true,
+          "type": "string",
+          "enum": [
+            "Active",
+            "Removed"
+          ],
+          "x-ms-enum": {
+            "name": "DeviceStatus",
+            "modelAsString": true
+          },
+          "description": "Device status."
+        }
+      }
+    },
+    "NetworkInterface": {
+      "type": "object",
+      "description": "Network interface",
+      "properties": {
+        "ipAddress": {
+          "$ref": "#/definitions/IpAddress"
+        },
+        "macAddress": {
+          "$ref": "#/definitions/MacAddress"
+        },
+        "vlans": {
+          "readOnly": true,
+          "type": "array",
+          "description": "List of device vlans.",
+          "items": {
+            "type": "string"
+          }
+        }
+      }
+    },
+    "IpAddress": {
+      "type": "object",
+      "description": "IP Address information",
+      "properties": {
+        "v4Address": {
+          "readOnly": true,
+          "type": "string",
+          "description": "IPV4 address"
+        },
+        "detectionTime": {
+          "readOnly": true,
+          "type": "string",
+          "format": "date-time",
+          "description": "Detection time of the ip address."
+        },
+        "subnetCidr": {
+          "readOnly": true,
+          "type": "string",
+          "description": "Subnet Classless Inter-Domain Routing"
+        },
+        "fqdn": {
+          "readOnly": true,
+          "type": "string",
+          "description": "Fully qualified domain name"
+        },
+        "fqdnLastLookupTime": {
+          "readOnly": true,
+          "type": "string",
+          "format": "date-time",
+          "description": "FQDN last lookup time."
+        }
+      }
+    },
+    "MacAddress": {
+      "type": "object",
+      "description": "MAC Address information",
+      "properties": {
+        "address": {
+          "readOnly": true,
+          "type": "string",
+          "description": "MAC address"
+        },
+        "detectionTime": {
+          "readOnly": true,
+          "type": "string",
+          "format": "date-time",
+          "description": "Detection time of the mac address."
+        },
+        "significance": {
+          "readOnly": true,
+          "type": "string",
+          "enum": [
+            "Primary",
+            "Secondary"
+          ],
+          "x-ms-enum": {
+            "name": "MacSignificance",
+            "modelAsString": true
+          },
+          "description": "Indicates whether this is the primary secondary MAC address of the device"
+        },
+        "relationToIpStatus": {
+          "readOnly": true,
+          "type": "string",
+          "enum": [
+            "Guess",
+            "Certain"
+          ],
+          "x-ms-enum": {
+            "name": "RelationToIpStatus",
+            "modelAsString": true
+          },
+          "description": "Indicates whether the relation of the mac to the ip address is certain or a guess"
+        }
+      }
+    },
+    "Firmware": {
+      "type": "object",
+      "description": "Firmware information",
+      "properties": {
+        "moduleAddress": {
+          "readOnly": true,
+          "type": "string",
+          "description": "Address of the specific module a firmware is related to"
+        },
+        "rack": {
+          "readOnly": true,
+          "type": "string",
+          "description": "Rack number of the module a firmware is related to."
+        },
+        "slot": {
+          "readOnly": true,
+          "type": "string",
+          "description": "Slot number in the rack of the module a firmware is related to"
+        },
+        "serial": {
+          "readOnly": true,
+          "type": "string",
+          "description": "Serial of the firmware"
+        },
+        "model": {
+          "readOnly": true,
+          "type": "string",
+          "description": "Firmware model"
+        },
+        "version": {
+          "readOnly": true,
+          "type": "string",
+          "description": "Firmware version"
+        },
+        "additionalData": {
+          "readOnly": true,
+          "type": "object",
+          "description": " A bag of fields which extends the firmware information."
+        }
+      }
+    },
+    "Protocol": {
+      "type": "object",
+      "description": "Protocol data",
+      "properties": {
+        "name": {
+          "readOnly": true,
+          "type": "string",
+          "description": "Protocol name"
+        },
+        "identifiers": {
+          "type": "string",
+          "description": "list of protocol identifiers."
+        }
+      }
+    }
+  },
+  "parameters": {
+    "DeviceId": {
+      "name": "deviceId",
+      "in": "path",
+      "required": true,
+      "description": "Identifier of the device.",
+      "type": "string",
+      "x-ms-parameter-location": "method"
+    }
+  }
+}
diff --git a/specification/security/resource-manager/Microsoft.Security/preview/2020-08-06-preview/examples/Devices/GetDevice.json b/specification/security/resource-manager/Microsoft.Security/preview/2020-08-06-preview/examples/Devices/GetDevice.json
new file mode 100644
index 000000000000..162758cf19c3
--- /dev/null
+++ b/specification/security/resource-manager/Microsoft.Security/preview/2020-08-06-preview/examples/Devices/GetDevice.json
@@ -0,0 +1,73 @@
+{
+  "parameters": {
+    "api-version": "2020-08-06-preview",
+    "resourceId": "subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/MyGroup/providers/Microsoft.Devices/iotHubs/myHub",
+    "deviceId": "myDevice"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/MyGroup/providers/Microsoft.Devices/iotHubs/myHub/providers/Microsoft.Security/devices/myDevice",
+        "name": "myDevice",
+        "type": "Microsoft.Security/devices",
+        "properties": {
+          "displayName": "10.168.140.1",
+          "deviceType": "PLC",
+          "sourceName": "HORIZON",
+          "networkInterfaces": [
+            {
+              "ipAddress": {
+                "v4Address": "10.168.140.1",
+                "detectionTime": "2020-05-13T06:32:25Z"
+              },
+              "macAddress": {
+                "address": "34-E1-2D-77-80-D0",
+                "detectionTime": "2020-05-13T06:32:25Z",
+                "significance": "Primary",
+                "relationToIpStatus": "Certain"
+              },
+              "vlans": [
+                "name(1)->2",
+                "3",
+                "another_name(4)"
+              ]
+            }
+          ],
+          "vendor": "BROADCOM",
+          "osName": "Windows 10 64",
+          "protocols": [
+            {
+              "name": "CIP",
+              "identifiers": "0, 1"
+            },
+            {
+              "name": "EtherNet/IP",
+              "identifiers": "0, 1"
+            }
+          ],
+          "lastActiveTime": "2020-05-13T06:32:25Z",
+          "lastUpdateTime": "2020-05-13T06:32:25Z",
+          "managementState": "Unmanaged",
+          "authorizationState": "Authorized",
+          "deviceCriticality": "Standard",
+          "purdueLevel": "ProcessControl",
+          "firmwares": [
+            {
+              "serial": "0x27269242",
+              "model": "1768-ENBT",
+              "version": "29.11"
+            }
+          ],
+          "discoveryTime": "2020-05-13T06:32:25Z",
+          "programmingState": "NotProgrammingDevice",
+          "scanningFunctionality": "NotScannerDevice",
+          "riskScore": 100,
+          "sensorName": "mySensor",
+          "siteName": "mySite",
+          "zoneName": "myZone",
+          "deviceStatus": "Active"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/security/resource-manager/Microsoft.Security/preview/2020-08-06-preview/examples/Devices/GetDevicesListForHub.json b/specification/security/resource-manager/Microsoft.Security/preview/2020-08-06-preview/examples/Devices/GetDevicesListForHub.json
new file mode 100644
index 000000000000..9bff57945fd5
--- /dev/null
+++ b/specification/security/resource-manager/Microsoft.Security/preview/2020-08-06-preview/examples/Devices/GetDevicesListForHub.json
@@ -0,0 +1,76 @@
+{
+  "parameters": {
+    "api-version": "2020-08-06-preview",
+    "resourceId": "subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/MyGroup/providers/Microsoft.Devices/iotHubs/myHub"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/MyGroup/providers/Microsoft.Devices/iotHubs/myHub/providers/Microsoft.Security/devices/myDevice",
+            "name": "myDevice",
+            "type": "Microsoft.Security/devices",
+            "properties": {
+              "displayName": "10.168.140.1",
+              "deviceType": "PLC",
+              "sourceName": "HORIZON",
+              "networkInterfaces": [
+                {
+                  "ipAddress": {
+                    "v4Address": "10.168.140.1",
+                    "detectionTime": "2020-05-13T06:32:25Z"
+                  },
+                  "macAddress": {
+                    "address": "34-E1-2D-77-80-D0",
+                    "detectionTime": "2020-05-13T06:32:25Z",
+                    "significance": "Primary",
+                    "relationToIpStatus": "Certain"
+                  },
+                  "vlans": [
+                    "name(1)->2",
+                    "3",
+                    "another_name(4)"
+                  ]
+                }
+              ],
+              "vendor": "BROADCOM",
+              "osName": "Windows 10 64",
+              "protocols": [
+                {
+                  "name": "CIP",
+                  "identifiers": "0, 1"
+                },
+                {
+                  "name": "EtherNet/IP",
+                  "identifiers": "0, 1"
+                }
+              ],
+              "lastActiveTime": "2020-05-13T06:32:25Z",
+              "lastUpdateTime": "2020-05-13T06:32:25Z",
+              "managementState": "Unmanaged",
+              "authorizationState": "Authorized",
+              "deviceCriticality": "Standard",
+              "purdueLevel": "ProcessControl",
+              "firmwares": [
+                {
+                  "serial": "0x27269242",
+                  "model": "1768-ENBT",
+                  "version": "29.11"
+                }
+              ],
+              "discoveryTime": "2020-05-13T06:32:25Z",
+              "programmingState": "NotProgrammingDevice",
+              "scanningFunctionality": "NotScannerDevice",
+              "riskScore": 100,
+              "sensorName": "mySensor",
+              "siteName": "mySite",
+              "zoneName": "myZone",
+              "deviceStatus": "Active"
+            }
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/security/resource-manager/Microsoft.Security/preview/2020-08-06-preview/examples/Devices/GetDevicesListForSubscription.json b/specification/security/resource-manager/Microsoft.Security/preview/2020-08-06-preview/examples/Devices/GetDevicesListForSubscription.json
new file mode 100644
index 000000000000..8552d79ac8a6
--- /dev/null
+++ b/specification/security/resource-manager/Microsoft.Security/preview/2020-08-06-preview/examples/Devices/GetDevicesListForSubscription.json
@@ -0,0 +1,76 @@
+{
+  "parameters": {
+    "api-version": "2020-08-06-preview",
+    "subscriptionId": "20ff7fc3-e762-44dd-bd96-b71116dcdc23"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/MyGroup/providers/Microsoft.Devices/iotHubs/myHub/providers/Microsoft.Security/devices/myDevice",
+            "name": "myDevice",
+            "type": "Microsoft.Security/devices",
+            "properties": {
+              "displayName": "10.168.140.1",
+              "deviceType": "PLC",
+              "sourceName": "HORIZON",
+              "networkInterfaces": [
+                {
+                  "ipAddress": {
+                    "v4Address": "10.168.140.1",
+                    "detectionTime": "2020-05-13T06:32:25Z"
+                  },
+                  "macAddress": {
+                    "address": "34-E1-2D-77-80-D0",
+                    "detectionTime": "2020-05-13T06:32:25Z",
+                    "significance": "Primary",
+                    "relationToIpStatus": "Certain"
+                  },
+                  "vlans": [
+                    "name(1)->2",
+                    "3",
+                    "another_name(4)"
+                  ]
+                }
+              ],
+              "vendor": "BROADCOM",
+              "osName": "Windows 10 64",
+              "protocols": [
+                {
+                  "name": "CIP",
+                  "identifiers": "0, 1"
+                },
+                {
+                  "name": "EtherNet/IP",
+                  "identifiers": "0, 1"
+                }
+              ],
+              "lastActiveTime": "2020-05-13T06:32:25Z",
+              "lastUpdateTime": "2020-05-13T06:32:25Z",
+              "managementState": "Unmanaged",
+              "authorizationState": "Authorized",
+              "deviceCriticality": "Standard",
+              "purdueLevel": "ProcessControl",
+              "firmwares": [
+                {
+                  "serial": "0x27269242",
+                  "model": "1768-ENBT",
+                  "version": "29.11"
+                }
+              ],
+              "discoveryTime": "2020-05-13T06:32:25Z",
+              "programmingState": "NotProgrammingDevice",
+              "scanningFunctionality": "NotScannerDevice",
+              "riskScore": 100,
+              "sensorName": "mySensor",
+              "siteName": "mySite",
+              "zoneName": "myZone",
+              "deviceStatus": "Active"
+            }
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/security/resource-manager/Microsoft.Security/stable/2020-01-01/alerts.json b/specification/security/resource-manager/Microsoft.Security/stable/2020-01-01/alerts.json
index 1761bd6f335a..8524e82d301f 100644
--- a/specification/security/resource-manager/Microsoft.Security/stable/2020-01-01/alerts.json
+++ b/specification/security/resource-manager/Microsoft.Security/stable/2020-01-01/alerts.json
@@ -126,7 +126,7 @@
           "Alerts"
         ],
         "description": "List all the alerts that are associated with the subscription that are stored in a specific location",
-        "operationId": "Alerts_ListSubscriptionLevelByRegion",
+        "operationId": "Alerts_ListSubscriptionLevelAlertsByRegion",
         "parameters": [
           {
             "$ref": "../../../common/v1/types.json#/parameters/ApiVersion"
@@ -168,7 +168,7 @@
           "Alerts"
         ],
         "description": "List all the alerts that are associated with the resource group that are stored in a specific location",
-        "operationId": "Alerts_ListResourceGroupLevelByRegion",
+        "operationId": "Alerts_ListResourceGroupLevelAlertsByRegion",
         "parameters": [
           {
             "$ref": "../../../common/v1/types.json#/parameters/ApiVersion"
@@ -213,7 +213,7 @@
           "Alerts"
         ],
         "description": "Get an alert that is associated with a subscription",
-        "operationId": "Alerts_GetSubscriptionLevel",
+        "operationId": "Alerts_GetSubscriptionLevelAlert",
         "parameters": [
           {
             "$ref": "../../../common/v1/types.json#/parameters/ApiVersion"
@@ -255,7 +255,7 @@
           "Alerts"
         ],
         "description": "Get an alert that is associated a resource group or a resource in a resource group",
-        "operationId": "Alerts_GetResourceGroupLevel",
+        "operationId": "Alerts_GetResourceGroupLevelAlerts",
         "parameters": [
           {
             "$ref": "../../../common/v1/types.json#/parameters/ApiVersion"
@@ -300,7 +300,7 @@
           "Alerts"
         ],
         "description": "Update the alert's state",
-        "operationId": "Alerts_UpdateSubscriptionLevelStateToDismiss",
+        "operationId": "Alerts_UpdateSubscriptionLevelAlertStateToDismiss",
         "parameters": [
           {
             "$ref": "../../../common/v1/types.json#/parameters/ApiVersion"
@@ -378,7 +378,7 @@
           "Alerts"
         ],
         "description": "Update the alert's state",
-        "operationId": "Alerts_UpdateSubscriptionLevelStateToActivate",
+        "operationId": "Alerts_UpdateSubscriptionLevelAlertStateToReactivate",
         "parameters": [
           {
             "$ref": "../../../common/v1/types.json#/parameters/ApiVersion"
@@ -459,7 +459,7 @@
           "Alerts"
         ],
         "description": "Update the alert's state",
-        "operationId": "Alerts_UpdateResourceGroupLevelStateToDismiss",
+        "operationId": "Alerts_UpdateResourceGroupLevelAlertStateToDismiss",
         "parameters": [
           {
             "$ref": "../../../common/v1/types.json#/parameters/ApiVersion"
@@ -501,7 +501,7 @@
           "Alerts"
         ],
         "description": "Update the alert's state",
-        "operationId": "Alerts_UpdateResourceGroupLevelStateToActivate",
+        "operationId": "Alerts_UpdateResourceGroupLevelAlertStateToReactivate",
         "parameters": [
           {
             "$ref": "../../../common/v1/types.json#/parameters/ApiVersion"
diff --git a/specification/security/resource-manager/Microsoft.Security/stable/2020-01-01/examples/secureScoreControlDefinitions/ListSecureScoreControlDefinitions_example.json b/specification/security/resource-manager/Microsoft.Security/stable/2020-01-01/examples/secureScoreControlDefinitions/ListSecureScoreControlDefinitions_example.json
new file mode 100644
index 000000000000..7f7fb09a0bf1
--- /dev/null
+++ b/specification/security/resource-manager/Microsoft.Security/stable/2020-01-01/examples/secureScoreControlDefinitions/ListSecureScoreControlDefinitions_example.json
@@ -0,0 +1,58 @@
+{
+  "parameters": {
+    "api-version": "2020-01-01"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "id": "/providers/Microsoft.Security/SecureScoreControlDefinitions/a9909064-42b4-4d34-8143-275477afe18b",
+            "name": "a9909064-42b4-4d34-8143-275477afe18b",
+            "type": "Microsoft.Security/SecureScoreControlDefinitions",
+            "properties": {
+              "source": {
+                "sourceType": "BuiltIn"
+              },
+              "displayName": "Protect applications against DDoS attacks",
+              "description": "This control contains recommendations regarding DDoS attack prevention",
+              "maxScore": 2,
+              "assessmentDefinitions": [
+                {
+                  "id": "/providers/Microsoft.Security/assessmentMetadata/e3de1cc0-f4dd-3b34-e496-8b5381ba2d70"
+                }
+              ]
+            }
+          },
+          {
+            "id": "/providers/Microsoft.Security/SecureScoreControlDefinitions/a000c66f-6da2-4f9d-826d-2364347d2588",
+            "name": "a000c66f-6da2-4f9d-826d-2364347d2588",
+            "type": "Microsoft.Security/SecureScoreControlDefinitions",
+            "properties": {
+              "source": {
+                "sourceType": "BuiltIn"
+              },
+              "displayName": "Apply adaptive application control",
+              "description": "This control contains recommendations regarding enabling adaptive application control",
+              "maxScore": 3,
+              "assessmentDefinitions": [
+                {
+                  "id": "/providers/Microsoft.Security/assessmentMetadata/35f45c95-27cf-4e52-891f-8390d1de5828"
+                },
+                {
+                  "id": "/providers/Microsoft.Security/assessmentMetadata/d1db3318-01ff-16de-29eb-28b344515626"
+                },
+                {
+                  "id": "/providers/Microsoft.Security/assessmentMetadata/e7ee30c4-bac9-2966-54bd-2023a4282872"
+                },
+                {
+                  "id": "/providers/Microsoft.Security/assessmentMetadata/8e2b96ff-3de2-289b-b5c1-3b9921a3441e"
+                }
+              ]
+            }
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/security/resource-manager/Microsoft.Security/stable/2020-01-01/examples/secureScoreControlDefinitions/ListSecureScoreControlDefinitions_subscription_example.json b/specification/security/resource-manager/Microsoft.Security/stable/2020-01-01/examples/secureScoreControlDefinitions/ListSecureScoreControlDefinitions_subscription_example.json
new file mode 100644
index 000000000000..2b82a2c59241
--- /dev/null
+++ b/specification/security/resource-manager/Microsoft.Security/stable/2020-01-01/examples/secureScoreControlDefinitions/ListSecureScoreControlDefinitions_subscription_example.json
@@ -0,0 +1,83 @@
+{
+  "parameters": {
+    "api-version": "2020-01-01",
+    "subscriptionId": "20ff7fc3-e762-44dd-bd96-b71116dcdc23"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "id": "/providers/Microsoft.Security/SecureScoreControlDefinitions/a9909064-42b4-4d34-8143-275477afe18b",
+            "name": "a9909064-42b4-4d34-8143-275477afe18b",
+            "type": "Microsoft.Security/SecureScoreControlDefinitions",
+            "properties": {
+              "source": {
+                "sourceType": "BuiltIn"
+              },
+              "displayName": "Protect applications against DDoS attacks",
+              "description": "This control contains recommendations regarding DDoS attack prevention",
+              "maxScore": 2,
+              "assessmentDefinitions": [
+                {
+                  "id": "/providers/Microsoft.Security/assessmentMetadata/e3de1cc0-f4dd-3b34-e496-8b5381ba2d70"
+                }
+              ]
+            }
+          },
+          {
+            "id": "/providers/Microsoft.Security/SecureScoreControlDefinitions/34a42fb3-e6db-409c-b56b-7b1db6b8aee0",
+            "name": "34a42fb3-e6db-409c-b56b-7b1db6b8aee0",
+            "type": "Microsoft.Security/SecureScoreControlDefinitions",
+            "properties": {
+              "source": {
+                "sourceType": "BuiltIn"
+              },
+              "displayName": "Enable MFA",
+              "description": "This control contains recommendations regarding MFA",
+              "maxScore": 10,
+              "assessmentDefinitions": [
+                {
+                  "id": "/providers/Microsoft.Security/assessmentMetadata/151e82c5-5341-a74b-1eb0-bc38d2c84bb5"
+                },
+                {
+                  "id": "/providers/Microsoft.Security/assessmentMetadata/57e98606-6b1e-6193-0e3d-fe621387c16b"
+                },
+                {
+                  "id": "/providers/Microsoft.Security/assessmentMetadata/94290b00-4d0c-d7b4-7cea-064a9554e681"
+                }
+              ]
+            }
+          },
+          {
+            "id": "/providers/Microsoft.Security/SecureScoreControlDefinitions/a000c66f-6da2-4f9d-826d-2364347d2588",
+            "name": "a000c66f-6da2-4f9d-826d-2364347d2588",
+            "type": "Microsoft.Security/SecureScoreControlDefinitions",
+            "properties": {
+              "source": {
+                "sourceType": "BuiltIn"
+              },
+              "displayName": "Apply adaptive application control",
+              "description": "This control contains recommendations regarding enabling adaptive application control",
+              "maxScore": 3,
+              "assessmentDefinitions": [
+                {
+                  "id": "/providers/Microsoft.Security/assessmentMetadata/35f45c95-27cf-4e52-891f-8390d1de5828"
+                },
+                {
+                  "id": "/providers/Microsoft.Security/assessmentMetadata/d1db3318-01ff-16de-29eb-28b344515626"
+                },
+                {
+                  "id": "/providers/Microsoft.Security/assessmentMetadata/e7ee30c4-bac9-2966-54bd-2023a4282872"
+                },
+                {
+                  "id": "/providers/Microsoft.Security/assessmentMetadata/8e2b96ff-3de2-289b-b5c1-3b9921a3441e"
+                }
+              ]
+            }
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/security/resource-manager/Microsoft.Security/stable/2020-01-01/examples/secureScores/GetSecureScoresSingle_example.json b/specification/security/resource-manager/Microsoft.Security/stable/2020-01-01/examples/secureScores/GetSecureScoresSingle_example.json
new file mode 100644
index 000000000000..f81aa4dabcaa
--- /dev/null
+++ b/specification/security/resource-manager/Microsoft.Security/stable/2020-01-01/examples/secureScores/GetSecureScoresSingle_example.json
@@ -0,0 +1,25 @@
+{
+  "parameters": {
+    "api-version": "2020-01-01",
+    "subscriptionId": "20ff7fc3-e762-44dd-bd96-b71116dcdc23",
+    "secureScoreName": "ascScore"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/secureScores/ascScore",
+        "name": "ascScore",
+        "type": "Microsoft.Security/secureScores",
+        "properties": {
+          "displayName": "ASC score",
+          "score": {
+            "max": 39,
+            "current": 23.53,
+            "percentage": 0.6033
+          },
+          "weight": 67
+        }
+      }
+    }
+  }
+}
diff --git a/specification/security/resource-manager/Microsoft.Security/stable/2020-01-01/examples/secureScores/ListSecureScoreControlsForNameWithExpand_builtin_example.json b/specification/security/resource-manager/Microsoft.Security/stable/2020-01-01/examples/secureScores/ListSecureScoreControlsForNameWithExpand_builtin_example.json
new file mode 100644
index 000000000000..e91cdc63766f
--- /dev/null
+++ b/specification/security/resource-manager/Microsoft.Security/stable/2020-01-01/examples/secureScores/ListSecureScoreControlsForNameWithExpand_builtin_example.json
@@ -0,0 +1,1111 @@
+{
+  "parameters": {
+    "api-version": "2020-01-01",
+    "subscriptionId": "20ff7fc3-e762-44dd-bd96-b71116dcdc23",
+    "secureScoreName": "ascScore",
+    "$expand": "definition"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/secureScores/ascScore/secureScoreControls/a9909064-42b4-4d34-8143-275477afe18b",
+            "name": "a9909064-42b4-4d34-8143-275477afe18b",
+            "type": "Microsoft.Security/secureScores/secureScoreControls",
+            "properties": {
+              "displayName": "Protect applications against DDoS attacks",
+              "healthyResourceCount": 0,
+              "unhealthyResourceCount": 0,
+              "notApplicableResourceCount": 1,
+              "score": {
+                "max": 0,
+                "current": 0,
+                "percentage": 0
+              },
+              "definition": {
+                "id": "/providers/Microsoft.Security/secureScoreControlDefinitions/a9909064-42b4-4d34-8143-275477afe18b",
+                "name": "a9909064-42b4-4d34-8143-275477afe18b",
+                "type": "Microsoft.Security/secureScoreControlDefinitions",
+                "properties": {
+                  "source": {
+                    "sourceType": "BuiltIn"
+                  },
+                  "displayName": "Protect applications against DDoS attacks",
+                  "maxScore": 2,
+                  "assessmentDefinitions": [
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/e3de1cc0-f4dd-3b34-e496-8b5381ba2d70"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/08e628db-e2ed-4793-bc91-d13e684401c3"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/405c9ae6-49f9-46c4-8873-a86690f27818"
+                    }
+                  ]
+                }
+              },
+              "weight": 0
+            }
+          },
+          {
+            "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/secureScores/ascScore/secureScoreControls/34a42fb3-e6db-409c-b56b-7b1db6b8aee0",
+            "name": "34a42fb3-e6db-409c-b56b-7b1db6b8aee0",
+            "type": "Microsoft.Security/secureScores/secureScoreControls",
+            "properties": {
+              "displayName": "Enable MFA",
+              "healthyResourceCount": 1,
+              "unhealthyResourceCount": 0,
+              "notApplicableResourceCount": 0,
+              "score": {
+                "max": 10,
+                "current": 10,
+                "percentage": 1
+              },
+              "definition": {
+                "id": "/providers/Microsoft.Security/secureScoreControlDefinitions/34a42fb3-e6db-409c-b56b-7b1db6b8aee0",
+                "name": "34a42fb3-e6db-409c-b56b-7b1db6b8aee0",
+                "type": "Microsoft.Security/secureScoreControlDefinitions",
+                "properties": {
+                  "source": {
+                    "sourceType": "BuiltIn"
+                  },
+                  "displayName": "Enable MFA",
+                  "maxScore": 10,
+                  "assessmentDefinitions": [
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/94290b00-4d0c-d7b4-7cea-064a9554e681"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/57e98606-6b1e-6193-0e3d-fe621387c16b"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/1f24d55a-df0f-4772-9090-4629c2d6bfff"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/8e3d9ac0-a248-4276-a437-304c6cd1443b"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/8d7a6128-c8f2-43df-b422-7877346f9ddb"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/dbfc99e3-e648-4c3b-bd32-995e6268430d"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/4a946e22-47e8-443d-8761-b25620b4a1e1"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/a7c8fa46-526d-4bf6-b8b3-17fa01310fd8"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/20f6c761-4dd7-4f27-9e37-6db8471486ef"
+                    }
+                  ]
+                }
+              },
+              "weight": 1
+            }
+          },
+          {
+            "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/secureScores/ascScore/secureScoreControls/76763537-9feb-42d3-b4f4-78c01117be80",
+            "name": "76763537-9feb-42d3-b4f4-78c01117be80",
+            "type": "Microsoft.Security/secureScores/secureScoreControls",
+            "properties": {
+              "displayName": "Implement security best practices",
+              "healthyResourceCount": 7,
+              "unhealthyResourceCount": 0,
+              "notApplicableResourceCount": 1,
+              "score": {
+                "max": 0,
+                "current": 0,
+                "percentage": 0
+              },
+              "definition": {
+                "id": "/providers/Microsoft.Security/secureScoreControlDefinitions/76763537-9feb-42d3-b4f4-78c01117be80",
+                "name": "76763537-9feb-42d3-b4f4-78c01117be80",
+                "type": "Microsoft.Security/secureScoreControlDefinitions",
+                "properties": {
+                  "source": {
+                    "sourceType": "BuiltIn"
+                  },
+                  "displayName": "Implement security best practices",
+                  "maxScore": 0,
+                  "assessmentDefinitions": [
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/151e82c5-5341-a74b-1eb0-bc38d2c84bb5"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/a8c6a4ad-d51e-88fe-2979-d3ee3c864f8b"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/6f90a6d6-d4d6-0794-0ec1-98fa77878c2e"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/a9341235-9389-42f0-a0bf-9bfb57960d44"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/45d313c3-3fca-5040-035f-d61928366d31"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/f0553104-cfdb-65e6-759c-002812e38500"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/47bb383c-8e25-95f0-c2aa-437add1d87d3"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/12018f4f-3d10-999b-e4c4-86ec25be08a1"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/eade5b56-eefd-444f-95c8-23f29e5d93cb"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/ebe970fe-9c27-4dd7-a165-1e943d565e10"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/f7010359-8d21-4598-a9f2-c3e81a17141e"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/24d8af06-d441-40b4-a49c-311421aa9f58"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/8c3e93d3-0276-4d06-b20a-9a9f3012742c"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/9172da4e-9571-6e33-2b5b-d742847f3be7"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/093c685b-56dd-13a3-8ed5-887a001837a2"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/64b8637e-4e1d-76a9-0fc9-c1e487a97ed8"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/fe02b3b7-a722-d4d6-6731-6493776203a6"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/57f36d21-69e3-4b0f-a66c-18629d1b736d"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/6c99f570-2ce7-46bc-8175-cde013df43bc"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/22489c48-27d1-4e40-9420-4303ad9cffef"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/fc84abc0-eee6-4758-8372-a7681965ca44"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/726cde3e-02f8-4041-8935-727f2be19ba7"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/a2bb3a1b-4a09-4cf7-9e79-c438687e2c2f"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/664c6a0b-5cd2-4140-aaff-a94241c07afd"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/3af5de46-fda8-4b6e-90f1-6565187d7c48"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/a9a59ebb-5d6f-42f5-92a1-036fd0fd1879"
+                    }
+                  ]
+                }
+              },
+              "weight": 7
+            }
+          },
+          {
+            "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/secureScores/ascScore/secureScoreControls/4db8d6cf-075b-4149-a813-da09ca2ae120",
+            "name": "4db8d6cf-075b-4149-a813-da09ca2ae120",
+            "type": "Microsoft.Security/secureScores/secureScoreControls",
+            "properties": {
+              "displayName": "Enable Advanced Threat Protection",
+              "healthyResourceCount": 0,
+              "unhealthyResourceCount": 1,
+              "notApplicableResourceCount": 0,
+              "score": {
+                "max": 0,
+                "current": 0,
+                "percentage": 0
+              },
+              "definition": {
+                "id": "/providers/Microsoft.Security/secureScoreControlDefinitions/4db8d6cf-075b-4149-a813-da09ca2ae120",
+                "name": "4db8d6cf-075b-4149-a813-da09ca2ae120",
+                "type": "Microsoft.Security/secureScoreControlDefinitions",
+                "properties": {
+                  "source": {
+                    "sourceType": "BuiltIn"
+                  },
+                  "displayName": "Enable Advanced Threat Protection",
+                  "maxScore": 0,
+                  "assessmentDefinitions": [
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/56a6e81f-7413-4f72-9a1b-aaeeaa87c872"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/0876ef51-fee7-449d-ba1e-f2662c7e43c6"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/58d72d9d-0310-4792-9a3b-6dd111093cdb"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/6ac66a74-761f-4a59-928a-d373eea3f028"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/1be22853-8ed1-4005-9907-ddad64cb1417"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/86ea1a79-29d3-4eac-a9f4-3541ace4e718"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/53572822-d3fc-4363-bfb9-248645841612"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/b1af52e4-e968-4e2b-b6d0-6736c9651f0a"
+                    }
+                  ]
+                }
+              },
+              "weight": 1
+            }
+          },
+          {
+            "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/secureScores/ascScore/secureScoreControls/27b24961-75ba-4fe4-8909-97286d5dd5ee",
+            "name": "27b24961-75ba-4fe4-8909-97286d5dd5ee",
+            "type": "Microsoft.Security/secureScores/secureScoreControls",
+            "properties": {
+              "displayName": "Enable auditing and logging",
+              "healthyResourceCount": 1,
+              "unhealthyResourceCount": 4,
+              "notApplicableResourceCount": 0,
+              "score": {
+                "max": 1,
+                "current": 0.2,
+                "percentage": 0.2
+              },
+              "definition": {
+                "id": "/providers/Microsoft.Security/secureScoreControlDefinitions/27b24961-75ba-4fe4-8909-97286d5dd5ee",
+                "name": "27b24961-75ba-4fe4-8909-97286d5dd5ee",
+                "type": "Microsoft.Security/secureScoreControlDefinitions",
+                "properties": {
+                  "source": {
+                    "sourceType": "BuiltIn"
+                  },
+                  "displayName": "Enable auditing and logging",
+                  "maxScore": 1,
+                  "assessmentDefinitions": [
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/94208a8b-16e8-4e5b-abbd-4e81c9d02bee"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/c6dad669-efd7-cd72-61c5-289935607791"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/77785808-ce86-4e40-b45f-19110a547397"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/32771b45-220c-1a8b-584e-fdd5a2584a66"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/f11b27f2-8c49-5bb4-eff5-e1e5384bf95e"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/f19ab7d9-5ff2-f8fd-ab3b-0bf95dcb6889"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/ad5bbaeb-7632-5edf-f1c2-752075831ce8"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/dea5192e-1bb3-101b-b70c-4646546f5e1e"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/1597605a-0faf-5860-eb74-462ae2e9fc21"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/91387f44-7e43-4ecc-55f0-46f5adee3dd5"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/961eb649-3ea9-f8c2-6595-88e9a3aeedeb"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/88bbc99c-e5af-ddd7-6105-6150b2bfa519"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/22438e3c-73c8-40af-a083-10c980c63aa2"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/5720f1a6-6061-4768-9c0d-2000a6041744"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/dbfc99e3-e648-4c3b-bd32-995e6268430d"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/30c69b23-a9a2-4729-aca6-f21adacfff66"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/a9ac48d8-8dd7-42b9-9752-b1fa70ea5dd9"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/00261067-76a8-4ebb-b5fc-becc81067bee"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/83ca4867-58c1-45d6-b6b6-dbf226512891"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/a269cbdb-86e8-431c-9ff2-f0ea491174d8"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/5ea59e47-093b-446f-9765-5b0ec4c9da61"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/011397ca-1366-4bcc-b85a-7a5e3df2e80b"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/c62371bc-f6a7-4915-b5b5-14288682cf79"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/293ba336-7312-42fc-a59d-836e4e678b17"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/0b547a38-2c0d-47e1-b9a2-a59fccc140db"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/7d0ad86f-f43b-4889-b2f7-09d91bd1407b"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/b20558b6-de31-480c-8aa0-e920d62b9764"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/022efc2d-5119-480b-a203-e151b6b2645c"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/3ee7608e-f0e7-4c26-8921-5ae46c4e99df"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/33765629-073d-49eb-bab4-64bdf8ac90da"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/9c054f50-823f-45ab-839e-9df4eb7c2f11"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/f61e15f3-4bcf-4d2e-8f06-32237cabe0a0"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/cdb3af55-2abf-476b-aac7-5cfec366a4dd"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/bc26b0d4-a1d7-4665-9d44-efc205ae73f0"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/3812e247-34f2-4f06-a312-89a8fe51fa37"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/f0f8405a-5ecc-4314-808e-083e030d6163"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/c23e0eec-eee4-4632-b1c2-6c884c3c963b"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/7ce5a01f-e94b-438a-8b72-fa02c076f11a"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/46e4e0ed-106d-405e-b1a9-ca34c8f7d31f"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/b1294b0d-9b2e-4e1b-9f67-77a75fb10a65"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/0b86a67f-bde5-4c91-b10c-4102033b8692"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/3d55e4b1-ecdb-4eaf-9e3f-b00a764182bd"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/a7c8fa46-526d-4bf6-b8b3-17fa01310fd8"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/20f6c761-4dd7-4f27-9e37-6db8471486ef"
+                    }
+                  ]
+                }
+              },
+              "weight": 5
+            }
+          },
+          {
+            "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/secureScores/ascScore/secureScoreControls/2d85f639-0bea-4a4a-b6c6-608952a1414a",
+            "name": "2d85f639-0bea-4a4a-b6c6-608952a1414a",
+            "type": "Microsoft.Security/secureScores/secureScoreControls",
+            "properties": {
+              "displayName": "Manage access and permissions",
+              "healthyResourceCount": 1,
+              "unhealthyResourceCount": 1,
+              "notApplicableResourceCount": 0,
+              "score": {
+                "max": 4,
+                "current": 2,
+                "percentage": 0.5
+              },
+              "definition": {
+                "id": "/providers/Microsoft.Security/secureScoreControlDefinitions/2d85f639-0bea-4a4a-b6c6-608952a1414a",
+                "name": "2d85f639-0bea-4a4a-b6c6-608952a1414a",
+                "type": "Microsoft.Security/secureScoreControlDefinitions",
+                "properties": {
+                  "source": {
+                    "sourceType": "BuiltIn"
+                  },
+                  "displayName": "Manage access and permissions",
+                  "maxScore": 4,
+                  "assessmentDefinitions": [
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/c3b6ae71-f1f0-31b4-e6c1-d5951285d03d"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/04e7147b-0deb-9796-2e5c-0336343ceb3d"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/e52064aa-6853-e252-a11e-dffc675689c2"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/00c6d40b-e990-6acf-d4f3-471e747a27c4"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/2c79b4af-f830-b61e-92b9-63dfa30f16e4"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/b0fdc63a-38e7-4bab-a7c4-2c2665abbaa9"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/03afeb6f-7634-adb3-0a01-803b0b9cb611"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/9d07b7e6-2986-4964-a76c-b2689604e212"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/08e628db-e2ed-4793-bc91-d13e684401c3"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/5d90913f-a1c5-4429-ad54-2c6c17fb3c73"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/582c14e9-48c1-4b25-ab93-91bdeaf9120c"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/8a10942a-02ca-483f-81ae-2260ea7808cc"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/9b8eac17-6b11-4b94-9bb4-18c81aee7123"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/554ba13c-d7d4-4530-88ce-94cf11a670ce"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/66a1d478-4d24-42d4-8eca-dcdab6532a18"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/b396f112-a462-4813-a93f-80bc90041e4d"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/5425052d-cc0d-4424-af71-050311f99634"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/09cb7d54-db05-4d31-97f3-9bbfe1dff610"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/01fb1ad4-303b-4789-abf2-c024c4a76523"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/0de072b9-6515-4985-842e-0318047bb85b"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/8c3f474a-234e-442f-92b3-2a45e37f7eee"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/c55461af-4923-4fbb-b270-40d5e5f4c0ff"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/bbdc4999-1462-4d46-853b-2f8c6ca1c682"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/9e1f12d0-cb3d-4e1c-a468-6bc3d934c99d"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/fd5d38f6-340e-4bd2-88f2-e1314c3c07a9"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/0384d5b7-5def-4130-b7b5-db7da7e63276"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/dbfc99e3-e648-4c3b-bd32-995e6268430d"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/0ad39832-f031-4fdd-885e-c6cce85ac77c"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/90191798-da1b-40dd-aa9c-1c0eafb1ba87"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/ddced3c8-a5e2-4dc4-b0fe-1331c77fc9c4"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/52f83ea2-6871-45c3-8b26-13566e966638"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/79b4eb34-c06e-49bf-883d-5352a21a962f"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/5723400d-5b2a-45f1-99ee-837986866318"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/76e8881d-f18e-4e1b-b01d-376d0260e066"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/0eaf40a8-5673-4b33-8457-a31d85882233"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/5a235918-41a2-4bd0-8ab0-00a596e9d6a8"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/3ff38dcd-92e2-4b67-8765-35bb0174a4c7"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/1ff4501b-2109-4ef6-ba9d-e824a96d63d0"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/f493084a-d3c4-4886-8cf2-3c815aeef901"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/a7c8fa46-526d-4bf6-b8b3-17fa01310fd8"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/20f6c761-4dd7-4f27-9e37-6db8471486ef"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/11c95609-3553-430d-b788-fd41cde8b2db"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/27d6f0e9-b4d5-468b-ae7e-03d5473fd864"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/f0debc84-981c-4a0d-924d-aa4bd7d55fef"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/9b795646-9130-41a4-90b7-df9eae2437c8"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/802c0637-5a8c-4c98-abd7-7c96d89d6010"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/43dc2a2e-ce69-4d42-923e-ab7d136f2cfe"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/2acd365d-e8b5-4094-bce4-244b7c51d67c"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/51fd8bb1-0db4-bbf1-7e2b-cfcba7eb66a6"
+                    }
+                  ]
+                }
+              },
+              "weight": 2
+            }
+          },
+          {
+            "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/secureScores/ascScore/secureScoreControls/99fc8df2-e0f5-40f8-9415-a7f7ca948b5a",
+            "name": "99fc8df2-e0f5-40f8-9415-a7f7ca948b5a",
+            "type": "Microsoft.Security/secureScores/secureScoreControls",
+            "properties": {
+              "displayName": "Remediate security configurations",
+              "healthyResourceCount": 0,
+              "unhealthyResourceCount": 1,
+              "notApplicableResourceCount": 0,
+              "score": {
+                "max": 4,
+                "current": 0,
+                "percentage": 0
+              },
+              "definition": {
+                "id": "/providers/Microsoft.Security/secureScoreControlDefinitions/99fc8df2-e0f5-40f8-9415-a7f7ca948b5a",
+                "name": "99fc8df2-e0f5-40f8-9415-a7f7ca948b5a",
+                "type": "Microsoft.Security/secureScoreControlDefinitions",
+                "properties": {
+                  "source": {
+                    "sourceType": "BuiltIn"
+                  },
+                  "displayName": "Remediate security configurations",
+                  "maxScore": 4,
+                  "assessmentDefinitions": [
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/d1db3318-01ff-16de-29eb-28b344515626"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/e7ee30c4-bac9-2966-54bd-2023a4282872"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/27ac71b1-75c5-41c2-adc2-858f5db45b08"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/720a3e77-0b9a-4fa9-98b6-ddf0fd7e32c1"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/8e2b96ff-3de2-289b-b5c1-3b9921a3441e"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/181ac480-f7c4-544b-9865-11b8ffe87f47"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/8c3d9ad0-3639-4686-9cd2-2b2ab2609bda"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/0677209d-e675-2c6f-e91a-54cef2878663"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/a3eee263-aa01-4b52-a7c0-0094578ef48f"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/45cfe080-ceb1-a91e-9743-71551ed24e94"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/8941d121-f740-35f6-952c-6561d2b38d36"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/0396b18c-41aa-489c-affd-4ee5d1714a59"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/fa924a53-0837-4296-9bf7-18ce7dd68593"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/9e1789cd-7b61-42db-ba12-7268283ba466"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/233da9cd-11bf-463a-8aa7-4c81b9e788d1"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/c4131c22-1ecc-4beb-9961-d90108bd975f"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/d74d2738-2485-4103-9919-69c7e63776ec"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/5f65e47f-7a00-4bf3-acae-90ee441ee876"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/bc85a7ee-7f43-47ab-8736-4faaec9346b5"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/08e628db-e2ed-4793-bc91-d13e684401c3"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/86f91051-9d6a-47c3-a07f-bd14cb214b45"
+                    }
+                  ]
+                }
+              },
+              "weight": 1
+            }
+          },
+          {
+            "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/secureScores/ascScore/secureScoreControls/12136bd9-dc24-44f2-9587-7be3af6aac14",
+            "name": "12136bd9-dc24-44f2-9587-7be3af6aac14",
+            "type": "Microsoft.Security/secureScores/secureScoreControls",
+            "properties": {
+              "displayName": "Enable endpoint protection",
+              "healthyResourceCount": 0,
+              "unhealthyResourceCount": 1,
+              "notApplicableResourceCount": 0,
+              "score": {
+                "max": 2,
+                "current": 0,
+                "percentage": 0
+              },
+              "definition": {
+                "id": "/providers/Microsoft.Security/secureScoreControlDefinitions/12136bd9-dc24-44f2-9587-7be3af6aac14",
+                "name": "12136bd9-dc24-44f2-9587-7be3af6aac14",
+                "type": "Microsoft.Security/secureScoreControlDefinitions",
+                "properties": {
+                  "source": {
+                    "sourceType": "BuiltIn"
+                  },
+                  "displayName": "Enable endpoint protection",
+                  "maxScore": 2,
+                  "assessmentDefinitions": [
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/d1db3318-01ff-16de-29eb-28b344515626"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/e7ee30c4-bac9-2966-54bd-2023a4282872"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/27ac71b1-75c5-41c2-adc2-858f5db45b08"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/720a3e77-0b9a-4fa9-98b6-ddf0fd7e32c1"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/8e2b96ff-3de2-289b-b5c1-3b9921a3441e"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/83f577bd-a1b6-b7e1-0891-12ca19d1e6df"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/4fb67663-9ab9-475d-b026-8c544cced439"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/383cf3bc-fdf9-4a02-120a-3e7e36c6bfee"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/3bcd234d-c9c7-c2a2-89e0-c01f419c1a8a"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/37a3689a-818e-4a0e-82ac-b1392b9bb000"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/45cfe080-ceb1-a91e-9743-71551ed24e94"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/21300918-b2e3-0346-785f-c77ff57d243b"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/e71020c2-860c-3235-cd39-04f3f8c936d2"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/bc85a7ee-7f43-47ab-8736-4faaec9346b5"
+                    }
+                  ]
+                }
+              },
+              "weight": 1
+            }
+          },
+          {
+            "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/secureScores/ascScore/secureScoreControls/61702b76-1fab-41f2-bcbc-50b7870dcf38",
+            "name": "61702b76-1fab-41f2-bcbc-50b7870dcf38",
+            "type": "Microsoft.Security/secureScores/secureScoreControls",
+            "properties": {
+              "displayName": "Apply system updates",
+              "healthyResourceCount": 0,
+              "unhealthyResourceCount": 1,
+              "notApplicableResourceCount": 0,
+              "score": {
+                "max": 6,
+                "current": 0,
+                "percentage": 0
+              },
+              "definition": {
+                "id": "/providers/Microsoft.Security/secureScoreControlDefinitions/61702b76-1fab-41f2-bcbc-50b7870dcf38",
+                "name": "61702b76-1fab-41f2-bcbc-50b7870dcf38",
+                "type": "Microsoft.Security/secureScoreControlDefinitions",
+                "properties": {
+                  "source": {
+                    "sourceType": "BuiltIn"
+                  },
+                  "displayName": "Apply system updates",
+                  "maxScore": 6,
+                  "assessmentDefinitions": [
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/d1db3318-01ff-16de-29eb-28b344515626"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/e7ee30c4-bac9-2966-54bd-2023a4282872"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/27ac71b1-75c5-41c2-adc2-858f5db45b08"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/720a3e77-0b9a-4fa9-98b6-ddf0fd7e32c1"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/8e2b96ff-3de2-289b-b5c1-3b9921a3441e"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/4ab6e3c5-74dd-8b35-9ab9-f61b30875b27"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/f2805ebc-abc2-4aac-a8d6-35664c479971"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/c0f5316d-5ac5-9218-b77a-b96e16ccfd66"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/45cfe080-ceb1-a91e-9743-71551ed24e94"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/bd20bd91-aaf1-7f14-b6e4-866de2f43146"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/8bc390da-9eb6-938d-25ed-44a35d9bcc9d"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/22e18b64-4576-41e6-8972-0eb28c9af0c8"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/bc85a7ee-7f43-47ab-8736-4faaec9346b5"
+                    }
+                  ]
+                }
+              },
+              "weight": 1
+            }
+          },
+          {
+            "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/secureScores/ascScore/secureScoreControls/0e55495e-034f-4abc-8293-767229250176",
+            "name": "0e55495e-034f-4abc-8293-767229250176",
+            "type": "Microsoft.Security/secureScores/secureScoreControls",
+            "properties": {
+              "displayName": "Encrypt data in transit",
+              "healthyResourceCount": 5,
+              "unhealthyResourceCount": 1,
+              "notApplicableResourceCount": 0,
+              "score": {
+                "max": 4,
+                "current": 3.33,
+                "percentage": 0.8325
+              },
+              "definition": {
+                "id": "/providers/Microsoft.Security/secureScoreControlDefinitions/0e55495e-034f-4abc-8293-767229250176",
+                "name": "0e55495e-034f-4abc-8293-767229250176",
+                "type": "Microsoft.Security/secureScoreControlDefinitions",
+                "properties": {
+                  "source": {
+                    "sourceType": "BuiltIn"
+                  },
+                  "displayName": "Encrypt data in transit",
+                  "maxScore": 4,
+                  "assessmentDefinitions": [
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/1b351b29-41ca-6df5-946c-c190a56be5fe"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/cb0acdc6-0846-fd48-debe-9905af151b6d"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/bf82a334-13b6-ca57-ea75-096fc2ffce50"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/35b25be2-d08a-e340-45ed-f08a95d804fc"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/1c5de8e1-f68d-6a17-e0d2-ec259c42768c"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/a3ebc80a-847b-46d5-a37d-8dca5e6947df"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/c28a89d9-7cf4-439b-a8c4-ad4e769f68ee"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/2acc27c6-5fdb-405e-9080-cb66b850c8f5"
+                    }
+                  ]
+                }
+              },
+              "weight": 6
+            }
+          },
+          {
+            "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/secureScores/ascScore/secureScoreControls/f9d5432b-8f7b-45e9-b90c-e214a30f6a02",
+            "name": "f9d5432b-8f7b-45e9-b90c-e214a30f6a02",
+            "type": "Microsoft.Security/secureScores/secureScoreControls",
+            "properties": {
+              "displayName": "Restrict unauthorized network access",
+              "healthyResourceCount": 1,
+              "unhealthyResourceCount": 0,
+              "notApplicableResourceCount": 0,
+              "score": {
+                "max": 4,
+                "current": 4,
+                "percentage": 1
+              },
+              "definition": {
+                "id": "/providers/Microsoft.Security/secureScoreControlDefinitions/f9d5432b-8f7b-45e9-b90c-e214a30f6a02",
+                "name": "f9d5432b-8f7b-45e9-b90c-e214a30f6a02",
+                "type": "Microsoft.Security/secureScoreControlDefinitions",
+                "properties": {
+                  "source": {
+                    "sourceType": "BuiltIn"
+                  },
+                  "displayName": "Restrict unauthorized network access",
+                  "maxScore": 4,
+                  "assessmentDefinitions": [
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/483f12ed-ae23-447e-a2de-a67a10db4353"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/3b20e985-f71f-483b-b078-f30d73936d43"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/f9f0eed0-f143-47bf-b856-671ea2eeed62"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/1a2b5b4c-f80d-46e7-ac81-b51a9fb363de"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/c3b51c94-588b-426b-a892-24696f9e54cc"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/e40df93c-7a7c-1b0a-c787-9987ceb98e54"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/7b3d4796-9400-2904-692b-4a5ede7f0a1e"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/df4d1739-47f0-60c7-1706-3731fea6ab03"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/1a36f14a-8bd8-45f5-abe5-eef88d76ab5b"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/beb62be3-5e78-49bd-ac5f-099250ef3c7c"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/ba975338-f956-41e7-a9f2-7614832d382d"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/d5a8d84a-9ad0-42e2-80e0-d38e3d46028a"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/5a3d6cdd-8eb3-46d2-ba11-d24a0d47fe65"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/d8326952-60bb-40fb-b33f-51e662708a88"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/08e628db-e2ed-4793-bc91-d13e684401c3"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/5f88450f-9546-4b78-a181-a2d9162bb441"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/add45209-73f6-4fa5-a5a5-74a451b07fbe"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/dbfc99e3-e648-4c3b-bd32-995e6268430d"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/b3473ed6-78c0-40d5-b5f0-674e98924952"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/9dd55566-33b9-4c07-a959-14794ce02355"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/ad0b04b9-eaf9-49f8-b85e-724f9520e760"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/ece6ec5d-a862-4e22-a8db-271661216018"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/e40b679a-f44e-4366-87dd-7693e16a2128"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/0bdcd23c-4ff2-4077-aa14-eb6950bfbdd8"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/1f386f4e-449e-41e8-b829-a2fe01086ae1"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/2f6c8a5a-9407-467c-8082-0ad4ab915d77"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/3b1713ec-feb3-4b32-b5b0-251acff0a84a"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/049f1551-438b-444e-8904-a3c3afbcb43e"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/684307e9-62a8-4f2a-887a-4b90de5e4b98"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/0327f9da-f758-4d69-8903-55448b8cf70e"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/cc637123-c11e-40ee-adf8-93c0876481f4"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/a7c8fa46-526d-4bf6-b8b3-17fa01310fd8"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/20f6c761-4dd7-4f27-9e37-6db8471486ef"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/ebc68898-5c0f-4353-a426-4a5f1e737b12"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/f67fb4ed-d481-44d7-91e5-efadf504f74a"
+                    }
+                  ]
+                }
+              },
+              "weight": 1
+            }
+          },
+          {
+            "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/secureScores/ascScore/secureScoreControls/8fd574ec-43cf-426e-a439-a67cbaf2d564",
+            "name": "8fd574ec-43cf-426e-a439-a67cbaf2d564",
+            "type": "Microsoft.Security/secureScores/secureScoreControls",
+            "properties": {
+              "displayName": "Enable encryption at rest",
+              "healthyResourceCount": 1,
+              "unhealthyResourceCount": 0,
+              "notApplicableResourceCount": 0,
+              "score": {
+                "max": 4,
+                "current": 4,
+                "percentage": 1
+              },
+              "definition": {
+                "id": "/providers/Microsoft.Security/secureScoreControlDefinitions/8fd574ec-43cf-426e-a439-a67cbaf2d564",
+                "name": "8fd574ec-43cf-426e-a439-a67cbaf2d564",
+                "type": "Microsoft.Security/secureScoreControlDefinitions",
+                "properties": {
+                  "source": {
+                    "sourceType": "BuiltIn"
+                  },
+                  "displayName": "Enable encryption at rest",
+                  "maxScore": 4,
+                  "assessmentDefinitions": [
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/d57a4221-a804-52ca-3dea-768284f06bb7"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/651967bf-044e-4bde-8376-3e08e0600105"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/b12bc79e-4f12-44db-acda-571820191ddc"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/7f04fc0c-4a3d-5c7e-ce19-666cb871b510"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/dbfc99e3-e648-4c3b-bd32-995e6268430d"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/c01fab9f-bde1-4ba5-9d35-7de51f31c2d3"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/23b514bd-2afc-4a3e-8d3d-f4327118eee9"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/3053474d-4fab-4603-8d18-2a6dfd09f782"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/6be98232-0100-474a-b33d-ba9c1a747f70"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/a7c8fa46-526d-4bf6-b8b3-17fa01310fd8"
+                    },
+                    {
+                      "id": "/providers/Microsoft.Security/assessmentMetadata/20f6c761-4dd7-4f27-9e37-6db8471486ef"
+                    }
+                  ]
+                }
+              },
+              "weight": 1
+            }
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/security/resource-manager/Microsoft.Security/stable/2020-01-01/examples/secureScores/ListSecureScoreControlsForName_builtin_example.json b/specification/security/resource-manager/Microsoft.Security/stable/2020-01-01/examples/secureScores/ListSecureScoreControlsForName_builtin_example.json
new file mode 100644
index 000000000000..fee1621836a8
--- /dev/null
+++ b/specification/security/resource-manager/Microsoft.Security/stable/2020-01-01/examples/secureScores/ListSecureScoreControlsForName_builtin_example.json
@@ -0,0 +1,219 @@
+{
+  "parameters": {
+    "api-version": "2020-01-01",
+    "subscriptionId": "20ff7fc3-e762-44dd-bd96-b71116dcdc23",
+    "secureScoreName": "ascScore"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/secureScores/ascScore/secureScoreControls/a9909064-42b4-4d34-8143-275477afe18b",
+            "name": "a9909064-42b4-4d34-8143-275477afe18b",
+            "type": "Microsoft.Security/secureScores/secureScoreControls",
+            "properties": {
+              "displayName": "Protect applications against DDoS attacks",
+              "healthyResourceCount": 0,
+              "unhealthyResourceCount": 0,
+              "notApplicableResourceCount": 1,
+              "score": {
+                "max": 0,
+                "current": 0,
+                "percentage": 0
+              },
+              "weight": 0
+            }
+          },
+          {
+            "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/secureScores/ascScore/secureScoreControls/34a42fb3-e6db-409c-b56b-7b1db6b8aee0",
+            "name": "34a42fb3-e6db-409c-b56b-7b1db6b8aee0",
+            "type": "Microsoft.Security/secureScores/secureScoreControls",
+            "properties": {
+              "displayName": "Enable MFA",
+              "healthyResourceCount": 1,
+              "unhealthyResourceCount": 0,
+              "notApplicableResourceCount": 0,
+              "score": {
+                "max": 10,
+                "current": 10,
+                "percentage": 1
+              },
+              "weight": 1
+            }
+          },
+          {
+            "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/secureScores/ascScore/secureScoreControls/76763537-9feb-42d3-b4f4-78c01117be80",
+            "name": "76763537-9feb-42d3-b4f4-78c01117be80",
+            "type": "Microsoft.Security/secureScores/secureScoreControls",
+            "properties": {
+              "displayName": "Implement security best practices",
+              "healthyResourceCount": 7,
+              "unhealthyResourceCount": 0,
+              "notApplicableResourceCount": 1,
+              "score": {
+                "max": 0,
+                "current": 0,
+                "percentage": 0
+              },
+              "weight": 7
+            }
+          },
+          {
+            "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/secureScores/ascScore/secureScoreControls/4db8d6cf-075b-4149-a813-da09ca2ae120",
+            "name": "4db8d6cf-075b-4149-a813-da09ca2ae120",
+            "type": "Microsoft.Security/secureScores/secureScoreControls",
+            "properties": {
+              "displayName": "Enable Advanced Threat Protection",
+              "healthyResourceCount": 0,
+              "unhealthyResourceCount": 1,
+              "notApplicableResourceCount": 0,
+              "score": {
+                "max": 0,
+                "current": 0,
+                "percentage": 0
+              },
+              "weight": 1
+            }
+          },
+          {
+            "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/secureScores/ascScore/secureScoreControls/27b24961-75ba-4fe4-8909-97286d5dd5ee",
+            "name": "27b24961-75ba-4fe4-8909-97286d5dd5ee",
+            "type": "Microsoft.Security/secureScores/secureScoreControls",
+            "properties": {
+              "displayName": "Enable auditing and logging",
+              "healthyResourceCount": 1,
+              "unhealthyResourceCount": 4,
+              "notApplicableResourceCount": 0,
+              "score": {
+                "max": 1,
+                "current": 0.2,
+                "percentage": 0.2
+              },
+              "weight": 5
+            }
+          },
+          {
+            "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/secureScores/ascScore/secureScoreControls/2d85f639-0bea-4a4a-b6c6-608952a1414a",
+            "name": "2d85f639-0bea-4a4a-b6c6-608952a1414a",
+            "type": "Microsoft.Security/secureScores/secureScoreControls",
+            "properties": {
+              "displayName": "Manage access and permissions",
+              "healthyResourceCount": 1,
+              "unhealthyResourceCount": 1,
+              "notApplicableResourceCount": 0,
+              "score": {
+                "max": 4,
+                "current": 2,
+                "percentage": 0.5
+              },
+              "weight": 2
+            }
+          },
+          {
+            "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/secureScores/ascScore/secureScoreControls/99fc8df2-e0f5-40f8-9415-a7f7ca948b5a",
+            "name": "99fc8df2-e0f5-40f8-9415-a7f7ca948b5a",
+            "type": "Microsoft.Security/secureScores/secureScoreControls",
+            "properties": {
+              "displayName": "Remediate security configurations",
+              "healthyResourceCount": 0,
+              "unhealthyResourceCount": 1,
+              "notApplicableResourceCount": 0,
+              "score": {
+                "max": 4,
+                "current": 0,
+                "percentage": 0
+              },
+              "weight": 1
+            }
+          },
+          {
+            "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/secureScores/ascScore/secureScoreControls/12136bd9-dc24-44f2-9587-7be3af6aac14",
+            "name": "12136bd9-dc24-44f2-9587-7be3af6aac14",
+            "type": "Microsoft.Security/secureScores/secureScoreControls",
+            "properties": {
+              "displayName": "Enable endpoint protection",
+              "healthyResourceCount": 0,
+              "unhealthyResourceCount": 1,
+              "notApplicableResourceCount": 0,
+              "score": {
+                "max": 2,
+                "current": 0,
+                "percentage": 0
+              },
+              "weight": 1
+            }
+          },
+          {
+            "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/secureScores/ascScore/secureScoreControls/61702b76-1fab-41f2-bcbc-50b7870dcf38",
+            "name": "61702b76-1fab-41f2-bcbc-50b7870dcf38",
+            "type": "Microsoft.Security/secureScores/secureScoreControls",
+            "properties": {
+              "displayName": "Apply system updates",
+              "healthyResourceCount": 0,
+              "unhealthyResourceCount": 1,
+              "notApplicableResourceCount": 0,
+              "score": {
+                "max": 6,
+                "current": 0,
+                "percentage": 0
+              },
+              "weight": 1
+            }
+          },
+          {
+            "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/secureScores/ascScore/secureScoreControls/0e55495e-034f-4abc-8293-767229250176",
+            "name": "0e55495e-034f-4abc-8293-767229250176",
+            "type": "Microsoft.Security/secureScores/secureScoreControls",
+            "properties": {
+              "displayName": "Encrypt data in transit",
+              "healthyResourceCount": 5,
+              "unhealthyResourceCount": 1,
+              "notApplicableResourceCount": 0,
+              "score": {
+                "max": 4,
+                "current": 3.33,
+                "percentage": 0.8325
+              },
+              "weight": 6
+            }
+          },
+          {
+            "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/secureScores/ascScore/secureScoreControls/f9d5432b-8f7b-45e9-b90c-e214a30f6a02",
+            "name": "f9d5432b-8f7b-45e9-b90c-e214a30f6a02",
+            "type": "Microsoft.Security/secureScores/secureScoreControls",
+            "properties": {
+              "displayName": "Restrict unauthorized network access",
+              "healthyResourceCount": 1,
+              "unhealthyResourceCount": 0,
+              "notApplicableResourceCount": 0,
+              "score": {
+                "max": 4,
+                "current": 4,
+                "percentage": 1
+              },
+              "weight": 1
+            }
+          },
+          {
+            "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/secureScores/ascScore/secureScoreControls/8fd574ec-43cf-426e-a439-a67cbaf2d564",
+            "name": "8fd574ec-43cf-426e-a439-a67cbaf2d564",
+            "type": "Microsoft.Security/secureScores/secureScoreControls",
+            "properties": {
+              "displayName": "Enable encryption at rest",
+              "healthyResourceCount": 1,
+              "unhealthyResourceCount": 0,
+              "notApplicableResourceCount": 0,
+              "score": {
+                "max": 4,
+                "current": 4,
+                "percentage": 1
+              },
+              "weight": 1
+            }
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/security/resource-manager/Microsoft.Security/stable/2020-01-01/examples/secureScores/ListSecureScoreControls_example.json b/specification/security/resource-manager/Microsoft.Security/stable/2020-01-01/examples/secureScores/ListSecureScoreControls_example.json
new file mode 100644
index 000000000000..e0f997e6b2d4
--- /dev/null
+++ b/specification/security/resource-manager/Microsoft.Security/stable/2020-01-01/examples/secureScores/ListSecureScoreControls_example.json
@@ -0,0 +1,218 @@
+{
+  "parameters": {
+    "api-version": "2020-01-01",
+    "subscriptionId": "20ff7fc3-e762-44dd-bd96-b71116dcdc23"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/secureScores/ascScore/secureScoreControls/a9909064-42b4-4d34-8143-275477afe18b",
+            "name": "a9909064-42b4-4d34-8143-275477afe18b",
+            "type": "Microsoft.Security/secureScores/secureScoreControls",
+            "properties": {
+              "displayName": "Protect applications against DDoS attacks",
+              "healthyResourceCount": 0,
+              "unhealthyResourceCount": 0,
+              "notApplicableResourceCount": 1,
+              "score": {
+                "max": 0,
+                "current": 0,
+                "percentage": 0
+              },
+              "weight": 0
+            }
+          },
+          {
+            "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/secureScores/ascScore/secureScoreControls/34a42fb3-e6db-409c-b56b-7b1db6b8aee0",
+            "name": "34a42fb3-e6db-409c-b56b-7b1db6b8aee0",
+            "type": "Microsoft.Security/secureScores/secureScoreControls",
+            "properties": {
+              "displayName": "Enable MFA",
+              "healthyResourceCount": 1,
+              "unhealthyResourceCount": 0,
+              "notApplicableResourceCount": 0,
+              "score": {
+                "max": 10,
+                "current": 10,
+                "percentage": 1
+              },
+              "weight": 1
+            }
+          },
+          {
+            "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/secureScores/ascScore/secureScoreControls/76763537-9feb-42d3-b4f4-78c01117be80",
+            "name": "76763537-9feb-42d3-b4f4-78c01117be80",
+            "type": "Microsoft.Security/secureScores/secureScoreControls",
+            "properties": {
+              "displayName": "Implement security best practices",
+              "healthyResourceCount": 7,
+              "unhealthyResourceCount": 0,
+              "notApplicableResourceCount": 1,
+              "score": {
+                "max": 0,
+                "current": 0,
+                "percentage": 0
+              },
+              "weight": 7
+            }
+          },
+          {
+            "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/secureScores/ascScore/secureScoreControls/4db8d6cf-075b-4149-a813-da09ca2ae120",
+            "name": "4db8d6cf-075b-4149-a813-da09ca2ae120",
+            "type": "Microsoft.Security/secureScores/secureScoreControls",
+            "properties": {
+              "displayName": "Enable Advanced Threat Protection",
+              "healthyResourceCount": 0,
+              "unhealthyResourceCount": 1,
+              "notApplicableResourceCount": 0,
+              "score": {
+                "max": 0,
+                "current": 0,
+                "percentage": 0
+              },
+              "weight": 1
+            }
+          },
+          {
+            "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/secureScores/ascScore/secureScoreControls/27b24961-75ba-4fe4-8909-97286d5dd5ee",
+            "name": "27b24961-75ba-4fe4-8909-97286d5dd5ee",
+            "type": "Microsoft.Security/secureScores/secureScoreControls",
+            "properties": {
+              "displayName": "Enable auditing and logging",
+              "healthyResourceCount": 1,
+              "unhealthyResourceCount": 4,
+              "notApplicableResourceCount": 0,
+              "score": {
+                "max": 1,
+                "current": 0.2,
+                "percentage": 0.2
+              },
+              "weight": 5
+            }
+          },
+          {
+            "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/secureScores/ascScore/secureScoreControls/2d85f639-0bea-4a4a-b6c6-608952a1414a",
+            "name": "2d85f639-0bea-4a4a-b6c6-608952a1414a",
+            "type": "Microsoft.Security/secureScores/secureScoreControls",
+            "properties": {
+              "displayName": "Manage access and permissions",
+              "healthyResourceCount": 1,
+              "unhealthyResourceCount": 1,
+              "notApplicableResourceCount": 0,
+              "score": {
+                "max": 4,
+                "current": 2,
+                "percentage": 0.5
+              },
+              "weight": 2
+            }
+          },
+          {
+            "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/secureScores/ascScore/secureScoreControls/99fc8df2-e0f5-40f8-9415-a7f7ca948b5a",
+            "name": "99fc8df2-e0f5-40f8-9415-a7f7ca948b5a",
+            "type": "Microsoft.Security/secureScores/secureScoreControls",
+            "properties": {
+              "displayName": "Remediate security configurations",
+              "healthyResourceCount": 0,
+              "unhealthyResourceCount": 1,
+              "notApplicableResourceCount": 0,
+              "score": {
+                "max": 4,
+                "current": 0,
+                "percentage": 0
+              },
+              "weight": 1
+            }
+          },
+          {
+            "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/secureScores/ascScore/secureScoreControls/12136bd9-dc24-44f2-9587-7be3af6aac14",
+            "name": "12136bd9-dc24-44f2-9587-7be3af6aac14",
+            "type": "Microsoft.Security/secureScores/secureScoreControls",
+            "properties": {
+              "displayName": "Enable endpoint protection",
+              "healthyResourceCount": 0,
+              "unhealthyResourceCount": 1,
+              "notApplicableResourceCount": 0,
+              "score": {
+                "max": 2,
+                "current": 0,
+                "percentage": 0
+              },
+              "weight": 1
+            }
+          },
+          {
+            "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/secureScores/ascScore/secureScoreControls/61702b76-1fab-41f2-bcbc-50b7870dcf38",
+            "name": "61702b76-1fab-41f2-bcbc-50b7870dcf38",
+            "type": "Microsoft.Security/secureScores/secureScoreControls",
+            "properties": {
+              "displayName": "Apply system updates",
+              "healthyResourceCount": 0,
+              "unhealthyResourceCount": 1,
+              "notApplicableResourceCount": 0,
+              "score": {
+                "max": 6,
+                "current": 0,
+                "percentage": 0
+              },
+              "weight": 1
+            }
+          },
+          {
+            "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/secureScores/ascScore/secureScoreControls/0e55495e-034f-4abc-8293-767229250176",
+            "name": "0e55495e-034f-4abc-8293-767229250176",
+            "type": "Microsoft.Security/secureScores/secureScoreControls",
+            "properties": {
+              "displayName": "Encrypt data in transit",
+              "healthyResourceCount": 5,
+              "unhealthyResourceCount": 1,
+              "notApplicableResourceCount": 0,
+              "score": {
+                "max": 4,
+                "current": 3.33,
+                "percentage": 0.8325
+              },
+              "weight": 6
+            }
+          },
+          {
+            "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/secureScores/ascScore/secureScoreControls/f9d5432b-8f7b-45e9-b90c-e214a30f6a02",
+            "name": "f9d5432b-8f7b-45e9-b90c-e214a30f6a02",
+            "type": "Microsoft.Security/secureScores/secureScoreControls",
+            "properties": {
+              "displayName": "Restrict unauthorized network access",
+              "healthyResourceCount": 1,
+              "unhealthyResourceCount": 0,
+              "notApplicableResourceCount": 0,
+              "score": {
+                "max": 4,
+                "current": 4,
+                "percentage": 1
+              },
+              "weight": 1
+            }
+          },
+          {
+            "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/secureScores/ascScore/secureScoreControls/8fd574ec-43cf-426e-a439-a67cbaf2d564",
+            "name": "8fd574ec-43cf-426e-a439-a67cbaf2d564",
+            "type": "Microsoft.Security/secureScores/secureScoreControls",
+            "properties": {
+              "displayName": "Enable encryption at rest",
+              "healthyResourceCount": 1,
+              "unhealthyResourceCount": 0,
+              "notApplicableResourceCount": 0,
+              "score": {
+                "max": 4,
+                "current": 4,
+                "percentage": 1
+              },
+              "weight": 1
+            }
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/security/resource-manager/Microsoft.Security/stable/2020-01-01/examples/secureScores/ListSecureScores_example.json b/specification/security/resource-manager/Microsoft.Security/stable/2020-01-01/examples/secureScores/ListSecureScores_example.json
new file mode 100644
index 000000000000..0f541546cb8a
--- /dev/null
+++ b/specification/security/resource-manager/Microsoft.Security/stable/2020-01-01/examples/secureScores/ListSecureScores_example.json
@@ -0,0 +1,28 @@
+{
+  "parameters": {
+    "api-version": "2020-01-01",
+    "subscriptionId": "20ff7fc3-e762-44dd-bd96-b71116dcdc23"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/secureScores/ascScore",
+            "name": "ascScore",
+            "type": "Microsoft.Security/secureScores",
+            "properties": {
+              "displayName": "ASC score",
+              "score": {
+                "max": 39,
+                "current": 23.53,
+                "percentage": 0.6033
+              },
+              "weight": 67
+            }
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/security/resource-manager/Microsoft.Security/stable/2020-01-01/secureScore.json b/specification/security/resource-manager/Microsoft.Security/stable/2020-01-01/secureScore.json
new file mode 100644
index 000000000000..c7a296a5fd3c
--- /dev/null
+++ b/specification/security/resource-manager/Microsoft.Security/stable/2020-01-01/secureScore.json
@@ -0,0 +1,622 @@
+{
+  "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/secureScores": {
+      "get": {
+        "x-ms-examples": {
+          "List secure scores": {
+            "$ref": "./examples/secureScores/ListSecureScores_example.json"
+          }
+        },
+        "tags": [
+          "Secure Score"
+        ],
+        "description": "List secure scores for all your Security Center initiatives within your current scope.",
+        "operationId": "SecureScores_List",
+        "parameters": [
+          {
+            "$ref": "../../../common/v1/types.json#/parameters/ApiVersion"
+          },
+          {
+            "$ref": "../../../common/v1/types.json#/parameters/SubscriptionId"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/SecureScoresList"
+            }
+          },
+          "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/secureScores/{secureScoreName}": {
+      "get": {
+        "x-ms-examples": {
+          "Get single secure score": {
+            "$ref": "./examples/secureScores/GetSecureScoresSingle_example.json"
+          }
+        },
+        "tags": [
+          "Secure Score"
+        ],
+        "description": "Get secure score for a specific Security Center initiative within your current scope. For the ASC Default initiative, use 'ascScore'.",
+        "operationId": "SecureScores_Get",
+        "parameters": [
+          {
+            "$ref": "../../../common/v1/types.json#/parameters/ApiVersion"
+          },
+          {
+            "$ref": "../../../common/v1/types.json#/parameters/SubscriptionId"
+          },
+          {
+            "$ref": "#/parameters/secureScoreName"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/SecureScoreItem"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "../../../common/v1/types.json#/definitions/CloudError"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/providers/Microsoft.Security/secureScores/{secureScoreName}/secureScoreControls": {
+      "get": {
+        "x-ms-examples": {
+          "Get security controls and their current score for the specified initiative": {
+            "$ref": "./examples/secureScores/ListSecureScoreControlsForName_builtin_example.json"
+          },
+          "Get security controls and their current score for the specified initiative with the expand parameter": {
+            "$ref": "./examples/secureScores/ListSecureScoreControlsForNameWithExpand_builtin_example.json"
+          }
+        },
+        "tags": [
+          "Secure Score"
+        ],
+        "description": "Get all security controls for a specific initiative within a scope",
+        "operationId": "SecureScoreControls_ListBySecureScore",
+        "parameters": [
+          {
+            "$ref": "../../../common/v1/types.json#/parameters/ApiVersion"
+          },
+          {
+            "$ref": "../../../common/v1/types.json#/parameters/SubscriptionId"
+          },
+          {
+            "$ref": "#/parameters/secureScoreName"
+          },
+          {
+            "$ref": "#/parameters/ExpandControlsDefinition"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/SecureScoreControlList"
+            }
+          },
+          "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/secureScoreControls": {
+      "get": {
+        "x-ms-examples": {
+          "List all secure scores controls": {
+            "$ref": "./examples/secureScores/ListSecureScoreControls_example.json"
+          }
+        },
+        "tags": [
+          "Secure Score Controls"
+        ],
+        "description": "Get all security controls within a scope",
+        "operationId": "SecureScoreControls_List",
+        "parameters": [
+          {
+            "$ref": "../../../common/v1/types.json#/parameters/ApiVersion"
+          },
+          {
+            "$ref": "../../../common/v1/types.json#/parameters/SubscriptionId"
+          },
+          {
+            "$ref": "#/parameters/ExpandControlsDefinition"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/SecureScoreControlList"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "../../../common/v1/types.json#/definitions/CloudError"
+            }
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        }
+      }
+    },
+    "/providers/Microsoft.Security/secureScoreControlDefinitions": {
+      "get": {
+        "x-ms-examples": {
+          "List security controls definition": {
+            "$ref": "./examples/secureScoreControlDefinitions/ListSecureScoreControlDefinitions_example.json"
+          }
+        },
+        "tags": [
+          "Secure Score Control Definitions"
+        ],
+        "description": "List the available security controls, their assessments, and the max score",
+        "operationId": "SecureScoreControlDefinitions_List",
+        "parameters": [
+          {
+            "$ref": "../../../common/v1/types.json#/parameters/ApiVersion"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/secureScoreControlDefinitionList"
+            }
+          },
+          "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/secureScoreControlDefinitions": {
+      "get": {
+        "x-ms-examples": {
+          "List security controls definition by subscription": {
+            "$ref": "./examples/secureScoreControlDefinitions/ListSecureScoreControlDefinitions_subscription_example.json"
+          }
+        },
+        "tags": [
+          "Secure Score Control Definitions"
+        ],
+        "description": "For a specified subscription, list the available security controls, their assessments, and the max score",
+        "operationId": "SecureScoreControlDefinitions_ListBySubscription",
+        "parameters": [
+          {
+            "$ref": "../../../common/v1/types.json#/parameters/ApiVersion"
+          },
+          {
+            "$ref": "../../../common/v1/types.json#/parameters/SubscriptionId"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/secureScoreControlDefinitionList"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "../../../common/v1/types.json#/definitions/CloudError"
+            }
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        }
+      }
+    }
+  },
+  "definitions": {
+    "SecureScoresList": {
+      "type": "object",
+      "description": "List of secure scores",
+      "properties": {
+        "value": {
+          "description": "Collection of secure scores in this page",
+          "readOnly": true,
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/SecureScoreItem"
+          }
+        },
+        "nextLink": {
+          "description": "The URI to fetch the next page.",
+          "readOnly": true,
+          "type": "string"
+        }
+      }
+    },
+    "SecureScoreItem": {
+      "description": "Secure score item data model",
+      "readOnly": true,
+      "type": "object",
+      "properties": {
+        "properties": {
+          "description": "Secure score item",
+          "readOnly": true,
+          "x-ms-client-flatten": true,
+          "$ref": "#/definitions/SecureScoreItemProperties"
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "../../../common/v1/types.json#/definitions/Resource"
+        }
+      ]
+    },
+    "SecureScoreItemProperties": {
+      "description": "Describes properties of a calculated secure score.",
+      "readOnly": true,
+      "type": "object",
+      "properties": {
+        "displayName": {
+          "description": "The initiative’s name",
+          "readOnly": true,
+          "type": "string"
+        },
+        "score": {
+          "description": "score object",
+          "readOnly": true,
+          "x-ms-client-flatten": true,
+          "$ref": "#/definitions/ScoreDetails"
+        },
+        "weight": {
+          "description": "The relative weight for each subscription. Used when calculating an aggregated secure score for multiple subscriptions.",
+          "readOnly": true,
+          "type": "integer",
+          "format": "int64",
+          "minimum": 0,
+          "exclusiveMinimum": false
+        }
+      }
+    },
+    "ScoreDetails": {
+      "description": "Calculation result data",
+      "readOnly": true,
+      "type": "object",
+      "properties": {
+        "max": {
+          "description": "Maximum score available",
+          "readOnly": true,
+          "type": "integer",
+          "format": "int32",
+          "minimum": 0,
+          "exclusiveMinimum": false
+        },
+        "current": {
+          "description": "Current score",
+          "readOnly": true,
+          "type": "number",
+          "format": "double",
+          "minimum": 0.00,
+          "exclusiveMinimum": false
+        },
+        "percentage": {
+          "description": "Ratio of the current score divided by the maximum. Rounded to 4 digits after the decimal point",
+          "readOnly": true,
+          "type": "number",
+          "format": "double",
+          "minimum": 0.00,
+          "maximum": 1.00,
+          "exclusiveMinimum": false,
+          "exclusiveMaximum": false
+        }
+      }
+    },
+    "SecureScoreControlScore": {
+      "description": "Calculation result data",
+      "type": "object",
+      "properties": {
+        "max": {
+          "description": "Maximum control score (0..10)",
+          "readOnly": true,
+          "type": "integer",
+          "format": "int32",
+          "minimum": 0,
+          "maximum": 10,
+          "exclusiveMinimum": false
+        },
+        "current": {
+          "description": "Actual score for the control = (achieved points / total points) * max score. if total points is zeroed, the return number is 0.00",
+          "readOnly": true,
+          "type": "number",
+          "format": "double",
+          "minimum": 0.00,
+          "maximum": 10.00,
+          "exclusiveMinimum": false
+        },
+        "percentage": {
+          "description": "Ratio of the current score divided by the maximum. Rounded to 4 digits after the decimal point",
+          "readOnly": true,
+          "type": "number",
+          "format": "double",
+          "minimum": 0.00,
+          "maximum": 1.00,
+          "exclusiveMinimum": false,
+          "exclusiveMaximum": false
+        }
+      }
+    },
+    "SecureScoreControlList": {
+      "description": "List of security controls",
+      "type": "object",
+      "properties": {
+        "value": {
+          "description": "Collection of security controls in this page",
+          "readOnly": true,
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/SecureScoreControlDetails"
+          }
+        },
+        "nextLink": {
+          "description": "The URI to fetch the next page.",
+          "readOnly": true,
+          "type": "string"
+        }
+      }
+    },
+    "SecureScoreControlDetails": {
+      "description": "Details of the security control, its score, and the health status of the relevant resources.",
+      "type": "object",
+      "properties": {
+        "properties": {
+          "x-ms-client-flatten": true,
+          "$ref": "#/definitions/SecureScoreControlScoreDetails"
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "../../../common/v1/types.json#/definitions/Resource"
+        }
+      ]
+    },
+    "SecureScoreControlScoreDetails": {
+      "description": "Calculation result data in control level",
+      "type": "object",
+      "properties": {
+        "displayName": {
+          "description": "User friendly display name of the control",
+          "readOnly": true,
+          "type": "string"
+        },
+        "score": {
+          "description": "Actual score object for the control",
+          "x-ms-client-flatten": true,
+          "$ref": "#/definitions/ScoreDetails"
+        },
+        "healthyResourceCount": {
+          "description": "Number of healthy resources in the control",
+          "readOnly": true,
+          "type": "integer",
+          "format": "int32"
+        },
+        "unhealthyResourceCount": {
+          "description": "Number of unhealthy resources in the control",
+          "readOnly": true,
+          "type": "integer",
+          "format": "int32"
+        },
+        "notApplicableResourceCount": {
+          "description": "Number of not applicable resources in the control",
+          "readOnly": true,
+          "type": "integer",
+          "format": "int32"
+        },
+        "weight": {
+          "description": "The relative weight for this specific control in each of your subscriptions. Used when calculating an aggregated score for this control across all of your subscriptions.",
+          "readOnly": true,
+          "type": "integer",
+          "format": "int64",
+          "minimum": 0,
+          "exclusiveMinimum": false
+        },
+        "definition": {
+          "$ref": "#/definitions/SecureScoreControlDefinitionItem"
+        }
+      }
+    },
+    "secureScoreControlDefinitionList": {
+      "description": "List of security controls definition",
+      "type": "object",
+      "properties": {
+        "value": {
+          "description": "Collection of security controls definition in this page",
+          "readOnly": true,
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/SecureScoreControlDefinitionItem"
+          }
+        },
+        "nextLink": {
+          "description": "The URI to fetch the next page.",
+          "readOnly": true,
+          "type": "string"
+        }
+      }
+    },
+    "SecureScoreControlDefinitionItem": {
+      "description": "Information about the security control.",
+      "type": "object",
+      "properties": {
+        "properties": {
+          "x-ms-client-flatten": true,
+          "$ref": "#/definitions/SecureScoreControlDefinitionItemProperties"
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "../../../common/v1/types.json#/definitions/Resource"
+        }
+      ]
+    },
+    "SecureScoreControlDefinitionItemProperties": {
+      "description": "Security Control Definition Properties.",
+      "type": "object",
+      "properties": {
+        "displayName": {
+          "description": "User friendly display name of the control",
+          "readOnly": true,
+          "type": "string"
+        },
+        "description": {
+          "description": "User friendly description of the control",
+          "readOnly": true,
+          "type": "string",
+          "maxLength": 256
+        },
+        "maxScore": {
+          "description": "Maximum control score (0..10)",
+          "readOnly": true,
+          "type": "integer",
+          "format": "int32",
+          "minimum": 0,
+          "maximum": 10,
+          "exclusiveMinimum": false
+        },
+        "source": {
+          "description": "Source object from which the control was created",
+          "readOnly": true,
+          "$ref": "#/definitions/SecureScoreControlDefinitionSource"
+        },
+        "assessmentDefinitions": {
+          "description": "Array of assessments metadata IDs that are included in this security control",
+          "readOnly": true,
+          "$ref": "../../../common/v1/types.json#/definitions/AzureResourceLinks"
+        }
+      }
+    },
+    "SecureScoreControlDefinitionSource": {
+      "description": "The type of the security control (For example, BuiltIn)",
+      "readOnly": true,
+      "type": "object",
+      "properties": {
+        "sourceType": {
+          "description": "The type of security control (for example, BuiltIn)",
+          "type": "string",
+          "enum": [
+            "BuiltIn",
+            "Custom"
+          ],
+          "x-ms-enum": {
+            "name": "controlType",
+            "modelAsString": true,
+            "values": [
+              {
+                "value": "BuiltIn",
+                "description": "Azure Security Center managed assessments"
+              },
+              {
+                "value": "Custom",
+                "description": "Non Azure Security Center managed assessments"
+              }
+            ]
+          }
+        }
+      }
+    }
+  },
+  "parameters": {
+    "ExpandControlsDefinition": {
+      "name": "$expand",
+      "in": "query",
+      "required": false,
+      "type": "string",
+      "description": "OData expand. Optional.",
+      "x-ms-parameter-location": "method",
+      "enum": [
+        "definition"
+      ],
+      "x-ms-enum": {
+        "name": "ExpandControlsEnum",
+        "modelAsString": true,
+        "values": [
+          {
+            "value": "definition",
+            "description": "Add definition object for each control"
+          }
+        ]
+      }
+    },
+    "secureScoreName": {
+      "name": "secureScoreName",
+      "in": "path",
+      "required": true,
+      "type": "string",
+      "description": "The initiative name. For the ASC Default initiative, use 'ascScore' as in the sample request below.",
+      "x-ms-parameter-location": "method"
+    }
+  }
+}
diff --git a/specification/security/resource-manager/readme.md b/specification/security/resource-manager/readme.md
index f9211516c275..9e8651424d97 100644
--- a/specification/security/resource-manager/readme.md
+++ b/specification/security/resource-manager/readme.md
@@ -84,6 +84,9 @@ These settings apply only when `--tag=package-composite-v1` is specified on the
 
 ``` yaml $(tag) == 'package-composite-v1'
 input-file:
+- Microsoft.Security/preview/2020-07-01-preview/sqlVulnerabilityAssessmentsScanOperations.json
+- Microsoft.Security/preview/2020-07-01-preview/sqlVulnerabilityAssessmentsScanResultsOperations.json
+- Microsoft.Security/preview/2020-07-01-preview/sqlVulnerabilityAssessmentsBaselineRuleOperations.json
 - Microsoft.Security/preview/2020-01-01-preview/secureScore.json
 - Microsoft.Security/preview/2020-01-01-preview/connectors.json
 - Microsoft.Security/preview/2019-01-01-preview/automations.json
@@ -122,6 +125,9 @@ These settings apply only when `--tag=package-composite-v2` is specified on the
 
 ``` yaml $(tag) == 'package-composite-v2'
 input-file:
+- Microsoft.Security/preview/2020-07-01-preview/sqlVulnerabilityAssessmentsScanOperations.json
+- Microsoft.Security/preview/2020-07-01-preview/sqlVulnerabilityAssessmentsScanResultsOperations.json
+- Microsoft.Security/preview/2020-07-01-preview/sqlVulnerabilityAssessmentsBaselineRuleOperations.json
 - Microsoft.Security/preview/2020-01-01-preview/secureScore.json
 - Microsoft.Security/preview/2020-01-01-preview/connectors.json
 - Microsoft.Security/preview/2019-01-01-preview/automations.json
@@ -197,11 +203,15 @@ input-file:
 - Microsoft.Security/stable/2020-01-01/discoveredSecuritySolutions.json
 - Microsoft.Security/stable/2020-01-01/securitySolutionsReferenceData.json
 - Microsoft.Security/stable/2020-01-01/externalSecuritySolutions.json
-- Microsoft.Security/preview/2020-01-01-preview/secureScore.json
+- Microsoft.Security/stable/2020-01-01/secureScore.json
 - Microsoft.Security/stable/2020-01-01/SecuritySolutions.json
 - Microsoft.Security/preview/2020-01-01-preview/connectors.json
+- Microsoft.Security/preview/2020-07-01-preview/sqlVulnerabilityAssessmentsScanOperations.json
+- Microsoft.Security/preview/2020-07-01-preview/sqlVulnerabilityAssessmentsScanResultsOperations.json
+- Microsoft.Security/preview/2020-07-01-preview/sqlVulnerabilityAssessmentsBaselineRuleOperations.json
 - Microsoft.Security/preview/2020-08-06-preview/iotDefenderSettings.json
 - Microsoft.Security/preview/2020-08-06-preview/iotSensors.json
+- Microsoft.Security/preview/2020-08-06-preview/devices.json
 - Microsoft.Security/preview/2020-08-06-preview/onPremiseIotSensors.json
 - Microsoft.Security/preview/2020-08-06-preview/iotAlerts.json
 - Microsoft.Security/preview/2020-08-06-preview/iotAlertTypes.json
@@ -378,6 +388,22 @@ input-file:
 - Microsoft.Security/stable/2020-01-01/jitNetworkAccessPolicies.json
 - Microsoft.Security/stable/2020-01-01/serverVulnerabilityAssessments.json	
 - Microsoft.Security/stable/2020-01-01/topologies.json
+- Microsoft.Security/stable/2020-01-01/secureScore.json
+
+# Needed when there is more than one input file
+override-info:
+  title: SecurityCenter
+```
+
+### Tag: package-2020-07-preview-only
+
+These settings apply only when `--tag=package-2020-07-preview-only` is specified on the command line. This tag is used for Ruby SDK.
+
+``` yaml $(tag) == 'package-2020-07-preview-only'
+input-file:
+- Microsoft.Security/preview/2020-07-01-preview/sqlVulnerabilityAssessmentsScanOperations.json
+- Microsoft.Security/preview/2020-07-01-preview/sqlVulnerabilityAssessmentsScanResultsOperations.json
+- Microsoft.Security/preview/2020-07-01-preview/sqlVulnerabilityAssessmentsBaselineRuleOperations.json
 
 # Needed when there is more than one input file
 override-info:
@@ -392,6 +418,7 @@ These settings apply only when `--tag=package-2020-08-preview-only` is specified
 input-file:
 - Microsoft.Security/preview/2020-08-06-preview/iotDefenderSettings.json
 - Microsoft.Security/preview/2020-08-06-preview/iotSensors.json
+- Microsoft.Security/preview/2020-08-06-preview/devices.json
 - Microsoft.Security/preview/2020-08-06-preview/onPremiseIotSensors.json
 - Microsoft.Security/preview/2020-08-06-preview/iotAlerts.json
 - Microsoft.Security/preview/2020-08-06-preview/iotAlertTypes.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 682ca4c40b17..6b6f24464a09 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
@@ -3150,14 +3150,14 @@
       },
       "put": {
         "x-ms-examples": {
-          "Creates an incident comment.": {
+          "Creates or updates an incident comment.": {
             "$ref": "./examples/incidents/comments/CreateIncidentComment.json"
           }
         },
         "tags": [
           "IncidentComments"
         ],
-        "description": "Creates the incident comment.",
+        "description": "Creates or updates the incident comment.",
         "operationId": "IncidentComments_CreateComment",
         "parameters": [
           {
@@ -3186,6 +3186,12 @@
           }
         ],
         "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/IncidentComment"
+            }
+          },
           "201": {
             "description": "Created",
             "schema": {
@@ -3199,6 +3205,55 @@
             }
           }
         }
+      },
+      "delete": {
+        "x-ms-examples": {
+          "Delete the incident comment.": {
+            "$ref": "./examples/incidents/comments/DeleteIncidentComment.json"
+          }
+        },
+        "tags": [
+          "IncidentComments"
+        ],
+        "description": "Delete the incident comment.",
+        "operationId": "IncidentComments_DeleteComment",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion"
+          },
+          {
+            "$ref": "#/parameters/SubscriptionId"
+          },
+          {
+            "$ref": "#/parameters/ResourceGroupName"
+          },
+          {
+            "$ref": "#/parameters/OperationalInsightsResourceProvider"
+          },
+          {
+            "$ref": "#/parameters/WorkspaceName"
+          },
+          {
+            "$ref": "#/parameters/IncidentId"
+          },
+          {
+            "$ref": "#/parameters/IncidentCommentId"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "OK"
+          },
+          "204": {
+            "description": "No Content"
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "#/definitions/CloudError"
+            }
+          }
+        }
       }
     },
     "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{operationalInsightsResourceProvider}/workspaces/{workspaceName}/providers/Microsoft.SecurityInsights/incidents/{incidentId}/entities": {
@@ -6939,7 +6994,7 @@
     "IncidentComment": {
       "allOf": [
         {
-          "$ref": "#/definitions/Resource"
+          "$ref": "#/definitions/ResourceWithEtag"
         }
       ],
       "description": "Represents an incident comment",
@@ -6981,6 +7036,12 @@
           "readOnly": true,
           "type": "string"
         },
+        "lastModifiedTimeUtc": {
+          "description": "The time the comment was updated",
+          "format": "date-time",
+          "readOnly": true,
+          "type": "string"
+        },
         "message": {
           "description": "The comment message",
           "type": "string"
@@ -7598,7 +7659,9 @@
             "Azure Security Center",
             "Azure Advanced Threat Protection",
             "Azure Active Directory Identity Protection",
-            "Azure Security Center for IoT"
+            "Azure Security Center for IoT",
+            "Office 365 Advanced Threat Protection",
+            "Microsoft Defender Advanced Threat Protection"
           ],
           "type": "string",
           "x-ms-enum": {
@@ -9041,11 +9104,11 @@
           "$ref": "#/definitions/DataConnector"
         }
       ],
-      "description": "Represents threat intelligence data connector.",
+      "description": "Data connector to pull threat intelligence data from TIP products.",
       "properties": {
         "properties": {
           "$ref": "#/definitions/TIDataConnectorProperties",
-          "description": "TI (Threat Intelligence) data connector properties.",
+          "description": "Threat Intelligence Platforms data connector properties.",
           "x-ms-client-flatten": true
         }
       },
@@ -9053,7 +9116,7 @@
       "x-ms-discriminator-value": "ThreatIntelligence"
     },
     "TIDataConnectorDataTypes": {
-      "description": "The available data types for TI (Threat Intelligence) data connector.",
+      "description": "The available data types for Threat Intelligence Platforms data connector.",
       "properties": {
         "indicators": {
           "allOf": [
@@ -9061,7 +9124,7 @@
               "$ref": "#/definitions/DataConnectorDataTypeCommon"
             }
           ],
-          "description": "Data type for indicators connection.",
+          "description": "Data type for Threat Intelligence Platforms data connector.",
           "type": "object"
         }
       },
@@ -9073,7 +9136,7 @@
           "$ref": "#/definitions/DataConnectorTenantId"
         }
       ],
-      "description": "TI (Threat Intelligence) data connector properties.",
+      "description": "Threat Intelligence Platforms data connector properties.",
       "properties": {
         "dataTypes": {
           "$ref": "#/definitions/TIDataConnectorDataTypes",
@@ -9088,11 +9151,11 @@
           "$ref": "#/definitions/DataConnectorsCheckRequirements"
         }
       ],
-      "description": "Represents threat intelligence requirements check request.",
+      "description": "Threat Intelligence Platforms data connector check requirements",
       "properties": {
         "properties": {
           "$ref": "#/definitions/TICheckRequirementsProperties",
-          "description": "TI (Threat Intelligence) requirements check properties.",
+          "description": "Threat Intelligence Platforms data connector check required properties",
           "x-ms-client-flatten": true
         }
       },
@@ -9105,7 +9168,7 @@
           "$ref": "#/definitions/DataConnectorTenantId"
         }
       ],
-      "description": "TI (Threat Intelligence) requirements check properties.",
+      "description": "Threat Intelligence Platforms data connector required properties.",
       "properties": {},
       "type": "object"
     },
@@ -9115,11 +9178,11 @@
           "$ref": "#/definitions/DataConnector"
         }
       ],
-      "description": "Represents threat intelligence taxii data connector.",
+      "description": "Data connector to pull Threat intelligence data from TAXII 2.0/2.1 server",
       "properties": {
         "properties": {
           "$ref": "#/definitions/TiTaxiiDataConnectorProperties",
-          "description": "Threat intelligence taxii client data connector properties.",
+          "description": "Threat intelligence TAXII data connector properties.",
           "x-ms-client-flatten": true
         }
       },
@@ -9127,7 +9190,7 @@
       "x-ms-discriminator-value": "ThreatIntelligenceTaxii"
     },
     "TiTaxiiDataConnectorDataTypes": {
-      "description": "The available data types for Threat Intelligence taxii client data connector.",
+      "description": "The available data types for Threat Intelligence TAXII data connector.",
       "properties": {
         "taxiiClient": {
           "allOf": [
@@ -9135,7 +9198,7 @@
               "$ref": "#/definitions/DataConnectorDataTypeCommon"
             }
           ],
-          "description": "Data type for taxii client.",
+          "description": "Data type for TAXII connector.",
           "type": "object"
         }
       },
@@ -9147,35 +9210,35 @@
           "$ref": "#/definitions/DataConnectorTenantId"
         }
       ],
-      "description": "Threat Intelligence taxii client data connector properties.",
+      "description": "Threat Intelligence TAXII data connector properties.",
       "properties": {
         "workspaceId": {
           "description": "The workspace id.",
           "type": "string"
         },
         "friendlyName": {
-          "description": "The friendly name for taxii client connector.",
+          "description": "The friendly name for the TAXII server.",
           "type": "string"
         },
         "taxiiServer": {
-          "description": "The API root server for taxii client.",
+          "description": "The API root for the TAXII server.",
           "type": "string"
         },
         "collectionId": {
-          "description": "The taxii collection id.",
+          "description": "The collection id of the TAXII server.",
           "type": "string"
         },
         "userName": {
-          "description": "The taxii server user name.",
+          "description": "The userName for the TAXII server.",
           "type": "string"
         },
         "password": {
-          "description": "The taxii server password.",
+          "description": "The password for the TAXII server.",
           "type": "string"
         },
         "dataTypes": {
           "$ref": "#/definitions/TiTaxiiDataConnectorDataTypes",
-          "description": "The available data types for the connector."
+          "description": "The available data types for Threat Intelligence TAXII data connector."
         }
       },
       "type": "object"
@@ -9186,11 +9249,11 @@
           "$ref": "#/definitions/DataConnectorsCheckRequirements"
         }
       ],
-      "description": "Represents threat intelligence requirements check request.",
+      "description": "Threat Intelligence TAXII data connector check requirements",
       "properties": {
         "properties": {
           "$ref": "#/definitions/TiTaxiiCheckRequirementsProperties",
-          "description": "Ti Taxii (Threat Intelligence Taxii) requirements check properties.",
+          "description": "Threat Intelligence TAXII check required properties.",
           "x-ms-client-flatten": true
         }
       },
@@ -9203,7 +9266,7 @@
           "$ref": "#/definitions/DataConnectorTenantId"
         }
       ],
-      "description": "Threat Intelligence taxii client data connector properties.",
+      "description": "Threat Intelligence TAXII data connector required properties.",
       "type": "object"
     },
     "ThreatIntelligence": {
diff --git a/specification/securityinsights/resource-manager/Microsoft.SecurityInsights/preview/2019-01-01-preview/examples/incidents/comments/CreateIncidentComment.json b/specification/securityinsights/resource-manager/Microsoft.SecurityInsights/preview/2019-01-01-preview/examples/incidents/comments/CreateIncidentComment.json
index e82cacf4bc78..40faabcdc088 100644
--- a/specification/securityinsights/resource-manager/Microsoft.SecurityInsights/preview/2019-01-01-preview/examples/incidents/comments/CreateIncidentComment.json
+++ b/specification/securityinsights/resource-manager/Microsoft.SecurityInsights/preview/2019-01-01-preview/examples/incidents/comments/CreateIncidentComment.json
@@ -14,14 +14,35 @@
     }
   },
   "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/d0cfe6b2-9ac0-4464-9919-dccaee2e48c0/resourceGroups/myRg/providers/Microsoft.OperationalIinsights/workspaces/myWorkspace/providers/Microsoft.SecurityInsights/incidents/73e01a99-5cd7-4139-a149-9f2736ff2ab5/comments/4bb36b7b-26ff-4d1c-9cbe-0d8ab3da0014",
+        "name": "4bb36b7b-26ff-4d1c-9cbe-0d8ab3da0014",
+        "type": "Microsoft.SecurityInsights/incidents/comments",
+        "etag": "190057d0-0000-0d00-0000-5c6f5adb0000",
+        "properties": {
+          "message": "Some message",
+          "createdTimeUtc": "2019-01-01T13:15:30Z",
+          "lastModifiedTimeUtc": "2019-01-03T11:10:30Z",
+          "author": {
+            "objectId": "2046feea-040d-4a46-9e2b-91c2941bfa70",
+            "email": "john.doe@contoso.com",
+            "userPrincipalName": "john@contoso.com",
+            "name": "john doe"
+          }
+        }
+      }
+    },
     "201": {
       "body": {
         "id": "/subscriptions/d0cfe6b2-9ac0-4464-9919-dccaee2e48c0/resourceGroups/myRg/providers/Microsoft.OperationalIinsights/workspaces/myWorkspace/providers/Microsoft.SecurityInsights/incidents/73e01a99-5cd7-4139-a149-9f2736ff2ab5/comments/4bb36b7b-26ff-4d1c-9cbe-0d8ab3da0014",
         "name": "4bb36b7b-26ff-4d1c-9cbe-0d8ab3da0014",
         "type": "Microsoft.SecurityInsights/incidents/comments",
+        "etag": "190057d0-0000-0d00-0000-5c622adb0000",
         "properties": {
           "message": "Some message",
           "createdTimeUtc": "2019-01-01T13:15:30Z",
+          "lastModifiedTimeUtc": "2019-01-01T13:15:30Z",
           "author": {
             "objectId": "2046feea-040d-4a46-9e2b-91c2941bfa70",
             "email": "john.doe@contoso.com",
diff --git a/specification/securityinsights/resource-manager/Microsoft.SecurityInsights/preview/2019-01-01-preview/examples/incidents/comments/DeleteIncidentComment.json b/specification/securityinsights/resource-manager/Microsoft.SecurityInsights/preview/2019-01-01-preview/examples/incidents/comments/DeleteIncidentComment.json
new file mode 100644
index 000000000000..77d29e520f83
--- /dev/null
+++ b/specification/securityinsights/resource-manager/Microsoft.SecurityInsights/preview/2019-01-01-preview/examples/incidents/comments/DeleteIncidentComment.json
@@ -0,0 +1,15 @@
+{
+  "parameters": {
+    "api-version": "2019-01-01-preview",
+    "subscriptionId": "d0cfe6b2-9ac0-4464-9919-dccaee2e48c0",
+    "resourceGroupName": "myRg",
+    "workspaceName": "myWorkspace",
+    "operationalInsightsResourceProvider": "Microsoft.OperationalInsights",
+    "incidentId": "73e01a99-5cd7-4139-a149-9f2736ff2ab5",
+    "incidentCommentId": "4bb36b7b-26ff-4d1c-9cbe-0d8ab3da0014"
+  },
+  "responses": {
+    "200": {},
+    "204": {}
+  }
+}
diff --git a/specification/securityinsights/resource-manager/Microsoft.SecurityInsights/preview/2019-01-01-preview/examples/incidents/comments/GetAllIncidentComments.json b/specification/securityinsights/resource-manager/Microsoft.SecurityInsights/preview/2019-01-01-preview/examples/incidents/comments/GetAllIncidentComments.json
index 87dbdd886e30..b820b7626c63 100644
--- a/specification/securityinsights/resource-manager/Microsoft.SecurityInsights/preview/2019-01-01-preview/examples/incidents/comments/GetAllIncidentComments.json
+++ b/specification/securityinsights/resource-manager/Microsoft.SecurityInsights/preview/2019-01-01-preview/examples/incidents/comments/GetAllIncidentComments.json
@@ -15,9 +15,11 @@
             "id": "/subscriptions/d0cfe6b2-9ac0-4464-9919-dccaee2e48c0/resourceGroups/myRg/providers/Microsoft.OperationalIinsights/workspaces/myWorkspace/providers/Microsoft.SecurityInsights/incidents/73e01a99-5cd7-4139-a149-9f2736ff2ab5/comments/4bb36b7b-26ff-4d1c-9cbe-0d8ab3da0014",
             "name": "4bb36b7b-26ff-4d1c-9cbe-0d8ab3da0014",
             "type": "Microsoft.SecurityInsights/incidents/comments",
+            "etag": "190057d0-0000-0d00-0000-5c6f5adb0000",
             "properties": {
               "message": "Some message",
               "createdTimeUtc": "2019-01-01T13:15:30Z",
+              "lastModifiedTimeUtc": "2019-01-03T11:10:30Z",
               "author": {
                 "objectId": "2046feea-040d-4a46-9e2b-91c2941bfa70",
                 "email": "john.doe@contoso.com",
diff --git a/specification/securityinsights/resource-manager/Microsoft.SecurityInsights/preview/2019-01-01-preview/examples/incidents/comments/GetIncidentCommentById.json b/specification/securityinsights/resource-manager/Microsoft.SecurityInsights/preview/2019-01-01-preview/examples/incidents/comments/GetIncidentCommentById.json
index fe757de317b3..315f614edc5e 100644
--- a/specification/securityinsights/resource-manager/Microsoft.SecurityInsights/preview/2019-01-01-preview/examples/incidents/comments/GetIncidentCommentById.json
+++ b/specification/securityinsights/resource-manager/Microsoft.SecurityInsights/preview/2019-01-01-preview/examples/incidents/comments/GetIncidentCommentById.json
@@ -14,9 +14,11 @@
         "id": "/subscriptions/d0cfe6b2-9ac0-4464-9919-dccaee2e48c0/resourceGroups/myRg/providers/Microsoft.OperationalIinsights/workspaces/myWorkspace/providers/Microsoft.SecurityInsights/incidents/73e01a99-5cd7-4139-a149-9f2736ff2ab5/comments/4bb36b7b-26ff-4d1c-9cbe-0d8ab3da0014",
         "name": "4bb36b7b-26ff-4d1c-9cbe-0d8ab3da0014",
         "type": "Microsoft.SecurityInsights/incidents/comments",
+        "etag": "190057d0-0000-0d00-0000-5c6f5adb0000",
         "properties": {
           "message": "Some message",
           "createdTimeUtc": "2019-01-01T13:15:30Z",
+          "lastModifiedTimeUtc": "2019-01-03T11:10:30Z",
           "author": {
             "objectId": "2046feea-040d-4a46-9e2b-91c2941bfa70",
             "email": "john.doe@contoso.com",
diff --git a/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/BackupPartition-1.json b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/BackupPartition-1.json
new file mode 100644
index 000000000000..2a7638588821
--- /dev/null
+++ b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/BackupPartition-1.json
@@ -0,0 +1,12 @@
+{
+  "operationId": "BackupPartition",
+  "description": "This example shows how to trigger backup of a partition now, which is already configured for periodic backups. The newly created backup will be saved at the same location where the periodic backups are being saved.",
+  "parameters": {
+    "api-version": "6.4",
+    "partitionId": "1daae3f5-7fd6-42e9-b1ba-8c05f873994d",
+    "BackupPartitionDescription": {}
+  },
+  "responses": {
+    "202": {}
+  }
+}
diff --git a/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/BackupPartition-2.json b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/BackupPartition-2.json
new file mode 100644
index 000000000000..9aa037a4d490
--- /dev/null
+++ b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/BackupPartition-2.json
@@ -0,0 +1,18 @@
+{
+  "operationId": "BackupPartition",
+  "description": "This example shows how to trigger backup of a partition now, and save the backup to a specific Azure blob storage account.",
+  "parameters": {
+    "api-version": "6.4",
+    "partitionId": "1daae3f5-7fd6-42e9-b1ba-8c05f873994d",
+    "BackupPartitionDescription": {
+      "BackupStorage": {
+        "StorageKind": "AzureBlobStore",
+        "ConnectionString": "DefaultEndpointsProtocol=https;AccountName=storagesample;AccountKey=<PutYourAccountKeyHere>",
+        "ContainerName": "BackupContainer"
+      }
+    }
+  },
+  "responses": {
+    "202": {}
+  }
+}
diff --git a/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/BackupPartition-3.json b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/BackupPartition-3.json
new file mode 100644
index 000000000000..3d9ef05b08e4
--- /dev/null
+++ b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/BackupPartition-3.json
@@ -0,0 +1,19 @@
+{
+  "operationId": "BackupPartition",
+  "description": "This example shows how to trigger backup of a partition now, and save the backup to a specific file share accessible from all cluster nodes.",
+  "parameters": {
+    "api-version": "6.4",
+    "partitionId": "1daae3f5-7fd6-42e9-b1ba-8c05f873994d",
+    "BackupPartitionDescription": {
+      "BackupStorage": {
+        "StorageKind": "FileShare",
+        "Path": "\\\\myshare\\backupshare",
+        "PrimaryUserName": "mydomain\\backupaccount",
+        "PrimaryPassword": "abcd1234"
+      }
+    }
+  },
+  "responses": {
+    "202": {}
+  }
+}
diff --git a/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/BackupPartition-4.json b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/BackupPartition-4.json
new file mode 100644
index 000000000000..e77b1a9f010d
--- /dev/null
+++ b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/BackupPartition-4.json
@@ -0,0 +1,18 @@
+{
+  "operationId": "BackupPartition",
+  "description": "This example shows how to trigger backup of a partition now, and save the backup to a specific Dsms Azure blob storage location.",
+  "parameters": {
+    "api-version": "6.4",
+    "partitionId": "1daae3f5-7fd6-42e9-b1ba-8c05f873994d",
+    "BackupPartitionDescription": {
+      "BackupStorage": {
+        "StorageKind": "DsmsAzureBlobStore",
+        "StorageCredentialsSourceLocation": "https://sample-dsms.dsms.core.winows.net/dsms/samplecredentiallocation/storageaccounts/samplestorageac/servicefabricbackup/samplebackup",
+        "ContainerName": "BackupContainer"
+      }
+    }
+  },
+  "responses": {
+    "202": {}
+  }
+}
diff --git a/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/CreateApplication-1.json b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/CreateApplication-1.json
new file mode 100644
index 000000000000..815b59ce3e50
--- /dev/null
+++ b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/CreateApplication-1.json
@@ -0,0 +1,15 @@
+{
+  "operationId": "CreateApplication",
+  "description": "This example shows how to create a Service Fabric application without overriding any application parameter values.",
+  "parameters": {
+    "api-version": "6.0",
+    "ApplicationDescription": {
+      "Name": "fabric:/samples/CalcApp",
+      "TypeVersion": "1.0",
+      "TypeName": "CalculatorApp"
+    }
+  },
+  "responses": {
+    "201": {}
+  }
+}
diff --git a/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/CreateBackupPolicy-1.json b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/CreateBackupPolicy-1.json
new file mode 100644
index 000000000000..a2bb056ee6d0
--- /dev/null
+++ b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/CreateBackupPolicy-1.json
@@ -0,0 +1,34 @@
+{
+  "operationId": "CreateBackupPolicy",
+  "description": "This example shows how to create a backup policy which takes backup twice everyday at 9 AM and 5 PM UTC which shall get deleted after 3 months, with Azure blob store as the backup location.",
+  "parameters": {
+    "api-version": "6.4",
+    "BackupPolicyDescription": {
+      "Name": "DailyAzureBackupPolicy",
+      "AutoRestoreOnDataLoss": false,
+      "MaxIncrementalBackups": 3,
+      "Schedule": {
+        "ScheduleKind": "TimeBased",
+        "ScheduleFrequencyType": "Daily",
+        "RunTimes": [
+          "0001-01-01T09:00:00Z",
+          "0001-01-01T17:00:00Z"
+        ]
+      },
+      "Storage": {
+        "StorageKind": "AzureBlobStore",
+        "FriendlyName": "Azure_storagesample",
+        "ConnectionString": "DefaultEndpointsProtocol=https;AccountName=storagesample;AccountKey=<PutYourAccountKeyHere>",
+        "ContainerName": "BackupContainer"
+      },
+      "RetentionPolicy": {
+        "RetentionPolicyType": "Basic",
+        "MinimumNumberOfBackups": 20,
+        "RetentionDuration": "P3M"
+      }
+    }
+  },
+  "responses": {
+    "201": {}
+  }
+}
diff --git a/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/CreateBackupPolicy-2.json b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/CreateBackupPolicy-2.json
new file mode 100644
index 000000000000..f688def9e59e
--- /dev/null
+++ b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/CreateBackupPolicy-2.json
@@ -0,0 +1,31 @@
+{
+  "operationId": "CreateBackupPolicy",
+  "description": "This example shows how to create a backup policy which takes backup every 10 minutes which shall get deleted after 20 days, with file share as the backup location.",
+  "parameters": {
+    "api-version": "6.4",
+    "BackupPolicyDescription": {
+      "Name": "FileShare10MinBackupPolicy",
+      "AutoRestoreOnDataLoss": false,
+      "MaxIncrementalBackups": 3,
+      "Schedule": {
+        "ScheduleKind": "FrequencyBased",
+        "Interval": "PT10M"
+      },
+      "Storage": {
+        "StorageKind": "FileShare",
+        "FriendlyName": "FileShare_myshare",
+        "Path": "\\\\myshare\\backupshare",
+        "PrimaryUserName": "backupaccount",
+        "PrimaryPassword": "abcd1234"
+      },
+      "RetentionPolicy": {
+        "RetentionPolicyType": "Basic",
+        "MinimumNumberOfBackups": 20,
+        "RetentionDuration": "P20D"
+      }
+    }
+  },
+  "responses": {
+    "201": {}
+  }
+}
diff --git a/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/CreateBackupPolicy-3.json b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/CreateBackupPolicy-3.json
new file mode 100644
index 000000000000..9c6068a735f8
--- /dev/null
+++ b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/CreateBackupPolicy-3.json
@@ -0,0 +1,34 @@
+{
+  "operationId": "CreateBackupPolicy",
+  "description": "This example shows how to create a backup policy which takes backup twice everyday at 9 AM and 5 PM UTC which shall get deleted after 3 months, with Dsms Azure blob store as the backup location.",
+  "parameters": {
+    "api-version": "6.4",
+    "BackupPolicyDescription": {
+      "Name": "SampleDsmsBackupPolicy",
+      "AutoRestoreOnDataLoss": false,
+      "MaxIncrementalBackups": 3,
+      "Schedule": {
+        "ScheduleKind": "TimeBased",
+        "ScheduleFrequencyType": "Daily",
+        "RunTimes": [
+          "0001-01-01T09:00:00Z",
+          "0001-01-01T17:00:00Z"
+        ]
+      },
+      "Storage": {
+        "StorageKind": "DsmsAzureBlobStore",
+        "FriendlyName": "DsmsAzure_storagesample",
+        "StorageCredentialsSourceLocation": "https://sample-dsms.dsms.core.winows.net/dsms/samplecredentiallocation/storageaccounts/samplestorageac/servicefabricbackup/samplebackup",
+        "ContainerName": "BackupContainer"
+      },
+      "RetentionPolicy": {
+        "RetentionPolicyType": "Basic",
+        "MinimumNumberOfBackups": 20,
+        "RetentionDuration": "P3M"
+      }
+    }
+  },
+  "responses": {
+    "201": {}
+  }
+}
diff --git a/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/CreateName-1.json b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/CreateName-1.json
new file mode 100644
index 000000000000..39588770e334
--- /dev/null
+++ b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/CreateName-1.json
@@ -0,0 +1,13 @@
+{
+  "operationId": "CreateName",
+  "description": "This example shows how to create a new Service Fabric name. The name can be created under an existing name that represents an appliction or a service or under a completely new name.",
+  "parameters": {
+    "api-version": "6.0",
+    "NameDescription": {
+      "Name": "fabric:/samples/CalculatorApp/CalculatorService/Name-1"
+    }
+  },
+  "responses": {
+    "201": {}
+  }
+}
diff --git a/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/CreateService-1.json b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/CreateService-1.json
new file mode 100644
index 000000000000..a969c12cd8a9
--- /dev/null
+++ b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/CreateService-1.json
@@ -0,0 +1,21 @@
+{
+  "operationId": "CreateService",
+  "description": "This example shows how to create a basic stateless Service Fabric service.",
+  "parameters": {
+    "applicationId": "test",
+    "api-version": "6.0",
+    "ServiceDescription": {
+      "ServiceKind": "Stateless",
+      "ApplicationName": "fabric:/test",
+      "ServiceName": "fabric:/test/test1",
+      "ServiceTypeName": "StatelessFrontendService",
+      "PartitionDescription": {
+        "PartitionScheme": "Singleton"
+      },
+      "InstanceCount": 4
+    }
+  },
+  "responses": {
+    "202": {}
+  }
+}
diff --git a/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/CreateService-2.json b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/CreateService-2.json
new file mode 100644
index 000000000000..bc7ada6bb8be
--- /dev/null
+++ b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/CreateService-2.json
@@ -0,0 +1,23 @@
+{
+  "operationId": "CreateService",
+  "description": "This example shows how to create a basic stateful Service Fabric service.",
+  "parameters": {
+    "applicationId": "test",
+    "api-version": "6.0",
+    "ServiceDescription": {
+      "ServiceKind": "Stateful",
+      "ApplicationName": "fabric:/test",
+      "ServiceName": "fabric:/test/test2",
+      "ServiceTypeName": "StatefulBackendService",
+      "PartitionDescription": {
+        "PartitionScheme": "Singleton"
+      },
+      "TargetReplicaSetSize": 3,
+      "MinReplicaSetSize": 2,
+      "HasPersistedState": false
+    }
+  },
+  "responses": {
+    "202": {}
+  }
+}
diff --git a/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/CreateService-3.json b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/CreateService-3.json
new file mode 100644
index 000000000000..75eaaea023df
--- /dev/null
+++ b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/CreateService-3.json
@@ -0,0 +1,47 @@
+{
+  "operationId": "CreateService",
+  "description": "This example shows how to create a stateless Service Fabric service with a dns name definied and auto scaling based on cpu usage.",
+  "parameters": {
+    "applicationId": "test",
+    "api-version": "6.0",
+    "ServiceDescription": {
+      "ServiceKind": "Stateless",
+      "ApplicationName": "fabric:/test",
+      "ServiceName": "fabric:/test/test1",
+      "ServiceTypeName": "StatelessFrontendService",
+      "InitializationData": [],
+      "PartitionDescription": {
+        "PartitionScheme": "Singleton"
+      },
+      "InstanceCount": 2,
+      "PlacementConstraints": "Color==Blue",
+      "CorrelationScheme": [],
+      "ServiceLoadMetrics": [],
+      "ServicePlacementPolicies": [],
+      "DefaultMoveCost": "Low",
+      "IsDefaultMoveCostSpecified": true,
+      "ServicePackageActivationMode": "ExclusiveProcess",
+      "ServiceDnsName": "test1.test",
+      "ScalingPolicies": [
+        {
+          "ScalingTrigger": {
+            "Kind": "AveragePartitionLoad",
+            "MetricName": "servicefabric:/_CpuCores",
+            "LowerLoadThreshold": "0.300000",
+            "UpperLoadThreshold": "0.800000",
+            "ScaleIntervalInSeconds": 600
+          },
+          "ScalingMechanism": {
+            "Kind": "PartitionInstanceCount",
+            "MinInstanceCount": 1,
+            "MaxInstanceCount": 6,
+            "ScaleIncrement": 2
+          }
+        }
+      ]
+    }
+  },
+  "responses": {
+    "202": {}
+  }
+}
diff --git a/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/CreateService-4.json b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/CreateService-4.json
new file mode 100644
index 000000000000..2211ae300e4b
--- /dev/null
+++ b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/CreateService-4.json
@@ -0,0 +1,46 @@
+{
+  "operationId": "CreateService",
+  "description": "This example shows how to create a stateful Service Fabric service with named partitions and scaling enabled based on memory usage.",
+  "parameters": {
+    "applicationId": "test",
+    "api-version": "6.0",
+    "ServiceDescription": {
+      "ServiceKind": "Stateful",
+      "ApplicationName": "fabric:/test",
+      "ServiceName": "fabric:/test/test2",
+      "ServiceTypeName": "StatefulBackendService",
+      "InitializationData": [],
+      "PartitionDescription": {
+        "PartitionScheme": "Named",
+        "Count": 1,
+        "Names": [
+          "0"
+        ]
+      },
+      "TargetReplicaSetSize": 3,
+      "MinReplicaSetSize": 2,
+      "HasPersistedState": true,
+      "ServicePackageActivationMode": "ExclusiveProcess",
+      "ScalingPolicies": [
+        {
+          "ScalingTrigger": {
+            "Kind": "AverageServiceLoad",
+            "MetricName": "servicefabric:/_MemoryInMB",
+            "LowerLoadThreshold": "500",
+            "UpperLoadThreshold": "900",
+            "ScaleIntervalInSeconds": 600
+          },
+          "ScalingMechanism": {
+            "Kind": "AddRemoveIncrementalNamedPartition",
+            "MinPartitionCount": 1,
+            "MaxPartitionCount": 3,
+            "ScaleIncrement": 1
+          }
+        }
+      ]
+    }
+  },
+  "responses": {
+    "202": {}
+  }
+}
diff --git a/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/DeleteBackupPolicy.json b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/DeleteBackupPolicy.json
new file mode 100644
index 000000000000..d4796b5ede08
--- /dev/null
+++ b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/DeleteBackupPolicy.json
@@ -0,0 +1,11 @@
+{
+  "operationId": "DeleteBackupPolicy",
+  "description": "This example shows how to delete an existing backup policy which is currently not associated with any backup entity.",
+  "parameters": {
+    "api-version": "6.4",
+    "backupPolicyName": "SampleBackupPolicy"
+  },
+  "responses": {
+    "200": {}
+  }
+}
diff --git a/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/DisableApplicationBackup.json b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/DisableApplicationBackup.json
new file mode 100644
index 000000000000..964fdaa8c3f3
--- /dev/null
+++ b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/DisableApplicationBackup.json
@@ -0,0 +1,14 @@
+{
+  "operationId": "DisableApplicationBackup",
+  "description": "This example shows how to disable periodic backup for a stateful application which was previously enabled.",
+  "parameters": {
+    "api-version": "6.4",
+    "applicationId": "CalcApp",
+    "DisableBackupDescription": {
+      "CleanBackup": true
+    }
+  },
+  "responses": {
+    "202": {}
+  }
+}
diff --git a/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/DisablePartitionBackup.json b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/DisablePartitionBackup.json
new file mode 100644
index 000000000000..1f6cc6b32ed3
--- /dev/null
+++ b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/DisablePartitionBackup.json
@@ -0,0 +1,14 @@
+{
+  "operationId": "DisablePartitionBackup",
+  "description": "This example shows how to disable periodic backup for a stateful partition which was previously enabled.",
+  "parameters": {
+    "api-version": "6.4",
+    "partitionId": "1daae3f5-7fd6-42e9-b1ba-8c05f873994d",
+    "DisableBackupDescription": {
+      "CleanBackup": false
+    }
+  },
+  "responses": {
+    "202": {}
+  }
+}
diff --git a/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/DisableServiceBackup.json b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/DisableServiceBackup.json
new file mode 100644
index 000000000000..14ca9acf4e25
--- /dev/null
+++ b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/DisableServiceBackup.json
@@ -0,0 +1,14 @@
+{
+  "operationId": "DisableServiceBackup",
+  "description": "This example shows how to disable periodic backup for a stateful service which was previously enabled.",
+  "parameters": {
+    "api-version": "6.4",
+    "serviceId": "CalcApp/CalcService",
+    "DisableBackupDescription": {
+      "CleanBackup": true
+    }
+  },
+  "responses": {
+    "202": {}
+  }
+}
diff --git a/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/EnableApplicationBackup.json b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/EnableApplicationBackup.json
new file mode 100644
index 000000000000..b0e24cd35f67
--- /dev/null
+++ b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/EnableApplicationBackup.json
@@ -0,0 +1,14 @@
+{
+  "operationId": "EnableApplicationBackup",
+  "description": "This example shows how to enable periodic backup for a stateful application.",
+  "parameters": {
+    "api-version": "6.4",
+    "applicationId": "CalcApp",
+    "EnableBackupDescription": {
+      "BackupPolicyName": "DailyAzureBackupPolicy"
+    }
+  },
+  "responses": {
+    "202": {}
+  }
+}
diff --git a/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/EnablePartitionBackup.json b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/EnablePartitionBackup.json
new file mode 100644
index 000000000000..739bd06ce60e
--- /dev/null
+++ b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/EnablePartitionBackup.json
@@ -0,0 +1,14 @@
+{
+  "operationId": "EnablePartitionBackup",
+  "description": "This example shows how to enable periodic backup for a stateful partition.",
+  "parameters": {
+    "api-version": "6.4",
+    "partitionId": "1daae3f5-7fd6-42e9-b1ba-8c05f873994d",
+    "EnableBackupDescription": {
+      "BackupPolicyName": "DailyAzureBackupPolicy"
+    }
+  },
+  "responses": {
+    "202": {}
+  }
+}
diff --git a/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/EnableServiceBackup.json b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/EnableServiceBackup.json
new file mode 100644
index 000000000000..0fe38fd714bc
--- /dev/null
+++ b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/EnableServiceBackup.json
@@ -0,0 +1,14 @@
+{
+  "operationId": "EnableServiceBackup",
+  "description": "This example shows how to enable periodic backup for a stateful service.",
+  "parameters": {
+    "api-version": "6.4",
+    "serviceId": "CalcApp/CalcService",
+    "EnableBackupDescription": {
+      "BackupPolicyName": "DailyAzureBackupPolicy"
+    }
+  },
+  "responses": {
+    "202": {}
+  }
+}
diff --git a/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetAllEntitiesBackedUpByPolicy-1.json b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetAllEntitiesBackedUpByPolicy-1.json
new file mode 100644
index 000000000000..9f4e37d7fdf9
--- /dev/null
+++ b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetAllEntitiesBackedUpByPolicy-1.json
@@ -0,0 +1,27 @@
+{
+  "operationId": "GetAllEntitiesBackedUpByPolicy",
+  "description": "This example shows how to get list of backup entities that are currently associated with a backup policy. The number of results in a page are limited to maximum of two using the MaxResult parameter.",
+  "parameters": {
+    "api-version": "6.4",
+    "backupPolicyName": "DailyAzureBackupPolicy",
+    "MaxResults": 2
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": {
+        "ContinuationToken": "fabric:/DemoApp",
+        "Items": [
+          {
+            "EntityKind": "Application",
+            "ApplicationName": "fabric:/CalcApp"
+          },
+          {
+            "EntityKind": "Application",
+            "ApplicationName": "fabric:/DemoApp"
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetAllEntitiesBackedUpByPolicy-2.json b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetAllEntitiesBackedUpByPolicy-2.json
new file mode 100644
index 000000000000..18f3467fc9ed
--- /dev/null
+++ b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetAllEntitiesBackedUpByPolicy-2.json
@@ -0,0 +1,24 @@
+{
+  "operationId": "GetAllEntitiesBackedUpByPolicy",
+  "description": "This example shows how to get list of backup entities that are currently associated with a backup policy. This example uses the ContinuationToken parameter. The value of this parameter is provided from the previous query; in this case the example shown above. The response contains the remaining results and an empty ContinuationToken. The empty ContinuationToken indicates that additional results are not available.",
+  "parameters": {
+    "api-version": "6.4",
+    "backupPolicyName": "DailyAzureBackupPolicy",
+    "MaxResults": 2,
+    "ContinuationToken": "fabric:/DemoApp"
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": {
+        "ContinuationToken": "",
+        "Items": [
+          {
+            "EntityKind": "Service",
+            "ServiceName": "fabric:/VotingApp/VotingActorService"
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetApplicationBackupConfigurationInfo-1.json b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetApplicationBackupConfigurationInfo-1.json
new file mode 100644
index 000000000000..3d396dbf082d
--- /dev/null
+++ b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetApplicationBackupConfigurationInfo-1.json
@@ -0,0 +1,39 @@
+{
+  "operationId": "GetApplicationBackupConfigurationInfo",
+  "description": "This example shows how to get list of backup configuration for this application and entities (services and partitions) under this application. The number of results in a page are limited to maximum of two using the MaxResult parameter.",
+  "parameters": {
+    "api-version": "6.4",
+    "applicationId": "CalcApp",
+    "MaxResults": 2
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": {
+        "ContinuationToken": "fabric:/CalcApp/CalcService",
+        "Items": [
+          {
+            "Kind": "Application",
+            "PolicyName": "BackupPolicy1",
+            "PolicyInheritedFrom": "Application",
+            "ApplicationName": "fabric:/CalcApp",
+            "SuspensionInfo": {
+              "IsSuspended": false,
+              "SuspensionInheritedFrom": "Invalid"
+            }
+          },
+          {
+            "Kind": "Service",
+            "PolicyName": "BackupPolicy2",
+            "PolicyInheritedFrom": "Service",
+            "ServiceName": "fabric:/CalcApp/CalcService",
+            "SuspensionInfo": {
+              "IsSuspended": false,
+              "SuspensionInheritedFrom": "Invalid"
+            }
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetApplicationBackupConfigurationInfo-2.json b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetApplicationBackupConfigurationInfo-2.json
new file mode 100644
index 000000000000..1ca86bee1983
--- /dev/null
+++ b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetApplicationBackupConfigurationInfo-2.json
@@ -0,0 +1,31 @@
+{
+  "operationId": "GetApplicationBackupConfigurationInfo",
+  "description": "This example shows how to get list of backup configuration for this application and entities (services and partitions) under this application. The number of results in a page are limited to maximum of two using the MaxResult parameter. This example uses the ContinuationToken parameter. The value of this parameter is provided from the previous query; in this case the example shown above. The response contains the remaining results and an empty ContinuationToken. The empty ContinuationToken indicates that additional results are not available.",
+  "parameters": {
+    "api-version": "6.4",
+    "applicationId": "CalcApp",
+    "MaxResults": 2,
+    "ContinuationToken": "fabric:/CalcApp/CalcService"
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": {
+        "ContinuationToken": "",
+        "Items": [
+          {
+            "Kind": "Partition",
+            "PolicyName": "BackupPolicy2",
+            "PolicyInheritedFrom": "Service",
+            "ServiceName": "fabric:/CalcApp/CalcService",
+            "PartitionId": "1daae3f5-7fd6-42e9-b1ba-8c05f873994d",
+            "SuspensionInfo": {
+              "IsSuspended": true,
+              "SuspensionInheritedFrom": "Partition"
+            }
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetApplicationBackupList-1.json b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetApplicationBackupList-1.json
new file mode 100644
index 000000000000..bc89f402c6bd
--- /dev/null
+++ b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetApplicationBackupList-1.json
@@ -0,0 +1,108 @@
+{
+  "operationId": "GetApplicationBackupList",
+  "description": "This example shows how to get list of application backups within a time range.",
+  "parameters": {
+    "api-version": "6.4",
+    "applicationId": "CalcApp",
+    "StartDateTimeFilter": "2018-01-01T00:00:00Z",
+    "EndDateTimeFilter": "2018-01-01T23:59:59Z"
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": {
+        "ContinuationToken": "",
+        "Items": [
+          {
+            "BackupId": "3a056ac9-7206-43c3-8424-6f6103003eba",
+            "BackupChainId": "3a056ac9-7206-43c3-8424-6f6103003eba",
+            "ApplicationName": "fabric:/CalcApp",
+            "ServiceName": "fabric:/CalcApp/CalcService",
+            "PartitionInformation": {
+              "LowKey": "-9223372036854775808",
+              "HighKey": "9223372036854775807",
+              "ServicePartitionKind": "Int64Range",
+              "Id": "1daae3f5-7fd6-42e9-b1ba-8c05f873994d"
+            },
+            "BackupLocation": "CalcApp\\CalcService\\1daae3f5-7fd6-42e9-b1ba-8c05f873994d\\2018-01-01 09.00.55.zip",
+            "BackupType": "Full",
+            "ServiceManifestVersion": "1.0.0",
+            "EpochOfLastBackupRecord": {
+              "DataLossVersion": "131462452931584510",
+              "ConfigurationVersion": "8589934592"
+            },
+            "LsnOfLastBackupRecord": "261",
+            "CreationTimeUtc": "2018-01-01T09:00:55Z",
+            "FailureError": null
+          },
+          {
+            "BackupId": "7903dc2a-228d-44b0-b7c8-a13a6c9b46bd",
+            "BackupChainId": "3a056ac9-7206-43c3-8424-6f6103003eba",
+            "ApplicationName": "fabric:/CalcApp",
+            "ServiceManifestVersion": "1.0.0",
+            "ServiceName": "fabric:/CalcApp/CalcService",
+            "PartitionInformation": {
+              "LowKey": "-9223372036854775808",
+              "HighKey": "9223372036854775807",
+              "ServicePartitionKind": "Int64Range",
+              "Id": "1daae3f5-7fd6-42e9-b1ba-8c05f873994d"
+            },
+            "BackupLocation": "CalcApp\\CalcService\\1daae3f5-7fd6-42e9-b1ba-8c05f873994d\\2018-01-01 17.01.02.zip",
+            "BackupType": "Incremental",
+            "EpochOfLastBackupRecord": {
+              "DataLossVersion": "131462452931584510",
+              "ConfigurationVersion": "8589934592"
+            },
+            "LsnOfLastBackupRecord": "446",
+            "CreationTimeUtc": "2018-01-01T17:01:02Z",
+            "FailureError": null
+          },
+          {
+            "BackupId": "0ff4fdbe-131c-4dfb-8249-7b4029ddc014",
+            "BackupChainId": "0ff4fdbe-131c-4dfb-8249-7b4029ddc014",
+            "ApplicationName": "fabric:/CalcApp",
+            "ServiceName": "fabric:/CalcApp/CalcService",
+            "ServiceManifestVersion": "1.0.0",
+            "PartitionInformation": {
+              "LowKey": "-9223372036854775808",
+              "HighKey": "9223372036854775807",
+              "ServicePartitionKind": "Int64Range",
+              "Id": "81645ec7-d260-4c59-9533-8f129bde8e83"
+            },
+            "BackupLocation": "CalcApp\\CalcService\\81645ec7-d260-4c59-9533-8f129bde8e83\\2018-01-01 09.01.02.zip",
+            "BackupType": "Full",
+            "EpochOfLastBackupRecord": {
+              "DataLossVersion": "131462452931584510",
+              "ConfigurationVersion": "8589934592"
+            },
+            "LsnOfLastBackupRecord": "161",
+            "CreationTimeUtc": "2018-01-01T09:01:02Z",
+            "FailureError": null
+          },
+          {
+            "BackupId": "d55a2d98-258b-4a34-8fe5-2063e81af9dc",
+            "BackupChainId": "0ff4fdbe-131c-4dfb-8249-7b4029ddc014",
+            "ApplicationName": "fabric:/CalcApp",
+            "ServiceName": "fabric:/CalcApp/CalcService",
+            "ServiceManifestVersion": "1.0.0",
+            "PartitionInformation": {
+              "LowKey": "-9223372036854775808",
+              "HighKey": "9223372036854775807",
+              "ServicePartitionKind": "Int64Range",
+              "Id": "81645ec7-d260-4c59-9533-8f129bde8e83"
+            },
+            "BackupLocation": "CalcApp\\CalcService\\81645ec7-d260-4c59-9533-8f129bde8e83\\2018-01-01 17.00.34.zip",
+            "BackupType": "Incremental",
+            "EpochOfLastBackupRecord": {
+              "DataLossVersion": "131462452931584510",
+              "ConfigurationVersion": "8589934592"
+            },
+            "LsnOfLastBackupRecord": "246",
+            "CreationTimeUtc": "2018-01-01T17:00:34Z",
+            "FailureError": null
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetApplicationBackupList-2.json b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetApplicationBackupList-2.json
new file mode 100644
index 000000000000..adb11bc306b8
--- /dev/null
+++ b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetApplicationBackupList-2.json
@@ -0,0 +1,63 @@
+{
+  "operationId": "GetApplicationBackupList",
+  "description": "This example shows how to get the latest backup for each partition within an application.",
+  "parameters": {
+    "api-version": "6.4",
+    "applicationId": "CalcApp",
+    "Latest": true
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": {
+        "ContinuationToken": "",
+        "Items": [
+          {
+            "BackupId": "7903dc2a-228d-44b0-b7c8-a13a6c9b46bd",
+            "BackupChainId": "3a056ac9-7206-43c3-8424-6f6103003eba",
+            "ApplicationName": "fabric:/CalcApp",
+            "ServiceName": "fabric:/CalcApp/CalcService",
+            "ServiceManifestVersion": "1.0.0",
+            "PartitionInformation": {
+              "LowKey": "-9223372036854775808",
+              "HighKey": "9223372036854775807",
+              "ServicePartitionKind": "Int64Range",
+              "Id": "1daae3f5-7fd6-42e9-b1ba-8c05f873994d"
+            },
+            "BackupLocation": "CalcApp\\CalcService\\1daae3f5-7fd6-42e9-b1ba-8c05f873994d\\2018-01-01 17.01.02.zip",
+            "BackupType": "Incremental",
+            "EpochOfLastBackupRecord": {
+              "DataLossVersion": "131462452931584510",
+              "ConfigurationVersion": "8589934592"
+            },
+            "LsnOfLastBackupRecord": "446",
+            "CreationTimeUtc": "2018-01-01T17:01:02Z",
+            "FailureError": null
+          },
+          {
+            "BackupId": "d55a2d98-258b-4a34-8fe5-2063e81af9dc",
+            "BackupChainId": "0ff4fdbe-131c-4dfb-8249-7b4029ddc014",
+            "ApplicationName": "fabric:/CalcApp",
+            "ServiceManifestVersion": "1.0.0",
+            "ServiceName": "fabric:/CalcApp/CalcService",
+            "PartitionInformation": {
+              "LowKey": "-9223372036854775808",
+              "HighKey": "9223372036854775807",
+              "ServicePartitionKind": "Int64Range",
+              "Id": "81645ec7-d260-4c59-9533-8f129bde8e83"
+            },
+            "BackupLocation": "CalcApp\\CalcService\\81645ec7-d260-4c59-9533-8f129bde8e83\\2018-01-01 17.00.34.zip",
+            "BackupType": "Incremental",
+            "EpochOfLastBackupRecord": {
+              "DataLossVersion": "131462452931584510",
+              "ConfigurationVersion": "8589934592"
+            },
+            "LsnOfLastBackupRecord": "246",
+            "CreationTimeUtc": "2018-01-01T17:00:34Z",
+            "FailureError": null
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetApplicationBackupList-3.json b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetApplicationBackupList-3.json
new file mode 100644
index 000000000000..189ba7d18cbf
--- /dev/null
+++ b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetApplicationBackupList-3.json
@@ -0,0 +1,63 @@
+{
+  "operationId": "GetApplicationBackupList",
+  "description": "This example shows how to get list of application backups. The number of results in a page are limited to maximum of two using the MaxResult parameter.",
+  "parameters": {
+    "api-version": "6.4",
+    "applicationId": "CalcApp",
+    "MaxResults": 2
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": {
+        "ContinuationToken": "fabric:/CalcApp/CalcService#1daae3f5-7fd6-42e9-b1ba-8c05f873994d#7903dc2a-228d-44b0-b7c8-a13a6c9b46bd",
+        "Items": [
+          {
+            "BackupId": "3a056ac9-7206-43c3-8424-6f6103003eba",
+            "BackupChainId": "3a056ac9-7206-43c3-8424-6f6103003eba",
+            "ApplicationName": "fabric:/CalcApp",
+            "ServiceManifestVersion": "1.0.0",
+            "ServiceName": "fabric:/CalcApp/CalcService",
+            "PartitionInformation": {
+              "LowKey": "-9223372036854775808",
+              "HighKey": "9223372036854775807",
+              "ServicePartitionKind": "Int64Range",
+              "Id": "1daae3f5-7fd6-42e9-b1ba-8c05f873994d"
+            },
+            "BackupLocation": "CalcApp\\CalcService\\1daae3f5-7fd6-42e9-b1ba-8c05f873994d\\2018-01-01 09.00.55.zip",
+            "BackupType": "Full",
+            "EpochOfLastBackupRecord": {
+              "DataLossVersion": "131462452931584510",
+              "ConfigurationVersion": "8589934592"
+            },
+            "LsnOfLastBackupRecord": "261",
+            "CreationTimeUtc": "2018-01-01T09:00:55Z",
+            "FailureError": null
+          },
+          {
+            "BackupId": "7903dc2a-228d-44b0-b7c8-a13a6c9b46bd",
+            "BackupChainId": "3a056ac9-7206-43c3-8424-6f6103003eba",
+            "ApplicationName": "fabric:/CalcApp",
+            "ServiceManifestVersion": "1.0.0",
+            "ServiceName": "fabric:/CalcApp/CalcService",
+            "PartitionInformation": {
+              "LowKey": "-9223372036854775808",
+              "HighKey": "9223372036854775807",
+              "ServicePartitionKind": "Int64Range",
+              "Id": "1daae3f5-7fd6-42e9-b1ba-8c05f873994d"
+            },
+            "BackupLocation": "CalcApp\\CalcService\\1daae3f5-7fd6-42e9-b1ba-8c05f873994d\\2018-01-01 17.01.02.zip",
+            "BackupType": "Incremental",
+            "EpochOfLastBackupRecord": {
+              "DataLossVersion": "131462452931584510",
+              "ConfigurationVersion": "8589934592"
+            },
+            "LsnOfLastBackupRecord": "446",
+            "CreationTimeUtc": "2018-01-01T17:01:02Z",
+            "FailureError": null
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetApplicationBackupList-4.json b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetApplicationBackupList-4.json
new file mode 100644
index 000000000000..537af235a0e2
--- /dev/null
+++ b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetApplicationBackupList-4.json
@@ -0,0 +1,64 @@
+{
+  "operationId": "GetApplicationBackupList",
+  "description": "This example shows how to get list of application backups. The number of results in a page are limited to maximum of two using the MaxResult parameter. This example uses the ContinuationToken parameter. The value of this parameter is provided from the previous query; in this case the example shown above. The response contains the remaining results and an empty ContinuationToken. The empty ContinuationToken indicates that additional results are not available.",
+  "parameters": {
+    "api-version": "6.4",
+    "applicationId": "CalcApp",
+    "MaxResults": 2,
+    "ContinuationToken": "fabric:/CalcApp/CalcService#1daae3f5-7fd6-42e9-b1ba-8c05f873994d#7903dc2a-228d-44b0-b7c8-a13a6c9b46bd"
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": {
+        "ContinuationToken": "",
+        "Items": [
+          {
+            "BackupId": "0ff4fdbe-131c-4dfb-8249-7b4029ddc014",
+            "BackupChainId": "0ff4fdbe-131c-4dfb-8249-7b4029ddc014",
+            "ApplicationName": "fabric:/CalcApp",
+            "ServiceManifestVersion": "1.0.0",
+            "ServiceName": "fabric:/CalcApp/CalcService",
+            "PartitionInformation": {
+              "LowKey": "-9223372036854775808",
+              "HighKey": "9223372036854775807",
+              "ServicePartitionKind": "Int64Range",
+              "Id": "81645ec7-d260-4c59-9533-8f129bde8e83"
+            },
+            "BackupLocation": "CalcApp\\CalcService\\81645ec7-d260-4c59-9533-8f129bde8e83\\2018-01-01 09.01.02.zip",
+            "BackupType": "Full",
+            "EpochOfLastBackupRecord": {
+              "DataLossVersion": "131462452931584510",
+              "ConfigurationVersion": "8589934592"
+            },
+            "LsnOfLastBackupRecord": "161",
+            "CreationTimeUtc": "2018-01-01T09:01:02Z",
+            "FailureError": null
+          },
+          {
+            "BackupId": "d55a2d98-258b-4a34-8fe5-2063e81af9dc",
+            "BackupChainId": "0ff4fdbe-131c-4dfb-8249-7b4029ddc014",
+            "ApplicationName": "fabric:/CalcApp",
+            "ServiceManifestVersion": "1.0.0",
+            "ServiceName": "fabric:/CalcApp/CalcService",
+            "PartitionInformation": {
+              "LowKey": "-9223372036854775808",
+              "HighKey": "9223372036854775807",
+              "ServicePartitionKind": "Int64Range",
+              "Id": "81645ec7-d260-4c59-9533-8f129bde8e83"
+            },
+            "BackupLocation": "CalcApp\\CalcService\\81645ec7-d260-4c59-9533-8f129bde8e83\\2018-01-01 17.00.34.zip",
+            "BackupType": "Incremental",
+            "EpochOfLastBackupRecord": {
+              "DataLossVersion": "131462452931584510",
+              "ConfigurationVersion": "8589934592"
+            },
+            "LsnOfLastBackupRecord": "246",
+            "CreationTimeUtc": "2018-01-01T17:00:34Z",
+            "FailureError": null
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetApplicationEventList.json b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetApplicationEventList.json
new file mode 100644
index 000000000000..32bca288ae42
--- /dev/null
+++ b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetApplicationEventList.json
@@ -0,0 +1,27 @@
+{
+  "operationId": "GetApplicationEventList",
+  "description": "This example shows how to get all application-related events during a certain time window.",
+  "parameters": {
+    "applicationId": "app1",
+    "api-version": "6.4",
+    "StartTimeUtc": "2018-04-03T18:00:00Z",
+    "EndTimeUtc": "2018-04-04T18:00:00Z"
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": [
+        {
+          "Kind": "ApplicationCreated",
+          "ApplicationTypeName": "App1Type",
+          "ApplicationTypeVersion": "1.0.1",
+          "ApplicationDefinitionKind": "ServiceFabricApplicationDescription",
+          "ApplicationId": "app1",
+          "EventInstanceId": "8a7a0c42-67ca-4cd3-9160-edcdb822db10",
+          "TimeStamp": "2018-04-03T20:21:23.5774199Z",
+          "HasCorrelatedEvents": false
+        }
+      ]
+    }
+  }
+}
diff --git a/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetApplicationInfoByName-1.json b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetApplicationInfoByName-1.json
new file mode 100644
index 000000000000..fb15937b1e84
--- /dev/null
+++ b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetApplicationInfoByName-1.json
@@ -0,0 +1,33 @@
+{
+  "operationId": "GetApplicationInfo",
+  "description": "This example shows how to get information about an application using it's identifier. If the application is found, information about it is returned with 200 status code. If the application is not found, empty content is returned with 204 status code.",
+  "parameters": {
+    "api-version": "6.0",
+    "applicationId": "samples~CalculatorApp"
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": {
+        "Id": "samples~CalculatorApp",
+        "Name": "fabric:/samples/CalculatorApp",
+        "TypeName": "CalculatorApp",
+        "TypeVersion": "1.0",
+        "Status": "Ready",
+        "Parameters": [
+          {
+            "Key": "CalculatorAppParameter1",
+            "Value": "314"
+          },
+          {
+            "Key": "CalculatorAppParameter2",
+            "Value": "271"
+          }
+        ],
+        "HealthState": "Ok",
+        "ApplicationDefinitionKind": "ServiceFabricApplicationDescription"
+      }
+    },
+    "204": {}
+  }
+}
diff --git a/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetApplicationInfoList-1.json b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetApplicationInfoList-1.json
new file mode 100644
index 000000000000..2ca46b64e3a4
--- /dev/null
+++ b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetApplicationInfoList-1.json
@@ -0,0 +1,38 @@
+{
+  "operationId": "GetApplicationInfoList",
+  "description": "This example shows how to get information about applications on the cluster. The number of results in a page are limited to maximum of two using the MaxResult parameter.",
+  "parameters": {
+    "api-version": "6.1",
+    "MaxResults": 2
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": {
+        "ContinuationToken": "fabric:/samples/PQueueApp1",
+        "Items": [
+          {
+            "Id": "samples~CalculatorApp",
+            "Name": "fabric:/samples/CalculatorApp",
+            "TypeName": "CalculatorApp",
+            "TypeVersion": "1.0",
+            "Status": "Ready",
+            "Parameters": [],
+            "HealthState": "Ok",
+            "ApplicationDefinitionKind": "ServiceFabricApplicationDescription"
+          },
+          {
+            "Id": "samples~PQueueApp1",
+            "Name": "fabric:/samples/PQueueApp1",
+            "TypeName": "PersistentQueueApp",
+            "TypeVersion": "1.0",
+            "Status": "Ready",
+            "Parameters": [],
+            "HealthState": "Ok",
+            "ApplicationDefinitionKind": "ServiceFabricApplicationDescription"
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetApplicationInfoList-2.json b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetApplicationInfoList-2.json
new file mode 100644
index 000000000000..c0755d26e14b
--- /dev/null
+++ b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetApplicationInfoList-2.json
@@ -0,0 +1,29 @@
+{
+  "operationId": "GetApplicationInfoList",
+  "description": "This example shows how to page through the information about applications on the cluster using the ContinuationToken parameter. The value of this parameter is provided from the previous query, in this case the example shown above. The response contains the remaining one result and an empty ContinuationToken. The empty ContinuationToken indicates that additional results are not available.",
+  "parameters": {
+    "api-version": "6.1",
+    "MaxResults": 2,
+    "ContinuationToken": "fabric:/samples/PQueueApp1"
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": {
+        "ContinuationToken": "",
+        "Items": [
+          {
+            "Id": "samples~VQueueApp1",
+            "Name": "fabric:/samples/VQueueApp1",
+            "TypeName": "VolatileQueueApp",
+            "TypeVersion": "1.0",
+            "Status": "Ready",
+            "Parameters": [],
+            "HealthState": "Ok",
+            "ApplicationDefinitionKind": "ServiceFabricApplicationDescription"
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetApplicationTypeInfoList-1.json b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetApplicationTypeInfoList-1.json
new file mode 100644
index 000000000000..bcb6a4e5e3b7
--- /dev/null
+++ b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetApplicationTypeInfoList-1.json
@@ -0,0 +1,85 @@
+{
+  "operationId": "GetApplicationTypeInfoList",
+  "description": "This example shows how to get information about application types that are provisioned or being provisioned in the cluster. The number of results in a page are limited to maximum of five using MaxResult parameter.",
+  "parameters": {
+    "api-version": "6.0",
+    "MaxResults": 5
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": {
+        "ContinuationToken": "PersistentQueueApp+2.0",
+        "Items": [
+          {
+            "Name": "CalculatorApp",
+            "Version": "1.0",
+            "DefaultParameterList": [
+              {
+                "Key": "ServiceInstanceCount",
+                "Value": "3"
+              }
+            ],
+            "Status": "Available"
+          },
+          {
+            "Name": "CalculatorApp",
+            "Version": "2.0",
+            "DefaultParameterList": [
+              {
+                "Key": "ServiceInstanceCount",
+                "Value": "3"
+              }
+            ],
+            "Status": "Available"
+          },
+          {
+            "Name": "GatewayApp",
+            "Version": "1.0",
+            "DefaultParameterList": [
+              {
+                "Key": "GatewayPort",
+                "Value": "8505"
+              },
+              {
+                "Key": "ServiceInstanceCount",
+                "Value": "1000"
+              }
+            ],
+            "Status": "Available"
+          },
+          {
+            "Name": "PersistentQueueApp",
+            "Version": "1.0",
+            "DefaultParameterList": [
+              {
+                "Key": "MinReplicaSetSize",
+                "Value": "2"
+              },
+              {
+                "Key": "TargetReplicaSetSize",
+                "Value": "3"
+              }
+            ],
+            "Status": "Available"
+          },
+          {
+            "Name": "PersistentQueueApp",
+            "Version": "2.0",
+            "DefaultParameterList": [
+              {
+                "Key": "MinReplicaSetSize",
+                "Value": "2"
+              },
+              {
+                "Key": "TargetReplicaSetSize",
+                "Value": "3"
+              }
+            ],
+            "Status": "Available"
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetApplicationTypeInfoList-2.json b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetApplicationTypeInfoList-2.json
new file mode 100644
index 000000000000..a7c38cdedbe7
--- /dev/null
+++ b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetApplicationTypeInfoList-2.json
@@ -0,0 +1,49 @@
+{
+  "operationId": "GetApplicationTypeInfoList",
+  "description": "This example shows how to page through the information about application types that are provisioned or being provisioned in the cluster using ContinuationToken parameter. The value of this parameter is provided from the previous query, in this case the example shown above. The response contains the remaining two results and an empty ContinuationToken. The empty ContinuationToken indicates that additional results are not available.",
+  "parameters": {
+    "api-version": "6.0",
+    "MaxResults": 5,
+    "ContinuationToken": "PersistentQueueApp+2.0"
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": {
+        "ContinuationToken": "",
+        "Items": [
+          {
+            "Name": "VolatileQueueApp",
+            "Version": "1.0",
+            "DefaultParameterList": [
+              {
+                "Key": "MinReplicaSetSize",
+                "Value": "2"
+              },
+              {
+                "Key": "TargetReplicaSetSize",
+                "Value": "3"
+              }
+            ],
+            "Status": "Available"
+          },
+          {
+            "Name": "VolatileQueueApp",
+            "Version": "2.0",
+            "DefaultParameterList": [
+              {
+                "Key": "MinReplicaSetSize",
+                "Value": "2"
+              },
+              {
+                "Key": "TargetReplicaSetSize",
+                "Value": "3"
+              }
+            ],
+            "Status": "Available"
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetApplicationTypeInfoList-3.json b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetApplicationTypeInfoList-3.json
new file mode 100644
index 000000000000..473565e56c6d
--- /dev/null
+++ b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetApplicationTypeInfoList-3.json
@@ -0,0 +1,60 @@
+{
+  "operationId": "GetApplicationTypeInfoList",
+  "description": "This example shows how to exclude application parameter in the result when getting the information about application types that are provisioned or being provisioned in the cluster.",
+  "parameters": {
+    "api-version": "6.0",
+    "ExcludeApplicationParameters": true
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": {
+        "ContinuationToken": "",
+        "Items": [
+          {
+            "Name": "CalculatorApp",
+            "Version": "1.0",
+            "DefaultParameterList": [],
+            "Status": "Available"
+          },
+          {
+            "Name": "CalculatorApp",
+            "Version": "2.0",
+            "DefaultParameterList": [],
+            "Status": "Available"
+          },
+          {
+            "Name": "GatewayApp",
+            "Version": "1.0",
+            "DefaultParameterList": [],
+            "Status": "Available"
+          },
+          {
+            "Name": "PersistentQueueApp",
+            "Version": "1.0",
+            "DefaultParameterList": [],
+            "Status": "Available"
+          },
+          {
+            "Name": "PersistentQueueApp",
+            "Version": "2.0",
+            "DefaultParameterList": [],
+            "Status": "Available"
+          },
+          {
+            "Name": "VolatileQueueApp",
+            "Version": "1.0",
+            "DefaultParameterList": [],
+            "Status": "Available"
+          },
+          {
+            "Name": "VolatileQueueApp",
+            "Version": "2.0",
+            "DefaultParameterList": [],
+            "Status": "Available"
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetApplicationsEventList.json b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetApplicationsEventList.json
new file mode 100644
index 000000000000..fa65ec159120
--- /dev/null
+++ b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetApplicationsEventList.json
@@ -0,0 +1,36 @@
+{
+  "operationId": "GetApplicationsEventList",
+  "description": "This example shows how to get all applications-related events during a certain time window.",
+  "parameters": {
+    "api-version": "6.4",
+    "StartTimeUtc": "2018-04-03T18:00:00Z",
+    "EndTimeUtc": "2018-04-04T18:00:00Z"
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": [
+        {
+          "Kind": "ApplicationCreated",
+          "ApplicationTypeName": "App1Type",
+          "ApplicationTypeVersion": "1.0.1",
+          "ApplicationDefinitionKind": "ServiceFabricApplicationDescription",
+          "ApplicationId": "app1",
+          "EventInstanceId": "8a7a0c42-67ca-4cd3-9160-edcdb822db10",
+          "TimeStamp": "2018-04-03T20:21:23.5774199Z",
+          "HasCorrelatedEvents": false
+        },
+        {
+          "Kind": "ApplicationCreated",
+          "ApplicationTypeName": "App2Type",
+          "ApplicationTypeVersion": "4.0.1",
+          "ApplicationDefinitionKind": "ServiceFabricApplicationDescription",
+          "ApplicationId": "app2",
+          "EventInstanceId": "d50574bc-6a31-4945-8275-7639bec7a0b3",
+          "TimeStamp": "2018-04-03T20:21:59.74842Z",
+          "HasCorrelatedEvents": false
+        }
+      ]
+    }
+  }
+}
diff --git a/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetBackupPolicyByName.json b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetBackupPolicyByName.json
new file mode 100644
index 000000000000..411b836109b2
--- /dev/null
+++ b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetBackupPolicyByName.json
@@ -0,0 +1,36 @@
+{
+  "operationId": "GetBackupPolicyByName",
+  "description": "This example shows how to query a backup policy by name.",
+  "parameters": {
+    "api-version": "6.4",
+    "backupPolicyName": "DailyAzureBackupPolicy"
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": {
+        "Name": "DailyAzureBackupPolicy",
+        "AutoRestoreOnDataLoss": false,
+        "MaxIncrementalBackups": 3,
+        "Schedule": {
+          "ScheduleKind": "TimeBased",
+          "ScheduleFrequencyType": "Daily",
+          "RunTimes": [
+            "0001-01-01T09:00:00Z",
+            "0001-01-01T17:00:00Z"
+          ]
+        },
+        "Storage": {
+          "StorageKind": "AzureBlobStore",
+          "ConnectionString": "DefaultEndpointsProtocol=https;AccountName=storagesample;AccountKey=<PutYourAccountKeyHere>",
+          "ContainerName": "BackupContainer"
+        },
+        "RetentionPolicy": {
+          "RetentionPolicyType": "Basic",
+          "MinimumNumberOfBackups": 20,
+          "RetentionDuration": "P20D"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetBackupPolicyList-1.json b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetBackupPolicyList-1.json
new file mode 100644
index 000000000000..c3ad42774736
--- /dev/null
+++ b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetBackupPolicyList-1.json
@@ -0,0 +1,87 @@
+{
+  "operationId": "GetBackupPolicyList",
+  "description": "This example shows how to get list of backup policies. The number of results in a page are limited to maximum of two using the MaxResult parameter.",
+  "parameters": {
+    "api-version": "6.4",
+    "MaxResults": 3
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": {
+        "ContinuationToken": "FileShare10MinBackupPolicy",
+        "Items": [
+          {
+            "Name": "DailyAzureBackupPolicy",
+            "AutoRestoreOnDataLoss": false,
+            "MaxIncrementalBackups": 3,
+            "Schedule": {
+              "ScheduleKind": "TimeBased",
+              "ScheduleFrequencyType": "Daily",
+              "RunTimes": [
+                "0001-01-01T09:00:00Z",
+                "0001-01-01T17:00:00Z"
+              ]
+            },
+            "Storage": {
+              "StorageKind": "AzureBlobStore",
+              "FriendlyName": "Azure_storagesample",
+              "ConnectionString": "DefaultEndpointsProtocol=https;AccountName=storagesample;AccountKey=<PutYourAccountKeyHere>",
+              "ContainerName": "BackupContainer"
+            },
+            "RetentionPolicy": {
+              "RetentionPolicyType": "Basic",
+              "MinimumNumberOfBackups": 30,
+              "RetentionDuration": "P29D"
+            }
+          },
+          {
+            "Name": "SampleDsmsBackupPolicy",
+            "AutoRestoreOnDataLoss": false,
+            "MaxIncrementalBackups": 3,
+            "Schedule": {
+              "ScheduleKind": "TimeBased",
+              "ScheduleFrequencyType": "Daily",
+              "RunTimes": [
+                "0001-01-01T09:00:00Z",
+                "0001-01-01T17:00:00Z"
+              ]
+            },
+            "Storage": {
+              "StorageKind": "DsmsAzureBlobStore",
+              "FriendlyName": "DsmsAzure_storagesample",
+              "StorageCredentialsSourceLocation": "https://sample-dsms.dsms.core.winows.net/dsms/samplecredentiallocation/storageaccounts/samplestorageac/servicefabricbackup/samplebackup",
+              "ContainerName": "BackupContainer"
+            },
+            "RetentionPolicy": {
+              "RetentionPolicyType": "Basic",
+              "MinimumNumberOfBackups": 10,
+              "RetentionDuration": "P3M"
+            }
+          },
+          {
+            "Name": "FileShare10MinBackupPolicy",
+            "AutoRestoreOnDataLoss": false,
+            "MaxIncrementalBackups": 3,
+            "Schedule": {
+              "ScheduleKind": "FrequencyBased",
+              "Interval": "PT10M"
+            },
+            "Storage": {
+              "StorageKind": "FileShare",
+              "FriendlyName": "FileShare_myshare",
+              "Path": "\\\\myshare\\backupshare",
+              "PrimaryUserName": "backupaccount",
+              "PrimaryPassword": "****"
+            },
+            "RetentionPolicy": {
+              "RetentionPolicyType": "Basic",
+              "MinimumNumberOfBackups": 20,
+              "RetentionDuration": "P20D"
+            }
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetBackupPolicyList-2.json b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetBackupPolicyList-2.json
new file mode 100644
index 000000000000..f5f941d6eda8
--- /dev/null
+++ b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetBackupPolicyList-2.json
@@ -0,0 +1,42 @@
+{
+  "operationId": "GetBackupPolicyList",
+  "description": "This example shows how to get list of backup policies. The number of results in a page are limited to maximum of two using the MaxResult parameter. This example uses the ContinuationToken parameter. The value of this parameter is provided from the previous query; in this case the example shown above. The response contains the remaining results and an empty ContinuationToken. The empty ContinuationToken indicates that additional results are not available.",
+  "parameters": {
+    "api-version": "6.4",
+    "MaxResults": 3,
+    "ContinuationToken": "FileShare10MinBackupPolicy"
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": {
+        "ContinuationToken": "",
+        "Items": [
+          {
+            "AutoRestoreOnDataLoss": false,
+            "Name": "SampleBackupPolicy",
+            "MaxIncrementalBackups": 5,
+            "Schedule": {
+              "ScheduleKind": "FrequencyBased",
+              "Interval": "PT4H5M"
+            },
+            "Storage": {
+              "Path": "\\\\myshare\\BackupStore",
+              "PrimaryUserName": "myuser1",
+              "PrimaryPassword": "****",
+              "SecondaryUserName": "myuser2",
+              "SecondaryPassword": "****",
+              "StorageKind": "FileShare",
+              "FriendlyName": ""
+            },
+            "RetentionPolicy": {
+              "RetentionPolicyType": "Basic",
+              "MinimumNumberOfBackups": 0,
+              "RetentionDuration": "P20D"
+            }
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetBackupsFromBackupLocation-1.json b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetBackupsFromBackupLocation-1.json
new file mode 100644
index 000000000000..6925de02aeb5
--- /dev/null
+++ b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetBackupsFromBackupLocation-1.json
@@ -0,0 +1,73 @@
+{
+  "operationId": "GetBackupsFromBackupLocation",
+  "description": "This example shows how to get list of application backups from a specified backup location. The number of results in a page are limited to maximum of two using the MaxResult parameter.",
+  "parameters": {
+    "api-version": "6.4",
+    "MaxResults": 2,
+    "GetBackupByStorageQueryDescription": {
+      "Storage": {
+        "StorageKind": "AzureBlobStore",
+        "ConnectionString": "DefaultEndpointsProtocol=https;AccountName=storagesample;AccountKey=<PutYourAccountKeyHere>",
+        "ContainerName": "BackupContainer"
+      },
+      "BackupEntity": {
+        "EntityKind": "Application",
+        "ApplicationName": "fabric:/CalcApp"
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": {
+        "ContinuationToken": "fabric:/CalcApp/CalcService#1daae3f5-7fd6-42e9-b1ba-8c05f873994d#7903dc2a-228d-44b0-b7c8-a13a6c9b46bd",
+        "Items": [
+          {
+            "BackupId": "3a056ac9-7206-43c3-8424-6f6103003eba",
+            "BackupChainId": "3a056ac9-7206-43c3-8424-6f6103003eba",
+            "ApplicationName": "fabric:/CalcApp",
+            "ServiceManifestVersion": "1.0.0",
+            "ServiceName": "fabric:/CalcApp/CalcService",
+            "PartitionInformation": {
+              "LowKey": "-9223372036854775808",
+              "HighKey": "9223372036854775807",
+              "ServicePartitionKind": "Int64Range",
+              "Id": "1daae3f5-7fd6-42e9-b1ba-8c05f873994d"
+            },
+            "BackupLocation": "CalcApp\\CalcService\\1daae3f5-7fd6-42e9-b1ba-8c05f873994d\\2018-01-01 09.00.55.zip",
+            "BackupType": "Full",
+            "EpochOfLastBackupRecord": {
+              "DataLossVersion": "131462452931584510",
+              "ConfigurationVersion": "8589934592"
+            },
+            "LsnOfLastBackupRecord": "261",
+            "CreationTimeUtc": "2018-01-01T09:00:55Z",
+            "FailureError": null
+          },
+          {
+            "BackupId": "7903dc2a-228d-44b0-b7c8-a13a6c9b46bd",
+            "BackupChainId": "3a056ac9-7206-43c3-8424-6f6103003eba",
+            "ApplicationName": "fabric:/CalcApp",
+            "ServiceManifestVersion": "1.0.0",
+            "ServiceName": "fabric:/CalcApp/CalcService",
+            "PartitionInformation": {
+              "LowKey": "-9223372036854775808",
+              "HighKey": "9223372036854775807",
+              "ServicePartitionKind": "Int64Range",
+              "Id": "1daae3f5-7fd6-42e9-b1ba-8c05f873994d"
+            },
+            "BackupLocation": "CalcApp\\CalcService\\1daae3f5-7fd6-42e9-b1ba-8c05f873994d\\2018-01-01 17.01.02.zip",
+            "BackupType": "Incremental",
+            "EpochOfLastBackupRecord": {
+              "DataLossVersion": "131462452931584510",
+              "ConfigurationVersion": "8589934592"
+            },
+            "LsnOfLastBackupRecord": "446",
+            "CreationTimeUtc": "2018-01-01T17:01:02Z",
+            "FailureError": null
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetBackupsFromBackupLocation-2.json b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetBackupsFromBackupLocation-2.json
new file mode 100644
index 000000000000..190f318797ab
--- /dev/null
+++ b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetBackupsFromBackupLocation-2.json
@@ -0,0 +1,74 @@
+{
+  "operationId": "GetBackupsFromBackupLocation",
+  "description": "This example shows how to get list of application backups. The number of results in a page are limited to maximum of two using the MaxResult parameter. This example uses the ContinuationToken parameter. The value of this parameter is provided from the previous query; in this case the example shown above. The response contains the remaining results and an empty ContinuationToken. The empty ContinuationToken indicates that additional results are not available.",
+  "parameters": {
+    "api-version": "6.4",
+    "MaxResults": 2,
+    "GetBackupByStorageQueryDescription": {
+      "Storage": {
+        "StorageKind": "AzureBlobStore",
+        "ConnectionString": "DefaultEndpointsProtocol=https;AccountName=storagesample;AccountKey=<PutYourAccountKeyHere>",
+        "ContainerName": "BackupContainer"
+      },
+      "BackupEntity": {
+        "EntityKind": "Application",
+        "ApplicationName": "fabric:/CalcApp"
+      }
+    },
+    "ContinuationToken": "fabric:/CalcApp/CalcService#1daae3f5-7fd6-42e9-b1ba-8c05f873994d#7903dc2a-228d-44b0-b7c8-a13a6c9b46bd"
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": {
+        "ContinuationToken": "",
+        "Items": [
+          {
+            "BackupId": "0ff4fdbe-131c-4dfb-8249-7b4029ddc014",
+            "BackupChainId": "0ff4fdbe-131c-4dfb-8249-7b4029ddc014",
+            "ApplicationName": "fabric:/CalcApp",
+            "ServiceManifestVersion": "1.0.0",
+            "ServiceName": "fabric:/CalcApp/CalcService",
+            "PartitionInformation": {
+              "LowKey": "-9223372036854775808",
+              "HighKey": "9223372036854775807",
+              "ServicePartitionKind": "Int64Range",
+              "Id": "81645ec7-d260-4c59-9533-8f129bde8e83"
+            },
+            "BackupLocation": "CalcApp\\CalcService\\81645ec7-d260-4c59-9533-8f129bde8e83\\2018-01-01 09.01.02.zip",
+            "BackupType": "Full",
+            "EpochOfLastBackupRecord": {
+              "DataLossVersion": "131462452931584510",
+              "ConfigurationVersion": "8589934592"
+            },
+            "LsnOfLastBackupRecord": "161",
+            "CreationTimeUtc": "2018-01-01T09:01:02Z",
+            "FailureError": null
+          },
+          {
+            "BackupId": "d55a2d98-258b-4a34-8fe5-2063e81af9dc",
+            "BackupChainId": "0ff4fdbe-131c-4dfb-8249-7b4029ddc014",
+            "ApplicationName": "fabric:/CalcApp",
+            "ServiceManifestVersion": "1.0.0",
+            "ServiceName": "fabric:/CalcApp/CalcService",
+            "PartitionInformation": {
+              "LowKey": "-9223372036854775808",
+              "HighKey": "9223372036854775807",
+              "ServicePartitionKind": "Int64Range",
+              "Id": "81645ec7-d260-4c59-9533-8f129bde8e83"
+            },
+            "BackupLocation": "CalcApp\\CalcService\\81645ec7-d260-4c59-9533-8f129bde8e83\\2018-01-01 17.00.34.zip",
+            "BackupType": "Incremental",
+            "EpochOfLastBackupRecord": {
+              "DataLossVersion": "131462452931584510",
+              "ConfigurationVersion": "8589934592"
+            },
+            "LsnOfLastBackupRecord": "246",
+            "CreationTimeUtc": "2018-01-01T17:00:34Z",
+            "FailureError": null
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetChaosEvents.json b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetChaosEvents.json
new file mode 100644
index 000000000000..4e5d7bb0b4e3
--- /dev/null
+++ b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetChaosEvents.json
@@ -0,0 +1,62 @@
+{
+  "operationId": "GetChaosEvents",
+  "description": "This example shows how to get Chaos events in a single response message without the need for paging through ContinuationToken parameter.",
+  "parameters": {
+    "api-version": "6.2",
+    "StartTimeUtc": "0",
+    "EndTimeUtc": "3155378975999999999"
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": {
+        "ContinuationToken": "",
+        "History": [
+          {
+            "ChaosEvent": {
+              "Kind": "Started",
+              "TimeStampUtc": "2017-04-14T04:27:19.049Z",
+              "ChaosParameters": {
+                "MaxClusterStabilizationTimeoutInSeconds": 30,
+                "MaxConcurrentFaults": 3,
+                "WaitTimeBetweenIterationsInSeconds": 10,
+                "WaitTimeBetweenFaultsInSeconds": 1,
+                "TimeToRunInSeconds": "3600",
+                "EnableMoveReplicaFaults": true,
+                "ClusterHealthPolicy": {
+                  "ConsiderWarningAsError": true,
+                  "MaxPercentUnhealthyNodes": 0,
+                  "MaxPercentUnhealthyApplications": 10,
+                  "ApplicationTypeHealthPolicyMap": [
+                    {
+                      "Key": "myapp",
+                      "Value": 3
+                    }
+                  ]
+                },
+                "Context": {
+                  "Map": {
+                    "k1": "v1",
+                    "k2": "v2",
+                    "k3": "v5"
+                  }
+                }
+              }
+            }
+          },
+          {
+            "ChaosEvent": {
+              "Kind": "ExecutingFaults",
+              "TimeStampUtc": "2017-04-14T04:27:20.667Z",
+              "Faults": [
+                "ActionType: RestartReplica, ServiceUri: fabric:/TestApp1/PersistServ_6R_1, PartitionId: 6a91b09a-bd76-45da-afaa-ed0fd9bfe7d2, ReplicaId: 131366172775684622",
+                "ActionType: CodePackageRestart, NodeName: N0050, ApplicationName: fabric:/TestApp1, ServiceManifestName: SP1, ServiceManifestName: , CodePackageName: CP1.",
+                "ActionType: RestartReplica, ServiceUri: fabric:/TestApp1/PersistServ_6R_3, PartitionId: baa3a51e-5c42-435e-89d3-6e97b2164661, ReplicaId: 131366172988968762"
+              ]
+            }
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetClusterEventList.json b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetClusterEventList.json
new file mode 100644
index 000000000000..3a122bb8aec0
--- /dev/null
+++ b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetClusterEventList.json
@@ -0,0 +1,55 @@
+{
+  "operationId": "GetClusterEventList",
+  "description": "This example shows how to get all cluster-related events during a certain time window.",
+  "parameters": {
+    "api-version": "6.4",
+    "StartTimeUtc": "2018-04-03T18:00:00Z",
+    "EndTimeUtc": "2018-04-04T18:00:00Z"
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": [
+        {
+          "Kind": "ClusterUpgradeStarted",
+          "CurrentClusterVersion": "0.0.0.0:",
+          "TargetClusterVersion": "6.2:1.0",
+          "UpgradeType": "Rolling",
+          "RollingUpgradeMode": "UnmonitoredAuto",
+          "FailureAction": "Manual",
+          "EventInstanceId": "090add3c-8f56-4d35-8d57-a855745b6064",
+          "TimeStamp": "2018-04-03T20:18:59.4313064Z",
+          "HasCorrelatedEvents": false
+        },
+        {
+          "Kind": "ClusterUpgradeDomainCompleted",
+          "TargetClusterVersion": "6.2:1.0",
+          "UpgradeState": "RollingForward",
+          "UpgradeDomains": "(0 1 2)",
+          "UpgradeDomainElapsedTimeInMs": 78.5288,
+          "EventInstanceId": "090add3c-8f56-4d35-8d57-a855745b6064",
+          "TimeStamp": "2018-04-03T20:19:59.5729953Z",
+          "HasCorrelatedEvents": false
+        },
+        {
+          "Kind": "ClusterUpgradeDomainCompleted",
+          "TargetClusterVersion": "6.2:1.0",
+          "UpgradeState": "RollingForward",
+          "UpgradeDomains": "(3 4)",
+          "UpgradeDomainElapsedTimeInMs": 0.0,
+          "EventInstanceId": "090add3c-8f56-4d35-8d57-a855745b6064",
+          "TimeStamp": "2018-04-03T20:20:59.6271949Z",
+          "HasCorrelatedEvents": false
+        },
+        {
+          "Kind": "ClusterUpgradeCompleted",
+          "TargetClusterVersion": "6.2:1.0",
+          "OverallUpgradeElapsedTimeInMs": 120196.5212,
+          "EventInstanceId": "090add3c-8f56-4d35-8d57-a855745b6064",
+          "TimeStamp": "2018-04-03T20:20:59.8134457Z",
+          "HasCorrelatedEvents": false
+        }
+      ]
+    }
+  }
+}
diff --git a/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetClusterVersion-1.json b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetClusterVersion-1.json
new file mode 100644
index 000000000000..fd3b6fbf55b8
--- /dev/null
+++ b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetClusterVersion-1.json
@@ -0,0 +1,15 @@
+{
+  "operationId": "GetClusterVersion",
+  "description": "This example retrieves the current (or lowest version during upgrade) cluster version.",
+  "parameters": {
+    "api-version": "6.4"
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": {
+        "Version": "6.4.514.9494"
+      }
+    }
+  }
+}
diff --git a/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetContainerLogsDeployedOnNode-1.json b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetContainerLogsDeployedOnNode-1.json
new file mode 100644
index 000000000000..1be29fb8e6ef
--- /dev/null
+++ b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetContainerLogsDeployedOnNode-1.json
@@ -0,0 +1,19 @@
+{
+  "operationId": "GetContainerLogsDeployedOnNode",
+  "description": "This example shows how to get container logs for container deployed on a Service Fabric node for the given code package.",
+  "parameters": {
+    "api-version": "6.2",
+    "nodeName": "_Node_0",
+    "applicationId": "SimpleHttpServerApp",
+    "ServiceManifestName": "SimpleHttpServerSvcPkg",
+    "CodePackageName": "Code"
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": {
+        "Content": "HTTP Server started listening on port 8080\r\n"
+      }
+    }
+  }
+}
diff --git a/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetContainerLogsDeployedOnNode-2.json b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetContainerLogsDeployedOnNode-2.json
new file mode 100644
index 000000000000..9f1025363561
--- /dev/null
+++ b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetContainerLogsDeployedOnNode-2.json
@@ -0,0 +1,20 @@
+{
+  "operationId": "GetContainerLogsDeployedOnNode",
+  "description": "This example shows how to get last 10 lines of container logs for container deployed on a Service Fabric node for the given code package.",
+  "parameters": {
+    "api-version": "6.2",
+    "nodeName": "_Node_0",
+    "applicationId": "SimpleHttpServerApp",
+    "ServiceManifestName": "SimpleHttpServerSvcPkg",
+    "CodePackageName": "Code",
+    "Tail": "10"
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": {
+        "Content": "UTC Time Now: 04/02/2018 22:06:31\r\nUTC Time Now: 04/02/2018 22:06:32\r\nUTC Time Now: 04/02/2018 22:06:33\r\nUTC Time Now: 04/02/2018 22:06:344\r\nUTC Time Now: 04/02/2018 22:06:35\r\nUTC Time Now: 04/02/2018 22:06:36\r\nUTC Time Now: 04/02/2018 22:06:37\r\nUTC Time Now: 04/02/2018 22:06:38\r\nUTC Time Now: 04/02/2018 22:06:39\r\nUTC Time Now: 04/02/2018 22:06:40\r\n"
+      }
+    }
+  }
+}
diff --git a/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetContainerLogsDeployedOnNode-3.json b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetContainerLogsDeployedOnNode-3.json
new file mode 100644
index 000000000000..2ca6cad4f774
--- /dev/null
+++ b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetContainerLogsDeployedOnNode-3.json
@@ -0,0 +1,20 @@
+{
+  "operationId": "GetContainerLogsDeployedOnNode",
+  "description": "This example shows how to get container logs of previous dead container on a Service Fabric node for the given code package.",
+  "parameters": {
+    "api-version": "6.2",
+    "nodeName": "_Node_0",
+    "applicationId": "SimpleHttpServerApp",
+    "ServiceManifestName": "SimpleHttpServerSvcPkg",
+    "CodePackageName": "Code",
+    "Previous": true
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": {
+        "Content": "Exception encountered: System.Net.Http.HttpRequestException: Response status code does not indicate success: 500 (Internal Server Error).\r\n\tat System.Net.Http.HttpResponseMessage.EnsureSuccessStatusCode()\r\n"
+      }
+    }
+  }
+}
diff --git a/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetCorrelatedEventList.json b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetCorrelatedEventList.json
new file mode 100644
index 000000000000..7e271b230d90
--- /dev/null
+++ b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetCorrelatedEventList.json
@@ -0,0 +1,31 @@
+{
+  "operationId": "GetCorrelatedEventList",
+  "description": "This example shows how to get all correlated events for a given eventInstanceId.",
+  "parameters": {
+    "eventInstanceId": "e00fa5b7-f747-40dd-9e09-f5a031e96de4",
+    "api-version": "6.4"
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": [
+        {
+          "Kind": "PartitionPrimaryMoveAnalysis",
+          "WhenMoveCompleted": "2018-04-03T20:06:55.966073Z",
+          "PreviousNode": "node3(b9d52c016a15a8f57673d3b8041e2d35)",
+          "CurrentNode": "node1(cf68563e16a44f808e86197a9cf83de5)",
+          "MoveReason": "ApplicationHostDown",
+          "RelevantTraces": "",
+          "PartitionId": "f2a6a893-39be-4c7d-b07f-72bc2d36de89",
+          "EventInstanceId": "59dde2bc-a833-412e-a56d-8f6ada0c7963",
+          "TimeStamp": "2018-04-03T20:07:55.966073Z",
+          "HasCorrelatedEvents": true,
+          "Metadata": {
+            "Delay": "00:00:20",
+            "Duration": "00:01:59"
+          }
+        }
+      ]
+    }
+  }
+}
diff --git a/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetDataLossProgress-Running.json b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetDataLossProgress-Running.json
new file mode 100644
index 000000000000..90590fff4f2f
--- /dev/null
+++ b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetDataLossProgress-Running.json
@@ -0,0 +1,18 @@
+{
+  "operationId": "GetDataLossProgress",
+  "description": "This shows an example of output when a data loss operation is in a Running State.  If the State has a value of Running, only the State field will have a value.",
+  "parameters": {
+    "serviceId": "fabric:/myapp/myservice",
+    "partitionId": "1daae3f5-7fd6-42e9-b1ba-8c05f873994d",
+    "OperationId": "7216486c-1ee9-4b00-99b2-92b26fcb07f5",
+    "api-version": "6.0"
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": {
+        "State": "Running"
+      }
+    }
+  }
+}
diff --git a/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetDataLossProgress.json b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetDataLossProgress.json
new file mode 100644
index 000000000000..89d341f05c26
--- /dev/null
+++ b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetDataLossProgress.json
@@ -0,0 +1,25 @@
+{
+  "operationId": "GetDataLossProgress",
+  "description": "This shows an example of possible output when GetDataLossProgress has reached a State of Completed.  If the State has a value of Running, only the State field will have a value.",
+  "parameters": {
+    "serviceId": "fabric:/myapp/myservice",
+    "partitionId": "1daae3f5-7fd6-42e9-b1ba-8c05f873994d",
+    "OperationId": "7216486c-1ee9-4b00-99b2-92b26fcb07f5",
+    "api-version": "6.0"
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": {
+        "State": "Completed",
+        "InvokeDataLossResult": {
+          "ErrorCode": 0,
+          "SelectedPartition": {
+            "ServiceName": "fabric:/myapp/myservice",
+            "PartitionId": "1daae3f5-7fd6-42e9-b1ba-8c05f873994d"
+          }
+        }
+      }
+    }
+  }
+}
diff --git a/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetDeployedApplicationInfoByName-1.json b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetDeployedApplicationInfoByName-1.json
new file mode 100644
index 000000000000..8552057cbe2f
--- /dev/null
+++ b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetDeployedApplicationInfoByName-1.json
@@ -0,0 +1,26 @@
+{
+  "operationId": "GetDeployedApplicationInfoList",
+  "description": "This example shows how to get information about an application deployed on a specified node by using an application identifier. If the application is found it's information is returned with 200 status code. An empty response with status code 204 is returned, if the specified application is not deployed on the node.",
+  "parameters": {
+    "api-version": "6.1",
+    "nodeName": "_Node_0",
+    "applicationId": "samples~CalculatorApp",
+    "IncludeHealthState": true
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": {
+        "Id": "samples~CalculatorApp",
+        "Name": "fabric:/samples/CalculatorApp",
+        "TypeName": "CalculatorApp",
+        "Status": "Active",
+        "WorkDirectory": "C:\\SfDevCluster\\Data\\_App\\_Node_1\\CalculatorApp_App0\\work",
+        "LogDirectory": "C:\\SfDevCluster\\Data\\_App\\_Node_1\\CalculatorApp_App0\\log",
+        "TempDirectory": "C:\\SfDevCluster\\Data\\_App\\_Node_1\\CalculatorApp_App0\\temp",
+        "HealthState": "Ok"
+      }
+    },
+    "204": {}
+  }
+}
diff --git a/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetDeployedApplicationInfoList-1.json b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetDeployedApplicationInfoList-1.json
new file mode 100644
index 000000000000..c19d4e2a841c
--- /dev/null
+++ b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetDeployedApplicationInfoList-1.json
@@ -0,0 +1,39 @@
+{
+  "operationId": "GetDeployedApplicationInfoList",
+  "description": "This example shows how to specify the number of applications returned by the query when getting information about applications deployed on a specific node. The number of results in a page are limited to maximum of 2 using the MaxResult parameter. Health state is not requested in this example, so the returned health state will be Unknown.",
+  "parameters": {
+    "api-version": "6.1",
+    "nodeName": "_Node_0",
+    "MaxResults": 2
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": {
+        "ContinuationToken": "fabric:/samples/PQueueApp1",
+        "Items": [
+          {
+            "Id": "samples~CalculatorApp",
+            "Name": "fabric:/samples/CalculatorApp",
+            "TypeName": "CalculatorApp",
+            "Status": "Active",
+            "WorkDirectory": "C:\\SfDevCluster\\Data\\_App\\_Node_0\\CalculatorApp_App0\\work",
+            "LogDirectory": "C:\\SfDevCluster\\Data\\_App\\_Node_0\\CalculatorApp_App0\\log",
+            "TempDirectory": "C:\\SfDevCluster\\Data\\_App\\_Node_0\\CalculatorApp_App0\\temp",
+            "HealthState": "Unknown"
+          },
+          {
+            "Id": "samples~PQueueApp1",
+            "Name": "fabric:/samples/PQueueApp1",
+            "TypeName": "PersistentQueueApp",
+            "Status": "Active",
+            "WorkDirectory": "C:\\SfDevCluster\\Data\\_App\\_Node_0\\PersistentQueueApp_App1\\work",
+            "LogDirectory": "C:\\SfDevCluster\\Data\\_App\\_Node_0\\PersistentQueueApp_App1\\log",
+            "TempDirectory": "C:\\SfDevCluster\\Data\\_App\\_Node_0\\PersistentQueueApp_App1\\temp",
+            "HealthState": "Unknown"
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetDeployedApplicationInfoList-2.json b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetDeployedApplicationInfoList-2.json
new file mode 100644
index 000000000000..7f6320e69e6d
--- /dev/null
+++ b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetDeployedApplicationInfoList-2.json
@@ -0,0 +1,29 @@
+{
+  "operationId": "GetDeployedApplicationInfoListByName",
+  "description": "This example demonstrates the paging functionality available when getting information about applications deployed on a specific node. This example uses the ContinuationToken parameter. The value of this parameter is provided from the previous query; in this case the example shown above. The response contains the remaining results and an empty ContinuationToken. The empty ContinuationToken indicates that additional results are not available.",
+  "parameters": {
+    "api-version": "6.1",
+    "nodeName": "_Node_0",
+    "ContinuationToken": "fabric:/samples/PQueueApp1"
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": {
+        "ContinuationToken": "",
+        "Items": [
+          {
+            "Id": "samples~VQueueApp1",
+            "Name": "fabric:/samples/VQueueApp1",
+            "TypeName": "VolatileQueueApp",
+            "Status": "Active",
+            "WorkDirectory": "C:\\SfDevCluster\\Data\\_App\\_Node_0\\VolatileQueueApp_App2\\work",
+            "LogDirectory": "C:\\SfDevCluster\\Data\\_App\\_Node_0\\VolatileQueueApp_App2\\log",
+            "TempDirectory": "C:\\SfDevCluster\\Data\\_App\\_Node_0\\VolatileQueueApp_App2\\temp",
+            "HealthState": "Unknown"
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetDeployedApplicationInfoList-3.json b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetDeployedApplicationInfoList-3.json
new file mode 100644
index 000000000000..01cad866d3c1
--- /dev/null
+++ b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetDeployedApplicationInfoList-3.json
@@ -0,0 +1,49 @@
+{
+  "operationId": "GetDeployedApplicationInfoList",
+  "description": "This example shows how to include the health state of each deployed application when getting information about applications deployed on a specific node.",
+  "parameters": {
+    "api-version": "6.1",
+    "nodeName": "_Node_0",
+    "IncludeHealthState": true
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": {
+        "ContinuationToken": "",
+        "Items": [
+          {
+            "Id": "samples~CalculatorApp",
+            "Name": "fabric:/samples/CalculatorApp",
+            "TypeName": "CalculatorApp",
+            "Status": "Active",
+            "WorkDirectory": "C:\\SfDevCluster\\Data\\_App\\_Node_0\\CalculatorApp_App0\\work",
+            "LogDirectory": "C:\\SfDevCluster\\Data\\_App\\_Node_0\\CalculatorApp_App0\\log",
+            "TempDirectory": "C:\\SfDevCluster\\Data\\_App\\_Node_0\\CalculatorApp_App0\\temp",
+            "HealthState": "Ok"
+          },
+          {
+            "Id": "samples~PQueueApp1",
+            "Name": "fabric:/samples/PQueueApp1",
+            "TypeName": "PersistentQueueApp",
+            "Status": "Active",
+            "WorkDirectory": "C:\\SfDevCluster\\Data\\_App\\_Node_0\\PersistentQueueApp_App1\\work",
+            "LogDirectory": "C:\\SfDevCluster\\Data\\_App\\_Node_0\\PersistentQueueApp_App1\\log",
+            "TempDirectory": "C:\\SfDevCluster\\Data\\_App\\_Node_0\\PersistentQueueApp_App1\\temp",
+            "HealthState": "Ok"
+          },
+          {
+            "Id": "samples~VQueueApp1",
+            "Name": "fabric:/samples/VQueueApp1",
+            "TypeName": "VolatileQueueApp",
+            "Status": "Active",
+            "WorkDirectory": "C:\\SfDevCluster\\Data\\_App\\_Node_0\\VolatileQueueApp_App2\\work",
+            "LogDirectory": "C:\\SfDevCluster\\Data\\_App\\_Node_0\\VolatileQueueApp_App2\\log",
+            "TempDirectory": "C:\\SfDevCluster\\Data\\_App\\_Node_0\\VolatileQueueApp_App2\\temp",
+            "HealthState": "Ok"
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetFaultOperationList.json b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetFaultOperationList.json
new file mode 100644
index 000000000000..c7194dad614a
--- /dev/null
+++ b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetFaultOperationList.json
@@ -0,0 +1,51 @@
+{
+  "operationId": "GetFaultOperationList",
+  "description": "This shows an example of possible output for GetFaultOperationList",
+  "parameters": {
+    "TypeFilter": "0xFF",
+    "StateFilter": "0xFF",
+    "api-version": "6.0"
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": [
+        {
+          "OperationId": "00000000-0000-0000-0000-000000000010",
+          "State": "Completed",
+          "Type": "PartitionDataLoss"
+        },
+        {
+          "OperationId": "00000000-0000-0000-0000-000000000020",
+          "State": "Completed",
+          "Type": "PartitionQuorumLoss"
+        },
+        {
+          "OperationId": "00000000-0000-0000-0000-000000000030",
+          "State": "Completed",
+          "Type": "PartitionRestart"
+        },
+        {
+          "OperationId": "00000000-0000-0000-0000-000000000500",
+          "State": "Faulted",
+          "Type": "NodeTransition"
+        },
+        {
+          "OperationId": "00000000-0000-0000-0000-000000000700",
+          "State": "Completed",
+          "Type": "NodeTransition"
+        },
+        {
+          "OperationId": "00000000-0000-0000-0000-000000000710",
+          "State": "Completed",
+          "Type": "NodeTransition"
+        },
+        {
+          "OperationId": "88ef90f9-0b94-46b0-b817-a6ea20c07f8a",
+          "State": "Completed",
+          "Type": "PartitionRestart"
+        }
+      ]
+    }
+  }
+}
diff --git a/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetImageStoreContent.json b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetImageStoreContent.json
new file mode 100644
index 000000000000..7e912c407a79
--- /dev/null
+++ b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetImageStoreContent.json
@@ -0,0 +1,91 @@
+{
+  "operationId": "GetImageStoreContent",
+  "description": "This example shows how to get image store content under the given relative path.",
+  "parameters": {
+    "api-version": "6.2",
+    "contentPath": "Store\\CalcServiceApp"
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": {
+        "StoreFiles": [
+          {
+            "StoreRelativePath": "Store\\CalcServiceApp\\ApplicationManifest.2.0.xml",
+            "FileVersion": {
+              "EpochDataLossNumber": "131510254310497004",
+              "VersionNumber": "23",
+              "EpochConfigurationNumber": "25769803776"
+            },
+            "FileSize": "897",
+            "ModifiedDate": "2017-09-28T17:44:22.609Z"
+          },
+          {
+            "StoreRelativePath": "Store\\CalcServiceApp\\CalcService.Code.2.0.checksum",
+            "FileVersion": {
+              "EpochDataLossNumber": "131510254310497004",
+              "VersionNumber": "25",
+              "EpochConfigurationNumber": "25769803776"
+            },
+            "FileSize": "66",
+            "ModifiedDate": "2017-09-28T17:44:22.468Z"
+          },
+          {
+            "StoreRelativePath": "Store\\CalcServiceApp\\CalcService.Config.1.0.checksum",
+            "FileVersion": {
+              "EpochDataLossNumber": "131510254310497004",
+              "VersionNumber": "26",
+              "EpochConfigurationNumber": "25769803776"
+            },
+            "FileSize": "66",
+            "ModifiedDate": "2017-09-28T17:44:22.468Z"
+          },
+          {
+            "StoreRelativePath": "Store\\CalcServiceApp\\CalcService.Data.2.0.checksum",
+            "FileVersion": {
+              "EpochDataLossNumber": "131510254310497004",
+              "VersionNumber": "27",
+              "EpochConfigurationNumber": "25769803776"
+            },
+            "FileSize": "66",
+            "ModifiedDate": "2017-09-28T17:44:22.468Z"
+          },
+          {
+            "StoreRelativePath": "Store\\CalcServiceApp\\CalcService.Manifest.2.0.xml",
+            "FileVersion": {
+              "EpochDataLossNumber": "131510254310497004",
+              "VersionNumber": "19",
+              "EpochConfigurationNumber": "25769803776"
+            },
+            "FileSize": "744",
+            "ModifiedDate": "2017-09-28T17:44:22.578Z"
+          },
+          {
+            "StoreRelativePath": "Store\\CalcServiceApp\\CalcService.Manifest.2.0.xml.checksum",
+            "FileVersion": {
+              "EpochDataLossNumber": "131510254310497004",
+              "VersionNumber": "24",
+              "EpochConfigurationNumber": "25769803776"
+            },
+            "FileSize": "66",
+            "ModifiedDate": "2017-09-28T17:44:22.484Z"
+          }
+        ],
+        "StoreFolders": [
+          {
+            "StoreRelativePath": "Store\\CalcServiceApp\\CalcService.Code.2.0",
+            "FileCount": "2"
+          },
+          {
+            "StoreRelativePath": "Store\\CalcServiceApp\\CalcService.Config.1.0",
+            "FileCount": "2"
+          },
+          {
+            "StoreRelativePath": "Store\\CalcServiceApp\\CalcService.Data.2.0",
+            "FileCount": "2"
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetImageStoreInfo.json b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetImageStoreInfo.json
new file mode 100644
index 000000000000..e4360622b5fd
--- /dev/null
+++ b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetImageStoreInfo.json
@@ -0,0 +1,36 @@
+{
+  "operationId": "GetImageStoreInfo",
+  "description": "This example shows how to get ImageStore information.",
+  "parameters": {
+    "api-version": "6.5"
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": [
+        {
+          "DiskInfo": {
+            "Capacity": "500090007552",
+            "AvailableSpace": "228851900416"
+          },
+          "UsedByMetadata": {
+            "UsedSpace": "23093248",
+            "FileCount": 6
+          },
+          "UsedByStaging": {
+            "UsedSpace": "6291456",
+            "FileCount": 9
+          },
+          "UsedByCopy": {
+            "UsedSpace": "4194304",
+            "FileCount": 2
+          },
+          "UsedByRegister": {
+            "UsedSpace": "4194304",
+            "FileCount": 3
+          }
+        }
+      ]
+    }
+  }
+}
diff --git a/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetNodeEventList.json b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetNodeEventList.json
new file mode 100644
index 000000000000..4368ae718d58
--- /dev/null
+++ b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetNodeEventList.json
@@ -0,0 +1,32 @@
+{
+  "operationId": "GetNodeEventList",
+  "description": "This example shows how to get all node-related events during a certain time window.",
+  "parameters": {
+    "nodeName": "node1",
+    "api-version": "6.4",
+    "StartTimeUtc": "2018-04-03T18:00:00Z",
+    "EndTimeUtc": "2018-04-04T18:00:00Z"
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": [
+        {
+          "Kind": "NodeOpenSucceeded",
+          "NodeInstance": 131672596159209215,
+          "NodeId": "ba001a8bb353543e646be031afb10f1e",
+          "UpgradeDomain": "0",
+          "FaultDomain": "fd:/0",
+          "IpAddressOrFQDN": "100.78.240.56",
+          "Hostname": "RD0003FF5089AA",
+          "IsSeedNode": false,
+          "NodeVersion": "6.2:1.0",
+          "NodeName": "node1",
+          "EventInstanceId": "ecbce04a-a42b-4b70-a800-dfc6bc4f9b89",
+          "TimeStamp": "2018-04-03T20:06:55.966073Z",
+          "HasCorrelatedEvents": false
+        }
+      ]
+    }
+  }
+}
diff --git a/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetNodeInfo-1.json b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetNodeInfo-1.json
new file mode 100644
index 000000000000..24b8cfac97f7
--- /dev/null
+++ b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetNodeInfo-1.json
@@ -0,0 +1,41 @@
+{
+  "operationId": "GetNodeInfo",
+  "description": "This example shows how to get information about an node using it's identifier. If the node is found, information about it is returned with 200 status code. If the node is not found, empty content is returned with 204 status code.",
+  "parameters": {
+    "api-version": "6.0",
+    "nodeName": "_Node_1"
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": {
+        "Name": "_testnode_0",
+        "IpAddressOrFQDN": "10.0.0.4",
+        "Type": "testnode",
+        "CodeVersion": "6.3.139.9494",
+        "ConfigVersion": "5",
+        "NodeStatus": "Up",
+        "NodeUpTimeInSeconds": "18688",
+        "HealthState": "Ok",
+        "IsSeedNode": true,
+        "UpgradeDomain": "0",
+        "FaultDomain": "fd:/0",
+        "Id": {
+          "Id": "2acb9f55540659b1c95f27cc128ab326"
+        },
+        "InstanceId": "131738240209152398",
+        "NodeDeactivationInfo": {
+          "NodeDeactivationIntent": "Invalid",
+          "NodeDeactivationStatus": "None",
+          "NodeDeactivationTask": [],
+          "PendingSafetyChecks": []
+        },
+        "IsStopped": false,
+        "NodeDownTimeInSeconds": "0",
+        "NodeUpAt": "2018-06-18T19:33:52.944Z",
+        "NodeDownAt": "2018-06-18T19:33:39.514Z"
+      }
+    },
+    "204": {}
+  }
+}
diff --git a/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetNodeInfoList-1.json b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetNodeInfoList-1.json
new file mode 100644
index 000000000000..c494bff622c5
--- /dev/null
+++ b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetNodeInfoList-1.json
@@ -0,0 +1,72 @@
+{
+  "operationId": "GetNodeInfoList",
+  "description": "This example shows how to get information about the nodes in the cluster when the number of results returned is limited by the MaxResults parameter.",
+  "parameters": {
+    "api-version": "6.3",
+    "MaxResults": 2
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": {
+        "ContinuationToken": "2acb9f55540659b1c95f27cc128ab326",
+        "Items": [
+          {
+            "Name": "_testnode_1",
+            "IpAddressOrFQDN": "10.0.0.5",
+            "Type": "testnode",
+            "CodeVersion": "6.3.139.9494",
+            "ConfigVersion": "5",
+            "NodeStatus": "Up",
+            "NodeUpTimeInSeconds": "102016",
+            "HealthState": "Ok",
+            "IsSeedNode": true,
+            "UpgradeDomain": "1",
+            "FaultDomain": "fd:/1",
+            "Id": {
+              "Id": "ebd986a1134b3643a8117fb41b259bf"
+            },
+            "InstanceId": "131738274982501335",
+            "NodeDeactivationInfo": {
+              "NodeDeactivationIntent": "Invalid",
+              "NodeDeactivationStatus": "None",
+              "NodeDeactivationTask": [],
+              "PendingSafetyChecks": []
+            },
+            "IsStopped": false,
+            "NodeDownTimeInSeconds": "0",
+            "NodeUpAt": "2018-06-18T20:31:39.842Z",
+            "NodeDownAt": "2018-06-18T20:31:37.374Z"
+          },
+          {
+            "Name": "_testnode_0",
+            "IpAddressOrFQDN": "10.0.0.4",
+            "Type": "testnode",
+            "CodeVersion": "6.3.139.9494",
+            "ConfigVersion": "5",
+            "NodeStatus": "Up",
+            "NodeUpTimeInSeconds": "105483",
+            "HealthState": "Ok",
+            "IsSeedNode": true,
+            "UpgradeDomain": "0",
+            "FaultDomain": "fd:/0",
+            "Id": {
+              "Id": "2acb9f55540659b1c95f27cc128ab326"
+            },
+            "InstanceId": "131738240209152398",
+            "NodeDeactivationInfo": {
+              "NodeDeactivationIntent": "Invalid",
+              "NodeDeactivationStatus": "None",
+              "NodeDeactivationTask": [],
+              "PendingSafetyChecks": []
+            },
+            "IsStopped": false,
+            "NodeDownTimeInSeconds": "0",
+            "NodeUpAt": "2018-06-18T19:33:52.944Z",
+            "NodeDownAt": "2018-06-18T19:33:39.514Z"
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetNodeInfoList-2.json b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetNodeInfoList-2.json
new file mode 100644
index 000000000000..79bbd1bf1af7
--- /dev/null
+++ b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetNodeInfoList-2.json
@@ -0,0 +1,99 @@
+{
+  "operationId": "GetNodeInfoList",
+  "description": "This example shows how to get information about nodes in the cluster which appear on a sequential page, by using the ContinuationToken parameter.",
+  "parameters": {
+    "api-version": "6.3",
+    "ContinuationToken": "2acb9f55540659b1c95f27cc128ab326"
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": {
+        "ContinuationToken": "",
+        "Items": [
+          {
+            "Name": "_Node_4",
+            "IpAddressOrFQDN": "10.0.0.8",
+            "Type": "testnode",
+            "CodeVersion": "6.3.139.9494",
+            "ConfigVersion": "5",
+            "NodeStatus": "Up",
+            "NodeUpTimeInSeconds": "101547",
+            "HealthState": "Ok",
+            "IsSeedNode": true,
+            "UpgradeDomain": "4",
+            "FaultDomain": "fd:/4",
+            "Id": {
+              "Id": "ba9383d728221add7fa996bf67b757fb"
+            },
+            "InstanceId": "131737415865259763",
+            "NodeDeactivationInfo": {
+              "NodeDeactivationIntent": "Invalid",
+              "NodeDeactivationStatus": "None",
+              "NodeDeactivationTask": [],
+              "PendingSafetyChecks": []
+            },
+            "IsStopped": false,
+            "NodeDownTimeInSeconds": "0",
+            "NodeUpAt": "2018-06-17T20:40:07.378Z",
+            "NodeDownAt": "2018-06-17T20:33:11.877Z"
+          },
+          {
+            "Name": "_Node_3",
+            "IpAddressOrFQDN": "10.0.0.7",
+            "Type": "testnode",
+            "CodeVersion": "6.3.139.9494",
+            "ConfigVersion": "5",
+            "NodeStatus": "Up",
+            "NodeUpTimeInSeconds": "15615",
+            "HealthState": "Ok",
+            "IsSeedNode": true,
+            "UpgradeDomain": "3",
+            "FaultDomain": "fd:/3",
+            "Id": {
+              "Id": "d6a18a0935a3e39aeae2a049eb97255d"
+            },
+            "InstanceId": "131738275300526952",
+            "NodeDeactivationInfo": {
+              "NodeDeactivationIntent": "Invalid",
+              "NodeDeactivationStatus": "None",
+              "NodeDeactivationTask": [],
+              "PendingSafetyChecks": []
+            },
+            "IsStopped": false,
+            "NodeDownTimeInSeconds": "0",
+            "NodeUpAt": "2018-06-18T20:32:18.884Z",
+            "NodeDownAt": "2018-06-18T20:31:59.128Z"
+          },
+          {
+            "Name": "_Node_2",
+            "IpAddressOrFQDN": "10.0.0.6",
+            "Type": "testnode",
+            "CodeVersion": "6.3.139.9494",
+            "ConfigVersion": "5",
+            "NodeStatus": "Up",
+            "NodeUpTimeInSeconds": "19819",
+            "HealthState": "Ok",
+            "IsSeedNode": true,
+            "UpgradeDomain": "2",
+            "FaultDomain": "fd:/2",
+            "Id": {
+              "Id": "f2af91e5e9c8254dedb75b1424a9e3fc"
+            },
+            "InstanceId": "131738233282843485",
+            "NodeDeactivationInfo": {
+              "NodeDeactivationIntent": "Invalid",
+              "NodeDeactivationStatus": "None",
+              "NodeDeactivationTask": [],
+              "PendingSafetyChecks": []
+            },
+            "IsStopped": false,
+            "NodeDownTimeInSeconds": "0",
+            "NodeUpAt": "2018-06-18T19:22:15.272Z",
+            "NodeDownAt": "2018-06-18T19:22:02.740Z"
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetNodeInfoList.json b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetNodeInfoList.json
new file mode 100644
index 000000000000..d38a618440a9
--- /dev/null
+++ b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetNodeInfoList.json
@@ -0,0 +1,152 @@
+{
+  "operationId": "GetNodeInfoList",
+  "description": "This example shows how to get information about all the nodes in the cluster when the information fits in a single response message without the need for paging through ContinuationToken parameter.",
+  "parameters": {
+    "api-version": "6.3"
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": {
+        "ContinuationToken": "",
+        "Items": [
+          {
+            "Name": "_Node_1",
+            "IpAddressOrFQDN": "10.0.0.5",
+            "Type": "testnode",
+            "CodeVersion": "6.3.139.9494",
+            "ConfigVersion": "5",
+            "NodeStatus": "Up",
+            "NodeUpTimeInSeconds": "15275",
+            "HealthState": "Ok",
+            "IsSeedNode": true,
+            "UpgradeDomain": "1",
+            "FaultDomain": "fd:/1",
+            "Id": {
+              "Id": "ebd986a1134b3643a8117fb41b259bf"
+            },
+            "InstanceId": "131738274982501335",
+            "NodeDeactivationInfo": {
+              "NodeDeactivationIntent": "Invalid",
+              "NodeDeactivationStatus": "None",
+              "NodeDeactivationTask": [],
+              "PendingSafetyChecks": []
+            },
+            "IsStopped": false,
+            "NodeDownTimeInSeconds": "0",
+            "NodeUpAt": "2018-06-18T20:31:39.842Z",
+            "NodeDownAt": "2018-06-18T20:31:37.374Z"
+          },
+          {
+            "Name": "_Node_0",
+            "IpAddressOrFQDN": "10.0.0.4",
+            "Type": "testnode",
+            "CodeVersion": "6.3.139.9494",
+            "ConfigVersion": "5",
+            "NodeStatus": "Up",
+            "NodeUpTimeInSeconds": "18742",
+            "HealthState": "Ok",
+            "IsSeedNode": true,
+            "UpgradeDomain": "0",
+            "FaultDomain": "fd:/0",
+            "Id": {
+              "Id": "2acb9f55540659b1c95f27cc128ab326"
+            },
+            "InstanceId": "131738240209152398",
+            "NodeDeactivationInfo": {
+              "NodeDeactivationIntent": "Invalid",
+              "NodeDeactivationStatus": "None",
+              "NodeDeactivationTask": [],
+              "PendingSafetyChecks": []
+            },
+            "IsStopped": false,
+            "NodeDownTimeInSeconds": "0",
+            "NodeUpAt": "2018-06-18T19:33:52.944Z",
+            "NodeDownAt": "2018-06-18T19:33:39.514Z"
+          },
+          {
+            "Name": "_Node_4",
+            "IpAddressOrFQDN": "10.0.0.8",
+            "Type": "testnode",
+            "CodeVersion": "6.3.139.9494",
+            "ConfigVersion": "5",
+            "NodeStatus": "Up",
+            "NodeUpTimeInSeconds": "101168",
+            "HealthState": "Ok",
+            "IsSeedNode": true,
+            "UpgradeDomain": "4",
+            "FaultDomain": "fd:/4",
+            "Id": {
+              "Id": "ba9383d728221add7fa996bf67b757fb"
+            },
+            "InstanceId": "131737415865259763",
+            "NodeDeactivationInfo": {
+              "NodeDeactivationIntent": "Invalid",
+              "NodeDeactivationStatus": "None",
+              "NodeDeactivationTask": [],
+              "PendingSafetyChecks": []
+            },
+            "IsStopped": false,
+            "NodeDownTimeInSeconds": "0",
+            "NodeUpAt": "2018-06-17T20:40:07.378Z",
+            "NodeDownAt": "2018-06-17T20:33:11.877Z"
+          },
+          {
+            "Name": "_Node_3",
+            "IpAddressOrFQDN": "10.0.0.7",
+            "Type": "testnode",
+            "CodeVersion": "6.3.139.9494",
+            "ConfigVersion": "5",
+            "NodeStatus": "Up",
+            "NodeUpTimeInSeconds": "15236",
+            "HealthState": "Ok",
+            "IsSeedNode": true,
+            "UpgradeDomain": "3",
+            "FaultDomain": "fd:/3",
+            "Id": {
+              "Id": "d6a18a0935a3e39aeae2a049eb97255d"
+            },
+            "InstanceId": "131738275300526952",
+            "NodeDeactivationInfo": {
+              "NodeDeactivationIntent": "Invalid",
+              "NodeDeactivationStatus": "None",
+              "NodeDeactivationTask": [],
+              "PendingSafetyChecks": []
+            },
+            "IsStopped": false,
+            "NodeDownTimeInSeconds": "0",
+            "NodeUpAt": "2018-06-18T20:32:18.884Z",
+            "NodeDownAt": "2018-06-18T20:31:59.128Z"
+          },
+          {
+            "Name": "_Node_2",
+            "IpAddressOrFQDN": "10.0.0.6",
+            "Type": "testnode",
+            "CodeVersion": "6.3.139.9494",
+            "ConfigVersion": "5",
+            "NodeStatus": "Up",
+            "NodeUpTimeInSeconds": "19440",
+            "HealthState": "Ok",
+            "IsSeedNode": true,
+            "UpgradeDomain": "2",
+            "FaultDomain": "fd:/2",
+            "Id": {
+              "Id": "f2af91e5e9c8254dedb75b1424a9e3fc"
+            },
+            "InstanceId": "131738233282843485",
+            "NodeDeactivationInfo": {
+              "NodeDeactivationIntent": "Invalid",
+              "NodeDeactivationStatus": "None",
+              "NodeDeactivationTask": [],
+              "PendingSafetyChecks": []
+            },
+            "IsStopped": false,
+            "NodeDownTimeInSeconds": "0",
+            "NodeUpAt": "2018-06-18T19:22:15.272Z",
+            "NodeDownAt": "2018-06-18T19:22:02.740Z"
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetNodeTransitionProgress-Running.json b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetNodeTransitionProgress-Running.json
new file mode 100644
index 000000000000..62ad5c37ec58
--- /dev/null
+++ b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetNodeTransitionProgress-Running.json
@@ -0,0 +1,17 @@
+{
+  "operationId": "GetNodeTransitionProgress",
+  "description": "This shows an example of output when GetTransitionProgress has a State of Running.",
+  "parameters": {
+    "nodeName": "N0060",
+    "OperationId": "ed903556-acf1-489c-9f33-b484c31f9087",
+    "api-version": "6.0"
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": {
+        "State": "Running"
+      }
+    }
+  }
+}
diff --git a/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetNodeTransitionProgress.json b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetNodeTransitionProgress.json
new file mode 100644
index 000000000000..474ab826b8df
--- /dev/null
+++ b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetNodeTransitionProgress.json
@@ -0,0 +1,24 @@
+{
+  "operationId": "GetNodeTransitionProgress",
+  "description": "This shows an example of possible output when GetTransitionProgress has reached a State of Completed.  If the State has a value of Running, only the State field will have a value.",
+  "parameters": {
+    "nodeName": "N0060",
+    "OperationId": "a9c24269-88e9-4812-b4ad-a0bf2b724ad4",
+    "api-version": "6.0"
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": {
+        "State": "Completed",
+        "NodeTransitionResult": {
+          "ErrorCode": 0,
+          "NodeResult": {
+            "NodeName": "N0060",
+            "NodeInstanceId": "131366982707950527"
+          }
+        }
+      }
+    }
+  }
+}
diff --git a/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetNodesEventList.json b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetNodesEventList.json
new file mode 100644
index 000000000000..7aed70b97f31
--- /dev/null
+++ b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetNodesEventList.json
@@ -0,0 +1,46 @@
+{
+  "operationId": "GetNodesEventList",
+  "description": "This example shows how to get all nodes-related events during a certain time window.",
+  "parameters": {
+    "api-version": "6.4",
+    "StartTimeUtc": "2018-04-03T18:00:00Z",
+    "EndTimeUtc": "2018-04-04T18:00:00Z"
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": [
+        {
+          "Kind": "NodeOpenSucceeded",
+          "NodeInstance": 131672596159209215,
+          "NodeId": "ba001a8bb353543e646be031afb10f1e",
+          "UpgradeDomain": "0",
+          "FaultDomain": "fd:/0",
+          "IpAddressOrFQDN": "100.78.240.56",
+          "Hostname": "RD0003FF5089AA",
+          "IsSeedNode": false,
+          "NodeVersion": "6.2:1.0",
+          "NodeName": "node1",
+          "EventInstanceId": "ecbce04a-a42b-4b70-a800-dfc6bc4f9b89",
+          "TimeStamp": "2018-04-03T20:06:55.966073Z",
+          "HasCorrelatedEvents": false
+        },
+        {
+          "Kind": "NodeOpenSucceeded",
+          "NodeInstance": 131672596186027906,
+          "NodeId": "ba03ef91259835c54d674889849a7cee",
+          "UpgradeDomain": "3",
+          "FaultDomain": "fd:/3",
+          "IpAddressOrFQDN": "100.72.76.122",
+          "Hostname": "RD0003FF6047A8",
+          "IsSeedNode": false,
+          "NodeVersion": "6.2:1.0",
+          "NodeName": "node2",
+          "EventInstanceId": "67730c48-752c-4209-bf28-3c121555a4c0",
+          "TimeStamp": "2018-04-03T20:06:58.6357365Z",
+          "HasCorrelatedEvents": false
+        }
+      ]
+    }
+  }
+}
diff --git a/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetPartitionBackupConfigurationInfo.json b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetPartitionBackupConfigurationInfo.json
new file mode 100644
index 000000000000..dd97740de85f
--- /dev/null
+++ b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetPartitionBackupConfigurationInfo.json
@@ -0,0 +1,24 @@
+{
+  "operationId": "GetPartitionBackupConfigurationInfo",
+  "description": "This example shows how to get backup configuration for a partition.",
+  "parameters": {
+    "api-version": "6.4",
+    "partitionId": "1daae3f5-7fd6-42e9-b1ba-8c05f873994d"
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": {
+        "Kind": "Partition",
+        "PolicyName": "BackupPolicy2",
+        "PolicyInheritedFrom": "Service",
+        "ServiceName": "fabric:/CalcApp/CalcService",
+        "PartitionId": "1daae3f5-7fd6-42e9-b1ba-8c05f873994d",
+        "SuspensionInfo": {
+          "IsSuspended": true,
+          "SuspensionInheritedFrom": "Partition"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetPartitionBackupList-1.json b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetPartitionBackupList-1.json
new file mode 100644
index 000000000000..2c5fb63a2bc3
--- /dev/null
+++ b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetPartitionBackupList-1.json
@@ -0,0 +1,64 @@
+{
+  "operationId": "GetPartitionBackupList",
+  "description": "This example shows how to get list of partition backups within a time range.",
+  "parameters": {
+    "api-version": "6.4",
+    "partitionId": "1daae3f5-7fd6-42e9-b1ba-8c05f873994d",
+    "StartDateTimeFilter": "2018-01-01T00:00:00Z",
+    "EndDateTimeFilter": "2018-01-01T23:59:59Z"
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": {
+        "ContinuationToken": "",
+        "Items": [
+          {
+            "BackupId": "3a056ac9-7206-43c3-8424-6f6103003eba",
+            "BackupChainId": "3a056ac9-7206-43c3-8424-6f6103003eba",
+            "ApplicationName": "fabric:/CalcApp",
+            "ServiceManifestVersion": "1.0.0",
+            "ServiceName": "fabric:/CalcApp/CalcService",
+            "PartitionInformation": {
+              "LowKey": "-9223372036854775808",
+              "HighKey": "9223372036854775807",
+              "ServicePartitionKind": "Int64Range",
+              "Id": "1daae3f5-7fd6-42e9-b1ba-8c05f873994d"
+            },
+            "BackupLocation": "CalcApp\\CalcService\\1daae3f5-7fd6-42e9-b1ba-8c05f873994d\\2018-01-01 09.00.55.zip",
+            "BackupType": "Full",
+            "EpochOfLastBackupRecord": {
+              "DataLossVersion": "131462452931584510",
+              "ConfigurationVersion": "8589934592"
+            },
+            "LsnOfLastBackupRecord": "261",
+            "CreationTimeUtc": "2018-01-01T09:00:55Z",
+            "FailureError": null
+          },
+          {
+            "BackupId": "7903dc2a-228d-44b0-b7c8-a13a6c9b46bd",
+            "BackupChainId": "3a056ac9-7206-43c3-8424-6f6103003eba",
+            "ApplicationName": "fabric:/CalcApp",
+            "ServiceManifestVersion": "1.0.0",
+            "ServiceName": "fabric:/CalcApp/CalcService",
+            "PartitionInformation": {
+              "LowKey": "-9223372036854775808",
+              "HighKey": "9223372036854775807",
+              "ServicePartitionKind": "Int64Range",
+              "Id": "1daae3f5-7fd6-42e9-b1ba-8c05f873994d"
+            },
+            "BackupLocation": "CalcApp\\CalcService\\1daae3f5-7fd6-42e9-b1ba-8c05f873994d\\2018-01-01 17.01.02.zip",
+            "BackupType": "Incremental",
+            "EpochOfLastBackupRecord": {
+              "DataLossVersion": "131462452931584510",
+              "ConfigurationVersion": "8589934592"
+            },
+            "LsnOfLastBackupRecord": "446",
+            "CreationTimeUtc": "2018-01-01T17:01:02Z",
+            "FailureError": null
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetPartitionBackupList-2.json b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetPartitionBackupList-2.json
new file mode 100644
index 000000000000..cc627b382457
--- /dev/null
+++ b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetPartitionBackupList-2.json
@@ -0,0 +1,41 @@
+{
+  "operationId": "GetPartitionBackupList",
+  "description": "This example shows how to get the latest backup for the specified partition.",
+  "parameters": {
+    "api-version": "6.4",
+    "partitionId": "1daae3f5-7fd6-42e9-b1ba-8c05f873994d",
+    "Latest": true
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": {
+        "ContinuationToken": "",
+        "Items": [
+          {
+            "BackupId": "be06a49c-be67-4eb1-a602-b983605be862",
+            "BackupChainId": "be06a49c-be67-4eb1-a602-b983605be862",
+            "ApplicationName": "fabric:/CalcApp",
+            "ServiceManifestVersion": "1.0.0",
+            "ServiceName": "fabric:/CalcApp/CalcService",
+            "PartitionInformation": {
+              "LowKey": "-9223372036854775808",
+              "HighKey": "9223372036854775807",
+              "ServicePartitionKind": "Int64Range",
+              "Id": "1daae3f5-7fd6-42e9-b1ba-8c05f873994d"
+            },
+            "BackupLocation": "CalcApp\\CalcService\\1daae3f5-7fd6-42e9-b1ba-8c05f873994d\\2018-01-02 08.59.53.zip",
+            "BackupType": "Full",
+            "EpochOfLastBackupRecord": {
+              "DataLossVersion": "131462452931584510",
+              "ConfigurationVersion": "8589934592"
+            },
+            "LsnOfLastBackupRecord": "639",
+            "CreationTimeUtc": "2018-01-02T08:59:53Z",
+            "FailureError": null
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetPartitionBackupList-3.json b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetPartitionBackupList-3.json
new file mode 100644
index 000000000000..2cddad80321f
--- /dev/null
+++ b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetPartitionBackupList-3.json
@@ -0,0 +1,63 @@
+{
+  "operationId": "GetPartitionBackupList",
+  "description": "This example shows how to get list of partition backups. The number of results in a page are limited to maximum of two using the MaxResult parameter.",
+  "parameters": {
+    "api-version": "6.4",
+    "partitionId": "1daae3f5-7fd6-42e9-b1ba-8c05f873994d",
+    "MaxResults": 2
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": {
+        "ContinuationToken": "fabric:/CalcApp/CalcService#1daae3f5-7fd6-42e9-b1ba-8c05f873994d#7903dc2a-228d-44b0-b7c8-a13a6c9b46bd",
+        "Items": [
+          {
+            "BackupId": "3a056ac9-7206-43c3-8424-6f6103003eba",
+            "BackupChainId": "3a056ac9-7206-43c3-8424-6f6103003eba",
+            "ApplicationName": "fabric:/CalcApp",
+            "ServiceManifestVersion": "1.0.0",
+            "ServiceName": "fabric:/CalcApp/CalcService",
+            "PartitionInformation": {
+              "LowKey": "-9223372036854775808",
+              "HighKey": "9223372036854775807",
+              "ServicePartitionKind": "Int64Range",
+              "Id": "1daae3f5-7fd6-42e9-b1ba-8c05f873994d"
+            },
+            "BackupLocation": "CalcApp\\CalcService\\1daae3f5-7fd6-42e9-b1ba-8c05f873994d\\2018-01-01 09.00.55.zip",
+            "BackupType": "Full",
+            "EpochOfLastBackupRecord": {
+              "DataLossVersion": "131462452931584510",
+              "ConfigurationVersion": "8589934592"
+            },
+            "LsnOfLastBackupRecord": "261",
+            "CreationTimeUtc": "2018-01-01T09:00:55Z",
+            "FailureError": null
+          },
+          {
+            "BackupId": "7903dc2a-228d-44b0-b7c8-a13a6c9b46bd",
+            "BackupChainId": "3a056ac9-7206-43c3-8424-6f6103003eba",
+            "ApplicationName": "fabric:/CalcApp",
+            "ServiceManifestVersion": "1.0.0",
+            "ServiceName": "fabric:/CalcApp/CalcService",
+            "PartitionInformation": {
+              "LowKey": "-9223372036854775808",
+              "HighKey": "9223372036854775807",
+              "ServicePartitionKind": "Int64Range",
+              "Id": "1daae3f5-7fd6-42e9-b1ba-8c05f873994d"
+            },
+            "BackupLocation": "CalcApp\\CalcService\\1daae3f5-7fd6-42e9-b1ba-8c05f873994d\\2018-01-01 17.01.02.zip",
+            "BackupType": "Incremental",
+            "EpochOfLastBackupRecord": {
+              "DataLossVersion": "131462452931584510",
+              "ConfigurationVersion": "8589934592"
+            },
+            "LsnOfLastBackupRecord": "446",
+            "CreationTimeUtc": "2018-01-01T17:01:02Z",
+            "FailureError": null
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetPartitionBackupList-4.json b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetPartitionBackupList-4.json
new file mode 100644
index 000000000000..c73aaece09c8
--- /dev/null
+++ b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetPartitionBackupList-4.json
@@ -0,0 +1,42 @@
+{
+  "operationId": "GetPartitionBackupList",
+  "description": "This example shows how to get list of partition backups. The number of results in a page are limited to maximum of two using the MaxResult parameter. This example uses the ContinuationToken parameter. The value of this parameter is provided from the previous query; in this case the example shown above. The response contains the remaining results and an empty ContinuationToken. The empty ContinuationToken indicates that additional results are not available.",
+  "parameters": {
+    "api-version": "6.4",
+    "partitionId": "1daae3f5-7fd6-42e9-b1ba-8c05f873994d",
+    "MaxResults": 2,
+    "ContinuationToken": "fabric:/CalcApp/CalcService#1daae3f5-7fd6-42e9-b1ba-8c05f873994d#7903dc2a-228d-44b0-b7c8-a13a6c9b46bd"
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": {
+        "ContinuationToken": "",
+        "Items": [
+          {
+            "BackupId": "be06a49c-be67-4eb1-a602-b983605be862",
+            "BackupChainId": "be06a49c-be67-4eb1-a602-b983605be862",
+            "ApplicationName": "fabric:/CalcApp",
+            "ServiceManifestVersion": "1.0.0",
+            "ServiceName": "fabric:/CalcApp/CalcService",
+            "PartitionInformation": {
+              "LowKey": "-9223372036854775808",
+              "HighKey": "9223372036854775807",
+              "ServicePartitionKind": "Int64Range",
+              "Id": "1daae3f5-7fd6-42e9-b1ba-8c05f873994d"
+            },
+            "BackupLocation": "CalcApp\\CalcService\\1daae3f5-7fd6-42e9-b1ba-8c05f873994d\\2018-01-02 08.59.53.zip",
+            "BackupType": "Full",
+            "EpochOfLastBackupRecord": {
+              "DataLossVersion": "131462452931584510",
+              "ConfigurationVersion": "8589934592"
+            },
+            "LsnOfLastBackupRecord": "639",
+            "CreationTimeUtc": "2018-01-02T08:59:53Z",
+            "FailureError": null
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetPartitionBackupProgress.json b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetPartitionBackupProgress.json
new file mode 100644
index 000000000000..9d0df23312a6
--- /dev/null
+++ b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetPartitionBackupProgress.json
@@ -0,0 +1,25 @@
+{
+  "operationId": "GetPartitionBackupProgress",
+  "description": "This shows an example of possible output when GetPartitionBackupProgress has reached a BackupState of Success.  If the BackupState has a value of BackupInProgress, only the BackupState field will have a value.",
+  "parameters": {
+    "partitionId": "1daae3f5-7fd6-42e9-b1ba-8c05f873994d",
+    "api-version": "6.4"
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": {
+        "BackupState": "Success",
+        "TimeStampUtc": "2018-01-01T09:00:55Z",
+        "BackupId": "3a056ac9-7206-43c3-8424-6f6103003eba",
+        "BackupLocation": "CalcApp\\CalcService\\1daae3f5-7fd6-42e9-b1ba-8c05f873994d\\2018-01-01 09.00.55.zip",
+        "EpochOfLastBackupRecord": {
+          "DataLossVersion": "131462452931584510",
+          "ConfigurationVersion": "8589934592"
+        },
+        "LsnOfLastBackupRecord": "261",
+        "FailureError": null
+      }
+    }
+  }
+}
diff --git a/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetPartitionEventList.json b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetPartitionEventList.json
new file mode 100644
index 000000000000..bbfca06712e9
--- /dev/null
+++ b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetPartitionEventList.json
@@ -0,0 +1,37 @@
+{
+  "operationId": "GetPartitionEventList",
+  "description": "This example shows how to get all partition-related events during a certain time window.",
+  "parameters": {
+    "partitionId": "f2a6a893-39be-4c7d-b07f-72bc2d36de89",
+    "api-version": "6.4",
+    "StartTimeUtc": "2018-04-03T18:00:00Z",
+    "EndTimeUtc": "2018-04-04T18:00:00Z"
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": [
+        {
+          "Kind": "PartitionReconfigured",
+          "NodeName": "node1",
+          "NodeInstanceId": "ba001a8bb353543e646be031afb10f1e",
+          "ServiceType": "Svc1Type",
+          "CcEpochDataLossVersion": 131672604833413107,
+          "CcEpochConfigVersion": 8589934595,
+          "ReconfigType": "Other",
+          "Result": "Completed",
+          "Phase0DurationMs": 0.0,
+          "Phase1DurationMs": 0.0,
+          "Phase2DurationMs": 203.1935,
+          "Phase3DurationMs": 0.0262,
+          "Phase4DurationMs": 628.8527,
+          "TotalDurationMs": 832.0724,
+          "PartitionId": "f2a6a893-39be-4c7d-b07f-72bc2d36de89",
+          "EventInstanceId": "e00fa5b7-f747-40dd-9e09-f5a031e96de4",
+          "TimeStamp": "2018-04-03T20:21:47.3778996Z",
+          "HasCorrelatedEvents": true
+        }
+      ]
+    }
+  }
+}
diff --git a/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetPartitionRestartProgress.json b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetPartitionRestartProgress.json
new file mode 100644
index 000000000000..074289b470a2
--- /dev/null
+++ b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetPartitionRestartProgress.json
@@ -0,0 +1,25 @@
+{
+  "operationId": "GetPartitionRestartProgress",
+  "description": "This shows an example of possible output when GetPartitionRestartProgress has reached a State of Completed.  If the State has a value of Running, only the State field will have a value.",
+  "parameters": {
+    "serviceId": "fabric:/myapp/myservice",
+    "partitionId": "1daae3f5-7fd6-42e9-b1ba-8c05f873994d",
+    "OperationId": "6eb7f0d3-49ca-4cb1-81b7-ac2d56b5c5d1",
+    "api-version": "6.0"
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": {
+        "State": "Completed",
+        "RestartPartitionResult": {
+          "ErrorCode": 0,
+          "SelectedPartition": {
+            "ServiceName": "fabric:/myapp/myservice",
+            "PartitionId": "1daae3f5-7fd6-42e9-b1ba-8c05f873994d"
+          }
+        }
+      }
+    }
+  }
+}
diff --git a/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetPartitionRestoreProgress.json b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetPartitionRestoreProgress.json
new file mode 100644
index 000000000000..da52d1a100b9
--- /dev/null
+++ b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetPartitionRestoreProgress.json
@@ -0,0 +1,23 @@
+{
+  "operationId": "GetPartitionRestoreProgress",
+  "description": "This shows an example of possible output when GetPartitionRestoreProgress has reached a RestoreState of Success.  If the RestoreState has a value of RestoreInProgress, only the RestoreState field will have a value.",
+  "parameters": {
+    "partitionId": "1daae3f5-7fd6-42e9-b1ba-8c05f873994d",
+    "api-version": "6.4"
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": {
+        "RestoreState": "Success",
+        "TimeStampUtc": "2018-01-01T09:00:55Z",
+        "RestoredEpoch": {
+          "DataLossVersion": "131462452931584510",
+          "ConfigurationVersion": "8589934592"
+        },
+        "RestoredLsn": "261",
+        "FailureError": null
+      }
+    }
+  }
+}
diff --git a/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetPartitionsEventList.json b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetPartitionsEventList.json
new file mode 100644
index 000000000000..e49c5e402b00
--- /dev/null
+++ b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetPartitionsEventList.json
@@ -0,0 +1,56 @@
+{
+  "operationId": "GetPartitionsEventList",
+  "description": "This example shows how to get all partitions-related events during a certain time window.",
+  "parameters": {
+    "api-version": "6.4",
+    "StartTimeUtc": "2018-04-03T18:00:00Z",
+    "EndTimeUtc": "2018-04-04T18:00:00Z"
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": [
+        {
+          "Kind": "PartitionReconfigured",
+          "NodeName": "node1",
+          "NodeInstanceId": "ba001a8bb353543e646be031afb10f1e",
+          "ServiceType": "Svc1Type",
+          "CcEpochDataLossVersion": 131672604833413107,
+          "CcEpochConfigVersion": 8589934595,
+          "ReconfigType": "Other",
+          "Result": "Completed",
+          "Phase0DurationMs": 0.0,
+          "Phase1DurationMs": 0.0,
+          "Phase2DurationMs": 203.1935,
+          "Phase3DurationMs": 0.0262,
+          "Phase4DurationMs": 628.8527,
+          "TotalDurationMs": 832.0724,
+          "PartitionId": "f2a6a893-39be-4c7d-b07f-72bc2d36de89",
+          "EventInstanceId": "e00fa5b7-f747-40dd-9e09-f5a031e96de4",
+          "TimeStamp": "2018-04-03T20:21:47.3778996Z",
+          "HasCorrelatedEvents": true
+        },
+        {
+          "Kind": "PartitionReconfigured",
+          "NodeName": "node2",
+          "NodeInstanceId": "ba0459d257b028296deba8bd5add33cb",
+          "ServiceType": "Svc1Type",
+          "CcEpochDataLossVersion": 131672604833413107,
+          "CcEpochConfigVersion": 8589934596,
+          "ReconfigType": "Other",
+          "Result": "Completed",
+          "Phase0DurationMs": 0.0,
+          "Phase1DurationMs": 0.0,
+          "Phase2DurationMs": 205.667,
+          "Phase3DurationMs": 407.7781,
+          "Phase4DurationMs": 630.0935,
+          "TotalDurationMs": 1243.5386,
+          "PartitionId": "e12acfb3-2a43-4a1a-a252-aa5388ef1aec",
+          "EventInstanceId": "9aeb234a-16ef-4e8a-974e-26c60d6f2b86",
+          "TimeStamp": "2018-04-03T20:21:49.5155104Z",
+          "HasCorrelatedEvents": false
+        }
+      ]
+    }
+  }
+}
diff --git a/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetPropertyInfo-1.json b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetPropertyInfo-1.json
new file mode 100644
index 000000000000..ca5def4be2fb
--- /dev/null
+++ b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetPropertyInfo-1.json
@@ -0,0 +1,29 @@
+{
+  "operationId": "GetPropertyInfo",
+  "description": "This example shows how to get a Service Fabric property under a given name.",
+  "parameters": {
+    "api-version": "6.0",
+    "nameId": "samples/apps",
+    "PropertyName": "AppData"
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": {
+        "Name": "CalculatorAppData",
+        "Value": {
+          "Kind": "String",
+          "Data": "1+2=3"
+        },
+        "Metadata": {
+          "TypeId": "String",
+          "CustomTypeId": "EquationType",
+          "Parent": "fabric:/samples/apps",
+          "SizeInBytes": 12,
+          "LastModifiedUtcTimestamp": "2017-07-17T04:27:19.049Z",
+          "SequenceNumber": "12"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetPropertyInfoList-1.json b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetPropertyInfoList-1.json
new file mode 100644
index 000000000000..5729c6a4e4a2
--- /dev/null
+++ b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetPropertyInfoList-1.json
@@ -0,0 +1,41 @@
+{
+  "operationId": "GetPropertyInfoList",
+  "description": "This example shows how to get all Service Fabric properties under a given name.",
+  "parameters": {
+    "api-version": "6.0",
+    "nameId": "samples/apps"
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": {
+        "ContinuationToken": "PersistentQueueAppData$131439231986491349",
+        "IsConsistent": true,
+        "Properties": [
+          {
+            "Name": "CalculatorAppData",
+            "Metadata": {
+              "TypeId": "Int64",
+              "CustomTypeId": "",
+              "Parent": "fabric:/samples/apps",
+              "SizeInBytes": 5,
+              "LastModifiedUtcTimestamp": "2017-07-17T04:27:19.049Z",
+              "SequenceNumber": "10"
+            }
+          },
+          {
+            "Name": "PersistentQueueAppData",
+            "Metadata": {
+              "TypeId": "Binary",
+              "CustomTypeId": "InitializationDataType",
+              "Parent": "fabric:/samples/apps",
+              "SizeInBytes": 5,
+              "LastModifiedUtcTimestamp": "2017-07-17T04:36:19.049Z",
+              "SequenceNumber": "12"
+            }
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetPropertyInfoList-2.json b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetPropertyInfoList-2.json
new file mode 100644
index 000000000000..6a172f23f09a
--- /dev/null
+++ b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetPropertyInfoList-2.json
@@ -0,0 +1,56 @@
+{
+  "operationId": "GetPropertyInfoList",
+  "description": "This example shows how to get all Service Fabric properties and their values under a given name.",
+  "parameters": {
+    "api-version": "6.0",
+    "nameId": "samples/apps",
+    "IncludeValues": true
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": {
+        "ContinuationToken": "PersistentQueueAppData$131439231986491349",
+        "IsConsistent": true,
+        "Properties": [
+          {
+            "Name": "CalculatorAppData",
+            "Value": {
+              "Kind": "Int64",
+              "Data": "4534"
+            },
+            "Metadata": {
+              "TypeId": "Int64",
+              "CustomTypeId": "",
+              "Parent": "fabric:/samples/apps",
+              "SizeInBytes": 8,
+              "LastModifiedUtcTimestamp": "2017-07-17T04:27:19.049Z",
+              "SequenceNumber": "10"
+            }
+          },
+          {
+            "Name": "PersistentQueueAppData",
+            "Value": {
+              "Kind": "Binary",
+              "Data": [
+                6,
+                7,
+                8,
+                9,
+                10
+              ]
+            },
+            "Metadata": {
+              "TypeId": "Binary",
+              "CustomTypeId": "InitializationDataType",
+              "Parent": "fabric:/samples/apps",
+              "SizeInBytes": 5,
+              "LastModifiedUtcTimestamp": "2017-07-17T04:36:19.049Z",
+              "SequenceNumber": "12"
+            }
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetPropertyInfoList-3.json b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetPropertyInfoList-3.json
new file mode 100644
index 000000000000..ce12465b6ce6
--- /dev/null
+++ b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetPropertyInfoList-3.json
@@ -0,0 +1,36 @@
+{
+  "operationId": "GetPropertyInfoList",
+  "description": "This example shows how to page through the information about properties under a given Service Fabric name using ContinuationToken parameter. The value of this parameter is provided from the previous query, in this case the example shown above. The response contains the remaining two results and an empty ContinuationToken. The empty ContinuationToken indicates that additional results are not available.",
+  "parameters": {
+    "api-version": "6.0",
+    "nameId": "samples/apps",
+    "IncludeValues": true,
+    "ContinuationToken": "PersistentQueueAppData$131439231986491349"
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": {
+        "ContinuationToken": "",
+        "IsConsistent": true,
+        "Properties": [
+          {
+            "Name": "VolatileQueueAppData",
+            "Value": {
+              "Kind": "Double",
+              "Data": 67.89
+            },
+            "Metadata": {
+              "TypeId": "Double",
+              "CustomTypeId": "",
+              "Parent": "fabric:/samples/apps",
+              "SizeInBytes": 8,
+              "LastModifiedUtcTimestamp": "2017-07-17T04:01:19.049Z",
+              "SequenceNumber": "8"
+            }
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetQuorumLossProgress-Running.json b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetQuorumLossProgress-Running.json
new file mode 100644
index 000000000000..203fb157db03
--- /dev/null
+++ b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetQuorumLossProgress-Running.json
@@ -0,0 +1,18 @@
+{
+  "operationId": "GetQuorumLossProgress",
+  "description": "This shows an example of possible output when GetQuorumLossProgress has a State of Running.  If the State has a value of Running, only the State field will have a value.",
+  "parameters": {
+    "serviceId": "fabric:/myapp/myservice",
+    "partitionId": "1daae3f5-7fd6-42e9-b1ba-8c05f873994d",
+    "OperationId": "81fbaee7-4f49-44bb-a350-4cb2b51dbf26",
+    "api-version": "6.0"
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": {
+        "State": "Running"
+      }
+    }
+  }
+}
diff --git a/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetQuorumLossProgress.json b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetQuorumLossProgress.json
new file mode 100644
index 000000000000..c86fd0d2b31d
--- /dev/null
+++ b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetQuorumLossProgress.json
@@ -0,0 +1,25 @@
+{
+  "operationId": "GetQuorumLossProgress",
+  "description": "This shows an example of possible output when GetQuorumLossProgress has reached a State of Completed.  If the State has a value of Running, only the State field will have a value.",
+  "parameters": {
+    "serviceId": "fabric:/myapp/myservice",
+    "partitionId": "1daae3f5-7fd6-42e9-b1ba-8c05f873994d",
+    "OperationId": "81fbaee7-4f49-44bb-a350-4cb2b51dbf26",
+    "api-version": "6.0"
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": {
+        "State": "Completed",
+        "InvokeQuorumLossResult": {
+          "ErrorCode": 0,
+          "SelectedPartition": {
+            "ServiceName": "fabric:/myapp/myservice",
+            "PartitionId": "1daae3f5-7fd6-42e9-b1ba-8c05f873994d"
+          }
+        }
+      }
+    }
+  }
+}
diff --git a/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetReplicaEventList.json b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetReplicaEventList.json
new file mode 100644
index 000000000000..a3b517117bac
--- /dev/null
+++ b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetReplicaEventList.json
@@ -0,0 +1,35 @@
+{
+  "operationId": "GetPartitionReplicaEventList",
+  "description": "This example shows how to get all replica-related events during a certain time window.",
+  "parameters": {
+    "partitionId": "f2a6a893-39be-4c7d-b07f-72bc2d36de89",
+    "replicaId": 131672608994209130,
+    "api-version": "6.4",
+    "StartTimeUtc": "2018-04-03T18:00:00Z",
+    "EndTimeUtc": "2018-04-04T18:00:00Z"
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": [
+        {
+          "Kind": "StatefulReplicaNewHealthReport",
+          "ReplicaInstanceId": 131672608994209130,
+          "SourceId": "TestSource",
+          "Property": "",
+          "HealthState": "Error",
+          "TimeToLiveMs": 922337203685477,
+          "SequenceNumber": 131672654189677787,
+          "Description": "",
+          "RemoveWhenExpired": false,
+          "SourceUtcTimestamp": "2018-04-03T21:43:38Z",
+          "PartitionId": "f2a6a893-39be-4c7d-b07f-72bc2d36de89",
+          "ReplicaId": 131672608994209130,
+          "EventInstanceId": "b2684da3-df81-4add-8baa-201f73e9195d",
+          "TimeStamp": "2018-04-03T21:43:38.8904013Z",
+          "HasCorrelatedEvents": false
+        }
+      ]
+    }
+  }
+}
diff --git a/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetReplicasEventList.json b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetReplicasEventList.json
new file mode 100644
index 000000000000..1d2e9212dfcc
--- /dev/null
+++ b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetReplicasEventList.json
@@ -0,0 +1,51 @@
+{
+  "operationId": "GetPartitionReplicasEventList",
+  "description": "This example shows how to get all replicas-related events during a certain time window.",
+  "parameters": {
+    "partitionId": "f2a6a893-39be-4c7d-b07f-72bc2d36de89",
+    "api-version": "6.4",
+    "StartTimeUtc": "2018-04-03T18:00:00Z",
+    "EndTimeUtc": "2018-04-04T18:00:00Z"
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": [
+        {
+          "Kind": "StatefulReplicaNewHealthReport",
+          "ReplicaInstanceId": 131672608994209130,
+          "SourceId": "TestSource",
+          "Property": "",
+          "HealthState": "Error",
+          "TimeToLiveMs": 922337203685477,
+          "SequenceNumber": 131672654189677787,
+          "Description": "",
+          "RemoveWhenExpired": false,
+          "SourceUtcTimestamp": "2018-04-03T21:43:38Z",
+          "PartitionId": "f2a6a893-39be-4c7d-b07f-72bc2d36de89",
+          "ReplicaId": 131672608994209130,
+          "EventInstanceId": "b2684da3-df81-4add-8baa-201f73e9195d",
+          "TimeStamp": "2018-04-03T21:43:38.8904013Z",
+          "HasCorrelatedEvents": false
+        },
+        {
+          "Kind": "StatefulReplicaNewHealthReport",
+          "ReplicaInstanceId": 177872608994339550,
+          "SourceId": "TestSource",
+          "Property": "",
+          "HealthState": "Error",
+          "TimeToLiveMs": 922337203685477,
+          "SequenceNumber": 131672654189677788,
+          "Description": "",
+          "RemoveWhenExpired": false,
+          "SourceUtcTimestamp": "2018-04-03T21:44:38Z",
+          "PartitionId": "f549f3b3-08c2-4ec4-adb4-415e024cb0ef",
+          "ReplicaId": 177872608994339550,
+          "EventInstanceId": "4a8851d8-35a3-4618-b4ac-03ffa191c350",
+          "TimeStamp": "2018-04-03T21:44:38.8904013Z",
+          "HasCorrelatedEvents": false
+        }
+      ]
+    }
+  }
+}
diff --git a/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetServiceBackupConfigurationInfo-1.json b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetServiceBackupConfigurationInfo-1.json
new file mode 100644
index 000000000000..ab37c65b803f
--- /dev/null
+++ b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetServiceBackupConfigurationInfo-1.json
@@ -0,0 +1,40 @@
+{
+  "operationId": "GetServiceBackupConfigurationInfo",
+  "description": "This example shows how to get list of backup configuration for this service and partitions under this service. The number of results in a page are limited to maximum of two using the MaxResult parameter.",
+  "parameters": {
+    "api-version": "6.4",
+    "serviceId": "CalcApp/CalcService",
+    "MaxResults": 2
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": {
+        "ContinuationToken": "fabric:/CalcApp/CalcService#1daae3f5-7fd6-42e9-b1ba-8c05f873994d",
+        "Items": [
+          {
+            "Kind": "Service",
+            "PolicyName": "BackupPolicy1",
+            "PolicyInheritedFrom": "Application",
+            "ServiceName": "fabric:/CalcApp/CalcService",
+            "SuspensionInfo": {
+              "IsSuspended": false,
+              "SuspensionInheritedFrom": "Invalid"
+            }
+          },
+          {
+            "Kind": "Partition",
+            "PolicyName": "BackupPolicy2",
+            "PolicyInheritedFrom": "Partition",
+            "ServiceName": "fabric:/CalcApp/CalcService",
+            "PartitionId": "1daae3f5-7fd6-42e9-b1ba-8c05f873994d",
+            "SuspensionInfo": {
+              "IsSuspended": false,
+              "SuspensionInheritedFrom": "Invalid"
+            }
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetServiceBackupConfigurationInfo-2.json b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetServiceBackupConfigurationInfo-2.json
new file mode 100644
index 000000000000..76e7e948550d
--- /dev/null
+++ b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetServiceBackupConfigurationInfo-2.json
@@ -0,0 +1,31 @@
+{
+  "operationId": "GetServiceBackupConfigurationInfo",
+  "description": "This example shows how to get list of backup configuration for this service and partitions under this service. The number of results in a page are limited to maximum of two using the MaxResult parameter. This example uses the ContinuationToken parameter. The value of this parameter is provided from the previous query; in this case the example shown above. The response contains the remaining results and an empty ContinuationToken. The empty ContinuationToken indicates that additional results are not available.",
+  "parameters": {
+    "api-version": "6.4",
+    "serviceId": "CalcApp/CalcService",
+    "MaxResults": 2,
+    "ContinuationToken": "fabric:/CalcApp/CalcService#1daae3f5-7fd6-42e9-b1ba-8c05f873994d"
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": {
+        "ContinuationToken": "",
+        "Items": [
+          {
+            "Kind": "Partition",
+            "PolicyName": "BackupPolicy1",
+            "PolicyInheritedFrom": "Application",
+            "ServiceName": "fabric:/CalcApp/CalcService",
+            "PartitionId": "7216486c-1ee9-4b00-99b2-92b26fcb07f6",
+            "SuspensionInfo": {
+              "IsSuspended": true,
+              "SuspensionInheritedFrom": "Partition"
+            }
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetServiceBackupList-1.json b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetServiceBackupList-1.json
new file mode 100644
index 000000000000..b561b1b20f84
--- /dev/null
+++ b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetServiceBackupList-1.json
@@ -0,0 +1,108 @@
+{
+  "operationId": "GetServiceBackupList",
+  "description": "This example shows how to get list of service backups within a time range.",
+  "parameters": {
+    "api-version": "6.4",
+    "serviceId": "CalcApp/CalcService",
+    "StartDateTimeFilter": "2018-01-01T00:00:00Z",
+    "EndDateTimeFilter": "2018-01-01T23:59:59Z"
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": {
+        "ContinuationToken": "",
+        "Items": [
+          {
+            "BackupId": "3a056ac9-7206-43c3-8424-6f6103003eba",
+            "BackupChainId": "3a056ac9-7206-43c3-8424-6f6103003eba",
+            "ApplicationName": "fabric:/CalcApp",
+            "ServiceManifestVersion": "1.0.0",
+            "ServiceName": "fabric:/CalcApp/CalcService",
+            "PartitionInformation": {
+              "LowKey": "-9223372036854775808",
+              "HighKey": "9223372036854775807",
+              "ServicePartitionKind": "Int64Range",
+              "Id": "1daae3f5-7fd6-42e9-b1ba-8c05f873994d"
+            },
+            "BackupLocation": "CalcApp\\CalcService\\1daae3f5-7fd6-42e9-b1ba-8c05f873994d\\2018-01-01 09.00.55.zip",
+            "BackupType": "Full",
+            "EpochOfLastBackupRecord": {
+              "DataLossVersion": "131462452931584510",
+              "ConfigurationVersion": "8589934592"
+            },
+            "LsnOfLastBackupRecord": "261",
+            "CreationTimeUtc": "2018-01-01T09:00:55Z",
+            "FailureError": null
+          },
+          {
+            "BackupId": "7903dc2a-228d-44b0-b7c8-a13a6c9b46bd",
+            "BackupChainId": "3a056ac9-7206-43c3-8424-6f6103003eba",
+            "ApplicationName": "fabric:/CalcApp",
+            "ServiceManifestVersion": "1.0.0",
+            "ServiceName": "fabric:/CalcApp/CalcService",
+            "PartitionInformation": {
+              "LowKey": "-9223372036854775808",
+              "HighKey": "9223372036854775807",
+              "ServicePartitionKind": "Int64Range",
+              "Id": "1daae3f5-7fd6-42e9-b1ba-8c05f873994d"
+            },
+            "BackupLocation": "CalcApp\\CalcService\\1daae3f5-7fd6-42e9-b1ba-8c05f873994d\\2018-01-01 17.01.02.zip",
+            "BackupType": "Incremental",
+            "EpochOfLastBackupRecord": {
+              "DataLossVersion": "131462452931584510",
+              "ConfigurationVersion": "8589934592"
+            },
+            "LsnOfLastBackupRecord": "446",
+            "CreationTimeUtc": "2018-01-01T17:01:02Z",
+            "FailureError": null
+          },
+          {
+            "BackupId": "0ff4fdbe-131c-4dfb-8249-7b4029ddc014",
+            "BackupChainId": "0ff4fdbe-131c-4dfb-8249-7b4029ddc014",
+            "ApplicationName": "fabric:/CalcApp",
+            "ServiceManifestVersion": "1.0.0",
+            "ServiceName": "fabric:/CalcApp/CalcService",
+            "PartitionInformation": {
+              "LowKey": "-9223372036854775808",
+              "HighKey": "9223372036854775807",
+              "ServicePartitionKind": "Int64Range",
+              "Id": "81645ec7-d260-4c59-9533-8f129bde8e83"
+            },
+            "BackupLocation": "CalcApp\\CalcService\\81645ec7-d260-4c59-9533-8f129bde8e83\\2018-01-01 09.01.02.zip",
+            "BackupType": "Full",
+            "EpochOfLastBackupRecord": {
+              "DataLossVersion": "131462452931584510",
+              "ConfigurationVersion": "8589934592"
+            },
+            "LsnOfLastBackupRecord": "161",
+            "CreationTimeUtc": "2018-01-01T09:01:02Z",
+            "FailureError": null
+          },
+          {
+            "BackupId": "d55a2d98-258b-4a34-8fe5-2063e81af9dc",
+            "BackupChainId": "0ff4fdbe-131c-4dfb-8249-7b4029ddc014",
+            "ApplicationName": "fabric:/CalcApp",
+            "ServiceManifestVersion": "1.0.0",
+            "ServiceName": "fabric:/CalcApp/CalcService",
+            "PartitionInformation": {
+              "LowKey": "-9223372036854775808",
+              "HighKey": "9223372036854775807",
+              "ServicePartitionKind": "Int64Range",
+              "Id": "81645ec7-d260-4c59-9533-8f129bde8e83"
+            },
+            "BackupLocation": "CalcApp\\CalcService\\81645ec7-d260-4c59-9533-8f129bde8e83\\2018-01-01 17.00.34.zip",
+            "BackupType": "Incremental",
+            "EpochOfLastBackupRecord": {
+              "DataLossVersion": "131462452931584510",
+              "ConfigurationVersion": "8589934592"
+            },
+            "LsnOfLastBackupRecord": "246",
+            "CreationTimeUtc": "2018-01-01T17:00:34Z",
+            "FailureError": null
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetServiceBackupList-2.json b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetServiceBackupList-2.json
new file mode 100644
index 000000000000..df570db76649
--- /dev/null
+++ b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetServiceBackupList-2.json
@@ -0,0 +1,63 @@
+{
+  "operationId": "GetServiceBackupList",
+  "description": "This example shows how to get the latest backup for each partition within a service.",
+  "parameters": {
+    "api-version": "6.4",
+    "serviceId": "CalcApp/CalcService",
+    "Latest": true
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": {
+        "ContinuationToken": "",
+        "Items": [
+          {
+            "BackupId": "7903dc2a-228d-44b0-b7c8-a13a6c9b46bd",
+            "BackupChainId": "3a056ac9-7206-43c3-8424-6f6103003eba",
+            "ApplicationName": "fabric:/CalcApp",
+            "ServiceManifestVersion": "1.0.0",
+            "ServiceName": "fabric:/CalcApp/CalcService",
+            "PartitionInformation": {
+              "LowKey": "-9223372036854775808",
+              "HighKey": "9223372036854775807",
+              "ServicePartitionKind": "Int64Range",
+              "Id": "1daae3f5-7fd6-42e9-b1ba-8c05f873994d"
+            },
+            "BackupLocation": "CalcApp\\CalcService\\1daae3f5-7fd6-42e9-b1ba-8c05f873994d\\2018-01-01 17.01.02.zip",
+            "BackupType": "Incremental",
+            "EpochOfLastBackupRecord": {
+              "DataLossVersion": "131462452931584510",
+              "ConfigurationVersion": "8589934592"
+            },
+            "LsnOfLastBackupRecord": "446",
+            "CreationTimeUtc": "2018-01-01T17:01:02Z",
+            "FailureError": null
+          },
+          {
+            "BackupId": "d55a2d98-258b-4a34-8fe5-2063e81af9dc",
+            "BackupChainId": "0ff4fdbe-131c-4dfb-8249-7b4029ddc014",
+            "ApplicationName": "fabric:/CalcApp",
+            "ServiceManifestVersion": "1.0.0",
+            "ServiceName": "fabric:/CalcApp/CalcService",
+            "PartitionInformation": {
+              "LowKey": "-9223372036854775808",
+              "HighKey": "9223372036854775807",
+              "ServicePartitionKind": "Int64Range",
+              "Id": "81645ec7-d260-4c59-9533-8f129bde8e83"
+            },
+            "BackupLocation": "CalcApp\\CalcService\\81645ec7-d260-4c59-9533-8f129bde8e83\\2018-01-01 17.00.34.zip",
+            "BackupType": "Incremental",
+            "EpochOfLastBackupRecord": {
+              "DataLossVersion": "131462452931584510",
+              "ConfigurationVersion": "8589934592"
+            },
+            "LsnOfLastBackupRecord": "246",
+            "CreationTimeUtc": "2018-01-01T17:00:34Z",
+            "FailureError": null
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetServiceBackupList-3.json b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetServiceBackupList-3.json
new file mode 100644
index 000000000000..5b162231a889
--- /dev/null
+++ b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetServiceBackupList-3.json
@@ -0,0 +1,63 @@
+{
+  "operationId": "GetServiceBackupList",
+  "description": "This example shows how to get list of service backups. The number of results in a page are limited to maximum of two using the MaxResult parameter.",
+  "parameters": {
+    "api-version": "6.4",
+    "serviceId": "CalcApp/CalcService",
+    "MaxResults": 2
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": {
+        "ContinuationToken": "fabric:/CalcApp/CalcService#1daae3f5-7fd6-42e9-b1ba-8c05f873994d#7903dc2a-228d-44b0-b7c8-a13a6c9b46bd",
+        "Items": [
+          {
+            "BackupId": "3a056ac9-7206-43c3-8424-6f6103003eba",
+            "BackupChainId": "3a056ac9-7206-43c3-8424-6f6103003eba",
+            "ApplicationName": "fabric:/CalcApp",
+            "ServiceManifestVersion": "1.0.0",
+            "ServiceName": "fabric:/CalcApp/CalcService",
+            "PartitionInformation": {
+              "LowKey": "-9223372036854775808",
+              "HighKey": "9223372036854775807",
+              "ServicePartitionKind": "Int64Range",
+              "Id": "1daae3f5-7fd6-42e9-b1ba-8c05f873994d"
+            },
+            "BackupLocation": "CalcApp\\CalcService\\1daae3f5-7fd6-42e9-b1ba-8c05f873994d\\2018-01-01 09.00.55.zip",
+            "BackupType": "Full",
+            "EpochOfLastBackupRecord": {
+              "DataLossVersion": "131462452931584510",
+              "ConfigurationVersion": "8589934592"
+            },
+            "LsnOfLastBackupRecord": "261",
+            "CreationTimeUtc": "2018-01-01T09:00:55Z",
+            "FailureError": null
+          },
+          {
+            "BackupId": "7903dc2a-228d-44b0-b7c8-a13a6c9b46bd",
+            "BackupChainId": "3a056ac9-7206-43c3-8424-6f6103003eba",
+            "ApplicationName": "fabric:/CalcApp",
+            "ServiceManifestVersion": "1.0.0",
+            "ServiceName": "fabric:/CalcApp/CalcService",
+            "PartitionInformation": {
+              "LowKey": "-9223372036854775808",
+              "HighKey": "9223372036854775807",
+              "ServicePartitionKind": "Int64Range",
+              "Id": "1daae3f5-7fd6-42e9-b1ba-8c05f873994d"
+            },
+            "BackupLocation": "CalcApp\\CalcService\\1daae3f5-7fd6-42e9-b1ba-8c05f873994d\\2018-01-01 17.01.02.zip",
+            "BackupType": "Incremental",
+            "EpochOfLastBackupRecord": {
+              "DataLossVersion": "131462452931584510",
+              "ConfigurationVersion": "8589934592"
+            },
+            "LsnOfLastBackupRecord": "446",
+            "CreationTimeUtc": "2018-01-01T17:01:02Z",
+            "FailureError": null
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetServiceBackupList-4.json b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetServiceBackupList-4.json
new file mode 100644
index 000000000000..7420d61aca49
--- /dev/null
+++ b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetServiceBackupList-4.json
@@ -0,0 +1,64 @@
+{
+  "operationId": "GetServiceBackupList",
+  "description": "This example shows how to get list of service backups. The number of results in a page are limited to maximum of two using the MaxResult parameter. This example uses the ContinuationToken parameter. The value of this parameter is provided from the previous query; in this case the example shown above. The response contains the remaining results and an empty ContinuationToken. The empty ContinuationToken indicates that additional results are not available.",
+  "parameters": {
+    "api-version": "6.4",
+    "serviceId": "CalcApp/CalcService",
+    "MaxResults": 2,
+    "ContinuationToken": "fabric:/CalcApp/CalcService#1daae3f5-7fd6-42e9-b1ba-8c05f873994d#7903dc2a-228d-44b0-b7c8-a13a6c9b46bd"
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": {
+        "ContinuationToken": "",
+        "Items": [
+          {
+            "BackupId": "0ff4fdbe-131c-4dfb-8249-7b4029ddc014",
+            "BackupChainId": "0ff4fdbe-131c-4dfb-8249-7b4029ddc014",
+            "ApplicationName": "fabric:/CalcApp",
+            "ServiceManifestVersion": "1.0.0",
+            "ServiceName": "fabric:/CalcApp/CalcService",
+            "PartitionInformation": {
+              "LowKey": "-9223372036854775808",
+              "HighKey": "9223372036854775807",
+              "ServicePartitionKind": "Int64Range",
+              "Id": "81645ec7-d260-4c59-9533-8f129bde8e83"
+            },
+            "BackupLocation": "CalcApp\\CalcService\\81645ec7-d260-4c59-9533-8f129bde8e83\\2018-01-01 09.01.02.zip",
+            "BackupType": "Full",
+            "EpochOfLastBackupRecord": {
+              "DataLossVersion": "131462452931584510",
+              "ConfigurationVersion": "8589934592"
+            },
+            "LsnOfLastBackupRecord": "161",
+            "CreationTimeUtc": "2018-01-01T09:01:02Z",
+            "FailureError": null
+          },
+          {
+            "BackupId": "d55a2d98-258b-4a34-8fe5-2063e81af9dc",
+            "BackupChainId": "0ff4fdbe-131c-4dfb-8249-7b4029ddc014",
+            "ApplicationName": "fabric:/CalcApp",
+            "ServiceManifestVersion": "1.0.0",
+            "ServiceName": "fabric:/CalcApp/CalcService",
+            "PartitionInformation": {
+              "LowKey": "-9223372036854775808",
+              "HighKey": "9223372036854775807",
+              "ServicePartitionKind": "Int64Range",
+              "Id": "81645ec7-d260-4c59-9533-8f129bde8e83"
+            },
+            "BackupLocation": "CalcApp\\CalcService\\81645ec7-d260-4c59-9533-8f129bde8e83\\2018-01-01 17.00.34.zip",
+            "BackupType": "Incremental",
+            "EpochOfLastBackupRecord": {
+              "DataLossVersion": "131462452931584510",
+              "ConfigurationVersion": "8589934592"
+            },
+            "LsnOfLastBackupRecord": "246",
+            "CreationTimeUtc": "2018-01-01T17:00:34Z",
+            "FailureError": null
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetServiceEventList.json b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetServiceEventList.json
new file mode 100644
index 000000000000..fdaa115873cd
--- /dev/null
+++ b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetServiceEventList.json
@@ -0,0 +1,34 @@
+{
+  "operationId": "GetServiceEventList",
+  "description": "This example shows how to get all service-related events during a certain time window.",
+  "parameters": {
+    "serviceId": "app1~svc1",
+    "api-version": "6.4",
+    "StartTimeUtc": "2018-04-03T18:00:00Z",
+    "EndTimeUtc": "2018-04-04T18:00:00Z"
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": [
+        {
+          "Kind": "ServiceCreated",
+          "ServiceTypeName": "Svc1Type",
+          "ApplicationName": "fabric:/app1",
+          "ApplicationTypeName": "App1Type",
+          "ServiceInstance": 131672605579916062,
+          "IsStateful": true,
+          "PartitionCount": 2,
+          "TargetReplicaSetSize": 3,
+          "MinReplicaSetSize": 2,
+          "ServicePackageVersion": "1.0:1.0",
+          "PartitionId": "bd936249-183d-4e29-94ab-2e198e4e2e87",
+          "ServiceId": "app1/svc1",
+          "EventInstanceId": "8ba26506-4a93-4b8c-ae14-29a2841b3003",
+          "TimeStamp": "2018-04-03T20:22:38.0560496Z",
+          "HasCorrelatedEvents": false
+        }
+      ]
+    }
+  }
+}
diff --git a/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetServiceTypeInfoByName-1.json b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetServiceTypeInfoByName-1.json
new file mode 100644
index 000000000000..4340954856fe
--- /dev/null
+++ b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetServiceTypeInfoByName-1.json
@@ -0,0 +1,36 @@
+{
+  "operationId": "GetServiceTypeInfoByName",
+  "description": "This example shows how to get information about a specific service type. A 204 response is returned if the specified service type is not found in the cluster.",
+  "parameters": {
+    "api-version": "6.0",
+    "applicationTypeName": "Application2Type",
+    "ApplicationTypeVersion": "1.0.0",
+    "serviceTypeName": "Actor1ActorServiceType"
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": {
+        "ServiceTypeDescription": {
+          "IsStateful": true,
+          "ServiceTypeName": "Actor1ActorServiceType",
+          "PlacementConstraints": "",
+          "HasPersistedState": true,
+          "Kind": "Stateful",
+          "Extensions": [
+            {
+              "Key": "__GeneratedServiceType__",
+              "Value": "<GeneratedNames xmlns=\"http://schemas.microsoft.com/2015/03/fabact-no-schema\">\r\n            <DefaultService Name=\"Actor1ActorService\" />\r\n            <ReplicatorEndpoint Name=\"Actor1ActorServiceReplicatorEndpoint\" />\r\n            <ReplicatorConfigSection Name=\"Actor1ActorServiceReplicatorConfig\" />\r\n            <ReplicatorSecurityConfigSection Name=\"Actor1ActorServiceReplicatorSecurityConfig\" />\r\n            <StoreConfigSection Name=\"Actor1ActorServiceLocalStoreConfig\" />\r\n            <ServiceEndpointV2 Name=\"Actor1ActorServiceEndpointV2\" />\r\n          </GeneratedNames>"
+            }
+          ],
+          "LoadMetrics": [],
+          "ServicePlacementPolicies": []
+        },
+        "ServiceManifestVersion": "1.0.0",
+        "ServiceManifestName": "Actor1Pkg",
+        "IsServiceGroup": false
+      }
+    },
+    "204": {}
+  }
+}
diff --git a/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetServiceTypeInfoList-1.json b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetServiceTypeInfoList-1.json
new file mode 100644
index 000000000000..a4481bfa08c0
--- /dev/null
+++ b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetServiceTypeInfoList-1.json
@@ -0,0 +1,36 @@
+{
+  "operationId": "GetServiceTypeInfoList",
+  "description": "This example shows how to get information about service types that are supported by a provisioned application type in a Service Fabric cluster.",
+  "parameters": {
+    "api-version": "6.0",
+    "applicationTypeName": "Application2Type",
+    "ApplicationTypeVersion": "1.0.0"
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": [
+        {
+          "ServiceTypeDescription": {
+            "IsStateful": true,
+            "ServiceTypeName": "Actor1ActorServiceType",
+            "PlacementConstraints": "",
+            "HasPersistedState": true,
+            "Kind": "Stateful",
+            "Extensions": [
+              {
+                "Key": "__GeneratedServiceType__",
+                "Value": "<GeneratedNames xmlns=\"http://schemas.microsoft.com/2015/03/fabact-no-schema\">\r\n            <DefaultService Name=\"Actor1ActorService\" />\r\n            <ReplicatorEndpoint Name=\"Actor1ActorServiceReplicatorEndpoint\" />\r\n            <ReplicatorConfigSection Name=\"Actor1ActorServiceReplicatorConfig\" />\r\n            <ReplicatorSecurityConfigSection Name=\"Actor1ActorServiceReplicatorSecurityConfig\" />\r\n            <StoreConfigSection Name=\"Actor1ActorServiceLocalStoreConfig\" />\r\n            <ServiceEndpointV2 Name=\"Actor1ActorServiceEndpointV2\" />\r\n          </GeneratedNames>"
+              }
+            ],
+            "LoadMetrics": [],
+            "ServicePlacementPolicies": []
+          },
+          "ServiceManifestVersion": "1.0.0",
+          "ServiceManifestName": "Actor1Pkg",
+          "IsServiceGroup": false
+        }
+      ]
+    }
+  }
+}
diff --git a/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetServicesEventList.json b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetServicesEventList.json
new file mode 100644
index 000000000000..2d5863180a5a
--- /dev/null
+++ b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetServicesEventList.json
@@ -0,0 +1,50 @@
+{
+  "operationId": "GetServicesEventList",
+  "description": "This example shows how to get all services-related events during a certain time window.",
+  "parameters": {
+    "api-version": "6.4",
+    "StartTimeUtc": "2018-04-03T18:00:00Z",
+    "EndTimeUtc": "2018-04-04T18:00:00Z"
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": [
+        {
+          "Kind": "ServiceCreated",
+          "ServiceTypeName": "Svc1Type",
+          "ApplicationName": "fabric:/app1",
+          "ApplicationTypeName": "App1Type",
+          "ServiceInstance": 131672605579916062,
+          "IsStateful": true,
+          "PartitionCount": 2,
+          "TargetReplicaSetSize": 3,
+          "MinReplicaSetSize": 2,
+          "ServicePackageVersion": "1.0:1.0",
+          "PartitionId": "bd936249-183d-4e29-94ab-2e198e4e2e87",
+          "ServiceId": "app1/svc1",
+          "EventInstanceId": "8ba26506-4a93-4b8c-ae14-29a2841b3003",
+          "TimeStamp": "2018-04-03T20:22:38.0560496Z",
+          "HasCorrelatedEvents": false
+        },
+        {
+          "Kind": "ServiceCreated",
+          "ServiceTypeName": "Svc2Type",
+          "ApplicationName": "fabric:/app1",
+          "ApplicationTypeName": "App1Type",
+          "ServiceInstance": 131672605579916062,
+          "IsStateful": true,
+          "PartitionCount": 2,
+          "TargetReplicaSetSize": 3,
+          "MinReplicaSetSize": 2,
+          "ServicePackageVersion": "1.0:1.0",
+          "PartitionId": "87413d64-0134-4b23-a439-c2692c4e3ec3",
+          "ServiceId": "app1/svc2",
+          "EventInstanceId": "03246d3b-77f5-4ca2-b065-7b8671711318",
+          "TimeStamp": "2018-04-03T20:22:38.056197Z",
+          "HasCorrelatedEvents": false
+        }
+      ]
+    }
+  }
+}
diff --git a/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetSubNameInfoList-1.json b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetSubNameInfoList-1.json
new file mode 100644
index 000000000000..282319140d86
--- /dev/null
+++ b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetSubNameInfoList-1.json
@@ -0,0 +1,21 @@
+{
+  "operationId": "GetSubNameInfoList",
+  "description": "This example shows how to get information about all sub names of a given Service Fabric name.",
+  "parameters": {
+    "api-version": "6.0",
+    "nameId": "samples"
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": {
+        "ContinuationToken": "",
+        "IsConsistent": true,
+        "SubNames": [
+          "fabric:/samples/CalculatorApp",
+          "fabric:/samples/mynames"
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetSubNameInfoList-2.json b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetSubNameInfoList-2.json
new file mode 100644
index 000000000000..15391854f370
--- /dev/null
+++ b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetSubNameInfoList-2.json
@@ -0,0 +1,27 @@
+{
+  "operationId": "GetSubNameInfoList",
+  "description": "This example shows how to recursively get information about all child sub names of a given Service Fabric name.",
+  "parameters": {
+    "api-version": "6.0",
+    "nameId": "samples",
+    "Recursive": true
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": {
+        "ContinuationToken": "",
+        "IsConsistent": true,
+        "SubNames": [
+          "fabric:/samples/apps",
+          "fabric:/samples/data",
+          "fabric:/samples/CalculatorApp",
+          "fabric:/samples/CalculatorApp/CalculatorService",
+          "fabric:/samples/CalculatorApp/CalculatorService/Name-1",
+          "fabric:/samples/CalculatorApp/CalculatorService/Name-2",
+          "fabric:/samples/mynames/name-1"
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetSubNameInfoList-3.json b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetSubNameInfoList-3.json
new file mode 100644
index 000000000000..bf07c9c58bc4
--- /dev/null
+++ b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetSubNameInfoList-3.json
@@ -0,0 +1,23 @@
+{
+  "operationId": "GetSubNameInfoList",
+  "description": "This example shows how to page through the information about sub names under a given Service Fabric name using ContinuationToken parameter. The value of this parameter is provided from the previous query, in this case the example shown above. The response contains the remaining two results and an empty ContinuationToken. The empty ContinuationToken indicates that additional results are not available.",
+  "parameters": {
+    "api-version": "6.0",
+    "nameId": "samples",
+    "Recursive": true,
+    "ContinuationToken": "fabric:/samples/apps/PersistentQueueApp$131439231986491349"
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": {
+        "ContinuationToken": "",
+        "IsConsistent": true,
+        "SubNames": [
+          "fabric:/samples/apps/VolatileQueueApp",
+          "fabric:/samples/apps/NotepadApp"
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetUploadSessionById.json b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetUploadSessionById.json
new file mode 100644
index 000000000000..c565a13cfcbc
--- /dev/null
+++ b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetUploadSessionById.json
@@ -0,0 +1,33 @@
+{
+  "operationId": "GetImageStoreUploadSessionById",
+  "description": "This example shows how to get image store upload session by a given ID.",
+  "parameters": {
+    "api-version": "6.0",
+    "session-id": "4a2340e8-d8d8-497c-95fe-cdaa1052f33b"
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": {
+        "UploadSessions": [
+          {
+            "StoreRelativePath": "SwaggerTest\\Common.dll",
+            "SessionId": "4a2340e8-d8d8-497c-95fe-cdaa1052f33b",
+            "FileSize": "2097152",
+            "ModifiedDate": "2017-09-28T17:06:37.260Z",
+            "ExpectedRanges": [
+              {
+                "StartPosition": "0",
+                "EndPosition": "402128"
+              },
+              {
+                "StartPosition": "730105",
+                "EndPosition": "2097151"
+              }
+            ]
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetUploadSessionByPath.json b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetUploadSessionByPath.json
new file mode 100644
index 000000000000..8dc66b6d107d
--- /dev/null
+++ b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/GetUploadSessionByPath.json
@@ -0,0 +1,49 @@
+{
+  "operationId": "GetImageStoreUploadSessionByPath",
+  "description": "This example shows how to get image store upload session by a given relative path.",
+  "parameters": {
+    "api-version": "6.0",
+    "contentPath": "SwaggerTest\\Common.dll"
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": {
+        "UploadSessions": [
+          {
+            "StoreRelativePath": "SwaggerTest\\Common.dll",
+            "SessionId": "2032ac6c-a348-4594-86da-dab0f2bb1ae1",
+            "FileSize": "2097152",
+            "ModifiedDate": "2017-09-28T17:28:11.627Z",
+            "ExpectedRanges": [
+              {
+                "StartPosition": "0",
+                "EndPosition": "207615"
+              },
+              {
+                "StartPosition": "626977",
+                "EndPosition": "2097151"
+              }
+            ]
+          },
+          {
+            "StoreRelativePath": "SwaggerTest\\Common.dll",
+            "SessionId": "fb2da2b2-7cb4-45d2-a2e6-c4888d205bc5",
+            "FileSize": "2097152",
+            "ModifiedDate": "2017-09-28T17:28:11.643Z",
+            "ExpectedRanges": [
+              {
+                "StartPosition": "0",
+                "EndPosition": "616947"
+              },
+              {
+                "StartPosition": "1087529",
+                "EndPosition": "2097151"
+              }
+            ]
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/InvokeContainerApi.json b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/InvokeContainerApi.json
new file mode 100644
index 000000000000..bfe285758eec
--- /dev/null
+++ b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/InvokeContainerApi.json
@@ -0,0 +1,27 @@
+{
+  "operationId": "InvokeContainerApi",
+  "description": "This example shows how to call container API with HTTP GET for a code package deployed on a node.",
+  "parameters": {
+    "api-version": "6.2",
+    "nodeName": "Node01",
+    "applicationId": "samples/winnodejs",
+    "ServiceManifestName": "NodeServicePackage",
+    "CodePackageName": "NodeService.Code",
+    "CodePackageInstanceId": "131668159770315380",
+    "ContainerApiRequestBody": {
+      "UriPath": "/containers/{id}/logs?stdout=true&stderr=true"
+    }
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": {
+        "ContainerApiResult": {
+          "Status": 200,
+          "Content-Type": "text/plain; charset=utf-8",
+          "Body": "vEthernet (Container NIC ec5c19b2) 172.17.201.44\n"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/InvokeContainerApi_Post.json b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/InvokeContainerApi_Post.json
new file mode 100644
index 000000000000..0042fd341de0
--- /dev/null
+++ b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/InvokeContainerApi_Post.json
@@ -0,0 +1,29 @@
+{
+  "operationId": "InvokeContainerApi",
+  "description": "This example shows how to call container API with HTTP POST for a code package deployed on a node.",
+  "parameters": {
+    "api-version": "6.2",
+    "nodeName": "N0020",
+    "applicationId": "samples/nodejs1",
+    "ServiceManifestName": "NodeOnSF",
+    "CodePackageName": "Code",
+    "CodePackageInstanceId": "131673596679688285",
+    "ContainerApiRequestBody": {
+      "HttpVerb": "POST",
+      "UriPath": "/containers/{id}/update",
+      "Body": "{ \"CpuShares\": 512}"
+    }
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": {
+        "ContainerApiResult": {
+          "Status": 200,
+          "Content-Type": "application/json",
+          "Body": "{\"Warnings\":null}\n"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/PutProperty-1.json b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/PutProperty-1.json
new file mode 100644
index 000000000000..8eee209e7c7b
--- /dev/null
+++ b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/PutProperty-1.json
@@ -0,0 +1,25 @@
+{
+  "operationId": "PutProperty",
+  "description": "This example shows how to create or update a Service Fabric property under a given name.",
+  "parameters": {
+    "api-version": "6.0",
+    "nameId": "samples/apps/CalculatorApp",
+    "PropertyDescription": {
+      "PropertyName": "AppData",
+      "Value": {
+        "Kind": "Binary",
+        "Data": [
+          0,
+          1,
+          2,
+          3,
+          4,
+          5
+        ]
+      }
+    }
+  },
+  "responses": {
+    "200": {}
+  }
+}
diff --git a/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/PutProperty-2.json b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/PutProperty-2.json
new file mode 100644
index 000000000000..5db6a9ad77f7
--- /dev/null
+++ b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/PutProperty-2.json
@@ -0,0 +1,19 @@
+{
+  "operationId": "PutProperty",
+  "description": "This example shows how to create or update a Service Fabric property under a given name with a custom type.",
+  "parameters": {
+    "api-version": "6.0",
+    "nameId": "samples/apps/CalculatorApp",
+    "PropertyDescription": {
+      "PropertyName": "AppData",
+      "Value": {
+        "Kind": "String",
+        "Data": "1+2=3"
+      },
+      "CustomTypeId": "EquationType"
+    }
+  },
+  "responses": {
+    "200": {}
+  }
+}
diff --git a/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/Resources/Applications/Services/Replicas/CodePackages/get_logs.json b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/Resources/Applications/Services/Replicas/CodePackages/get_logs.json
new file mode 100644
index 000000000000..5f17ef376d9d
--- /dev/null
+++ b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/Resources/Applications/Services/Replicas/CodePackages/get_logs.json
@@ -0,0 +1,18 @@
+{
+  "operationId": "MeshCodePackage_GetContainerLogs",
+  "description": "This example shows how to get logs from the container of service replica. If the container exists, the logs are returned with an OK (200) status code, otherwise an error is returned with an appropriate status code.",
+  "parameters": {
+    "api-version": "6.4-preview",
+    "applicationResourceName": "sbzDocApp",
+    "serviceResourceName": "sbzDocService",
+    "replicaName": "0",
+    "codePackageName": "sbzDocCode"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "Content": " * Running on http://0.0.0.0:8080/ (Press CTRL+C to quit)\n * Downloading style https://assets-cdn.github.com/assets/frameworks-8f281eb0a8d2308ceb36e714ba3c3aec.css\n * Downloading style https://assets-cdn.github.com/assets/github-a698da0d53574b056d3c79ac732d4a70.css\n * Downloading style https://assets-cdn.github.com/assets/site-83dc1f7ebc9c7461fe1eab799b56c4c4.css\n * Cached all downloads in /root/.grip/cache-4.5.2\n167.220.0.83 - - [06/Apr/2018 07:16:02] \"GET / HTTP/1.1\" 200 -\n167.220.0.83 - - [06/Apr/2018 07:16:02] \"GET /__/grip/asset/frameworks-8f281eb0a8d2308ceb36e714ba3c3aec.css HTTP/1.1\" 200 -\n167.220.0.83 - - [06/Apr/2018 07:16:02] \"GET /__/grip/asset/site-83dc1f7ebc9c7461fe1eab799b56c4c4.css HTTP/1.1\" 200 -\n167.220.0.83 - - [06/Apr/2018 07:16:02] \"GET /__/grip/asset/github-a698da0d53574b056d3c79ac732d4a70.css HTTP/1.1\" 200 -\n167.220.0.83 - - [06/Apr/2018 07:16:02] \"GET /__/grip/static/octicons/octicons.css HTTP/1.1\" 200 -\n167.220.0.83 - - [06/Apr/2018 07:16:03] \"GET /__/grip/static/octicons/octicons.woff2?ef21c39f0ca9b1b5116e5eb7ac5eabe6 HTTP/1.1\" 200 -\n167.220.0.83 - - [06/Apr/2018 07:16:03] \"GET /__/grip/static/favicon.ico HTTP/1.1\" 200 -\n167.220.0.83 - - [06/Apr/2018 07:16:05] \"GET /seabreeze-index.md HTTP/1.1\" 200 -\n167.220.0.83 - - [06/Apr/2018 07:16:09] \"GET /seabreeze-api-application_get.md HTTP/1.1\" 200 -\n"
+      }
+    }
+  }
+}
diff --git a/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/Resources/Applications/Services/Replicas/get.json b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/Resources/Applications/Services/Replicas/get.json
new file mode 100644
index 000000000000..bb373e90c328
--- /dev/null
+++ b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/Resources/Applications/Services/Replicas/get.json
@@ -0,0 +1,57 @@
+{
+  "operationId": "MeshServiceReplica_Get",
+  "description": "This example shows how to get information about given replica of a service. If the replica exists, its description is returned along with an OK (200) status code. If the replica does not exist, an error is returned with an appropriate status code.",
+  "parameters": {
+    "api-version": "6.4-preview",
+    "applicationResourceName": "sampleApplication",
+    "serviceResourceName": "helloWorldService",
+    "replicaName": "0"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "osType": "Linux",
+        "codePackages": [
+          {
+            "name": "helloWorldCode",
+            "image": "seabreeze/sbz-helloworld:1.0-alpine",
+            "endpoints": [
+              {
+                "name": "helloWorldListener",
+                "port": 80
+              }
+            ],
+            "resources": {
+              "requests": {
+                "memoryInGB": 1,
+                "cpu": 1
+              }
+            },
+            "instanceView": {
+              "restartCount": 1,
+              "currentState": {
+                "state": "Running",
+                "exitCode": "0"
+              },
+              "previousState": {
+                "state": "NotSpecified",
+                "exitCode": "0"
+              }
+            }
+          }
+        ],
+        "networkRefs": [
+          {
+            "name": "sampleNetwork",
+            "endpointRefs": [
+              {
+                "name": "helloWorldListener"
+              }
+            ]
+          }
+        ],
+        "replicaName": "0"
+      }
+    }
+  }
+}
diff --git a/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/Resources/Applications/Services/Replicas/list.json b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/Resources/Applications/Services/Replicas/list.json
new file mode 100644
index 000000000000..1fe9b30fb836
--- /dev/null
+++ b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/Resources/Applications/Services/Replicas/list.json
@@ -0,0 +1,105 @@
+{
+  "operationId": "MeshServiceReplica_List",
+  "description": "This example shows how to list replicas of a service resources for a given application.",
+  "parameters": {
+    "api-version": "6.4-preview",
+    "applicationResourceName": "sampleApplication",
+    "serviceResourceName": "helloWorldService"
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": {
+        "ContinuationToken": "",
+        "Items": [
+          {
+            "osType": "Linux",
+            "codePackages": [
+              {
+                "name": "helloWorldCode",
+                "image": "seabreeze/sbz-helloworld:1.0-alpine",
+                "endpoints": [
+                  {
+                    "name": "helloWorldListener",
+                    "port": 80
+                  }
+                ],
+                "resources": {
+                  "requests": {
+                    "memoryInGB": 1,
+                    "cpu": 1
+                  }
+                },
+                "instanceView": {
+                  "restartCount": 1,
+                  "currentState": {
+                    "state": "Running",
+                    "exitCode": "0"
+                  },
+                  "previousState": {
+                    "state": "NotSpecified",
+                    "exitCode": "0"
+                  }
+                }
+              }
+            ],
+            "networkRefs": [
+              {
+                "name": "sampleNetwork",
+                "endpointRefs": [
+                  {
+                    "name": "helloWorldListener"
+                  }
+                ]
+              }
+            ],
+            "replicaName": "0"
+          },
+          {
+            "osType": "Linux",
+            "codePackages": [
+              {
+                "name": "helloWorldCode",
+                "image": "seabreeze/sbz-helloworld:1.0-alpine",
+                "endpoints": [
+                  {
+                    "name": "helloWorldListener",
+                    "port": 80
+                  }
+                ],
+                "resources": {
+                  "requests": {
+                    "memoryInGB": 1,
+                    "cpu": 1
+                  }
+                },
+                "instanceView": {
+                  "restartCount": 1,
+                  "currentState": {
+                    "state": "Running",
+                    "exitCode": "0"
+                  },
+                  "previousState": {
+                    "state": "NotSpecified",
+                    "exitCode": "0"
+                  }
+                }
+              }
+            ],
+            "networkRefs": [
+              {
+                "name": "sampleNetwork",
+                "endpointRefs": [
+                  {
+                    "name": "helloWorldListener"
+                  }
+                ]
+              }
+            ],
+            "replicaName": "1"
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/Resources/Applications/Services/get.json b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/Resources/Applications/Services/get.json
new file mode 100644
index 000000000000..45224d3a66f8
--- /dev/null
+++ b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/Resources/Applications/Services/get.json
@@ -0,0 +1,51 @@
+{
+  "operationId": "MeshService_Get",
+  "description": "This example shows how to get a service resource for a given application. If the service resource exists, its description is returned along with an OK (200) status code. If the service resource does not exist, an error is returned with an appropriate status code.",
+  "parameters": {
+    "api-version": "6.4-preview",
+    "applicationResourceName": "sampleApplication",
+    "serviceResourceName": "helloWorldService"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "name": "helloWorldService",
+        "properties": {
+          "osType": "Linux",
+          "codePackages": [
+            {
+              "name": "helloWorldCode",
+              "image": "seabreeze/sbz-helloworld:1.0-alpine",
+              "endpoints": [
+                {
+                  "name": "helloWorldListener",
+                  "port": 80
+                }
+              ],
+              "resources": {
+                "requests": {
+                  "memoryInGB": 1,
+                  "cpu": 1
+                }
+              }
+            }
+          ],
+          "networkRefs": [
+            {
+              "name": "sampleNetwork",
+              "endpointRefs": [
+                {
+                  "name": "helloWorldListener"
+                }
+              ]
+            }
+          ],
+          "description": "SeaBreeze Hello World Service.",
+          "replicaCount": 1,
+          "healthState": "Ok",
+          "status": "Ready"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/Resources/Applications/Services/list.json b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/Resources/Applications/Services/list.json
new file mode 100644
index 000000000000..3df5e396c764
--- /dev/null
+++ b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/Resources/Applications/Services/list.json
@@ -0,0 +1,56 @@
+{
+  "operationId": "MeshService_List",
+  "description": "This example shows how to list all service resources for a given application.",
+  "parameters": {
+    "api-version": "6.4-preview",
+    "applicationResourceName": "sampleApplication"
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": {
+        "ContinuationToken": "",
+        "Items": [
+          {
+            "name": "helloWorldService",
+            "properties": {
+              "osType": "Linux",
+              "codePackages": [
+                {
+                  "name": "helloWorldCode",
+                  "image": "seabreeze/sbz-helloworld:1.0-alpine",
+                  "endpoints": [
+                    {
+                      "name": "helloWorldListener",
+                      "port": 80
+                    }
+                  ],
+                  "resources": {
+                    "requests": {
+                      "memoryInGB": 1,
+                      "cpu": 1
+                    }
+                  }
+                }
+              ],
+              "networkRefs": [
+                {
+                  "name": "sampleNetwork",
+                  "endpointRefs": [
+                    {
+                      "name": "helloWorldListener"
+                    }
+                  ]
+                }
+              ],
+              "description": "SeaBreeze Hello World Service.",
+              "replicaCount": 1,
+              "healthState": "Ok",
+              "status": "Ready"
+            }
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/Resources/Applications/create_update.autoscale.json b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/Resources/Applications/create_update.autoscale.json
new file mode 100644
index 000000000000..16b621f6a572
--- /dev/null
+++ b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/Resources/Applications/create_update.autoscale.json
@@ -0,0 +1,102 @@
+{
+  "operationId": "MeshApplication_CreateOrUpdate",
+  "description": "This example shows how to create or update a application resource with services that autoscale based on the policies.",
+  "parameters": {
+    "api-version": "6.4-preview",
+    "applicationResourceName": "sampleApplication",
+    "applicationResourceDescription": {
+      "name": "sampleApplication",
+      "properties": {
+        "description": "Service Fabric Mesh sample application.",
+        "services": [
+          {
+            "name": "helloWorldService",
+            "properties": {
+              "description": "SeaBreeze Hello World Service.",
+              "osType": "Linux",
+              "codePackages": [
+                {
+                  "name": "helloWorldCode",
+                  "image": "seabreeze/sbz-helloworld:1.0-alpine",
+                  "endpoints": [
+                    {
+                      "name": "helloWorldListener",
+                      "port": 80
+                    }
+                  ],
+                  "resources": {
+                    "requests": {
+                      "memoryInGB": 1,
+                      "cpu": 1
+                    }
+                  }
+                }
+              ],
+              "replicaCount": 1,
+              "autoScalingPolicies": [
+                {
+                  "name": "MyAutoScaleRule",
+                  "trigger": {
+                    "kind": "AverageLoad",
+                    "metric": {
+                      "kind": "Resource",
+                      "name": "cpu"
+                    },
+                    "lowerLoadThreshold": 0.3,
+                    "upperLoadThreshold": 0.8,
+                    "scaleIntervalInSeconds": 3600
+                  },
+                  "mechanism": {
+                    "kind": "AddRemoveReplica",
+                    "minCount": 1,
+                    "maxCount": 4,
+                    "scaleIncrement": 1
+                  }
+                }
+              ],
+              "networkRefs": [
+                {
+                  "name": "sampleNetwork",
+                  "endpointRefs": [
+                    {
+                      "name": "helloWorldListener"
+                    }
+                  ]
+                }
+              ]
+            }
+          }
+        ]
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "name": "sampleApplication",
+        "properties": {
+          "description": "Service Fabric Mesh sample application.",
+          "serviceNames": [
+            "helloWorldService"
+          ],
+          "healthState": "Ok",
+          "status": "Ready"
+        }
+      }
+    },
+    "201": {
+      "body": {
+        "name": "sampleApplication",
+        "properties": {
+          "description": "Service Fabric Mesh sample application.",
+          "serviceNames": [
+            "helloWorldService"
+          ],
+          "healthState": "Unknown",
+          "status": "Creating"
+        }
+      }
+    },
+    "202": {}
+  }
+}
diff --git a/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/Resources/Applications/create_update.json b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/Resources/Applications/create_update.json
new file mode 100644
index 000000000000..8066c046fd00
--- /dev/null
+++ b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/Resources/Applications/create_update.json
@@ -0,0 +1,139 @@
+{
+  "operationId": "MeshApplication_CreateOrUpdate",
+  "description": "This example shows how to create or update a application resource.",
+  "parameters": {
+    "api-version": "6.4-preview",
+    "applicationResourceName": "sampleApplication",
+    "applicationResourceDescription": {
+      "name": "sampleApplication",
+      "properties": {
+        "description": "Service Fabric Mesh sample application.",
+        "services": [
+          {
+            "name": "helloWorldService",
+            "properties": {
+              "description": "SeaBreeze Hello World Service.",
+              "identityRefs": [
+                {
+                  "name": "ServiceIdentity1",
+                  "identityRef": "/subscriptions/c1089427-83d3-4286-9f35-5af546a6eb67/resourcegroups/myGroup/providers/Microsoft.Identity/Identities/identity1"
+                },
+                {
+                  "name": "ServiceIdentity2",
+                  "identityRef": "SystemAssigned"
+                }
+              ],
+              "osType": "Linux",
+              "codePackages": [
+                {
+                  "name": "helloWorldCode",
+                  "image": "seabreeze/sbz-helloworld:1.0-alpine",
+                  "endpoints": [
+                    {
+                      "name": "helloWorldListener",
+                      "port": 80
+                    }
+                  ],
+                  "resources": {
+                    "requests": {
+                      "memoryInGB": 1,
+                      "cpu": 1
+                    }
+                  }
+                }
+              ],
+              "replicaCount": 1,
+              "networkRefs": [
+                {
+                  "name": "sampleNetwork",
+                  "endpointRefs": [
+                    {
+                      "name": "helloWorldListener"
+                    }
+                  ]
+                }
+              ]
+            }
+          }
+        ]
+      }
+    },
+    "identity": {
+      "type": "SystemAssigned,UserAssigned",
+      "tokenServiceEndpoint": "http://tokenservice",
+      "tenantId": "D47A6CD5-E870-4ADF-8C00-1C0B758BC567",
+      "principalId": "84DFA616-1F44-4D63-BC08-43B5F758D16C",
+      "userAssignedIdentities": {
+        "/subscriptions/c1089427-83d3-4286-9f35-5af546a6eb67/resourcegroups/myGroup/providers/Microsoft.Identity/Identities/identity1": {
+          "clientId": "5287A675-78D2-4E49-BF09-D3BFE02493D4",
+          "principalId": "7D6F0B1C-AF9F-4E21-9B3C-AE22F4D926F8"
+        },
+        "/subscriptions/c1089427-83d3-4286-9f35-5af546a6eb67/resourcegroups/myGroup/providers/Microsoft.Identity/Identities/identity2": {
+          "clientId": "AF1509EC-9B5F-43CC-8A6F-FA7CC84AEBE1",
+          "principalId": "31144ACF-46F4-4639-A711-A257229EE0C0"
+        }
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "name": "sampleApplication",
+        "properties": {
+          "description": "Service Fabric Mesh sample application.",
+          "serviceNames": [
+            "helloWorldService"
+          ],
+          "healthState": "Ok",
+          "status": "Ready"
+        },
+        "identity": {
+          "type": "SystemAssigned,UserAssigned",
+          "tokenServiceEndpoint": "http://tokenservice",
+          "tenantId": "D47A6CD5-E870-4ADF-8C00-1C0B758BC567",
+          "principalId": "84DFA616-1F44-4D63-BC08-43B5F758D16C",
+          "userAssignedIdentities": {
+            "/subscriptions/c1089427-83d3-4286-9f35-5af546a6eb67/resourcegroups/myGroup/providers/Microsoft.Identity/Identities/identity1": {
+              "clientId": "5287A675-78D2-4E49-BF09-D3BFE02493D4",
+              "principalId": "7D6F0B1C-AF9F-4E21-9B3C-AE22F4D926F8"
+            },
+            "/subscriptions/c1089427-83d3-4286-9f35-5af546a6eb67/resourcegroups/myGroup/providers/Microsoft.Identity/Identities/identity2": {
+              "clientId": "AF1509EC-9B5F-43CC-8A6F-FA7CC84AEBE1",
+              "principalId": "31144ACF-46F4-4639-A711-A257229EE0C0"
+            }
+          }
+        }
+      }
+    },
+    "201": {
+      "body": {
+        "name": "sampleApplication",
+        "properties": {
+          "description": "Service Fabric Mesh sample application.",
+          "serviceNames": [
+            "helloWorldService"
+          ],
+          "healthState": "Unknown",
+          "status": "Creating"
+        },
+        "identity": {
+          "type": "SystemAssigned,UserAssigned",
+          "tokenServiceEndpoint": "http://tokenservice",
+          "tenantId": "D47A6CD5-E870-4ADF-8C00-1C0B758BC567",
+          "principalId": "84DFA616-1F44-4D63-BC08-43B5F758D16C",
+          "userAssignedIdentities": {
+            "/subscriptions/c1089427-83d3-4286-9f35-5af546a6eb67/resourcegroups/myGroup/providers/Microsoft.Identity/Identities/identity1": {
+              "clientId": "5287A675-78D2-4E49-BF09-D3BFE02493D4",
+              "principalId": "7D6F0B1C-AF9F-4E21-9B3C-AE22F4D926F8"
+            },
+            "/subscriptions/c1089427-83d3-4286-9f35-5af546a6eb67/resourcegroups/myGroup/providers/Microsoft.Identity/Identities/identity2": {
+              "clientId": "AF1509EC-9B5F-43CC-8A6F-FA7CC84AEBE1",
+              "principalId": "31144ACF-46F4-4639-A711-A257229EE0C0"
+            }
+          }
+        }
+      }
+    },
+    "202": {}
+  }
+}
diff --git a/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/Resources/Applications/delete.json b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/Resources/Applications/delete.json
new file mode 100644
index 000000000000..b51511b0865d
--- /dev/null
+++ b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/Resources/Applications/delete.json
@@ -0,0 +1,13 @@
+{
+  "operationId": "MeshApplication_Delete",
+  "description": "This example shows how to delete an existing application resource. If the application resource exists and is deleted successfully, an empty response with 200 status code is returned. If the application resource does not exist, an empty response with 204 status code is returned.",
+  "parameters": {
+    "api-version": "6.4-preview",
+    "applicationResourceName": "sampleApplication"
+  },
+  "responses": {
+    "200": {},
+    "202": {},
+    "204": {}
+  }
+}
diff --git a/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/Resources/Applications/get.json b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/Resources/Applications/get.json
new file mode 100644
index 000000000000..208ccd280bbd
--- /dev/null
+++ b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/Resources/Applications/get.json
@@ -0,0 +1,39 @@
+{
+  "operationId": "MeshApplication_Get",
+  "description": "This example shows how to get a application resource. If the application resource exists, its description is returned along with an OK (200) status code. If the application resource does not exist, an error is returned with an appropriate status code.",
+  "parameters": {
+    "api-version": "6.4-preview",
+    "applicationResourceName": "sampleApplication"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "name": "sampleApplication",
+        "properties": {
+          "description": "Service Fabric Mesh sample application.",
+          "serviceNames": [
+            "helloWorldService"
+          ],
+          "healthState": "Ok",
+          "status": "Ready"
+        },
+        "identity": {
+          "type": "SystemAssigned,UserAssigned",
+          "tokenServiceEndpoint": "http://tokenservice",
+          "tenantId": "D47A6CD5-E870-4ADF-8C00-1C0B758BC567",
+          "principalId": "84DFA616-1F44-4D63-BC08-43B5F758D16C",
+          "userAssignedIdentities": {
+            "/subscriptions/c1089427-83d3-4286-9f35-5af546a6eb67/resourcegroups/myGroup/providers/Microsoft.Identity/Identities/identity1": {
+              "clientId": "5287A675-78D2-4E49-BF09-D3BFE02493D4",
+              "principalId": "7D6F0B1C-AF9F-4E21-9B3C-AE22F4D926F8"
+            },
+            "/subscriptions/c1089427-83d3-4286-9f35-5af546a6eb67/resourcegroups/myGroup/providers/Microsoft.Identity/Identities/identity2": {
+              "clientId": "AF1509EC-9B5F-43CC-8A6F-FA7CC84AEBE1",
+              "principalId": "31144ACF-46F4-4639-A711-A257229EE0C0"
+            }
+          }
+        }
+      }
+    }
+  }
+}
diff --git a/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/Resources/Applications/get_upgrade.json b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/Resources/Applications/get_upgrade.json
new file mode 100644
index 000000000000..61be95fa11b7
--- /dev/null
+++ b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/Resources/Applications/get_upgrade.json
@@ -0,0 +1,30 @@
+{
+  "operationId": "MeshApplication_GetUpgradeProgress",
+  "description": "This example shows how to get a application resource upgrade. If the application resource exists, its description is returned along with an OK (200) status code. If the application resource does not exist, an error is returned with an appropriate status code.",
+  "parameters": {
+    "api-version": "6.4-preview",
+    "applicationResourceName": "sampleApplication"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "Name": "sampleApplication",
+        "TargetApplicationTypeVersion": "v1",
+        "StartTimestampUtc": "0001-01-01T00:00:00.000Z",
+        "UpgradeState": "RollingForward",
+        "PercentCompleted": "0",
+        "ServiceUpgradeProgress": [
+          {
+            "ServiceName": "helloWorldService",
+            "CompletedReplicaCount": "0",
+            "PendingReplicaCount": "3"
+          }
+        ],
+        "RollingUpgradeMode": "Monitored",
+        "UpgradeDuration": "PT0H0M2.31669S",
+        "ApplicationUpgradeStatusDetails": "Deployment upgrading from version: v0 to version: v1.",
+        "UpgradeReplicaSetCheckTimeoutInSeconds": 4294967295
+      }
+    }
+  }
+}
diff --git a/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/Resources/Applications/list.json b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/Resources/Applications/list.json
new file mode 100644
index 000000000000..2f34f40e3488
--- /dev/null
+++ b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/Resources/Applications/list.json
@@ -0,0 +1,44 @@
+{
+  "operationId": "MeshApplication_List",
+  "description": "This example shows how to list all application resources.",
+  "parameters": {
+    "api-version": "6.4-preview"
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": {
+        "ContinuationToken": "",
+        "Items": [
+          {
+            "name": "sampleApplication",
+            "properties": {
+              "description": "Service Fabric Mesh sample application.",
+              "serviceNames": [
+                "helloWorldService"
+              ],
+              "healthState": "Ok",
+              "status": "Ready"
+            },
+            "identity": {
+              "type": "SystemAssigned,UserAssigned",
+              "tokenServiceEndpoint": "http://tokenservice",
+              "tenantId": "D47A6CD5-E870-4ADF-8C00-1C0B758BC567",
+              "principalId": "84DFA616-1F44-4D63-BC08-43B5F758D16C",
+              "userAssignedIdentities": {
+                "/subscriptions/c1089427-83d3-4286-9f35-5af546a6eb67/resourcegroups/myGroup/providers/Microsoft.Identity/Identities/identity1": {
+                  "clientId": "5287A675-78D2-4E49-BF09-D3BFE02493D4",
+                  "principalId": "7D6F0B1C-AF9F-4E21-9B3C-AE22F4D926F8"
+                },
+                "/subscriptions/c1089427-83d3-4286-9f35-5af546a6eb67/resourcegroups/myGroup/providers/Microsoft.Identity/Identities/identity2": {
+                  "clientId": "AF1509EC-9B5F-43CC-8A6F-FA7CC84AEBE1",
+                  "principalId": "31144ACF-46F4-4639-A711-A257229EE0C0"
+                }
+              }
+            }
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/Resources/Gateways/create_update.json b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/Resources/Gateways/create_update.json
new file mode 100644
index 000000000000..2ded194ec7cc
--- /dev/null
+++ b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/Resources/Gateways/create_update.json
@@ -0,0 +1,193 @@
+{
+  "operationId": "MeshGateway_CreateOrUpdate",
+  "description": "This example shows how to create or update a gateway resource.",
+  "parameters": {
+    "api-version": "6.4-preview",
+    "gatewayResourceName": "sampleGateway",
+    "gatewayResourceDescription": {
+      "name": "sampleGateway",
+      "properties": {
+        "description": "Service Fabric Mesh sample gateway.",
+        "sourceNetwork": {
+          "name": "Open"
+        },
+        "destinationNetwork": {
+          "name": "helloWorldNetwork"
+        },
+        "tcp": [
+          {
+            "name": "web",
+            "port": 80,
+            "destination": {
+              "applicationName": "helloWorldApp",
+              "serviceName": "helloWorldService",
+              "endpointName": "helloWorldListener"
+            }
+          }
+        ],
+        "http": [
+          {
+            "name": "contosoWebsite",
+            "port": 8081,
+            "hosts": [
+              {
+                "name": "contoso.com",
+                "routes": [
+                  {
+                    "name": "index",
+                    "match": {
+                      "path": {
+                        "value": "/index",
+                        "rewrite": "/",
+                        "type": "prefix"
+                      },
+                      "headers": [
+                        {
+                          "name": "accept",
+                          "value": "application/json",
+                          "type": "exact"
+                        }
+                      ]
+                    },
+                    "destination": {
+                      "applicationName": "httpHelloWorldApp",
+                      "serviceName": "indexService",
+                      "endpointName": "indexHttpEndpoint"
+                    }
+                  }
+                ]
+              }
+            ]
+          }
+        ]
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "name": "sampleGateway",
+        "properties": {
+          "description": "Service Fabric Mesh sample gateway.",
+          "sourceNetwork": {
+            "name": "Open"
+          },
+          "destinationNetwork": {
+            "name": "helloWorldNetwork"
+          },
+          "tcp": [
+            {
+              "name": "web",
+              "port": 80,
+              "destination": {
+                "applicationName": "helloWorldApp",
+                "serviceName": "helloWorldService",
+                "endpointName": "helloWorldListener"
+              }
+            }
+          ],
+          "http": [
+            {
+              "name": "contosoWebsite",
+              "port": 8081,
+              "hosts": [
+                {
+                  "name": "contoso.com",
+                  "routes": [
+                    {
+                      "name": "index",
+                      "match": {
+                        "path": {
+                          "value": "/index",
+                          "rewrite": "/",
+                          "type": "prefix"
+                        },
+                        "headers": [
+                          {
+                            "name": "accept",
+                            "value": "application/json",
+                            "type": "exact"
+                          }
+                        ]
+                      },
+                      "destination": {
+                        "applicationName": "httpHelloWorldApp",
+                        "serviceName": "indexService",
+                        "endpointName": "indexHttpEndpoint"
+                      }
+                    }
+                  ]
+                }
+              ]
+            }
+          ],
+          "status": "Ready",
+          "ipAddress": "192.168.1.1"
+        }
+      }
+    },
+    "201": {
+      "body": {
+        "name": "sampleGateway",
+        "properties": {
+          "description": "Service Fabric Mesh Hello World sample gateway.",
+          "sourceNetwork": {
+            "name": "Open"
+          },
+          "destinationNetwork": {
+            "name": "helloWorldNetwork"
+          },
+          "tcp": [
+            {
+              "name": "web",
+              "port": 80,
+              "destination": {
+                "applicationName": "helloWorldApp",
+                "serviceName": "helloWorldService",
+                "endpointName": "helloWorldListener"
+              }
+            }
+          ],
+          "http": [
+            {
+              "name": "contosoWebsite",
+              "port": 8081,
+              "hosts": [
+                {
+                  "name": "contoso.com",
+                  "routes": [
+                    {
+                      "name": "index",
+                      "match": {
+                        "path": {
+                          "value": "/index",
+                          "rewrite": "/",
+                          "type": "prefix"
+                        },
+                        "headers": [
+                          {
+                            "name": "accept",
+                            "value": "application/json",
+                            "type": "exact"
+                          }
+                        ]
+                      },
+                      "destination": {
+                        "applicationName": "httpHelloWorldApp",
+                        "serviceName": "indexService",
+                        "endpointName": "indexHttpEndpoint"
+                      }
+                    }
+                  ]
+                }
+              ]
+            }
+          ],
+          "status": "Creating",
+          "ipAddress": ""
+        }
+      }
+    },
+    "202": {}
+  }
+}
diff --git a/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/Resources/Gateways/delete.json b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/Resources/Gateways/delete.json
new file mode 100644
index 000000000000..63ed69926752
--- /dev/null
+++ b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/Resources/Gateways/delete.json
@@ -0,0 +1,13 @@
+{
+  "operationId": "MeshGateway_Delete",
+  "description": "This example shows how to delete an existing gateway resource. If the gateway resource exists and is deleted successfully, an empty response with 200 status code is returned. If the gateway resource does not exist, an empty response with 204 status code is returned.",
+  "parameters": {
+    "api-version": "6.4-preview",
+    "gatewayResourceName": "sampleGateway"
+  },
+  "responses": {
+    "200": {},
+    "202": {},
+    "204": {}
+  }
+}
diff --git a/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/Resources/Gateways/get.json b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/Resources/Gateways/get.json
new file mode 100644
index 000000000000..c85b652cbc45
--- /dev/null
+++ b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/Resources/Gateways/get.json
@@ -0,0 +1,72 @@
+{
+  "operationId": "MeshGateway_Get",
+  "description": "This example shows how to get a gateway resource. If the gateway resource exists, its description is returned along with an OK (200) status code. If the gateway resource does not exist, an error is returned with an appropriate status code.",
+  "parameters": {
+    "api-version": "6.4-preview",
+    "gatewayResourceName": "sampleGateway"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "name": "sampleGateway",
+        "properties": {
+          "description": "Service Fabric Mesh sample gateway.",
+          "sourceNetwork": {
+            "name": "Open"
+          },
+          "destinationNetwork": {
+            "name": "helloWorldNetwork"
+          },
+          "tcp": [
+            {
+              "name": "web",
+              "port": 80,
+              "destination": {
+                "applicationName": "helloWorldApp",
+                "serviceName": "helloWorldService",
+                "endpointName": "helloWorldListener"
+              }
+            }
+          ],
+          "http": [
+            {
+              "name": "contosoWebsite",
+              "port": 8081,
+              "hosts": [
+                {
+                  "name": "contoso.com",
+                  "routes": [
+                    {
+                      "name": "index",
+                      "match": {
+                        "path": {
+                          "value": "/index",
+                          "rewrite": "/",
+                          "type": "prefix"
+                        },
+                        "headers": [
+                          {
+                            "name": "accept",
+                            "value": "application/json",
+                            "type": "exact"
+                          }
+                        ]
+                      },
+                      "destination": {
+                        "applicationName": "httpHelloWorldApp",
+                        "serviceName": "indexService",
+                        "endpointName": "indexHttpEndpoint"
+                      }
+                    }
+                  ]
+                }
+              ]
+            }
+          ],
+          "status": "Ready",
+          "ipAddress": "192.168.1.1"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/Resources/Gateways/list.json b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/Resources/Gateways/list.json
new file mode 100644
index 000000000000..5ad53b7d580f
--- /dev/null
+++ b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/Resources/Gateways/list.json
@@ -0,0 +1,77 @@
+{
+  "operationId": "MeshGateway_List",
+  "description": "This example shows how to list all gateway resources.",
+  "parameters": {
+    "api-version": "6.4-preview"
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": {
+        "ContinuationToken": "",
+        "Items": [
+          {
+            "name": "sampleGateway",
+            "properties": {
+              "description": "Service Fabric Mesh sample gateway.",
+              "sourceNetwork": {
+                "name": "Open"
+              },
+              "destinationNetwork": {
+                "name": "helloWorldNetwork"
+              },
+              "tcp": [
+                {
+                  "name": "web",
+                  "port": 80,
+                  "destination": {
+                    "applicationName": "helloWorldApp",
+                    "serviceName": "helloWorldService",
+                    "endpointName": "helloWorldListener"
+                  }
+                }
+              ],
+              "http": [
+                {
+                  "name": "contosoWebsite",
+                  "port": 8081,
+                  "hosts": [
+                    {
+                      "name": "contoso.com",
+                      "routes": [
+                        {
+                          "name": "index",
+                          "match": {
+                            "path": {
+                              "value": "/index",
+                              "rewrite": "/",
+                              "type": "prefix"
+                            },
+                            "headers": [
+                              {
+                                "name": "accept",
+                                "value": "application/json",
+                                "type": "exact"
+                              }
+                            ]
+                          },
+                          "destination": {
+                            "applicationName": "httpHelloWorldApp",
+                            "serviceName": "indexService",
+                            "endpointName": "indexHttpEndpoint"
+                          }
+                        }
+                      ]
+                    }
+                  ]
+                }
+              ],
+              "status": "Ready",
+              "ipAddress": "192.168.1.1"
+            }
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/Resources/Networks/create_update.json b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/Resources/Networks/create_update.json
new file mode 100644
index 000000000000..faf2a3960b48
--- /dev/null
+++ b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/Resources/Networks/create_update.json
@@ -0,0 +1,41 @@
+{
+  "operationId": "MeshNetwork_CreateOrUpdate",
+  "description": "This example shows how to create or update a network resource.",
+  "parameters": {
+    "api-version": "6.4-preview",
+    "networkResourceName": "sampleNetwork",
+    "networkResourceDescription": {
+      "name": "sampleNetwork",
+      "properties": {
+        "kind": "Local",
+        "description": "Service Fabric Mesh sample network.",
+        "networkAddressPrefix": "2.0.0.0/16"
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "name": "sampleNetwork",
+        "properties": {
+          "kind": "Local",
+          "description": "Service Fabric Mesh sample network.",
+          "networkAddressPrefix": "2.0.0.0/16",
+          "status": "Ready"
+        }
+      }
+    },
+    "201": {
+      "body": {
+        "name": "sampleNetwork",
+        "properties": {
+          "kind": "Local",
+          "description": "Service Fabric Mesh sample network.",
+          "networkAddressPrefix": "2.0.0.0/16",
+          "status": "Creating"
+        }
+      }
+    },
+    "202": {}
+  }
+}
diff --git a/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/Resources/Networks/delete.json b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/Resources/Networks/delete.json
new file mode 100644
index 000000000000..aea2170b7316
--- /dev/null
+++ b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/Resources/Networks/delete.json
@@ -0,0 +1,13 @@
+{
+  "operationId": "MeshGateway_Delete",
+  "description": "This example shows how to delete an existing network resource. If the network resource exists and is deleted successfully, an empty response with 200 status code is returned. If the network resource does not exist, an empty response with 204 status code is returned.",
+  "parameters": {
+    "api-version": "6.4-preview",
+    "networkResourceName": "sampleNetwork"
+  },
+  "responses": {
+    "200": {},
+    "202": {},
+    "204": {}
+  }
+}
diff --git a/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/Resources/Networks/get.json b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/Resources/Networks/get.json
new file mode 100644
index 000000000000..1afaee298e7d
--- /dev/null
+++ b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/Resources/Networks/get.json
@@ -0,0 +1,21 @@
+{
+  "operationId": "MeshGateway_Get",
+  "description": "This example shows how to get a network resource. If the network resource exists, its description is returned along with an OK (200) status code. If the network resource does not exist, an error is returned with an appropriate status code.",
+  "parameters": {
+    "api-version": "6.4-preview",
+    "networkResourceName": "sampleNetwork"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "name": "sampleNetwork",
+        "properties": {
+          "kind": "Local",
+          "description": "Service Fabric Mesh sample network.",
+          "networkAddressPrefix": "2.0.0.0/16",
+          "status": "Ready"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/Resources/Networks/list.json b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/Resources/Networks/list.json
new file mode 100644
index 000000000000..6cf521d8582c
--- /dev/null
+++ b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/Resources/Networks/list.json
@@ -0,0 +1,26 @@
+{
+  "operationId": "MeshGateway_List",
+  "description": "This example shows how to list all network resources.",
+  "parameters": {
+    "api-version": "6.4-preview"
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": {
+        "ContinuationToken": "",
+        "Items": [
+          {
+            "name": "sampleNetwork",
+            "properties": {
+              "kind": "Local",
+              "description": "Service Fabric Mesh sample network.",
+              "networkAddressPrefix": "2.0.0.0/16",
+              "status": "Ready"
+            }
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/Resources/Secrets/create_update.json b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/Resources/Secrets/create_update.json
new file mode 100644
index 000000000000..aab0125db5a5
--- /dev/null
+++ b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/Resources/Secrets/create_update.json
@@ -0,0 +1,41 @@
+{
+  "operationId": "MeshSecret_CreateOrUpdate",
+  "description": "This example shows how to create or update a secret resource.",
+  "parameters": {
+    "api-version": "6.4-preview",
+    "secretResourceName": "dbConnectionString",
+    "secretResourceDescription": {
+      "name": "dbConnectionString",
+      "properties": {
+        "kind": "inlinedValue",
+        "contentType": "text/plain",
+        "description": "Mongo DB connection string for backend database!"
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "name": "dbConnectionString",
+        "properties": {
+          "kind": "inlinedValue",
+          "contentType": "text/plain",
+          "description": "Mongo DB connection string for backend database!",
+          "status": "Ready"
+        }
+      }
+    },
+    "201": {
+      "body": {
+        "name": "dbConnectionString",
+        "properties": {
+          "kind": "inlinedValue",
+          "contentType": "text/plain",
+          "description": "Mongo DB connection string for backend database!",
+          "status": "Creating"
+        }
+      }
+    },
+    "202": {}
+  }
+}
diff --git a/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/Resources/Secrets/delete.json b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/Resources/Secrets/delete.json
new file mode 100644
index 000000000000..ffe68fd3ddc7
--- /dev/null
+++ b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/Resources/Secrets/delete.json
@@ -0,0 +1,13 @@
+{
+  "operationId": "MeshSecret_Delete",
+  "description": "This example shows how to delete an existing secret resource. If the secret resource exists and is deleted successfully, an empty response with 200 status code is returned. If the secret resource does not exist, an empty response with 204 status code is returned.",
+  "parameters": {
+    "api-version": "6.4-preview",
+    "secretResourceName": "dbConnectionString"
+  },
+  "responses": {
+    "200": {},
+    "202": {},
+    "204": {}
+  }
+}
diff --git a/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/Resources/Secrets/get.json b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/Resources/Secrets/get.json
new file mode 100644
index 000000000000..f358e51722dd
--- /dev/null
+++ b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/Resources/Secrets/get.json
@@ -0,0 +1,21 @@
+{
+  "operationId": "MeshSecret_Get",
+  "description": "This example shows how to get a secret resource. If the secret resource exists, its description is returned along with an OK (200) status code. If the secret resource does not exist, an error is returned with an appropriate status code.",
+  "parameters": {
+    "api-version": "6.4-preview",
+    "secretResourceName": "dbConnectionString"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "name": "dbConnectionString",
+        "properties": {
+          "kind": "inlinedValue",
+          "contentType": "text/plain",
+          "description": "Mongo DB connection string for backend database!",
+          "status": "Ready"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/Resources/Secrets/list.json b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/Resources/Secrets/list.json
new file mode 100644
index 000000000000..b46d7f8ff341
--- /dev/null
+++ b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/Resources/Secrets/list.json
@@ -0,0 +1,35 @@
+{
+  "operationId": "MeshSecret_List",
+  "description": "This example shows how to list all secret resources.",
+  "parameters": {
+    "api-version": "6.4-preview"
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": {
+        "ContinuationToken": "",
+        "Items": [
+          {
+            "name": "dbConnectionString",
+            "properties": {
+              "kind": "inlinedValue",
+              "contentType": "text/plain",
+              "description": "Mongo DB connection string for backend database!",
+              "status": "Ready"
+            }
+          },
+          {
+            "name": "contosoServiceApiKey",
+            "properties": {
+              "kind": "inlinedValue",
+              "contentType": "text/plain",
+              "description": "API Key to access contoso service APIs",
+              "status": "Ready"
+            }
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/Resources/Secrets/values/create.json b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/Resources/Secrets/values/create.json
new file mode 100644
index 000000000000..8cd0824452fd
--- /dev/null
+++ b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/Resources/Secrets/values/create.json
@@ -0,0 +1,34 @@
+{
+  "operationId": "MeshSecretValue_AddValue",
+  "description": "This example shows how to add a new value of a secret resource; the secret value is provided as plaintext.",
+  "parameters": {
+    "api-version": "6.4-preview",
+    "secretResourceName": "dbConnectionString",
+    "secretValueResourceName": "v1",
+    "secretValueResourceDescription": {
+      "name": "v1",
+      "properties": {
+        "value": "mongodb://contoso123:0Fc3IolnL12312asdfawejunASDF@asdfYXX2t8a97kghVcUzcDv98hawelufhawefafnoQRGwNj2nMPL1Y9qsIr9Srdw==@contoso123.documents.azure.com:10255/mydatabase?ssl=true"
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "name": "v1",
+        "properties": {
+          "value": null
+        }
+      }
+    },
+    "201": {
+      "body": {
+        "name": "v1",
+        "properties": {
+          "value": null
+        }
+      }
+    },
+    "202": {}
+  }
+}
diff --git a/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/Resources/Secrets/values/delete.json b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/Resources/Secrets/values/delete.json
new file mode 100644
index 000000000000..ad4b3ef9540b
--- /dev/null
+++ b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/Resources/Secrets/values/delete.json
@@ -0,0 +1,14 @@
+{
+  "operationId": "MeshSecretValue_Delete",
+  "description": "This example shows how to delete a secret value. If the specified named value exists and is deleted successfully, an empty response with 200 status code is returned. If the specified named value does not exist, an empty response with 204 status code is returned.",
+  "parameters": {
+    "api-version": "6.4-preview",
+    "secretResourceName": "dbConnectionString",
+    "secretValueResourceName": "v1"
+  },
+  "responses": {
+    "200": {},
+    "202": {},
+    "204": {}
+  }
+}
diff --git a/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/Resources/Secrets/values/get.json b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/Resources/Secrets/values/get.json
new file mode 100644
index 000000000000..a6491634ef44
--- /dev/null
+++ b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/Resources/Secrets/values/get.json
@@ -0,0 +1,19 @@
+{
+  "operationId": "MeshSecretValue_Get",
+  "description": "This example shows how to get the specified secret value resource. If the specified named value exists, its information is returned along with status code 200. The information does not include the value. To get the unecnrypted value use ListMeshSecretValue operation. If the specified named value does not exist, an error is returned with an appropriate status code.",
+  "parameters": {
+    "api-version": "6.4-preview",
+    "secretResourceName": "dbConnectionString",
+    "secretValueResourceName": "v1"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "name": "v1",
+        "properties": {
+          "value": null
+        }
+      }
+    }
+  }
+}
diff --git a/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/Resources/Secrets/values/list.json b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/Resources/Secrets/values/list.json
new file mode 100644
index 000000000000..0610d6d83c48
--- /dev/null
+++ b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/Resources/Secrets/values/list.json
@@ -0,0 +1,29 @@
+{
+  "operationId": "MeshSecretValue_List",
+  "description": "This example shows how to list names of all values of a secret resource, not including their respective values.",
+  "parameters": {
+    "api-version": "6.4-preview",
+    "secretResourceName": "dbConnectionString"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "ContinuationToken": "",
+        "Items": [
+          {
+            "name": "v1",
+            "properties": {
+              "value": null
+            }
+          },
+          {
+            "name": "v2",
+            "properties": {
+              "value": null
+            }
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/Resources/Secrets/values/list_value.json b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/Resources/Secrets/values/list_value.json
new file mode 100644
index 000000000000..b8d09ce2e23c
--- /dev/null
+++ b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/Resources/Secrets/values/list_value.json
@@ -0,0 +1,16 @@
+{
+  "operationId": "MeshSecretValue_Show",
+  "description": "This example shows how to get the unencrypted value of the secret. If the specified named value resource exists, its unencrypted value is returned along with status code 200. If the specified named value does not exist, an error is returned with an appropriate status code.",
+  "parameters": {
+    "api-version": "6.4-preview",
+    "secretResourceName": "dbConnectionString",
+    "secretValueResourceName": "v1"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": "mongodb://contoso123:0Fc3IolnL12312asdfawejunASDF@asdfYXX2t8a97kghVcUzcDv98hawelufhawefafnoQRGwNj2nMPL1Y9qsIr9Srdw==@contoso123.documents.azure.com:10255/mydatabase?ssl=true"
+      }
+    }
+  }
+}
diff --git a/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/Resources/Volumes/create_update.json b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/Resources/Volumes/create_update.json
new file mode 100644
index 000000000000..ba2623cdc556
--- /dev/null
+++ b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/Resources/Volumes/create_update.json
@@ -0,0 +1,53 @@
+{
+  "operationId": "MeshVolume_CreateOrUpdate",
+  "description": "This example shows how to create or update a volume resource.",
+  "parameters": {
+    "api-version": "6.4-preview",
+    "volumeResourceName": "sampleVolume",
+    "volumeResourceDescription": {
+      "name": "sampleVolume",
+      "properties": {
+        "description": "Service Fabric Mesh sample volume.",
+        "provider": "SFAzureFile",
+        "azureFileParameters": {
+          "accountName": "sbzdemoaccount",
+          "accountKey": "provide-account-key-here",
+          "shareName": "sharel"
+        }
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "name": "sampleVolume",
+        "properties": {
+          "description": "Service Fabric Mesh sample volume.",
+          "provider": "SFAzureFile",
+          "azureFileParameters": {
+            "accountName": "sbzdemoaccount",
+            "accountKey": null,
+            "shareName": "sharel"
+          },
+          "status": "Ready"
+        }
+      }
+    },
+    "201": {
+      "body": {
+        "name": "sampleVolume",
+        "properties": {
+          "description": "Service Fabric Mesh Hello World sample volume.",
+          "provider": "SFAzureFile",
+          "azureFileParameters": {
+            "accountName": "sbzdemoaccount",
+            "accountKey": null,
+            "shareName": "sharel"
+          },
+          "status": "Creating"
+        }
+      }
+    },
+    "202": {}
+  }
+}
diff --git a/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/Resources/Volumes/delete.json b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/Resources/Volumes/delete.json
new file mode 100644
index 000000000000..efaa1f836ae1
--- /dev/null
+++ b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/Resources/Volumes/delete.json
@@ -0,0 +1,13 @@
+{
+  "operationId": "MeshVolume_Delete",
+  "description": "This example shows how to delete an existing volume resource. If the volume resource exists and is deleted successfully, an empty response with 200 status code is returned. If the volume resource does not exist, an empty response with 204 status code is returned.",
+  "parameters": {
+    "api-version": "6.4-preview",
+    "volumeResourceName": "sampleVolume"
+  },
+  "responses": {
+    "200": {},
+    "202": {},
+    "204": {}
+  }
+}
diff --git a/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/Resources/Volumes/get.json b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/Resources/Volumes/get.json
new file mode 100644
index 000000000000..9d08f3b00a82
--- /dev/null
+++ b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/Resources/Volumes/get.json
@@ -0,0 +1,25 @@
+{
+  "operationId": "MeshVolume_Get",
+  "description": "This example shows how to get a volume resource. If the volume resource exists, its description is returned along with an OK (200) status code. If the volume resource does not exist, an error is returned with an appropriate status code.",
+  "parameters": {
+    "api-version": "6.4-preview",
+    "volumeResourceName": "sampleVolume"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "name": "sampleVolume",
+        "properties": {
+          "description": "Service Fabric Mesh sample volume.",
+          "provider": "SFAzureFile",
+          "azureFileParameters": {
+            "accountName": "sbzdemoaccount",
+            "accountKey": null,
+            "shareName": "sharel"
+          },
+          "status": "Ready"
+        }
+      }
+    }
+  }
+}
diff --git a/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/Resources/Volumes/list.json b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/Resources/Volumes/list.json
new file mode 100644
index 000000000000..3bf83798904b
--- /dev/null
+++ b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/Resources/Volumes/list.json
@@ -0,0 +1,30 @@
+{
+  "operationId": "MeshVolume_List",
+  "description": "This example shows how to list all volume resources.",
+  "parameters": {
+    "api-version": "6.4-preview"
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": {
+        "ContinuationToken": "",
+        "Items": [
+          {
+            "name": "sampleVolume",
+            "properties": {
+              "description": "Service Fabric Mesh sample volume.",
+              "provider": "SFAzureFile",
+              "azureFileParameters": {
+                "accountName": "sbzdemoaccount",
+                "accountKey": null,
+                "shareName": "sharel"
+              },
+              "status": "Ready"
+            }
+          }
+        ]
+      }
+    }
+  }
+}
diff --git a/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/RestorePartition.json b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/RestorePartition.json
new file mode 100644
index 000000000000..1e97e0557113
--- /dev/null
+++ b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/RestorePartition.json
@@ -0,0 +1,20 @@
+{
+  "operationId": "RestorePartition",
+  "description": "This example shows how to trigger restore of a partition now by specifying the backup to be used to restore.",
+  "parameters": {
+    "api-version": "6.4",
+    "partitionId": "1daae3f5-7fd6-42e9-b1ba-8c05f873994d",
+    "RestorePartitionDescription": {
+      "BackupId": "3a056ac9-7206-43c3-8424-6f6103003eba",
+      "BackupStorage": {
+        "StorageKind": "AzureBlobStore",
+        "ConnectionString": "DefaultEndpointsProtocol=https;AccountName=storagesample;AccountKey=<PutYourAccountKeyHere>",
+        "ContainerName": "BackupContainer"
+      },
+      "BackupLocation": "CalcApp\\CalcService\\1daae3f5-7fd6-42e9-b1ba-8c05f873994d\\2018-01-01 09.00.55.zip"
+    }
+  },
+  "responses": {
+    "202": {}
+  }
+}
diff --git a/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/ResumeApplicationBackup.json b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/ResumeApplicationBackup.json
new file mode 100644
index 000000000000..b25a7ac545ec
--- /dev/null
+++ b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/ResumeApplicationBackup.json
@@ -0,0 +1,11 @@
+{
+  "operationId": "ResumeApplicationBackup",
+  "description": "This example shows how to resume periodic backup for a stateful application which was previously suspended.",
+  "parameters": {
+    "api-version": "6.4",
+    "applicationId": "CalcApp"
+  },
+  "responses": {
+    "202": {}
+  }
+}
diff --git a/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/ResumePartitionBackup.json b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/ResumePartitionBackup.json
new file mode 100644
index 000000000000..feb701118438
--- /dev/null
+++ b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/ResumePartitionBackup.json
@@ -0,0 +1,11 @@
+{
+  "operationId": "ResumePartitionBackup",
+  "description": "This example shows how to resume periodic backup for a stateful partition which was previously suspended.",
+  "parameters": {
+    "api-version": "6.4",
+    "partitionId": "1daae3f5-7fd6-42e9-b1ba-8c05f873994d"
+  },
+  "responses": {
+    "202": {}
+  }
+}
diff --git a/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/ResumeServiceBackup.json b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/ResumeServiceBackup.json
new file mode 100644
index 000000000000..9037dfa23d9e
--- /dev/null
+++ b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/ResumeServiceBackup.json
@@ -0,0 +1,11 @@
+{
+  "operationId": "ResumeServiceBackup",
+  "description": "This example shows how to resume periodic backup for a stateful service which was previously suspended.",
+  "parameters": {
+    "api-version": "6.4",
+    "serviceId": "CalcApp/CalcService"
+  },
+  "responses": {
+    "202": {}
+  }
+}
diff --git a/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/StartApplicationUpgrade-1.json b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/StartApplicationUpgrade-1.json
new file mode 100644
index 000000000000..fd0317e28196
--- /dev/null
+++ b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/StartApplicationUpgrade-1.json
@@ -0,0 +1,30 @@
+{
+  "operationId": "StartApplicationUpgrade",
+  "description": "This example shows how to start upgrading an application in a Service Fabric cluster.",
+  "parameters": {
+    "api-version": "6.0",
+    "applicationId": "samples~CalculatorApp",
+    "ApplicationUpgradeDescription": {
+      "Name": "fabric:/samples/CalculatorApp",
+      "TargetApplicationTypeVersion": "2.0",
+      "Parameters": [
+        {
+          "Key": "CalculatorAppParameter1",
+          "Value": "314"
+        },
+        {
+          "Key": "CalculatorAppParameter2",
+          "Value": "271"
+        }
+      ],
+      "UpgradeKind": "Rolling",
+      "RollingUpgradeMode": "Monitored",
+      "MonitoringPolicy": {
+        "FailureAction": "Rollback"
+      }
+    }
+  },
+  "responses": {
+    "200": {}
+  }
+}
diff --git a/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/StartClusterConfigurationUpgrade-1.json b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/StartClusterConfigurationUpgrade-1.json
new file mode 100644
index 000000000000..2f8fd59a474e
--- /dev/null
+++ b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/StartClusterConfigurationUpgrade-1.json
@@ -0,0 +1,40 @@
+{
+  "operationId": "StartClusterConfigurationUpgrade",
+  "description": "This example shows how to start upgrading the configuration of a Service Fabric standalone cluster.",
+  "parameters": {
+    "api-version": "6.0",
+    "nameId": "samples/apps/CalculatorApp",
+    "ClusterConfigurationUpgradeDescription": {
+      "ClusterConfig": "<PutYourClusterConfigHere>",
+      "ApplicationHealthPolicies": {
+        "ApplicationHealthPolicyMap": [
+          {
+            "Key": "fabric:/samples/CalculatorApp",
+            "Value": {
+              "ConsiderWarningAsError": true,
+              "MaxPercentUnhealthyDeployedApplications": 10,
+              "DefaultServiceTypeHealthPolicy": {
+                "MaxPercentUnhealthyPartitionsPerService": 0,
+                "MaxPercentUnhealthyReplicasPerPartition": 0,
+                "MaxPercentUnhealthyServices": 0
+              },
+              "ServiceTypeHealthPolicyMap": [
+                {
+                  "Key": "Svc1Type",
+                  "Value": {
+                    "MaxPercentUnhealthyPartitionsPerService": 0,
+                    "MaxPercentUnhealthyReplicasPerPartition": 0,
+                    "MaxPercentUnhealthyServices": 10
+                  }
+                }
+              ]
+            }
+          }
+        ]
+      }
+    }
+  },
+  "responses": {
+    "202": {}
+  }
+}
diff --git a/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/SubmitPropertyBatch-1.json b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/SubmitPropertyBatch-1.json
new file mode 100644
index 000000000000..05410c96edc2
--- /dev/null
+++ b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/SubmitPropertyBatch-1.json
@@ -0,0 +1,71 @@
+{
+  "operationId": "SubmitPropertyBatch",
+  "description": "This example shows how to submit a property batch. This batch ensures that a property exists, checks that the property has the expected sequence number, and edits the property only if the previous conditions succeed. It then performs a get operation to get the property's current info. \r\n If all of the operations succeed, the batch is committed in a transactional manner and a success response is returned with 200 status code. \r\n If the batch fails then a failed response is returned with 409 status code. The failed response below shows batch failure because the property does not have expected sequence number.",
+  "parameters": {
+    "api-version": "6.0",
+    "nameId": "samples/apps",
+    "PropertyBatchDescriptionList": {
+      "Operations": [
+        {
+          "Kind": "CheckExists",
+          "PropertyName": "PersistentQueueAppData",
+          "Exists": true
+        },
+        {
+          "Kind": "CheckSequence",
+          "PropertyName": "PersistentQueueAppData",
+          "SequenceNumber": "12"
+        },
+        {
+          "Kind": "Put",
+          "PropertyName": "PersistentQueueAppData",
+          "Value": {
+            "Kind": "Binary",
+            "Data": [
+              1,
+              2,
+              3,
+              4,
+              5
+            ]
+          },
+          "CustomTypeId": "InitializationData"
+        },
+        {
+          "Kind": "Get",
+          "PropertyName": "PersistentQueueAppData",
+          "IncludeValue": false
+        }
+      ]
+    }
+  },
+  "responses": {
+    "200": {
+      "headers": {},
+      "body": {
+        "Kind": "Successful",
+        "Properties": {
+          "3": {
+            "Name": "PersistentQueueAppData",
+            "Metadata": {
+              "TypeId": "Binary",
+              "CustomTypeId": "InitializationData",
+              "Parent": "fabric:/samples/apps",
+              "SizeInBytes": 5,
+              "LastModifiedUtcTimestamp": "2017-07-17T05:01:19.049Z",
+              "SequenceNumber": "13"
+            }
+          }
+        }
+      }
+    },
+    "409": {
+      "headers": {},
+      "body": {
+        "Kind": "Failed",
+        "ErrorMessage": "FABRIC_E_PROPERTY_CHECK_FAILED",
+        "OperationIndex": 1
+      }
+    }
+  }
+}
diff --git a/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/SuspendApplicationBackup.json b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/SuspendApplicationBackup.json
new file mode 100644
index 000000000000..75bdad71a95e
--- /dev/null
+++ b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/SuspendApplicationBackup.json
@@ -0,0 +1,11 @@
+{
+  "operationId": "SuspendApplicationBackup",
+  "description": "This example shows how to suspend backup for a stateful application which is configured for periodic backup.",
+  "parameters": {
+    "api-version": "6.4",
+    "applicationId": "CalcApp"
+  },
+  "responses": {
+    "202": {}
+  }
+}
diff --git a/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/SuspendPartitionBackup.json b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/SuspendPartitionBackup.json
new file mode 100644
index 000000000000..b14619dd6fe8
--- /dev/null
+++ b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/SuspendPartitionBackup.json
@@ -0,0 +1,11 @@
+{
+  "operationId": "SuspendPartitionBackup",
+  "description": "This example shows how to suspend backup for a stateful partition which is configured for periodic backup.",
+  "parameters": {
+    "api-version": "6.4",
+    "partitionId": "1daae3f5-7fd6-42e9-b1ba-8c05f873994d"
+  },
+  "responses": {
+    "202": {}
+  }
+}
diff --git a/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/SuspendServiceBackup.json b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/SuspendServiceBackup.json
new file mode 100644
index 000000000000..14d0575c509e
--- /dev/null
+++ b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/SuspendServiceBackup.json
@@ -0,0 +1,11 @@
+{
+  "operationId": "SuspendServiceBackup",
+  "description": "This example shows how to suspend backup for a stateful service which is configured for periodic backup.",
+  "parameters": {
+    "api-version": "6.4",
+    "serviceId": "CalcApp/CalcService"
+  },
+  "responses": {
+    "202": {}
+  }
+}
diff --git a/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/UpdateBackupPolicy.json b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/UpdateBackupPolicy.json
new file mode 100644
index 000000000000..3129817ddb68
--- /dev/null
+++ b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/UpdateBackupPolicy.json
@@ -0,0 +1,35 @@
+{
+  "operationId": "UpdateBackupPolicy",
+  "description": "This example shows how to update the schedule of a backup policy to take backup twice everyday at 9 AM and 5 PM UTC which shall get deleted after 30 days, with Azure blob store as the backup location.",
+  "parameters": {
+    "api-version": "6.4",
+    "backupPolicyName": "DailyAzureBackupPolicy",
+    "BackupPolicyDescription": {
+      "Name": "DailyAzureBackupPolicy",
+      "AutoRestoreOnDataLoss": false,
+      "MaxIncrementalBackups": 3,
+      "Schedule": {
+        "ScheduleKind": "TimeBased",
+        "ScheduleFrequencyType": "Daily",
+        "RunTimes": [
+          "0001-01-01T09:00:00Z",
+          "0001-01-01T17:00:00Z"
+        ]
+      },
+      "Storage": {
+        "StorageKind": "AzureBlobStore",
+        "FriendlyName": "Azure_storagesample",
+        "ConnectionString": "DefaultEndpointsProtocol=https;AccountName=storagesample;AccountKey=<PutYourAccountKeyHere>",
+        "ContainerName": "BackupContainer"
+      },
+      "RetentionPolicy": {
+        "RetentionPolicyType": "Basic",
+        "MinimumNumberOfBackups": 60,
+        "RetentionDuration": "P30D"
+      }
+    }
+  },
+  "responses": {
+    "200": {}
+  }
+}
diff --git a/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/UpdateService-1.json b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/UpdateService-1.json
new file mode 100644
index 000000000000..3dd7f5950427
--- /dev/null
+++ b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/UpdateService-1.json
@@ -0,0 +1,34 @@
+{
+  "operationId": "UpdateService",
+  "description": "This example shows how to update placement and load balancing related settings of a stateless Service Fabric service.",
+  "parameters": {
+    "serviceId": "test~test1",
+    "api-version": "6.0",
+    "ServiceUpdateDescription": {
+      "ServiceKind": "Stateless",
+      "Flags": "1568",
+      "PlacementConstraints": "Color==Red",
+      "DefaultMoveCost": "High",
+      "ScalingPolicies": [
+        {
+          "ScalingTrigger": {
+            "Kind": "AveragePartitionLoad",
+            "MetricName": "servicefabric:/_CpuCores",
+            "LowerLoadThreshold": "0.500000",
+            "UpperLoadThreshold": "0.800000",
+            "ScaleIntervalInSeconds": 900
+          },
+          "ScalingMechanism": {
+            "Kind": "PartitionInstanceCount",
+            "MinInstanceCount": 4,
+            "MaxInstanceCount": 6,
+            "ScaleIncrement": 2
+          }
+        }
+      ]
+    }
+  },
+  "responses": {
+    "200": {}
+  }
+}
diff --git a/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/UpdateService-2.json b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/UpdateService-2.json
new file mode 100644
index 000000000000..cdb1368dbdd6
--- /dev/null
+++ b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/examples/UpdateService-2.json
@@ -0,0 +1,17 @@
+{
+  "operationId": "UpdateService",
+  "description": "This example shows how to update placement and load balancing related settings of a stateful Service Fabric service.",
+  "parameters": {
+    "serviceId": "test~test2",
+    "api-version": "6.0",
+    "ServiceUpdateDescription": {
+      "ServiceKind": "Stateful",
+      "Flags": "40",
+      "PlacementConstraints": "Color==Green",
+      "StandByReplicaKeepDurationSeconds": "1000"
+    }
+  },
+  "responses": {
+    "200": {}
+  }
+}
diff --git a/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/servicefabric.json b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/servicefabric.json
new file mode 100644
index 000000000000..86206e48e15d
--- /dev/null
+++ b/specification/servicefabric/data-plane/Microsoft.ServiceFabric/stable/7.2/servicefabric.json
@@ -0,0 +1,28687 @@
+{
+  "swagger": "2.0",
+  "info": {
+    "title": "Service Fabric Client APIs",
+    "description": "Service Fabric REST Client APIs allows management of Service Fabric clusters, applications and services.",
+    "version": "7.2.0.46"
+  },
+  "host": "localhost:19080",
+  "schemes": [
+    "http",
+    "https"
+  ],
+  "produces": [
+    "application/json"
+  ],
+  "paths": {
+    "/$/GetClusterManifest": {
+      "get": {
+        "operationId": "GetClusterManifest",
+        "summary": "Get the Service Fabric cluster manifest.",
+        "description": "Get the Service Fabric cluster manifest. The cluster manifest contains properties of the cluster that include different node types on the cluster,\nsecurity configurations, fault, and upgrade domain topologies, etc.\n\nThese properties are specified as part of the ClusterConfig.JSON file while deploying a stand-alone cluster. However, most of the information in the cluster manifest\nis generated internally by service fabric during cluster deployment in other deployment scenarios (e.g. when using Azure portal).\n\nThe contents of the cluster manifest are for informational purposes only and users are not expected to take a dependency on the format of the file contents or its interpretation.",
+        "tags": [
+          "Cluster"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-0_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "A successful operation will return 200 status code and the requested cluster manifest information.",
+            "schema": {
+              "$ref": "#/definitions/ClusterManifest"
+            }
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/$/GetClusterHealth": {
+      "get": {
+        "operationId": "GetClusterHealth",
+        "summary": "Gets the health of a Service Fabric cluster.",
+        "description": "Use EventsHealthStateFilter to filter the collection of health events reported on the cluster based on the health state.\nSimilarly, use NodesHealthStateFilter and ApplicationsHealthStateFilter to filter the collection of nodes and applications returned based on their aggregated health state.",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-0_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/NodesHealthStateFilterOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/ApplicationsHealthStateFilterOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/EventsHealthStateFilterOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/ExcludeHealthStatisticsOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/IncludeSystemApplicationHealthStatisticsOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "tags": [
+          "Cluster"
+        ],
+        "responses": {
+          "200": {
+            "description": "A successful operation will return 200 status code and the requested cluster health information.",
+            "schema": {
+              "$ref": "#/definitions/ClusterHealth"
+            }
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      },
+      "post": {
+        "operationId": "GetClusterHealthUsingPolicy",
+        "summary": "Gets the health of a Service Fabric cluster using the specified policy.",
+        "description": "Use EventsHealthStateFilter to filter the collection of health events reported on the cluster based on the health state.\nSimilarly, use NodesHealthStateFilter and ApplicationsHealthStateFilter to filter the collection of nodes and applications returned based on their aggregated health state.\nUse ClusterHealthPolicies to override the health policies used to evaluate the health.",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-0_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/NodesHealthStateFilterOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/ApplicationsHealthStateFilterOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/EventsHealthStateFilterOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/ExcludeHealthStatisticsOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/IncludeSystemApplicationHealthStatisticsOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/ClusterHealthPoliciesOptionalBodyParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "tags": [
+          "Cluster"
+        ],
+        "responses": {
+          "200": {
+            "description": "A successful operation will return 200 status code and the requested cluster health information.",
+            "schema": {
+              "$ref": "#/definitions/ClusterHealth"
+            }
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/$/GetClusterHealthChunk": {
+      "get": {
+        "operationId": "GetClusterHealthChunk",
+        "summary": "Gets the health of a Service Fabric cluster using health chunks.",
+        "description": "Gets the health of a Service Fabric cluster using health chunks. Includes the aggregated health state of the cluster, but none of the cluster entities.\nTo expand the cluster health and get the health state of all or some of the entities, use the POST URI and specify the cluster health chunk query description.",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-0_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "tags": [
+          "Cluster"
+        ],
+        "responses": {
+          "200": {
+            "description": "A successful operation will return 200 status code and the requested cluster health chunk information.",
+            "schema": {
+              "$ref": "#/definitions/ClusterHealthChunk"
+            }
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      },
+      "post": {
+        "operationId": "GetClusterHealthChunkUsingPolicyAndAdvancedFilters",
+        "summary": "Gets the health of a Service Fabric cluster using health chunks.",
+        "description": "Gets the health of a Service Fabric cluster using health chunks. The health evaluation is done based on the input cluster health chunk query description.\nThe query description allows users to specify health policies for evaluating the cluster and its children.\nUsers can specify very flexible filters to select which cluster entities to return. The selection can be done based on the entities health state and based on the hierarchy.\nThe query can return multi-level children of the entities based on the specified filters. For example, it can return one application with a specified name, and for this application, return\nonly services that are in Error or Warning, and all partitions and replicas for one of these services.",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-0_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/ClusterHealthChunkQueryDescriptionOptionalBodyParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "tags": [
+          "Cluster"
+        ],
+        "responses": {
+          "200": {
+            "description": "A successful operation will return 200 status code and the requested cluster health chunk information.",
+            "schema": {
+              "$ref": "#/definitions/ClusterHealthChunk"
+            }
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/$/ReportClusterHealth": {
+      "post": {
+        "operationId": "ReportClusterHealth",
+        "summary": "Sends a health report on the Service Fabric cluster.",
+        "description": "Sends a health report on a Service Fabric cluster. The report must contain the information about the source of the health report and property on which it is reported.\nThe report is sent to a Service Fabric gateway node, which forwards to the health store.\nThe report may be accepted by the gateway, but rejected by the health store after extra validation.\nFor example, the health store may reject the report because of an invalid parameter, like a stale sequence number.\nTo see whether the report was applied in the health store, run GetClusterHealth and check that the report appears in the HealthEvents section.",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-0_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/HealthInformationRequiredBodyParam"
+          },
+          {
+            "$ref": "#/parameters/ImmediateOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "tags": [
+          "Cluster"
+        ],
+        "responses": {
+          "200": {
+            "description": "A successful operation will return 200 status code when the cluster health report is accepted for processing."
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/$/GetProvisionedCodeVersions": {
+      "get": {
+        "operationId": "GetProvisionedFabricCodeVersionInfoList",
+        "summary": "Gets a list of fabric code versions that are provisioned in a Service Fabric cluster.",
+        "description": "Gets a list of information about fabric code versions that are provisioned in the cluster. The parameter CodeVersion can be used to optionally filter the output to only that particular version.",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-0_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/CodeVersionOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "tags": [
+          "Cluster"
+        ],
+        "responses": {
+          "200": {
+            "description": "A successful operation will return 200 status code and the requested provisioned code versions information.",
+            "schema": {
+              "$ref": "#/definitions/FabricCodeVersionInfoList"
+            }
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/$/GetProvisionedConfigVersions": {
+      "get": {
+        "operationId": "GetProvisionedFabricConfigVersionInfoList",
+        "summary": "Gets a list of fabric config versions that are provisioned in a Service Fabric cluster.",
+        "description": "Gets a list of information about fabric config versions that are provisioned in the cluster. The parameter ConfigVersion can be used to optionally filter the output to only that particular version.",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-0_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/ConfigVersionOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "tags": [
+          "Cluster"
+        ],
+        "responses": {
+          "200": {
+            "description": "A successful operation will return 200 status code and the requested provisioned config versions information.",
+            "schema": {
+              "$ref": "#/definitions/FabricConfigVersionInfoList"
+            }
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/$/GetUpgradeProgress": {
+      "get": {
+        "operationId": "GetClusterUpgradeProgress",
+        "summary": "Gets the progress of the current cluster upgrade.",
+        "description": "Gets the current progress of the ongoing cluster upgrade. If no upgrade is currently in progress, get the last state of the previous cluster upgrade.",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-0_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "tags": [
+          "Cluster"
+        ],
+        "responses": {
+          "200": {
+            "description": "A successful operation will return 200 status code and the requested cluster upgrade progress.",
+            "schema": {
+              "$ref": "#/definitions/ClusterUpgradeProgressObject"
+            }
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/$/GetClusterConfiguration": {
+      "get": {
+        "operationId": "GetClusterConfiguration",
+        "summary": "Get the Service Fabric standalone cluster configuration.",
+        "description": "The cluster configuration contains properties of the cluster that include different node types on the cluster,\nsecurity configurations, fault, and upgrade domain topologies, etc.",
+        "tags": [
+          "Cluster"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-0_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/ConfigurationApiVersionRequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "A successful operation will return 200 status code and the requested cluster configuration information.",
+            "schema": {
+              "$ref": "#/definitions/ClusterConfiguration"
+            }
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/$/GetClusterConfigurationUpgradeStatus": {
+      "get": {
+        "operationId": "GetClusterConfigurationUpgradeStatus",
+        "summary": "Get the cluster configuration upgrade status of a Service Fabric standalone cluster.",
+        "description": "Get the cluster configuration upgrade status details of a Service Fabric standalone cluster.",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-0_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "tags": [
+          "Cluster"
+        ],
+        "responses": {
+          "200": {
+            "description": "A successful operation will return 200 status code and the requested cluster configuration upgrade status.",
+            "schema": {
+              "$ref": "#/definitions/ClusterConfigurationUpgradeStatusInfo"
+            }
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/$/GetUpgradeOrchestrationServiceState": {
+      "get": {
+        "operationId": "GetUpgradeOrchestrationServiceState",
+        "summary": "Get the service state of Service Fabric Upgrade Orchestration Service.",
+        "description": "Get the service state of Service Fabric Upgrade Orchestration Service. This API is internally used for support purposes.",
+        "tags": [
+          "Cluster"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-0_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "A successful operation will return 200 status code and the requested service state of Service Fabric Upgrade Orchestration Service.",
+            "schema": {
+              "$ref": "#/definitions/UpgradeOrchestrationServiceState"
+            }
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/$/SetUpgradeOrchestrationServiceState": {
+      "post": {
+        "operationId": "SetUpgradeOrchestrationServiceState",
+        "summary": "Update the service state of Service Fabric Upgrade Orchestration Service.",
+        "description": "Update the service state of Service Fabric Upgrade Orchestration Service. This API is internally used for support purposes.",
+        "tags": [
+          "Cluster"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-0_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/UpgradeOrchestrationServiceStateRequiredBodyParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "A successful response means that the service state of Service Fabric Upgrade Orchestration Service has been updated.",
+            "schema": {
+              "$ref": "#/definitions/UpgradeOrchestrationServiceStateSummary"
+            }
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/$/Provision": {
+      "post": {
+        "summary": "Provision the code or configuration packages of a Service Fabric cluster.",
+        "description": "Validate and provision the code or configuration packages of a Service Fabric cluster.",
+        "operationId": "ProvisionCluster",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-0_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/ProvisionFabricDescriptionRequiredBodyParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "tags": [
+          "Cluster"
+        ],
+        "responses": {
+          "200": {
+            "description": "A successful response means that the code or configuration packages have been provisioned."
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/$/Unprovision": {
+      "post": {
+        "summary": "Unprovision the code or configuration packages of a Service Fabric cluster.",
+        "description": "It is supported to unprovision code and configuration separately.",
+        "operationId": "UnprovisionCluster",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-0_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/UnprovisionFabricDescriptionRequiredBodyParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "tags": [
+          "Cluster"
+        ],
+        "responses": {
+          "200": {
+            "description": "A successful response means that the code or configuration packages have been unprovisioned."
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/$/RollbackUpgrade": {
+      "post": {
+        "summary": "Roll back the upgrade of a Service Fabric cluster.",
+        "description": "Roll back the code or configuration upgrade of a Service Fabric cluster.",
+        "operationId": "RollbackClusterUpgrade",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-0_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "tags": [
+          "Cluster"
+        ],
+        "responses": {
+          "202": {
+            "description": "A successful response means that the rollback of a cluster upgrade has been initiated."
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/$/MoveToNextUpgradeDomain": {
+      "post": {
+        "summary": "Make the cluster upgrade move on to the next upgrade domain.",
+        "description": "Make the cluster code or configuration upgrade move on to the next upgrade domain if appropriate.",
+        "operationId": "ResumeClusterUpgrade",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-0_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/ResumeClusterUpgradeDescriptionRequiredBodyParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "tags": [
+          "Cluster"
+        ],
+        "responses": {
+          "200": {
+            "description": "A successful response means that the cluster upgrade has moved on to the next upgrade domain."
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/$/Upgrade": {
+      "post": {
+        "summary": "Start upgrading the code or configuration version of a Service Fabric cluster.",
+        "description": "Validate the supplied upgrade parameters and start upgrading the code or configuration version of a Service Fabric cluster if the parameters are valid.",
+        "operationId": "StartClusterUpgrade",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-0_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/StartClusterUpgradeDescriptionRequiredBodyParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "tags": [
+          "Cluster"
+        ],
+        "responses": {
+          "202": {
+            "description": "A successful response means that the cluster code or configuration upgrade has started. Use GetUpgradeProgress operation to get the status of the upgrade."
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/$/StartClusterConfigurationUpgrade": {
+      "post": {
+        "summary": "Start upgrading the configuration of a Service Fabric standalone cluster.",
+        "description": "Validate the supplied configuration upgrade parameters and start upgrading the cluster configuration if the parameters are valid.",
+        "operationId": "StartClusterConfigurationUpgrade",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-0_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/ClusterConfigurationUpgradeDescriptionRequiredBodyParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "tags": [
+          "Cluster"
+        ],
+        "x-ms-examples": {
+          "Start upgrading the configuration of a Service Fabric standalone cluster": {
+            "$ref": "./examples/StartClusterConfigurationUpgrade-1.json"
+          }
+        },
+        "responses": {
+          "202": {
+            "description": "A successful response means that the cluster configuration upgrade has started. Use GetClusterConfigurationUpgradeStatus operation to get the status of the upgrade."
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/$/UpdateUpgrade": {
+      "post": {
+        "operationId": "UpdateClusterUpgrade",
+        "summary": "Update the upgrade parameters of a Service Fabric cluster upgrade.",
+        "description": "Update the upgrade parameters used during a Service Fabric cluster upgrade.",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-0_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/UpdateClusterUpgradeDescriptionRequiredBodyParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "tags": [
+          "Cluster"
+        ],
+        "responses": {
+          "200": {
+            "description": "A successful operation returns 200 status code."
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/$/GetAadMetadata": {
+      "get": {
+        "operationId": "GetAadMetadata",
+        "summary": "Gets the Azure Active Directory metadata used for secured connection to cluster.",
+        "description": "Gets the Azure Active Directory metadata used for secured connection to cluster.\nThis API is not supposed to be called separately. It provides information needed to set up an Azure Active Directory secured connection with a Service Fabric cluster.",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-0_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "schemes": [
+          "https"
+        ],
+        "tags": [
+          "Cluster"
+        ],
+        "responses": {
+          "200": {
+            "description": "A successful operation will return 200 status code and the Azure Active Directory metadata.",
+            "schema": {
+              "$ref": "#/definitions/AadMetadataObject"
+            }
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/$/GetClusterVersion": {
+      "get": {
+        "operationId": "GetClusterVersion",
+        "summary": "Get the current Service Fabric cluster version.",
+        "description": "If a cluster upgrade is happening, then this API will return the lowest (older) version of the current and target cluster runtime versions.",
+        "tags": [
+          "Cluster"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-4_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "x-ms-examples": {
+          "Get cluster version": {
+            "$ref": "./examples/GetClusterVersion-1.json"
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "A successful operation will return 200 status code and the requested cluster version information.",
+            "schema": {
+              "$ref": "#/definitions/ClusterVersion"
+            }
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/$/GetLoadInformation": {
+      "get": {
+        "operationId": "GetClusterLoad",
+        "summary": "Gets the load of a Service Fabric cluster.",
+        "description": "Retrieves the load information of a Service Fabric cluster for all the metrics that have load or capacity defined.",
+        "tags": [
+          "Cluster"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-0_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "A successful operation will return 200 status code and the requested cluster load information.",
+            "schema": {
+              "$ref": "#/definitions/ClusterLoadInfo"
+            }
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/$/ToggleVerboseServicePlacementHealthReporting": {
+      "post": {
+        "operationId": "ToggleVerboseServicePlacementHealthReporting",
+        "summary": "Changes the verbosity of service placement health reporting.",
+        "description": "If verbosity is set to true, then detailed health reports will be generated when replicas cannot be placed or dropped.\nIf verbosity is set to false, then no health reports will be generated when replicas cannot be placed or dropped.",
+        "tags": [
+          "Cluster"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-4_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/VerboseServicePlacementHealthReportingParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "A successful response means that the verbosity of service placement health reporting was updated."
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/Nodes": {
+      "get": {
+        "summary": "Gets the list of nodes in the Service Fabric cluster.",
+        "description": "The response includes the name, status, ID, health, uptime, and other details about the nodes.",
+        "operationId": "GetNodeInfoList",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-3_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/ContinuationTokenOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/NodeStatusFilterOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/MaxResultsOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "tags": [
+          "Node"
+        ],
+        "x-ms-examples": {
+          "Get information about all nodes": {
+            "$ref": "./examples/GetNodeInfoList.json"
+          },
+          "Limit maximum results": {
+            "$ref": "./examples/GetNodeInfoList-1.json"
+          },
+          "Page using continuation token": {
+            "$ref": "./examples/GetNodeInfoList-2.json"
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "List of nodes in the cluster.",
+            "schema": {
+              "$ref": "#/definitions/PagedNodeInfoList"
+            }
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/Nodes/{nodeName}": {
+      "get": {
+        "summary": "Gets the information about a specific node in the Service Fabric cluster.",
+        "description": "The response includes the name, status, ID, health, uptime, and other details about the node.",
+        "operationId": "GetNodeInfo",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-0_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/NodeNameRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "tags": [
+          "Node"
+        ],
+        "x-ms-examples": {
+          "Get a specific node by node name": {
+            "$ref": "./examples/GetNodeInfo-1.json"
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "A successful operation will return information about the node with the specified nodeName.",
+            "schema": {
+              "$ref": "#/definitions/NodeInfo"
+            }
+          },
+          "204": {
+            "description": "An empty response is returned if the specified nodeName is not found."
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/Nodes/{nodeName}/$/GetHealth": {
+      "get": {
+        "operationId": "GetNodeHealth",
+        "summary": "Gets the health of a Service Fabric node.",
+        "description": "Gets the health of a Service Fabric node. Use EventsHealthStateFilter to filter the collection of health events reported on the node based on the health state. If the node that you specify by name does not exist in the health store, this returns an error.",
+        "tags": [
+          "Node"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-0_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/NodeNameRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/EventsHealthStateFilterOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "A successful operation will return 200 status code and the requested node health information.",
+            "schema": {
+              "$ref": "#/definitions/NodeHealth"
+            }
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      },
+      "post": {
+        "operationId": "GetNodeHealthUsingPolicy",
+        "summary": "Gets the health of a Service Fabric node, by using the specified health policy.",
+        "description": "Gets the health of a Service Fabric node. Use EventsHealthStateFilter to filter the collection of health events reported on the node based on the health state. Use ClusterHealthPolicy in the POST body to override the health policies used to evaluate the health. If the node that you specify by name does not exist in the health store, this returns an error.",
+        "tags": [
+          "Node"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-0_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/NodeNameRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/EventsHealthStateFilterOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/ClusterHealthPolicyOptionalBodyParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "A successful operation will return 200 status code and the requested node health information.",
+            "schema": {
+              "$ref": "#/definitions/NodeHealth"
+            }
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/Nodes/{nodeName}/$/ReportHealth": {
+      "post": {
+        "operationId": "ReportNodeHealth",
+        "summary": "Sends a health report on the Service Fabric node.",
+        "description": "Reports health state of the specified Service Fabric node. The report must contain the information about the source of the health report and property on which it is reported.\nThe report is sent to a Service Fabric gateway node, which forwards to the health store.\nThe report may be accepted by the gateway, but rejected by the health store after extra validation.\nFor example, the health store may reject the report because of an invalid parameter, like a stale sequence number.\nTo see whether the report was applied in the health store, run GetNodeHealth and check that the report appears in the HealthEvents section.",
+        "tags": [
+          "Node"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-0_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/NodeNameRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/HealthInformationRequiredBodyParam"
+          },
+          {
+            "$ref": "#/parameters/ImmediateOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "A successful operation will return 200 status code."
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/Nodes/{nodeName}/$/GetLoadInformation": {
+      "get": {
+        "operationId": "GetNodeLoadInfo",
+        "summary": "Gets the load information of a Service Fabric node.",
+        "description": "Retrieves the load information of a Service Fabric node for all the metrics that have load or capacity defined.",
+        "tags": [
+          "Node"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-0_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/NodeNameRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "A successful operation will return 200 status code and the requested node load information.",
+            "schema": {
+              "$ref": "#/definitions/NodeLoadInfo"
+            }
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/Nodes/{nodeName}/$/Deactivate": {
+      "post": {
+        "operationId": "DisableNode",
+        "summary": "Deactivate a Service Fabric cluster node with the specified deactivation intent.",
+        "description": "Deactivate a Service Fabric cluster node with the specified deactivation intent. Once the deactivation is in progress, the deactivation intent can be increased, but not decreased (for example, a node that is deactivated with the Pause intent can be deactivated further with Restart, but not the other way around. Nodes may be reactivated using the Activate a node operation any time after they are deactivated. If the deactivation is not complete, this will cancel the deactivation. A node that goes down and comes back up while deactivated will still need to be reactivated before services will be placed on that node.",
+        "tags": [
+          "Node"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-0_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/NodeNameRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/DeactivationIntentDescriptionRequiredBodyParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "A successful operation will return 200 status code."
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/Nodes/{nodeName}/$/Activate": {
+      "post": {
+        "operationId": "EnableNode",
+        "summary": "Activate a Service Fabric cluster node that is currently deactivated.",
+        "description": "Activates a Service Fabric cluster node that is currently deactivated. Once activated, the node will again become a viable target for placing new replicas, and any deactivated replicas remaining on the node will be reactivated.",
+        "tags": [
+          "Node"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-0_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/NodeNameRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "A successful operation will return 200 status code."
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/Nodes/{nodeName}/$/RemoveNodeState": {
+      "post": {
+        "operationId": "RemoveNodeState",
+        "summary": "Notifies Service Fabric that the persisted state on a node has been permanently removed or lost.",
+        "description": "This implies that it is not possible to recover the persisted state of that node. This generally happens if a hard disk has been wiped clean, or if a hard disk crashes. The node has to be down for this operation to be successful. This operation lets Service Fabric know that the replicas on that node no longer exist, and that Service Fabric should stop waiting for those replicas to come back up. Do not run this cmdlet if the state on the node has not been removed and the node can come back up with its state intact. Starting from Service Fabric 6.5, in order to use this API for seed nodes, please change the seed nodes to regular (non-seed) nodes and then invoke this API to remove the node state. If the cluster is running on Azure, after the seed node goes down, Service Fabric will try to change it to a non-seed node automatically. To make this happen, make sure the number of non-seed nodes in the primary node type is no less than the number of Down seed nodes. If necessary, add more nodes to the primary node type to achieve this. For standalone cluster, if the Down seed node is not expected to come back up with its state intact, please remove the node from the cluster, see https://docs.microsoft.com/azure/service-fabric/service-fabric-cluster-windows-server-add-remove-nodes",
+        "tags": [
+          "Node"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-0_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/NodeNameRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "A successful operation will return 200 status code."
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/Nodes/{nodeName}/$/Restart": {
+      "post": {
+        "operationId": "RestartNode",
+        "summary": "Restarts a Service Fabric cluster node.",
+        "description": "Restarts a Service Fabric cluster node that is already started.",
+        "tags": [
+          "Node"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-0_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/NodeNameRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/RestartNodeDescriptionRequiredBodyParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "A successful operation will return 200 status code. A successful operation means that the restart command was received by the node and it is in the process of restarting. Check the status of the node by calling GetNode operation."
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/Nodes/{nodeName}/$/RemoveConfigurationOverrides": {
+      "delete": {
+        "operationId": "RemoveConfigurationOverrides",
+        "summary": "Removes configuration overrides on the specified node.",
+        "description": "This api allows removing all existing configuration overrides on specified node.",
+        "tags": [
+          "Node"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_7-0_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/NodeNameRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "A successful operation will return 200 status code."
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/Nodes/{nodeName}/$/GetConfigurationOverrides": {
+      "get": {
+        "operationId": "GetConfigurationOverrides",
+        "summary": "Gets the list of configuration overrides on the specified node.",
+        "description": "This api allows getting all existing configuration overrides on the specified node.",
+        "tags": [
+          "Node"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_7-0_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/NodeNameRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "List of configuration overrides on the node.",
+            "schema": {
+              "$ref": "#/definitions/ConfigParameterOverrideList"
+            }
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/Nodes/{nodeName}/$/AddConfigurationParameterOverrides": {
+      "post": {
+        "operationId": "AddConfigurationParameterOverrides",
+        "summary": "Adds the list of configuration overrides on the specified node.",
+        "description": "This api allows adding all existing configuration overrides on the specified node.",
+        "tags": [
+          "Node"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_7-0_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/NodeNameRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/ConfigurationOverrideListRequiredParam"
+          },
+          {
+            "$ref": "#/parameters/ForceConfigurationOverrideOptionalParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "A successful operation will return 200 status code."
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/ApplicationTypes": {
+      "get": {
+        "summary": "Gets the list of application types in the Service Fabric cluster.",
+        "description": "Returns the information about the application types that are provisioned or in the process of being provisioned in the Service Fabric cluster. Each version of an application type is returned as one application type. The response includes the name, version, status, and other details about the application type. This is a paged query, meaning that if not all of the application types fit in a page, one page of results is returned as well as a continuation token, which can be used to get the next page. For example, if there are 10 application types but a page only fits the first three application types, or if max results is set to 3, then three is returned. To access the rest of the results, retrieve subsequent pages by using the returned continuation token in the next query. An empty continuation token is returned if there are no subsequent pages.",
+        "operationId": "GetApplicationTypeInfoList",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-0_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/ApplicationTypeDefinitionKindFilterOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/ExcludeApplicationParametersOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/ContinuationTokenOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/MaxResultsOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "x-ms-examples": {
+          "Limit maximum results": {
+            "$ref": "./examples/GetApplicationTypeInfoList-1.json"
+          },
+          "Page using continuation token": {
+            "$ref": "./examples/GetApplicationTypeInfoList-2.json"
+          },
+          "Exclude application parameters from the result": {
+            "$ref": "./examples/GetApplicationTypeInfoList-3.json"
+          }
+        },
+        "tags": [
+          "ApplicationType"
+        ],
+        "responses": {
+          "200": {
+            "description": "List of application types in the cluster.",
+            "schema": {
+              "$ref": "#/definitions/PagedApplicationTypeInfoList"
+            }
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/ApplicationTypes/{applicationTypeName}": {
+      "get": {
+        "summary": "Gets the list of application types in the Service Fabric cluster matching exactly the specified name.",
+        "description": "Returns the information about the application types that are provisioned or in the process of being provisioned in the Service Fabric cluster. These results are of application types whose name match exactly the one specified as the parameter, and which comply with the given query parameters. All versions of the application type matching the application type name are returned, with each version returned as one application type. The response includes the name, version, status, and other details about the application type. This is a paged query, meaning that if not all of the application types fit in a page, one page of results is returned as well as a continuation token, which can be used to get the next page. For example, if there are 10 application types but a page only fits the first three application types, or if max results is set to 3, then three is returned. To access the rest of the results, retrieve subsequent pages by using the returned continuation token in the next query. An empty continuation token is returned if there are no subsequent pages.",
+        "operationId": "GetApplicationTypeInfoListByName",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-0_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/ApplicationTypeNameRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/ApplicationTypeVersionOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/ExcludeApplicationParametersOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/ContinuationTokenOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/MaxResultsOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "tags": [
+          "ApplicationType"
+        ],
+        "responses": {
+          "200": {
+            "description": "List of application types in the cluster.",
+            "schema": {
+              "$ref": "#/definitions/PagedApplicationTypeInfoList"
+            }
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/ApplicationTypes/$/Provision": {
+      "post": {
+        "operationId": "ProvisionApplicationType",
+        "summary": "Provisions or registers a Service Fabric application type with the cluster using the '.sfpkg' package in the external store or using the application package in the image store.",
+        "description": "Provisions a Service Fabric application type with the cluster. The provision is required before any new applications can be instantiated.\nThe provision operation can be performed either on the application package specified by the relativePathInImageStore, or by using the URI of the external '.sfpkg'.",
+        "tags": [
+          "ApplicationType"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-2_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/ProvisionApplicationTypeDescriptionBaseRequiredBodyParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "A successful provision will return 200 status code."
+          },
+          "202": {
+            "description": "A 202 status code indicates the operation was accepted and the provision operation has been initiated."
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/ApplicationTypes/{applicationTypeName}/$/Unprovision": {
+      "post": {
+        "operationId": "UnprovisionApplicationType",
+        "summary": "Removes or unregisters a Service Fabric application type from the cluster.",
+        "description": "This operation can only be performed if all application instances of the application type have been deleted. Once the application type is unregistered, no new application instances can be created for this particular application type.",
+        "tags": [
+          "ApplicationType"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-0_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/ApplicationTypeNameRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/UnprovisionApplicationTypeRequiredBodyParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "A successful provision will return 200 status code."
+          },
+          "202": {
+            "description": "A 202 status code indicates the operation was accepted."
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/ApplicationTypes/{applicationTypeName}/$/GetServiceTypes": {
+      "get": {
+        "summary": "Gets the list containing the information about service types that are supported by a provisioned application type in a Service Fabric cluster.",
+        "description": "Gets the list containing the information about service types that are supported by a provisioned application type in a Service Fabric cluster. The provided application type must exist. Otherwise, a 404 status is returned.",
+        "operationId": "GetServiceTypeInfoList",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-0_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/ApplicationTypeNameRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/ApplicationTypeVersionRequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "tags": [
+          "ServiceType"
+        ],
+        "x-ms-examples": {
+          "Get information about all nodes.": {
+            "$ref": "./examples/GetServiceTypeInfoList-1.json"
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "List of service types that are supported by a provisioned application type.",
+            "schema": {
+              "$ref": "#/definitions/ServiceTypeInfoList"
+            }
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/ApplicationTypes/{applicationTypeName}/$/GetServiceTypes/{serviceTypeName}": {
+      "get": {
+        "summary": "Gets the information about a specific service type that is supported by a provisioned application type in a Service Fabric cluster.",
+        "description": "Gets the information about a specific service type that is supported by a provisioned application type in a Service Fabric cluster. The provided application type must exist. Otherwise, a 404 status is returned. A 204 response is returned if the specified service type is not found in the cluster.",
+        "operationId": "GetServiceTypeInfoByName",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-0_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/ApplicationTypeNameRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/ApplicationTypeVersionRequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/ServiceTypeNameRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "tags": [
+          "ServiceType"
+        ],
+        "x-ms-examples": {
+          "Get information about all nodes.": {
+            "$ref": "./examples/GetServiceTypeInfoByName-1.json"
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "A specific service type which supported by a provisioned application type.",
+            "schema": {
+              "$ref": "#/definitions/ServiceTypeInfo"
+            }
+          },
+          "204": {
+            "description": "A 204 response is returned if the specified service type is not found in the cluster."
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/ApplicationTypes/{applicationTypeName}/$/GetServiceManifest": {
+      "get": {
+        "summary": "Gets the manifest describing a service type.",
+        "description": "Gets the manifest describing a service type. The response contains the service manifest XML as a string.",
+        "operationId": "GetServiceManifest",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-0_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/ApplicationTypeNameRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/ApplicationTypeVersionRequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/ServiceManifestNameRequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "tags": [
+          "ServiceType"
+        ],
+        "responses": {
+          "200": {
+            "description": "Information about the service type.",
+            "schema": {
+              "$ref": "#/definitions/ServiceTypeManifest"
+            }
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/Nodes/{nodeName}/$/GetApplications/{applicationId}/$/GetServiceTypes": {
+      "get": {
+        "summary": "Gets the list containing the information about service types from the applications deployed on a node in a Service Fabric cluster.",
+        "description": "Gets the list containing the information about service types from the applications deployed on a node in a Service Fabric cluster. The response includes the name of the service type, its registration status, the code package that registered it and activation ID of the service package.",
+        "operationId": "GetDeployedServiceTypeInfoList",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-0_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/NodeNameRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/ApplicationIdRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/DeployedServiceType_ServiceManifestNameOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "tags": [
+          "ServiceType"
+        ],
+        "responses": {
+          "200": {
+            "description": "List of information about service types of an application deployed on a node.",
+            "schema": {
+              "$ref": "#/definitions/DeployedServiceTypeInfoList"
+            }
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/Nodes/{nodeName}/$/GetApplications/{applicationId}/$/GetServiceTypes/{serviceTypeName}": {
+      "get": {
+        "summary": "Gets the information about a specified service type of the application deployed on a node in a Service Fabric cluster.",
+        "description": "Gets the list containing the information about a specific service type from the applications deployed on a node in a Service Fabric cluster. The response includes the name of the service type, its registration status, the code package that registered it and activation ID of the service package. Each entry represents one activation of a service type, differentiated by the activation ID.",
+        "operationId": "GetDeployedServiceTypeInfoByName",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-0_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/NodeNameRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/ApplicationIdRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/ServiceTypeNameRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/DeployedServiceType_ServiceManifestNameOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "tags": [
+          "ServiceType"
+        ],
+        "responses": {
+          "200": {
+            "description": "Information about service types of an application deployed on a node.",
+            "schema": {
+              "$ref": "#/definitions/DeployedServiceTypeInfoList"
+            }
+          },
+          "204": {
+            "description": "An empty response is returned if the specified service type of the application is not deployed on the node."
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/Applications/$/Create": {
+      "post": {
+        "summary": "Creates a Service Fabric application.",
+        "description": "Creates a Service Fabric application using the specified description.",
+        "operationId": "CreateApplication",
+        "x-ms-examples": {
+          "Create application.": {
+            "$ref": "./examples/CreateApplication-1.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-0_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/ApplicationDescriptionRequiredBodyParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "tags": [
+          "Application"
+        ],
+        "responses": {
+          "201": {
+            "description": "A successful response means that the application creation has been started. Use GetApplication operation to get the status of the application. Once GetApplicationInfo successfully returns application information, the application is created. If the application has default services those may be in the process of being created. Use GetServiceInfo operation to get the status of the service within the application."
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/Applications/{applicationId}/$/Delete": {
+      "post": {
+        "summary": "Deletes an existing Service Fabric application.",
+        "description": "An application must be created before it can be deleted. Deleting an application will delete all services that are part of that application. By default, Service Fabric will try to close service replicas in a graceful manner and then delete the service. However, if a service is having issues closing the replica gracefully, the delete operation may take a long time or get stuck. Use the optional ForceRemove flag to skip the graceful close sequence and forcefully delete the application and all of its services.",
+        "operationId": "DeleteApplication",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-0_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/ApplicationIdRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/ForceRemoveOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "tags": [
+          "Application"
+        ],
+        "responses": {
+          "200": {
+            "description": "A successful operation will return 200 status code."
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/Applications/{applicationId}/$/GetLoadInformation": {
+      "get": {
+        "summary": "Gets load information about a Service Fabric application.",
+        "description": "Returns the load information about the application that was created or in the process of being created in the Service Fabric cluster and whose name matches the one specified as the parameter. The response includes the name, minimum nodes, maximum nodes, the number of nodes the application is occupying currently, and application load metric information about the application.",
+        "operationId": "GetApplicationLoadInfo",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-0_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/ApplicationIdRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "tags": [
+          "Application"
+        ],
+        "responses": {
+          "200": {
+            "description": "Information about the application load.",
+            "schema": {
+              "$ref": "#/definitions/ApplicationLoadInfo"
+            }
+          },
+          "204": {
+            "description": "An empty response is returned if the specified applicationId is not found in the cluster."
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/Applications": {
+      "get": {
+        "summary": "Gets the list of applications created in the Service Fabric cluster that match the specified filters.",
+        "description": "Gets the information about the applications that were created or in the process of being created in the Service Fabric cluster and match the specified filters. The response includes the name, type, status, parameters, and other details about the application. If the applications do not fit in a page, one page of results is returned as well as a continuation token, which can be used to get the next page. Filters ApplicationTypeName and ApplicationDefinitionKindFilter cannot be specified at the same time.",
+        "operationId": "GetApplicationInfoList",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-1_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/ApplicationDefinitionKindFilterOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/ApplicationTypeNameOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/ExcludeApplicationParametersOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/ContinuationTokenOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/MaxResultsOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "tags": [
+          "Application"
+        ],
+        "x-ms-examples": {
+          "Limit maximum results": {
+            "$ref": "./examples/GetApplicationInfoList-1.json"
+          },
+          "Page using continuation token": {
+            "$ref": "./examples/GetApplicationInfoList-2.json"
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "List of applications created in the cluster.",
+            "schema": {
+              "$ref": "#/definitions/PagedApplicationInfoList"
+            }
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/Applications/{applicationId}": {
+      "get": {
+        "summary": "Gets information about a Service Fabric application.",
+        "description": "Returns the information about the application that was created or in the process of being created in the Service Fabric cluster and whose name matches the one specified as the parameter. The response includes the name, type, status, parameters, and other details about the application.",
+        "operationId": "GetApplicationInfo",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-0_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/ApplicationIdRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/ExcludeApplicationParametersOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "tags": [
+          "Application"
+        ],
+        "x-ms-examples": {
+          "Get a specific application by application id": {
+            "$ref": "./examples/GetApplicationInfoByName-1.json"
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "Information about the application.",
+            "schema": {
+              "$ref": "#/definitions/ApplicationInfo"
+            }
+          },
+          "204": {
+            "description": "An empty response is returned if the specified applicationId is not found in the cluster."
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/Applications/{applicationId}/$/GetHealth": {
+      "get": {
+        "summary": "Gets the health of the service fabric application.",
+        "description": "Returns the heath state of the service fabric application. The response reports either Ok, Error or Warning health state. If the entity is not found in the health store, it will return Error.",
+        "operationId": "GetApplicationHealth",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApplicationIdRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/ApiVersion_6-0_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/EventsHealthStateFilterOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/DeployedApplicationsHealthStateFilterOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/ServicesHealthStateFilterOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/ExcludeHealthStatisticsOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "tags": [
+          "Application"
+        ],
+        "responses": {
+          "200": {
+            "description": "A successful operation will return 200 status code and the requested application health information.",
+            "schema": {
+              "$ref": "#/definitions/ApplicationHealth"
+            }
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      },
+      "post": {
+        "operationId": "GetApplicationHealthUsingPolicy",
+        "summary": "Gets the health of a Service Fabric application using the specified policy.",
+        "description": "Gets the health of a Service Fabric application. Use EventsHealthStateFilter to filter the collection of health events reported on the node based on the health state. Use ClusterHealthPolicies to override the health policies used to evaluate the health.",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApplicationIdRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/ApiVersion_6-0_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/EventsHealthStateFilterOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/DeployedApplicationsHealthStateFilterOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/ServicesHealthStateFilterOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/ExcludeHealthStatisticsOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/ApplicationHealthPolicyOptionalBodyParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "tags": [
+          "Application"
+        ],
+        "responses": {
+          "200": {
+            "description": "A successful operation will return 200 status code and the requested node health information.",
+            "schema": {
+              "$ref": "#/definitions/ApplicationHealth"
+            }
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/Applications/{applicationId}/$/ReportHealth": {
+      "post": {
+        "operationId": "ReportApplicationHealth",
+        "summary": "Sends a health report on the Service Fabric application.",
+        "description": "Reports health state of the specified Service Fabric application. The report must contain the information about the source of the health report and property on which it is reported.\nThe report is sent to a Service Fabric gateway Application, which forwards to the health store.\nThe report may be accepted by the gateway, but rejected by the health store after extra validation.\nFor example, the health store may reject the report because of an invalid parameter, like a stale sequence number.\nTo see whether the report was applied in the health store, get application health and check that the report appears in the HealthEvents section.",
+        "tags": [
+          "Application"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-0_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/ApplicationIdRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/HealthInformationRequiredBodyParam"
+          },
+          {
+            "$ref": "#/parameters/ImmediateOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "A successful operation will return 200 status code."
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/Applications/{applicationId}/$/Upgrade": {
+      "post": {
+        "summary": "Starts upgrading an application in the Service Fabric cluster.",
+        "description": "Validates the supplied application upgrade parameters and starts upgrading the application if the parameters are valid.\nNote, [ApplicationParameter](https://docs.microsoft.com/dotnet/api/system.fabric.description.applicationdescription.applicationparameters)s are not preserved across an application upgrade.\nIn order to preserve current application parameters, the user should get the parameters using [GetApplicationInfo](./GetApplicationInfo.md) operation first and pass them into the upgrade API call as shown in the example.",
+        "operationId": "StartApplicationUpgrade",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-0_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/ApplicationIdRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/ApplicationUpgradeDescriptionRequiredBodyParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "tags": [
+          "Application"
+        ],
+        "x-ms-examples": {
+          "Upgrade an application preserving current application parameters": {
+            "$ref": "./examples/StartApplicationUpgrade-1.json"
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "A successful response means that the application upgrade has started. Use GetApplicationUpgrade operation to get the status of the upgrade."
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/Applications/{applicationId}/$/GetUpgradeProgress": {
+      "get": {
+        "summary": "Gets details for the latest upgrade performed on this application.",
+        "description": "Returns information about the state of the latest application upgrade along with details to aid debugging application health issues.",
+        "operationId": "GetApplicationUpgrade",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-0_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/ApplicationIdRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "tags": [
+          "Application"
+        ],
+        "responses": {
+          "200": {
+            "description": "The application upgrade details.",
+            "schema": {
+              "$ref": "#/definitions/ApplicationUpgradeProgressInfo"
+            }
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/Applications/{applicationId}/$/UpdateUpgrade": {
+      "post": {
+        "summary": "Updates an ongoing application upgrade in the Service Fabric cluster.",
+        "description": "Updates the parameters of an ongoing application upgrade from the ones specified at the time of starting the application upgrade. This may be required to mitigate stuck application upgrades due to incorrect parameters or issues in the application to make progress.",
+        "operationId": "UpdateApplicationUpgrade",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-0_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/ApplicationIdRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/ApplicationUpgradeUpdateDescriptionRequiredBodyParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "tags": [
+          "Application"
+        ],
+        "responses": {
+          "200": {
+            "description": "A successful response means that the application upgrade has updated with the specified parameters. Use GetApplicationUpgrade operation to get the status of the upgrade."
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/Applications/{applicationId}/$/MoveToNextUpgradeDomain": {
+      "post": {
+        "summary": "Resumes upgrading an application in the Service Fabric cluster.",
+        "description": "Resumes an unmonitored manual Service Fabric application upgrade. Service Fabric upgrades one upgrade domain at a time. For unmonitored manual upgrades, after Service Fabric finishes an upgrade domain, it waits for you to call this API before proceeding to the next upgrade domain.",
+        "operationId": "ResumeApplicationUpgrade",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-0_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/ApplicationIdRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/ResumeApplicationUpgradeDescriptionRequiredBodyParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "tags": [
+          "Application"
+        ],
+        "responses": {
+          "200": {
+            "description": "A successful response means that the application upgrade has been resumed in the specified upgrade domain. Use GetApplicationUpgrade operation to get the status of the upgrade."
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/Applications/{applicationId}/$/RollbackUpgrade": {
+      "post": {
+        "summary": "Starts rolling back the currently on-going upgrade of an application in the Service Fabric cluster.",
+        "description": "Starts rolling back the current application upgrade to the previous version. This API can only be used to roll back the current in-progress upgrade that is rolling forward to new version. If the application is not currently being upgraded use StartApplicationUpgrade API to upgrade it to desired version, including rolling back to a previous version.",
+        "operationId": "RollbackApplicationUpgrade",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-0_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/ApplicationIdRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "tags": [
+          "Application"
+        ],
+        "responses": {
+          "200": {
+            "description": "A successful response means that the application has started to roll back. Use GetApplicationUpgrade operation to get the status of the upgrade."
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/Nodes/{nodeName}/$/GetApplications": {
+      "get": {
+        "operationId": "GetDeployedApplicationInfoList",
+        "summary": "Gets the list of applications deployed on a Service Fabric node.",
+        "description": "Gets the list of applications deployed on a Service Fabric node. The results do not include information about deployed system applications unless explicitly queried for by ID. Results encompass deployed applications in active, activating, and downloading states. This query requires that the node name corresponds to a node on the cluster. The query fails if the provided node name does not point to any active Service Fabric nodes on the cluster.",
+        "tags": [
+          "Application"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-1_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/NodeNameRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/IncludeHealthStateOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/ContinuationTokenOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/MaxResultsOptionalQueryParam"
+          }
+        ],
+        "x-ms-examples": {
+          "Limit maximum results": {
+            "$ref": "./examples/GetDeployedApplicationInfoList-1.json"
+          },
+          "Page using continuation token": {
+            "$ref": "./examples/GetDeployedApplicationInfoList-2.json"
+          },
+          "Include health state in the result": {
+            "$ref": "./examples/GetDeployedApplicationInfoList-3.json"
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "A successful operation will return 200 status code and the list of deployed application information.",
+            "schema": {
+              "$ref": "#/definitions/PagedDeployedApplicationInfoList"
+            }
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/Nodes/{nodeName}/$/GetApplications/{applicationId}": {
+      "get": {
+        "operationId": "GetDeployedApplicationInfo",
+        "summary": "Gets the information about an application deployed on a Service Fabric node.",
+        "description": "This query returns system application information if the application ID provided is for system application. Results encompass deployed applications in active, activating, and downloading states. This query requires that the node name corresponds to a node on the cluster. The query fails if the provided node name does not point to any active Service Fabric nodes on the cluster.",
+        "tags": [
+          "Application"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-1_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/NodeNameRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/ApplicationIdRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/IncludeHealthStateOptionalQueryParam"
+          }
+        ],
+        "x-ms-examples": {
+          "Get a specific deployed application by application ID and include the health state in the result": {
+            "$ref": "./examples/GetDeployedApplicationInfoByName-1.json"
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "A successful operation will return 200 status code and the information about the deployed application.",
+            "schema": {
+              "$ref": "#/definitions/DeployedApplicationInfo"
+            }
+          },
+          "204": {
+            "description": "An empty response is returned if the specified application is not deployed on the node."
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/Nodes/{nodeName}/$/GetApplications/{applicationId}/$/GetHealth": {
+      "get": {
+        "operationId": "GetDeployedApplicationHealth",
+        "summary": "Gets the information about health of an application deployed on a Service Fabric node.",
+        "description": "Gets the information about health of an application deployed on a Service Fabric node. Use EventsHealthStateFilter to optionally filter for the collection of HealthEvent objects reported on the deployed application based on health state. Use DeployedServicePackagesHealthStateFilter to optionally filter for DeployedServicePackageHealth children based on health state.",
+        "tags": [
+          "Application"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-0_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/NodeNameRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/ApplicationIdRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/EventsHealthStateFilterOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/DeployedServicePackagesHealthStateFilterOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/ExcludeHealthStatisticsOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "A successful operation will return 200 status code and the health information of the deployed application.",
+            "schema": {
+              "$ref": "#/definitions/DeployedApplicationHealth"
+            }
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      },
+      "post": {
+        "operationId": "GetDeployedApplicationHealthUsingPolicy",
+        "summary": "Gets the information about health of an application deployed on a Service Fabric node. using the specified policy.",
+        "description": "Gets the information about health of an application deployed on a Service Fabric node using the specified policy. Use EventsHealthStateFilter to optionally filter for the collection of HealthEvent objects reported on the deployed application based on health state. Use DeployedServicePackagesHealthStateFilter to optionally filter for DeployedServicePackageHealth children based on health state. Use ApplicationHealthPolicy to optionally override the health policies used to evaluate the health. This API only uses 'ConsiderWarningAsError' field of the ApplicationHealthPolicy. The rest of the fields are ignored while evaluating the health of the deployed application.",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-0_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/NodeNameRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/ApplicationIdRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/EventsHealthStateFilterOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/DeployedServicePackagesHealthStateFilterOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/ApplicationHealthPolicyOptionalBodyParam"
+          },
+          {
+            "$ref": "#/parameters/ExcludeHealthStatisticsOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "tags": [
+          "Application"
+        ],
+        "responses": {
+          "200": {
+            "description": "A successful operation will return 200 status code and the health information of the deployed application.",
+            "schema": {
+              "$ref": "#/definitions/DeployedApplicationHealth"
+            }
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/Nodes/{nodeName}/$/GetApplications/{applicationId}/$/ReportHealth": {
+      "post": {
+        "operationId": "ReportDeployedApplicationHealth",
+        "summary": "Sends a health report on the Service Fabric application deployed on a Service Fabric node.",
+        "description": "Reports health state of the application deployed on a Service Fabric node. The report must contain the information about the source of the health report and property on which it is reported.\nThe report is sent to a Service Fabric gateway Service, which forwards to the health store.\nThe report may be accepted by the gateway, but rejected by the health store after extra validation.\nFor example, the health store may reject the report because of an invalid parameter, like a stale sequence number.\nTo see whether the report was applied in the health store, get deployed application health and check that the report appears in the HealthEvents section.",
+        "tags": [
+          "Application"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-0_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/NodeNameRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/ApplicationIdRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/HealthInformationRequiredBodyParam"
+          },
+          {
+            "$ref": "#/parameters/ImmediateOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "A successful operation will return 200 status code."
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/ApplicationTypes/{applicationTypeName}/$/GetApplicationManifest": {
+      "get": {
+        "summary": "Gets the manifest describing an application type.",
+        "description": "The response contains the application manifest XML as a string.",
+        "operationId": "GetApplicationManifest",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-0_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/ApplicationTypeNameRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/ApplicationTypeVersionRequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "tags": [
+          "ApplicationType"
+        ],
+        "responses": {
+          "200": {
+            "description": "Information about the node.",
+            "schema": {
+              "$ref": "#/definitions/ApplicationTypeManifest"
+            }
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/Applications/{applicationId}/$/GetServices": {
+      "get": {
+        "summary": "Gets the information about all services belonging to the application specified by the application ID.",
+        "description": "Returns the information about all services belonging to the application specified by the application ID.",
+        "operationId": "GetServiceInfoList",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApplicationIdRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/ServiceTypeNameOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/ApiVersion_6-0_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/ContinuationTokenOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "tags": [
+          "Service"
+        ],
+        "responses": {
+          "200": {
+            "description": "List of services in the cluster for the specified application.",
+            "schema": {
+              "$ref": "#/definitions/PagedServiceInfoList"
+            }
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/Applications/{applicationId}/$/GetServices/{serviceId}": {
+      "get": {
+        "summary": "Gets the information about the specific service belonging to the Service Fabric application.",
+        "description": "Returns the information about the specified service belonging to the specified Service Fabric application.",
+        "operationId": "GetServiceInfo",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApplicationIdRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/ServiceIdRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/ApiVersion_6-0_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "tags": [
+          "Service"
+        ],
+        "responses": {
+          "200": {
+            "description": "Information about the specified service.",
+            "schema": {
+              "$ref": "#/definitions/ServiceInfo"
+            }
+          },
+          "204": {
+            "description": "An empty response is returned if the specified service is not part of the specified application."
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/Services/{serviceId}/$/GetApplicationName": {
+      "get": {
+        "summary": "Gets the name of the Service Fabric application for a service.",
+        "description": "Gets the name of the application for the specified service. A 404 FABRIC_E_SERVICE_DOES_NOT_EXIST error is returned if a service with the provided service ID does not exist.",
+        "operationId": "GetApplicationNameInfo",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-0_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/ServiceIdRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "tags": [
+          "Service"
+        ],
+        "responses": {
+          "200": {
+            "description": "Information about the name of the application for the specified service.",
+            "schema": {
+              "$ref": "#/definitions/ApplicationNameInfo"
+            }
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/Applications/{applicationId}/$/GetServices/$/Create": {
+      "post": {
+        "operationId": "CreateService",
+        "summary": "Creates the specified Service Fabric service.",
+        "description": "This api allows creating a new Service Fabric stateless or stateful service under a specified Service Fabric application. The description for creating the service includes partitioning information and optional properties for placement and load balancing. Some of the properties can later be modified using `UpdateService` API.",
+        "x-ms-examples": {
+          "Basic stateless service": {
+            "$ref": "./examples/CreateService-1.json"
+          },
+          "Basic stateful service": {
+            "$ref": "./examples/CreateService-2.json"
+          },
+          "Stateless service with dns name and auto scaling": {
+            "$ref": "./examples/CreateService-3.json"
+          },
+          "Stateful service with named partitions and auto scaling": {
+            "$ref": "./examples/CreateService-4.json"
+          }
+        },
+        "tags": [
+          "Service"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-0_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/ApplicationIdRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/ServiceDescriptionRequiredBodyParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "responses": {
+          "202": {
+            "description": "A successful operation will return 202 status code."
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/Applications/{applicationId}/$/GetServices/$/CreateFromTemplate": {
+      "post": {
+        "summary": "Creates a Service Fabric service from the service template.",
+        "description": "Creates a Service Fabric service from the service template defined in the application manifest. A service template contains the properties that will be same for the service instance of the same type. The API allows overriding the properties that are usually different for different services of the same service type.",
+        "operationId": "CreateServiceFromTemplate",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-0_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/ApplicationIdRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/CreateServiceFromTemplateRequiredBodyParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "tags": [
+          "Service"
+        ],
+        "responses": {
+          "202": {
+            "description": "A successful operation will return 202 status code."
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/Services/{serviceId}/$/Delete": {
+      "post": {
+        "summary": "Deletes an existing Service Fabric service.",
+        "description": "A service must be created before it can be deleted. By default, Service Fabric will try to close service replicas in a graceful manner and then delete the service. However, if the service is having issues closing the replica gracefully, the delete operation may take a long time or get stuck. Use the optional ForceRemove flag to skip the graceful close sequence and forcefully delete the service.",
+        "operationId": "DeleteService",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-0_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/ServiceIdRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/ForceRemoveOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "tags": [
+          "Service"
+        ],
+        "responses": {
+          "200": {
+            "description": "A successful operation will return 200 status code."
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/Services/{serviceId}/$/Update": {
+      "post": {
+        "operationId": "UpdateService",
+        "summary": "Updates a Service Fabric service using the specified update description.",
+        "description": "This API allows updating properties of a running Service Fabric service. The set of properties that can be updated are a subset of the properties that were specified at the time of creating the service. The current set of properties can be obtained using `GetServiceDescription` API. Note that updating the properties of a running service is different than upgrading your application using `StartApplicationUpgrade` API. The upgrade is a long running background operation that involves moving the application from one version to another, one upgrade domain at a time, whereas update applies the new properties immediately to the service.",
+        "x-ms-examples": {
+          "Stateless service": {
+            "$ref": "./examples/UpdateService-1.json"
+          },
+          "Stateful service": {
+            "$ref": "./examples/UpdateService-2.json"
+          }
+        },
+        "tags": [
+          "Service"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-0_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/ServiceIdRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/ServiceUpdateDescriptionRequiredBodyParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "A successful operation will return 202 status code."
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/Services/{serviceId}/$/GetDescription": {
+      "get": {
+        "summary": "Gets the description of an existing Service Fabric service.",
+        "description": "Gets the description of an existing Service Fabric service. A service must be created before its description can be obtained.",
+        "operationId": "GetServiceDescription",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-0_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/ServiceIdRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "tags": [
+          "Service"
+        ],
+        "responses": {
+          "200": {
+            "description": "A successful operation will return 200 status code.",
+            "schema": {
+              "$ref": "#/definitions/ServiceDescription"
+            }
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/Services/{serviceId}/$/GetHealth": {
+      "get": {
+        "summary": "Gets the health of the specified Service Fabric service.",
+        "description": "Gets the health information of the specified service.\nUse EventsHealthStateFilter to filter the collection of health events reported on the service based on the health state.\nUse PartitionsHealthStateFilter to filter the collection of partitions returned.\nIf you specify a service that does not exist in the health store, this request returns an error.",
+        "operationId": "GetServiceHealth",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-0_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/ServiceIdRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/EventsHealthStateFilterOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/PartitionsHealthStateFilterOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/ExcludeHealthStatisticsOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "tags": [
+          "Service"
+        ],
+        "responses": {
+          "200": {
+            "description": "A successful operation will return 200 status code and the health information of the specified service.",
+            "schema": {
+              "$ref": "#/definitions/ServiceHealth"
+            }
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      },
+      "post": {
+        "summary": "Gets the health of the specified Service Fabric service, by using the specified health policy.",
+        "description": "Gets the health information of the specified service.\nIf the application health policy is specified, the health evaluation uses it to get the aggregated health state.\nIf the policy is not specified, the health evaluation uses the application health policy defined in the application manifest, or the default health policy, if no policy is defined in the manifest.\nUse EventsHealthStateFilter to filter the collection of health events reported on the service based on the health state.\nUse PartitionsHealthStateFilter to filter the collection of partitions returned.\nIf you specify a service that does not exist in the health store, this request returns an error.",
+        "operationId": "GetServiceHealthUsingPolicy",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-0_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/ServiceIdRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/EventsHealthStateFilterOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/PartitionsHealthStateFilterOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/ApplicationHealthPolicyOptionalBodyParam"
+          },
+          {
+            "$ref": "#/parameters/ExcludeHealthStatisticsOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "tags": [
+          "Service"
+        ],
+        "responses": {
+          "200": {
+            "description": "A successful operation will return 200 status code and the health information of the specified service.",
+            "schema": {
+              "$ref": "#/definitions/ServiceHealth"
+            }
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/Services/{serviceId}/$/ReportHealth": {
+      "post": {
+        "operationId": "ReportServiceHealth",
+        "summary": "Sends a health report on the Service Fabric service.",
+        "description": "Reports health state of the specified Service Fabric service. The report must contain the information about the source of the health report and property on which it is reported.\nThe report is sent to a Service Fabric gateway Service, which forwards to the health store.\nThe report may be accepted by the gateway, but rejected by the health store after extra validation.\nFor example, the health store may reject the report because of an invalid parameter, like a stale sequence number.\nTo see whether the report was applied in the health store, run GetServiceHealth and check that the report appears in the HealthEvents section.",
+        "tags": [
+          "Service"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-0_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/ServiceIdRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/HealthInformationRequiredBodyParam"
+          },
+          {
+            "$ref": "#/parameters/ImmediateOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "A successful operation will return 200 status code."
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/Services/{serviceId}/$/ResolvePartition": {
+      "get": {
+        "operationId": "ResolveService",
+        "summary": "Resolve a Service Fabric partition.",
+        "description": "Resolve a Service Fabric service partition to get the endpoints of the service replicas.",
+        "tags": [
+          "Service"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-0_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/ServiceIdRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/PartitionKeyTypeOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/PartitionKeyValueOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/PreviousRspVersionOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "A successful operation will return 200 status code.",
+            "schema": {
+              "$ref": "#/definitions/ResolvedServicePartition"
+            }
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/Services/{serviceId}/$/GetUnplacedReplicaInformation": {
+      "get": {
+        "summary": "Gets the information about unplaced replica of the service.",
+        "description": "Returns the information about the unplaced replicas of the service.\nIf PartitionId is specified, then result will contain information only about unplaced replicas for that partition.\nIf PartitionId is not specified, then result will contain information about unplaced replicas for all partitions of that service.\nIf OnlyQueryPrimaries is set to true, then result will contain information only about primary replicas, and will ignore unplaced secondary replicas.",
+        "operationId": "GetUnplacedReplicaInformation",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-4_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/ServiceIdRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/PartitionIdOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/OnlyQueryPrimariesOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "tags": [
+          "Service"
+        ],
+        "responses": {
+          "200": {
+            "description": "Information about the specified service.",
+            "schema": {
+              "$ref": "#/definitions/UnplacedReplicaInformation"
+            }
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/Services/{serviceId}/$/GetPartitions": {
+      "get": {
+        "summary": "Gets the list of partitions of a Service Fabric service.",
+        "description": "The response includes the partition ID, partitioning scheme information, keys supported by the partition, status, health, and other details about the partition.",
+        "operationId": "GetPartitionInfoList",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-4_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/ServiceIdRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/ContinuationTokenOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "tags": [
+          "Partition"
+        ],
+        "responses": {
+          "200": {
+            "description": "List of partitions of a Service Fabric service.",
+            "schema": {
+              "$ref": "#/definitions/PagedServicePartitionInfoList"
+            }
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/Partitions/{partitionId}": {
+      "get": {
+        "summary": "Gets the information about a Service Fabric partition.",
+        "description": "Gets the information about the specified partition. The response includes the partition ID, partitioning scheme information, keys supported by the partition, status, health, and other details about the partition.",
+        "operationId": "GetPartitionInfo",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-0_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/PartitionIdRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "tags": [
+          "Partition"
+        ],
+        "responses": {
+          "200": {
+            "description": "Information about the specified partition.",
+            "schema": {
+              "$ref": "#/definitions/ServicePartitionInfo"
+            }
+          },
+          "204": {
+            "description": "An empty response is returned if the specified partitionId is not found in the cluster."
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/Partitions/{partitionId}/$/GetServiceName": {
+      "get": {
+        "summary": "Gets the name of the Service Fabric service for a partition.",
+        "description": "Gets name of the service for the specified partition. A 404 error is returned if the partition ID does not exist in the cluster.",
+        "operationId": "GetServiceNameInfo",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-0_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/PartitionIdRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "tags": [
+          "Partition"
+        ],
+        "responses": {
+          "200": {
+            "description": "Information about the name of the service for the specified partition.",
+            "schema": {
+              "$ref": "#/definitions/ServiceNameInfo"
+            }
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/Partitions/{partitionId}/$/GetHealth": {
+      "get": {
+        "summary": "Gets the health of the specified Service Fabric partition.",
+        "description": "Use EventsHealthStateFilter to filter the collection of health events reported on the service based on the health state.\nUse ReplicasHealthStateFilter to filter the collection of ReplicaHealthState objects on the partition.\nIf you specify a partition that does not exist in the health store, this request returns an error.",
+        "operationId": "GetPartitionHealth",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-0_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/PartitionIdRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/EventsHealthStateFilterOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/ReplicasHealthStateFilerOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/ExcludeHealthStatisticsOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "tags": [
+          "Partition"
+        ],
+        "responses": {
+          "200": {
+            "description": "A successful operation will return 200 status code and the health information about the specified partition.",
+            "schema": {
+              "$ref": "#/definitions/PartitionHealth"
+            }
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      },
+      "post": {
+        "summary": "Gets the health of the specified Service Fabric partition, by using the specified health policy.",
+        "description": "Gets the health information of the specified partition.\nIf the application health policy is specified, the health evaluation uses it to get the aggregated health state.\nIf the policy is not specified, the health evaluation uses the application health policy defined in the application manifest, or the default health policy, if no policy is defined in the manifest.\nUse EventsHealthStateFilter to filter the collection of health events reported on the partition based on the health state.\nUse ReplicasHealthStateFilter to filter the collection of ReplicaHealthState objects on the partition. Use ApplicationHealthPolicy in the POST body to override the health policies used to evaluate the health.\nIf you specify a partition that does not exist in the health store, this request returns an error.",
+        "operationId": "GetPartitionHealthUsingPolicy",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-0_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/PartitionIdRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/EventsHealthStateFilterOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/ReplicasHealthStateFilerOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/ApplicationHealthPolicyOptionalBodyParam"
+          },
+          {
+            "$ref": "#/parameters/ExcludeHealthStatisticsOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "tags": [
+          "Partition"
+        ],
+        "responses": {
+          "200": {
+            "description": "A successful operation will return 200 status code and the health information about the specified partition.",
+            "schema": {
+              "$ref": "#/definitions/PartitionHealth"
+            }
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/Partitions/{partitionId}/$/ReportHealth": {
+      "post": {
+        "operationId": "ReportPartitionHealth",
+        "summary": "Sends a health report on the Service Fabric partition.",
+        "description": "Reports health state of the specified Service Fabric partition. The report must contain the information about the source of the health report and property on which it is reported.\nThe report is sent to a Service Fabric gateway Partition, which forwards to the health store.\nThe report may be accepted by the gateway, but rejected by the health store after extra validation.\nFor example, the health store may reject the report because of an invalid parameter, like a stale sequence number.\nTo see whether the report was applied in the health store, run GetPartitionHealth and check that the report appears in the HealthEvents section.",
+        "tags": [
+          "Partition"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-0_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/PartitionIdRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/HealthInformationRequiredBodyParam"
+          },
+          {
+            "$ref": "#/parameters/ImmediateOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "A successful operation will return 200 status code."
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/Partitions/{partitionId}/$/GetLoadInformation": {
+      "get": {
+        "summary": "Gets the load information of the specified Service Fabric partition.",
+        "description": "Returns information about the load of a specified partition.\nThe response includes a list of load reports for a Service Fabric partition.\nEach report includes the load metric name, value, and last reported time in UTC.",
+        "operationId": "GetPartitionLoadInformation",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-0_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/PartitionIdRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "tags": [
+          "Partition"
+        ],
+        "responses": {
+          "200": {
+            "description": "Information about the specified partition's last reported load metrics.",
+            "schema": {
+              "$ref": "#/definitions/PartitionLoadInformation"
+            }
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/Partitions/{partitionId}/$/ResetLoad": {
+      "post": {
+        "operationId": "ResetPartitionLoad",
+        "summary": "Resets the current load of a Service Fabric partition.",
+        "description": "Resets the current load of a Service Fabric partition to the default load for the service.",
+        "tags": [
+          "Partition"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/parameters/PartitionIdRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/ApiVersion_6-0_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "A successful operation request will return 200 status code."
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/Partitions/{partitionId}/$/Recover": {
+      "post": {
+        "operationId": "RecoverPartition",
+        "summary": "Indicates to the Service Fabric cluster that it should attempt to recover a specific partition that is currently stuck in quorum loss.",
+        "description": "This operation should only be performed if it is known that the replicas that are down cannot be recovered. Incorrect use of this API can cause potential data loss.",
+        "tags": [
+          "Partition"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/parameters/PartitionIdRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/ApiVersion_6-0_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "A successful operation request will return 200 status code."
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/Services/$/{serviceId}/$/GetPartitions/$/Recover": {
+      "post": {
+        "operationId": "RecoverServicePartitions",
+        "summary": "Indicates to the Service Fabric cluster that it should attempt to recover the specified service that is currently stuck in quorum loss.",
+        "description": "Indicates to the Service Fabric cluster that it should attempt to recover the specified service that is currently stuck in quorum loss. This operation should only be performed if it is known that the replicas that are down cannot be recovered. Incorrect use of this API can cause potential data loss.",
+        "tags": [
+          "Partition"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/parameters/ServiceIdRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/ApiVersion_6-0_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "A successful operation request will return 200 status code."
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/$/RecoverSystemPartitions": {
+      "post": {
+        "operationId": "RecoverSystemPartitions",
+        "summary": "Indicates to the Service Fabric cluster that it should attempt to recover the system services that are currently stuck in quorum loss.",
+        "description": "Indicates to the Service Fabric cluster that it should attempt to recover the system services that are currently stuck in quorum loss. This operation should only be performed if it is known that the replicas that are down cannot be recovered. Incorrect use of this API can cause potential data loss.",
+        "tags": [
+          "Partition"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-0_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "A successful operation request will return 200 status code."
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/$/RecoverAllPartitions": {
+      "post": {
+        "operationId": "RecoverAllPartitions",
+        "summary": "Indicates to the Service Fabric cluster that it should attempt to recover any services (including system services) which are currently stuck in quorum loss.",
+        "description": "This operation should only be performed if it is known that the replicas that are down cannot be recovered. Incorrect use of this API can cause potential data loss.",
+        "tags": [
+          "Partition"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-0_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "A successful operation request will return 200 status code."
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/Partitions/{partitionId}/$/MovePrimaryReplica": {
+      "post": {
+        "operationId": "MovePrimaryReplica",
+        "summary": "Moves the primary replica of a partition of a stateful service.",
+        "description": "This command moves the primary replica of a partition of a stateful service, respecting all constraints.\nIf NodeName parameter is specified, primary will be moved to the specified node (if constraints allow it).\nIf NodeName parameter is not specified, primary replica will be moved to a random node in the cluster.\nIf IgnoreConstraints parameter is specified and set to true, then primary will be moved regardless of the constraints.",
+        "tags": [
+          "Partition"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-5_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/PartitionIdRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/NodeNameOptionalParam"
+          },
+          {
+            "$ref": "#/parameters/IgnoreConstraintsOptionalParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "A successful operation request will return 200 status code."
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/Partitions/{partitionId}/$/MoveSecondaryReplica": {
+      "post": {
+        "operationId": "MoveSecondaryReplica",
+        "summary": "Moves the secondary replica of a partition of a stateful service.",
+        "description": "This command moves the secondary replica of a partition of a stateful service, respecting all constraints.\nCurrentNodeName parameter must be specified to identify the replica that is moved.\nSource node name must be specified, but new node name can be omitted, and in that case replica is moved to a random node.\nIf IgnoreConstraints parameter is specified and set to true, then secondary will be moved regardless of the constraints.",
+        "tags": [
+          "Partition"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-5_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/PartitionIdRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/CurrentNodeNameRequiredParam"
+          },
+          {
+            "$ref": "#/parameters/NewNodeNameOptionalParam"
+          },
+          {
+            "$ref": "#/parameters/IgnoreConstraintsOptionalParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "A successful operation request will return 200 status code."
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/$/UpdatePartitionLoad": {
+      "post": {
+        "operationId": "UpdatePartitionLoad",
+        "summary": "Update the loads of provided partitions for specific metrics.",
+        "description": "Updates the load value and predicted load value for all the partitions provided for specified metrics.",
+        "tags": [
+          "Partition"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_7-2_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/PartitionMetricLoadDescriptionListRequiredParam"
+          },
+          {
+            "$ref": "#/parameters/ContinuationTokenOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/MaxResultsOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "List UpdatePartitionLoadResults.",
+            "schema": {
+              "$ref": "#/definitions/PagedUpdatePartitionLoadResultList"
+            }
+          },
+          "default": {
+            "description": "The error code response per specified partition.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/$/CreateRepairTask": {
+      "post": {
+        "operationId": "CreateRepairTask",
+        "summary": "Creates a new repair task.",
+        "description": "For clusters that have the Repair Manager Service configured,\nthis API provides a way to create repair tasks that run automatically or manually.\nFor repair tasks that run automatically, an appropriate repair executor\nmust be running for each repair action to run automatically.\nThese are currently only available in specially-configured Azure Cloud Services.\n\nTo create a manual repair task, provide the set of impacted node names and the\nexpected impact. When the state of the created repair task changes to approved,\nyou can safely perform repair actions on those nodes.\n\nThis API supports the Service Fabric platform; it is not meant to be used directly from your code.",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-0_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/RepairTaskRequiredBodyParam"
+          }
+        ],
+        "tags": [
+          "RepairManagement"
+        ],
+        "responses": {
+          "200": {
+            "description": "A successful operation will return 200 status code.\nThe response body provides information about the created repair task.",
+            "schema": {
+              "$ref": "#/definitions/RepairTaskUpdateInfo"
+            }
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/$/CancelRepairTask": {
+      "post": {
+        "operationId": "CancelRepairTask",
+        "summary": "Requests the cancellation of the given repair task.",
+        "description": "This API supports the Service Fabric platform; it is not meant to be used directly from your code.",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-0_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/RepairTaskCancelDescriptionRequiredBodyParam"
+          }
+        ],
+        "tags": [
+          "RepairManagement"
+        ],
+        "responses": {
+          "200": {
+            "description": "A successful operation will return 200 status code.\nThe response body provides information about the updated repair task.\nSuccess indicates that the cancellation request was recorded, but does not guarantee that the repair task will be cancelled.\nClients may use the State property of the repair task to determine the current state of the repair task.",
+            "schema": {
+              "$ref": "#/definitions/RepairTaskUpdateInfo"
+            }
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/$/DeleteRepairTask": {
+      "post": {
+        "operationId": "DeleteRepairTask",
+        "summary": "Deletes a completed repair task.",
+        "description": "This API supports the Service Fabric platform; it is not meant to be used directly from your code.",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-0_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/RepairTaskDeleteDescriptionRequiredBodyParam"
+          }
+        ],
+        "tags": [
+          "RepairManagement"
+        ],
+        "responses": {
+          "200": {
+            "description": "A successful operation will return 200 status code."
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/$/GetRepairTaskList": {
+      "get": {
+        "operationId": "GetRepairTaskList",
+        "summary": "Gets a list of repair tasks matching the given filters.",
+        "description": "This API supports the Service Fabric platform; it is not meant to be used directly from your code.",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-0_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/RepairTaskIdFilterOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/RepairTaskStateFilterOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/RepairTaskExecutorFilterOptionalQueryParam"
+          }
+        ],
+        "tags": [
+          "RepairManagement"
+        ],
+        "responses": {
+          "200": {
+            "description": "A successful operation will return 200 status code.\nThe response body provides a list of repair tasks matching all of the given filters.",
+            "schema": {
+              "$ref": "#/definitions/RepairTaskList"
+            }
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/$/ForceApproveRepairTask": {
+      "post": {
+        "operationId": "ForceApproveRepairTask",
+        "summary": "Forces the approval of the given repair task.",
+        "description": "This API supports the Service Fabric platform; it is not meant to be used directly from your code.",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-0_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/RepairTaskApproveDescriptionRequiredBodyParam"
+          }
+        ],
+        "tags": [
+          "RepairManagement"
+        ],
+        "responses": {
+          "200": {
+            "description": "A successful operation will return 200 status code.\nThe response body provides information about the updated repair task.",
+            "schema": {
+              "$ref": "#/definitions/RepairTaskUpdateInfo"
+            }
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/$/UpdateRepairTaskHealthPolicy": {
+      "post": {
+        "operationId": "UpdateRepairTaskHealthPolicy",
+        "summary": "Updates the health policy of the given repair task.",
+        "description": "This API supports the Service Fabric platform; it is not meant to be used directly from your code.",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-0_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/RepairTaskUpdateHealthPolicyDescriptionRequiredBodyParam"
+          }
+        ],
+        "tags": [
+          "RepairManagement"
+        ],
+        "responses": {
+          "200": {
+            "description": "A successful operation will return 200 status code.\nThe response body provides information about the updated repair task.",
+            "schema": {
+              "$ref": "#/definitions/RepairTaskUpdateInfo"
+            }
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/$/UpdateRepairExecutionState": {
+      "post": {
+        "operationId": "UpdateRepairExecutionState",
+        "summary": "Updates the execution state of a repair task.",
+        "description": "This API supports the Service Fabric platform; it is not meant to be used directly from your code.",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-0_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/RepairTaskRequiredBodyParam"
+          }
+        ],
+        "tags": [
+          "RepairManagement"
+        ],
+        "responses": {
+          "200": {
+            "description": "A successful operation will return 200 status code.\nThe response body provides information about the updated repair task.",
+            "schema": {
+              "$ref": "#/definitions/RepairTaskUpdateInfo"
+            }
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/Partitions/{partitionId}/$/GetReplicas": {
+      "get": {
+        "summary": "Gets the information about replicas of a Service Fabric service partition.",
+        "description": "The GetReplicas endpoint returns information about the replicas of the specified partition. The response includes the ID, role, status, health, node name, uptime, and other details about the replica.",
+        "operationId": "GetReplicaInfoList",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-0_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/PartitionIdRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/ContinuationTokenOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "tags": [
+          "Replica"
+        ],
+        "responses": {
+          "200": {
+            "description": "Information about the replicas of the specified partition.",
+            "schema": {
+              "$ref": "#/definitions/PagedReplicaInfoList"
+            }
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/Partitions/{partitionId}/$/GetReplicas/{replicaId}": {
+      "get": {
+        "summary": "Gets the information about a replica of a Service Fabric partition.",
+        "description": "The response includes the ID, role, status, health, node name, uptime, and other details about the replica.",
+        "operationId": "GetReplicaInfo",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-0_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/PartitionIdRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/ReplicaIdRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "tags": [
+          "Replica"
+        ],
+        "responses": {
+          "200": {
+            "description": "Information about the specified replicas of the specified partition of a Service Fabric service.",
+            "schema": {
+              "$ref": "#/definitions/ReplicaInfo"
+            }
+          },
+          "204": {
+            "description": "An empty response is returned if the specified replicaId is not a replica of the specified partition."
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/Partitions/{partitionId}/$/GetReplicas/{replicaId}/$/GetHealth": {
+      "get": {
+        "operationId": "GetReplicaHealth",
+        "summary": "Gets the health of a Service Fabric stateful service replica or stateless service instance.",
+        "description": "Gets the health of a Service Fabric replica.\nUse EventsHealthStateFilter to filter the collection of health events reported on the replica based on the health state.",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-0_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/PartitionIdRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/ReplicaIdRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/EventsHealthStateFilterOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "tags": [
+          "Replica"
+        ],
+        "responses": {
+          "200": {
+            "description": "A successful operation will return 200 status code and the requested replica health.",
+            "schema": {
+              "$ref": "#/definitions/ReplicaHealth"
+            }
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      },
+      "post": {
+        "operationId": "GetReplicaHealthUsingPolicy",
+        "summary": "Gets the health of a Service Fabric stateful service replica or stateless service instance using the specified policy.",
+        "description": "Gets the health of a Service Fabric stateful service replica or stateless service instance.\nUse EventsHealthStateFilter to filter the collection of health events reported on the cluster based on the health state.\nUse ApplicationHealthPolicy to optionally override the health policies used to evaluate the health. This API only uses 'ConsiderWarningAsError' field of the ApplicationHealthPolicy. The rest of the fields are ignored while evaluating the health of the replica.",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-0_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/PartitionIdRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/ReplicaIdRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/EventsHealthStateFilterOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/ApplicationHealthPolicyOptionalBodyParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "tags": [
+          "Replica"
+        ],
+        "responses": {
+          "200": {
+            "description": "A successful operation will return 200 status code and the requested replica health information.",
+            "schema": {
+              "$ref": "#/definitions/ReplicaHealth"
+            }
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/Partitions/{partitionId}/$/GetReplicas/{replicaId}/$/ReportHealth": {
+      "post": {
+        "operationId": "ReportReplicaHealth",
+        "summary": "Sends a health report on the Service Fabric replica.",
+        "description": "Reports health state of the specified Service Fabric replica. The report must contain the information about the source of the health report and property on which it is reported.\nThe report is sent to a Service Fabric gateway Replica, which forwards to the health store.\nThe report may be accepted by the gateway, but rejected by the health store after extra validation.\nFor example, the health store may reject the report because of an invalid parameter, like a stale sequence number.\nTo see whether the report was applied in the health store, run GetReplicaHealth and check that the report appears in the HealthEvents section.",
+        "tags": [
+          "Replica"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-0_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/PartitionIdRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/ReplicaIdRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/ReplicaHealthReportServiceKindRequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/HealthInformationRequiredBodyParam"
+          },
+          {
+            "$ref": "#/parameters/ImmediateOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "A successful operation will return 200 status code."
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/Nodes/{nodeName}/$/GetApplications/{applicationId}/$/GetReplicas": {
+      "get": {
+        "operationId": "GetDeployedServiceReplicaInfoList",
+        "summary": "Gets the list of replicas deployed on a Service Fabric node.",
+        "description": "Gets the list containing the information about replicas deployed on a Service Fabric node. The information include partition ID, replica ID, status of the replica, name of the service, name of the service type, and other information. Use PartitionId or ServiceManifestName query parameters to return information about the deployed replicas matching the specified values for those parameters.",
+        "tags": [
+          "Replica"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-0_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/NodeNameRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/ApplicationIdRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/PartitionIdOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/ServiceManifestNameOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "A successful operation will return 200 status code and the list of deployed service replica information.",
+            "schema": {
+              "$ref": "#/definitions/DeployedServiceReplicaInfoList"
+            }
+          },
+          "204": {
+            "description": "An empty response is returned if the specified applicationId is not found on the specified node. An empty response is also returned if there are no replicas matching the specified filter values for PartitionId or ServiceManifestName query parameters."
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/Nodes/{nodeName}/$/GetPartitions/{partitionId}/$/GetReplicas/{replicaId}/$/GetDetail": {
+      "get": {
+        "operationId": "GetDeployedServiceReplicaDetailInfo",
+        "summary": "Gets the details of replica deployed on a Service Fabric node.",
+        "description": "Gets the details of the replica deployed on a Service Fabric node. The information includes service kind, service name, current service operation, current service operation start date time, partition ID, replica/instance ID, reported load, and other information.",
+        "tags": [
+          "Replica"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-0_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/NodeNameRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/PartitionIdRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/ReplicaIdRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "A successful operation will return 200 status code and the list of deployed service replica information.",
+            "schema": {
+              "$ref": "#/definitions/DeployedServiceReplicaDetailInfo"
+            }
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/Nodes/{nodeName}/$/GetPartitions/{partitionId}/$/GetReplicas": {
+      "get": {
+        "operationId": "GetDeployedServiceReplicaDetailInfoByPartitionId",
+        "summary": "Gets the details of replica deployed on a Service Fabric node.",
+        "description": "Gets the details of the replica deployed on a Service Fabric node. The information includes service kind, service name, current service operation, current service operation start date time, partition ID, replica/instance ID, reported load, and other information.",
+        "tags": [
+          "Replica"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-0_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/NodeNameRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/PartitionIdRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "A successful operation will return 200 status code and the list of deployed service replica information.",
+            "schema": {
+              "$ref": "#/definitions/DeployedServiceReplicaDetailInfo"
+            }
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/Nodes/{nodeName}/$/GetPartitions/{partitionId}/$/GetReplicas/{replicaId}/$/Restart": {
+      "post": {
+        "operationId": "RestartReplica",
+        "summary": "Restarts a service replica of a persisted service running on a node.",
+        "description": "Restarts a service replica of a persisted service running on a node. Warning - There are no safety checks performed when this API is used. Incorrect use of this API can lead to availability loss for stateful services.",
+        "tags": [
+          "Replica"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-0_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/NodeNameRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/PartitionIdRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/ReplicaIdRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "A successful operation will return 200 status code. A successful operation means that the restart command was received by the replica on the node and it is in the process of restarting."
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/Nodes/{nodeName}/$/GetPartitions/{partitionId}/$/GetReplicas/{replicaId}/$/Delete": {
+      "post": {
+        "operationId": "RemoveReplica",
+        "summary": "Removes a service replica running on a node.",
+        "description": "This API simulates a Service Fabric replica failure by removing a replica from a Service Fabric cluster. The removal closes the replica, transitions the replica to the role None, and then removes all of the state information of the replica from the cluster. This API tests the replica state removal path, and simulates the report fault permanent path through client APIs. Warning - There are no safety checks performed when this API is used. Incorrect use of this API can lead to data loss for stateful services. In addition, the forceRemove flag impacts all other replicas hosted in the same process.",
+        "tags": [
+          "Replica"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-0_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/NodeNameRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/PartitionIdRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/ReplicaIdRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/ForceRemoveReplicaOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "A successful operation will return 200 status code. A successful operation means that the restart command was received by the replica on the node and it is in the process of restarting."
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/Nodes/{nodeName}/$/GetApplications/{applicationId}/$/GetServicePackages": {
+      "get": {
+        "operationId": "GetDeployedServicePackageInfoList",
+        "summary": "Gets the list of service packages deployed on a Service Fabric node.",
+        "description": "Returns the information about the service packages deployed on a Service Fabric node for the given application.",
+        "tags": [
+          "Service Package"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-0_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/NodeNameRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/ApplicationIdRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "A successful operation will return 200 status code and the list of deployed service packages information.",
+            "schema": {
+              "$ref": "#/definitions/DeployedServicePackageInfoList"
+            }
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/Nodes/{nodeName}/$/GetApplications/{applicationId}/$/GetServicePackages/{servicePackageName}": {
+      "get": {
+        "operationId": "GetDeployedServicePackageInfoListByName",
+        "summary": "Gets the list of service packages deployed on a Service Fabric node matching exactly the specified name.",
+        "description": "Returns the information about the service packages deployed on a Service Fabric node for the given application. These results are of service packages whose name match exactly the service package name specified as the parameter.",
+        "tags": [
+          "Service Package"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-0_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/NodeNameRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/ApplicationIdRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/ServicePackageNameRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "A successful operation will return 200 status code and the list of deployed service packages information.",
+            "schema": {
+              "$ref": "#/definitions/DeployedServicePackageInfoList"
+            }
+          },
+          "204": {
+            "description": "An empty response is returned if the specified service package from the application is not deployed on the node."
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/Nodes/{nodeName}/$/GetApplications/{applicationId}/$/GetServicePackages/{servicePackageName}/$/GetHealth": {
+      "get": {
+        "operationId": "GetDeployedServicePackageHealth",
+        "summary": "Gets the information about health of a service package for a specific application deployed for a Service Fabric node and application.",
+        "description": "Gets the information about health of a service package for a specific application deployed on a Service Fabric node. Use EventsHealthStateFilter to optionally filter for the collection of HealthEvent objects reported on the deployed service package based on health state.",
+        "tags": [
+          "Service Package"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-0_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/NodeNameRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/ApplicationIdRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/ServicePackageNameRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/EventsHealthStateFilterOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "A successful operation will return 200 status code and the health information of the deployed service package for a specific node and application.",
+            "schema": {
+              "$ref": "#/definitions/DeployedServicePackageHealth"
+            }
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      },
+      "post": {
+        "operationId": "GetDeployedServicePackageHealthUsingPolicy",
+        "summary": "Gets the information about health of service package for a specific application deployed on a Service Fabric node using the specified policy.",
+        "description": "Gets the information about health of a service package for a specific application deployed on a Service Fabric node. using the specified policy. Use EventsHealthStateFilter to optionally filter for the collection of HealthEvent objects reported on the deployed service package based on health state. Use ApplicationHealthPolicy to optionally override the health policies used to evaluate the health. This API only uses 'ConsiderWarningAsError' field of the ApplicationHealthPolicy. The rest of the fields are ignored while evaluating the health of the deployed service package.",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-0_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/NodeNameRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/ApplicationIdRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/ServicePackageNameRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/EventsHealthStateFilterOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/ApplicationHealthPolicyOptionalBodyParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "tags": [
+          "Service Package"
+        ],
+        "responses": {
+          "200": {
+            "description": "A successful operation will return 200 status code and the health information of the deployed service package for a specific node and application.",
+            "schema": {
+              "$ref": "#/definitions/DeployedServicePackageHealth"
+            }
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/Nodes/{nodeName}/$/GetApplications/{applicationId}/$/GetServicePackages/{servicePackageName}/$/ReportHealth": {
+      "post": {
+        "operationId": "ReportDeployedServicePackageHealth",
+        "summary": "Sends a health report on the Service Fabric deployed service package.",
+        "description": "Reports health state of the service package of the application deployed on a Service Fabric node. The report must contain the information about the source of the health report and property on which it is reported.\nThe report is sent to a Service Fabric gateway Service, which forwards to the health store.\nThe report may be accepted by the gateway, but rejected by the health store after extra validation.\nFor example, the health store may reject the report because of an invalid parameter, like a stale sequence number.\nTo see whether the report was applied in the health store, get deployed service package health and check that the report appears in the HealthEvents section.",
+        "tags": [
+          "Service Package"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-0_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/NodeNameRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/ApplicationIdRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/ServicePackageNameRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/HealthInformationRequiredBodyParam"
+          },
+          {
+            "$ref": "#/parameters/ImmediateOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "A successful operation will return 200 status code."
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/Nodes/{nodeName}/$/DeployServicePackage": {
+      "post": {
+        "operationId": "DeployServicePackageToNode",
+        "summary": "Downloads all of the code packages associated with specified service manifest on the specified node.",
+        "description": "This API provides a way to download code packages including the container images on a specific node outside of the normal application deployment and upgrade path. This is useful for the large code packages and container images to be present on the node before the actual application deployment and upgrade, thus significantly reducing the total time required for the deployment or upgrade.",
+        "tags": [
+          "Service Package"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-0_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/NodeNameRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/DeployServicePackageToNodeRequiredBodyParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "A successful operation will return 200 status code."
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/Nodes/{nodeName}/$/GetApplications/{applicationId}/$/GetCodePackages": {
+      "get": {
+        "operationId": "GetDeployedCodePackageInfoList",
+        "summary": "Gets the list of code packages deployed on a Service Fabric node.",
+        "description": "Gets the list of code packages deployed on a Service Fabric node for the given application.",
+        "tags": [
+          "Code Package"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-0_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/NodeNameRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/ApplicationIdRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/ServiceManifestNameOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/CodePackageNameOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "A successful operation will return 200 status code and the list of deployed code packages information.",
+            "schema": {
+              "$ref": "#/definitions/DeployedCodePackageInfoList"
+            }
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/Nodes/{nodeName}/$/GetApplications/{applicationId}/$/GetCodePackages/$/Restart": {
+      "post": {
+        "operationId": "RestartDeployedCodePackage",
+        "summary": "Restarts a code package deployed on a Service Fabric node in a cluster.",
+        "description": "Restarts a code package deployed on a Service Fabric node in a cluster. This aborts the code package process, which will restart all the user service replicas hosted in that process.",
+        "tags": [
+          "Code Package"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-0_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/NodeNameRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/ApplicationIdRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/RestartDeployedCodePackageRequiredBodyParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "A successful operation will return 200 status code."
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/Nodes/{nodeName}/$/GetApplications/{applicationId}/$/GetCodePackages/$/ContainerLogs": {
+      "get": {
+        "operationId": "GetContainerLogsDeployedOnNode",
+        "summary": "Gets the container logs for container deployed on a Service Fabric node.",
+        "description": "Gets the container logs for container deployed on a Service Fabric node for the given code package.",
+        "tags": [
+          "Code Package"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-2_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/NodeNameRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/ApplicationIdRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/ServiceManifestNameRequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/CodePackageNameRequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/TailOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/PreviousOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "x-ms-examples": {
+          "Get container logs for given code package": {
+            "$ref": "./examples/GetContainerLogsDeployedOnNode-1.json"
+          },
+          "Get last 10 lines of container logs": {
+            "$ref": "./examples/GetContainerLogsDeployedOnNode-2.json"
+          },
+          "Get container logs of previous dead container for given code package": {
+            "$ref": "./examples/GetContainerLogsDeployedOnNode-3.json"
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "A successful operation will return 200 status code and the container logs for container deployed on a Service Fabric node for the given code package.",
+            "schema": {
+              "$ref": "#/definitions/ContainerLogs"
+            }
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/Nodes/{nodeName}/$/GetApplications/{applicationId}/$/GetCodePackages/$/ContainerApi": {
+      "post": {
+        "operationId": "InvokeContainerApi",
+        "summary": "Invoke container API on a container deployed on a Service Fabric node.",
+        "description": "Invoke container API on a container deployed on a Service Fabric node for the given code package.",
+        "x-ms-examples": {
+          "Get container logs": {
+            "$ref": "./examples/InvokeContainerApi.json"
+          },
+          "Update container": {
+            "$ref": "./examples/InvokeContainerApi_Post.json"
+          }
+        },
+        "tags": [
+          "Code Package"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-2_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/NodeNameRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/ApplicationIdRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/ServiceManifestNameRequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/CodePackageNameRequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/CodePackageInstanceIdRequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/ContainerApiRequiredBodyParam"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "A successful operation will return 200 status code and container API response for a container deployed on a Service Fabric node for the given code package.",
+            "schema": {
+              "$ref": "#/definitions/ContainerApiResponse"
+            }
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/ComposeDeployments/$/Create": {
+      "put": {
+        "summary": "Creates a Service Fabric compose deployment.",
+        "description": "Compose is a file format that describes multi-container applications. This API allows deploying container based applications defined in compose format in a Service Fabric cluster. Once the deployment is created, its status can be tracked via the `GetComposeDeploymentStatus` API.",
+        "operationId": "CreateComposeDeployment",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-0-Preview_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/CreateComposeDeploymentRequiredBodyParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "tags": [
+          "Compose Deployment"
+        ],
+        "responses": {
+          "202": {
+            "description": "A successful operation will return 202 status code."
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/ComposeDeployments/{deploymentName}": {
+      "get": {
+        "summary": "Gets information about a Service Fabric compose deployment.",
+        "description": "Returns the status of the compose deployment that was created or in the process of being created in the Service Fabric cluster and whose name matches the one specified as the parameter. The response includes the name, status, and other details about the deployment.",
+        "operationId": "GetComposeDeploymentStatus",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-0-Preview_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/DeploymentNameRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "tags": [
+          "Compose Deployment"
+        ],
+        "responses": {
+          "200": {
+            "description": "Information about the compose deployment.",
+            "schema": {
+              "$ref": "#/definitions/ComposeDeploymentStatusInfo"
+            }
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/ComposeDeployments": {
+      "get": {
+        "summary": "Gets the list of compose deployments created in the Service Fabric cluster.",
+        "description": "Gets the status about the compose deployments that were created or in the process of being created in the Service Fabric cluster. The response includes the name, status, and other details about the compose deployments. If the list of deployments do not fit in a page, one page of results is returned as well as a continuation token, which can be used to get the next page.",
+        "operationId": "GetComposeDeploymentStatusList",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-0-Preview_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/ContinuationTokenOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/MaxResultsOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "tags": [
+          "Compose Deployment"
+        ],
+        "responses": {
+          "200": {
+            "description": "List of status of compose deployments in the cluster.",
+            "schema": {
+              "$ref": "#/definitions/PagedComposeDeploymentStatusInfoList"
+            }
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/ComposeDeployments/{deploymentName}/$/GetUpgradeProgress": {
+      "get": {
+        "summary": "Gets details for the latest upgrade performed on this Service Fabric compose deployment.",
+        "description": "Returns the information about the state of the compose deployment upgrade along with details to aid debugging application health issues.",
+        "operationId": "GetComposeDeploymentUpgradeProgress",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-0-Preview_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/DeploymentNameRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "tags": [
+          "Compose Deployment"
+        ],
+        "responses": {
+          "200": {
+            "description": "Details about the compose deployment upgrade.",
+            "schema": {
+              "$ref": "#/definitions/ComposeDeploymentUpgradeProgressInfo"
+            }
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/ComposeDeployments/{deploymentName}/$/Delete": {
+      "post": {
+        "summary": "Deletes an existing Service Fabric compose deployment from cluster.",
+        "description": "Deletes an existing Service Fabric compose deployment.",
+        "operationId": "RemoveComposeDeployment",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-0-Preview_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/DeploymentNameRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "tags": [
+          "Compose Deployment"
+        ],
+        "responses": {
+          "202": {
+            "description": "A successful operation will return 202 status code."
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/ComposeDeployments/{deploymentName}/$/Upgrade": {
+      "post": {
+        "summary": "Starts upgrading a compose deployment in the Service Fabric cluster.",
+        "description": "Validates the supplied upgrade parameters and starts upgrading the deployment if the parameters are valid.",
+        "operationId": "StartComposeDeploymentUpgrade",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-0-Preview_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/DeploymentNameRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/ComposeDeploymentUpgradeDescriptionRequiredBodyParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "tags": [
+          "Compose Deployment"
+        ],
+        "responses": {
+          "202": {
+            "description": "A successful response means that the upgrade has started. Use GetComposeDeploymentUpgrade operation to get the status of the upgrade."
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/ComposeDeployments/{deploymentName}/$/RollbackUpgrade": {
+      "post": {
+        "summary": "Starts rolling back a compose deployment upgrade in the Service Fabric cluster.",
+        "description": "Rollback a service fabric compose deployment upgrade.",
+        "operationId": "StartRollbackComposeDeploymentUpgrade",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-4-Preview_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/DeploymentNameRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "tags": [
+          "Compose Deployment"
+        ],
+        "responses": {
+          "200": {
+            "description": "A successful response means that the rollback has started. Use GetComposeDeploymentUpgrade operation to get the status of the rollback."
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/Tools/Chaos": {
+      "get": {
+        "operationId": "GetChaos",
+        "summary": "Get the status of Chaos.",
+        "description": "Get the status of Chaos indicating whether or not Chaos is running, the Chaos parameters used for running Chaos and the status of the Chaos Schedule.",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-2_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "tags": [
+          "Chaos"
+        ],
+        "responses": {
+          "200": {
+            "description": "A successful operation will return 200 status code and the status of Chaos.",
+            "schema": {
+              "$ref": "#/definitions/Chaos"
+            }
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/Tools/Chaos/$/Start": {
+      "post": {
+        "operationId": "StartChaos",
+        "summary": "Starts Chaos in the cluster.",
+        "description": "If Chaos is not already running in the cluster, it starts Chaos with the passed in Chaos parameters.\nIf Chaos is already running when this call is made, the call fails with the error code FABRIC_E_CHAOS_ALREADY_RUNNING.\nRefer to the article [Induce controlled Chaos in Service Fabric clusters](https://docs.microsoft.com/azure/service-fabric/service-fabric-controlled-chaos) for more details.",
+        "tags": [
+          "Chaos"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-0_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/ChaosParametersRequiredBodyParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "A successful operation will return 200 status code."
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/Tools/Chaos/$/Stop": {
+      "post": {
+        "operationId": "StopChaos",
+        "summary": "Stops Chaos if it is running in the cluster and put the Chaos Schedule in a stopped state.",
+        "description": "Stops Chaos from executing new faults. In-flight faults will continue to execute until they are complete. The current Chaos Schedule is put into a stopped state.\nOnce a schedule is stopped, it will stay in the stopped state and not be used to Chaos Schedule new runs of Chaos. A new Chaos Schedule must be set in order to resume scheduling.",
+        "tags": [
+          "Chaos"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-0_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "A successful operation will return 200 status code."
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/Tools/Chaos/Events": {
+      "get": {
+        "operationId": "GetChaosEvents",
+        "summary": "Gets the next segment of the Chaos events based on the continuation token or the time range.",
+        "description": "To get the next segment of the Chaos events, you can specify the ContinuationToken. To get the start of a new segment of Chaos events, you can specify the time range\nthrough StartTimeUtc and EndTimeUtc. You cannot specify both the ContinuationToken and the time range in the same call.\nWhen there are more than 100 Chaos events, the Chaos events are returned in multiple segments where a segment contains no more than 100 Chaos events and to get the next segment you make a call to this API with the continuation token.",
+        "x-ms-examples": {
+          "Get Chaos events given a time range": {
+            "$ref": "./examples/GetChaosEvents.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-2_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/ContinuationTokenOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/StartTimeUtcOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/EndTimeUtcOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/MaxResultsOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "tags": [
+          "Chaos"
+        ],
+        "responses": {
+          "200": {
+            "description": "Next segment of Chaos events.",
+            "schema": {
+              "$ref": "#/definitions/ChaosEventsSegment"
+            }
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/Tools/Chaos/Schedule": {
+      "get": {
+        "operationId": "GetChaosSchedule",
+        "summary": "Get the Chaos Schedule defining when and how to run Chaos.",
+        "description": "Gets the version of the Chaos Schedule in use and the Chaos Schedule that defines when and how to run Chaos.",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-2_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "tags": [
+          "Chaos"
+        ],
+        "responses": {
+          "200": {
+            "description": "A successful operation will return 200 status code and the schedule description including a Chaos Schedule used by Chaos and the version the Chaos Schedule is on.",
+            "schema": {
+              "$ref": "#/definitions/ChaosScheduleDescription"
+            }
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      },
+      "post": {
+        "operationId": "PostChaosSchedule",
+        "summary": "Set the schedule used by Chaos.",
+        "description": "Chaos will automatically schedule runs based on the Chaos Schedule.\nThe Chaos Schedule will be updated if the provided version matches the version on the server.\nWhen updating the Chaos Schedule, the version on the server is incremented by 1.\nThe version on the server will wrap back to 0 after reaching a large number.\nIf Chaos is running when this call is made, the call will fail.",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-2_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/ChaosScheduleRequiredBodyParam"
+          }
+        ],
+        "tags": [
+          "Chaos"
+        ],
+        "responses": {
+          "200": {
+            "description": "A successful operation will return 200 status code."
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/ImageStore/{contentPath}": {
+      "put": {
+        "summary": "Uploads contents of the file to the image store.",
+        "description": "Uploads contents of the file to the image store. Use this API if the file is small enough to upload again if the connection fails. The file's data needs to be added to the request body. The contents will be uploaded to the specified path. Image store service uses a mark file to indicate the availability of the folder. The mark file is an empty file named \"_.dir\". The mark file is generated by the image store service when all files in a folder are uploaded. When using File-by-File approach to upload application package in REST, the image store service isn't aware of the file hierarchy of the application package; you need to create a mark file per folder and upload it last, to let the image store service know that the folder is complete.",
+        "operationId": "UploadFile",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-0_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/ImageStoreContentPathRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "tags": [
+          "ImageStore"
+        ],
+        "responses": {
+          "200": {
+            "description": "If the upload request succeeds, the server returns the HTTP 200 OK status code."
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      },
+      "get": {
+        "summary": "Gets the image store content information.",
+        "description": "Returns the information about the image store content at the specified contentPath. The contentPath is relative to the root of the image store.",
+        "operationId": "GetImageStoreContent",
+        "x-ms-examples": {
+          "Get information about image store content under a given relative path": {
+            "$ref": "./examples/GetImageStoreContent.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-2_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/ImageStoreContentPathRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "tags": [
+          "ImageStore"
+        ],
+        "responses": {
+          "200": {
+            "description": "A successful operation will return 200 status code and the requested image store content information.",
+            "schema": {
+              "$ref": "#/definitions/ImageStoreContent"
+            }
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      },
+      "delete": {
+        "summary": "Deletes existing image store content.",
+        "description": "Deletes existing image store content being found within the given image store relative path. This command can be used to delete uploaded application packages once they are provisioned.",
+        "operationId": "DeleteImageStoreContent",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-0_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/ImageStoreContentPathRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "tags": [
+          "ImageStore"
+        ],
+        "responses": {
+          "200": {
+            "description": "A successful operation will return 200 status code."
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/ImageStore": {
+      "get": {
+        "summary": "Gets the content information at the root of the image store.",
+        "description": "Returns the information about the image store content at the root of the image store.",
+        "operationId": "GetImageStoreRootContent",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-0_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "tags": [
+          "ImageStore"
+        ],
+        "responses": {
+          "200": {
+            "description": "A successful operation will return 200 status code and the requested image store content information.",
+            "schema": {
+              "$ref": "#/definitions/ImageStoreContent"
+            }
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/ImageStore/$/Copy": {
+      "post": {
+        "summary": "Copies image store content internally",
+        "description": "Copies the image store content from the source image store relative path to the destination image store relative path.",
+        "operationId": "CopyImageStoreContent",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-0_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/ImageStoreCopyDescriptionRequiredBodyParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "tags": [
+          "ImageStore"
+        ],
+        "responses": {
+          "200": {
+            "description": "A successful operation will return 200 status code."
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/ImageStore/$/DeleteUploadSession": {
+      "delete": {
+        "summary": "Cancels an image store upload session.",
+        "description": "The DELETE request will cause the existing upload session to expire and remove any previously uploaded file chunks.",
+        "operationId": "DeleteImageStoreUploadSession",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-0_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/UploadSessionIdRequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "tags": [
+          "ImageStore"
+        ],
+        "responses": {
+          "200": {
+            "description": "A successful operation will return 200 status code."
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/ImageStore/$/CommitUploadSession": {
+      "post": {
+        "summary": "Commit an image store upload session.",
+        "description": "When all file chunks have been uploaded, the upload session needs to be committed explicitly to complete the upload. Image store preserves the upload session until the expiration time, which is 30 minutes after the last chunk received. ",
+        "operationId": "CommitImageStoreUploadSession",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-0_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/UploadSessionIdRequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "tags": [
+          "ImageStore"
+        ],
+        "responses": {
+          "200": {
+            "description": "If the commit request succeeds, the server returns the HTTP 200 OK status code."
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/ImageStore/$/GetUploadSession": {
+      "get": {
+        "summary": "Get the image store upload session by ID.",
+        "description": "Gets the image store upload session identified by the given ID. User can query the upload session at any time during uploading. ",
+        "operationId": "GetImageStoreUploadSessionById",
+        "x-ms-examples": {
+          "Get information about image store upload session by a given ID": {
+            "$ref": "./examples/GetUploadSessionById.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-0_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/UploadSessionIdRequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "tags": [
+          "ImageStore"
+        ],
+        "responses": {
+          "200": {
+            "description": "A successful operation will return 200 status code and the requested image store upload session information.",
+            "schema": {
+              "$ref": "#/definitions/UploadSession"
+            }
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/ImageStore/{contentPath}/$/GetUploadSession": {
+      "get": {
+        "summary": "Get the image store upload session by relative path.",
+        "description": "Gets the image store upload session associated with the given image store relative path. User can query the upload session at any time during uploading. ",
+        "operationId": "GetImageStoreUploadSessionByPath",
+        "x-ms-examples": {
+          "Get information about image store upload session by a given relative path": {
+            "$ref": "./examples/GetUploadSessionByPath.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-0_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/ImageStoreContentPathRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "tags": [
+          "ImageStore"
+        ],
+        "responses": {
+          "200": {
+            "description": "A successful operation will return 200 status code and the requested image store upload session information.",
+            "schema": {
+              "$ref": "#/definitions/UploadSession"
+            }
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/ImageStore/{contentPath}/$/UploadChunk": {
+      "put": {
+        "summary": "Uploads a file chunk to the image store relative path.",
+        "description": "Uploads a file chunk to the image store with the specified upload session ID and image store relative path. This API allows user to resume the file upload operation. user doesn't have to restart the file upload from scratch whenever there is a network interruption. Use this option if the file size is large.\n\nTo perform a resumable file upload, user need to break the file into multiple chunks and upload these chunks to the image store one-by-one. Chunks don't have to be uploaded in order. If the file represented by the image store relative path already exists, it will be overwritten when the upload session commits.",
+        "operationId": "UploadFileChunk",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-0_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/ImageStoreContentPathRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/UploadSessionIdRequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/UploadFileChunkContentRangeHeaderParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "tags": [
+          "ImageStore"
+        ],
+        "responses": {
+          "200": {
+            "description": "A successful operation will return the HTTP 200 OK status code."
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/ImageStore/$/FolderSize": {
+      "get": {
+        "summary": "Get the folder size at the root of the image store.",
+        "description": "Returns the total size of files at the root and children folders in image store.",
+        "operationId": "GetImageStoreRootFolderSize",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-5_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "tags": [
+          "ImageStore"
+        ],
+        "responses": {
+          "200": {
+            "description": "A successful operation will return 200 status code and the requested folder size in image store.",
+            "schema": {
+              "$ref": "#/definitions/FolderSizeInfo"
+            }
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/ImageStore/{contentPath}/$/FolderSize": {
+      "get": {
+        "summary": "Get the size of a folder in image store",
+        "description": "Gets the total size of file under a image store folder, specified by contentPath. The contentPath is relative to the root of the image store.",
+        "operationId": "GetImageStoreFolderSize",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-5_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/ImageStoreContentPathRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "tags": [
+          "ImageStore"
+        ],
+        "responses": {
+          "200": {
+            "description": "A successful operation will return 200 status code and the requested folder size in image store.",
+            "schema": {
+              "$ref": "#/definitions/FolderSizeInfo"
+            }
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/ImageStore/$/Info": {
+      "get": {
+        "summary": "Gets the overall ImageStore information",
+        "description": "Returns information about the primary ImageStore replica, such as disk capacity and available disk space at the node it is on, and several categories of the ImageStore's file system usage.",
+        "operationId": "GetImageStoreInfo",
+        "x-ms-examples": {
+          "Gets the overall ImageStore information": {
+            "$ref": "./examples/GetImageStoreInfo.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-5_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "tags": [
+          "ImageStore"
+        ],
+        "responses": {
+          "200": {
+            "description": "A successful operation will return 200 status code and the requested ImageStore info",
+            "schema": {
+              "$ref": "#/definitions/ImageStoreInfo"
+            }
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/$/InvokeInfrastructureCommand": {
+      "post": {
+        "operationId": "InvokeInfrastructureCommand",
+        "summary": "Invokes an administrative command on the given Infrastructure Service instance.",
+        "description": "For clusters that have one or more instances of the Infrastructure Service configured,\nthis API provides a way to send infrastructure-specific commands to a particular\ninstance of the Infrastructure Service.\n\nAvailable commands and their corresponding response formats vary depending upon\nthe infrastructure on which the cluster is running.\n\nThis API supports the Service Fabric platform; it is not meant to be used directly from your code.",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-0_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/InfrastructureCommandRequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/InfrastructureServiceIdOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "tags": [
+          "Infrastructure"
+        ],
+        "responses": {
+          "200": {
+            "description": "The response from the infrastructure service. The response format is a JSON stream.\nThe contents of the response depend on which command was issued.",
+            "schema": {
+              "$ref": "#/definitions/InfrastructureServiceResponse"
+            }
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/$/InvokeInfrastructureQuery": {
+      "get": {
+        "operationId": "InvokeInfrastructureQuery",
+        "summary": "Invokes a read-only query on the given infrastructure service instance.",
+        "description": "For clusters that have one or more instances of the Infrastructure Service configured,\nthis API provides a way to send infrastructure-specific queries to a particular\ninstance of the Infrastructure Service.\n\nAvailable commands and their corresponding response formats vary depending upon\nthe infrastructure on which the cluster is running.\n\nThis API supports the Service Fabric platform; it is not meant to be used directly from your code.",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-0_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/InfrastructureCommandRequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/InfrastructureServiceIdOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "tags": [
+          "Infrastructure"
+        ],
+        "responses": {
+          "200": {
+            "description": "The response from the infrastructure service. The response format is a JSON stream.\nThe contents of the response depend on which command was issued.",
+            "schema": {
+              "$ref": "#/definitions/InfrastructureServiceResponse"
+            }
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/Faults/Services/{serviceId}/$/GetPartitions/{partitionId}/$/StartDataLoss": {
+      "post": {
+        "operationId": "StartDataLoss",
+        "summary": "This API will induce data loss for the specified partition. It will trigger a call to the OnDataLossAsync API of the partition.",
+        "description": "This API will induce data loss for the specified partition. It will trigger a call to the OnDataLoss API of the partition.\nActual data loss will depend on the specified DataLossMode.\n\n- PartialDataLoss - Only a quorum of replicas are removed and OnDataLoss is triggered for the partition but actual data loss depends on the presence of in-flight replication.\n- FullDataLoss - All replicas are removed hence all data is lost and OnDataLoss is triggered.\n\nThis API should only be called with a stateful service as the target.\n\nCalling this API with a system service as the target is not advised.\n\nNote:  Once this API has been called, it cannot be reversed. Calling CancelOperation will only stop execution and clean up internal system state.\nIt will not restore data if the command has progressed far enough to cause data loss.\n\nCall the GetDataLossProgress API with the same OperationId to return information on the operation started with this API.",
+        "tags": [
+          "Faults"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-0_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/ServiceIdRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/PartitionIdRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/FaultOperationIdRequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/DataLossModeRequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "responses": {
+          "202": {
+            "description": "A 202 status code indicates the operation was accepted.  Call the GetDataLossProgress API to get the progress."
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/Faults/Services/{serviceId}/$/GetPartitions/{partitionId}/$/GetDataLossProgress": {
+      "get": {
+        "summary": "Gets the progress of a partition data loss operation started using the StartDataLoss API.",
+        "description": "Gets the progress of a data loss operation started with StartDataLoss, using the OperationId.",
+        "operationId": "GetDataLossProgress",
+        "x-ms-examples": {
+          "Gets information about a partition data loss operation.  In this case the operation has a State of Completed": {
+            "$ref": "./examples/GetDataLossProgress.json"
+          },
+          "Get information about a partition data loss operation.  In this case the operation is a State of Running": {
+            "$ref": "./examples/GetDataLossProgress-Running.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-0_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/ServiceIdRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/PartitionIdRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/FaultOperationIdRequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "tags": [
+          "Faults"
+        ],
+        "responses": {
+          "200": {
+            "description": "Information about the progress of the partition data loss operation.",
+            "schema": {
+              "$ref": "#/definitions/PartitionDataLossProgress"
+            }
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/Faults/Services/{serviceId}/$/GetPartitions/{partitionId}/$/StartQuorumLoss": {
+      "post": {
+        "operationId": "StartQuorumLoss",
+        "summary": "Induces quorum loss for a given stateful service partition.",
+        "description": "This API is useful for a temporary quorum loss situation on your service.\n\nCall the GetQuorumLossProgress API with the same OperationId to return information on the operation started with this API.\n\nThis can only be called on stateful persisted (HasPersistedState==true) services.  Do not use this API on stateless services or stateful in-memory only services.",
+        "tags": [
+          "Faults"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-0_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/ServiceIdRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/PartitionIdRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/FaultOperationIdRequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/QuorumLossModeRequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/QuorumLossDurationRequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "responses": {
+          "202": {
+            "description": "A 202 status code indicates the operation was accepted.  Call the GetQuorumLossProgress API to get the progress."
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/Faults/Services/{serviceId}/$/GetPartitions/{partitionId}/$/GetQuorumLossProgress": {
+      "get": {
+        "summary": "Gets the progress of a quorum loss operation on a partition started using the StartQuorumLoss API.",
+        "description": "Gets the progress of a quorum loss operation started with StartQuorumLoss, using the provided OperationId.",
+        "operationId": "GetQuorumLossProgress",
+        "x-ms-examples": {
+          "Gets information about a completed quorum loss operation": {
+            "$ref": "./examples/GetQuorumLossProgress.json"
+          },
+          "Gets information about a running quorum operation operation": {
+            "$ref": "./examples/GetQuorumLossProgress-Running.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-0_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/ServiceIdRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/PartitionIdRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/FaultOperationIdRequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "tags": [
+          "Faults"
+        ],
+        "responses": {
+          "200": {
+            "description": "Information about the progress of a partition quorum loss operation.",
+            "schema": {
+              "$ref": "#/definitions/PartitionQuorumLossProgress"
+            }
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/Faults/Services/{serviceId}/$/GetPartitions/{partitionId}/$/StartRestart": {
+      "post": {
+        "operationId": "StartPartitionRestart",
+        "summary": "This API will restart some or all replicas or instances of the specified partition.",
+        "description": "This API is useful for testing failover.\n\nIf used to target a stateless service partition, RestartPartitionMode must be AllReplicasOrInstances.\n\nCall the GetPartitionRestartProgress API using the same OperationId to get the progress.",
+        "tags": [
+          "Faults"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-0_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/ServiceIdRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/PartitionIdRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/FaultOperationIdRequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/RestartPartitionModeRequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "responses": {
+          "202": {
+            "description": "A 202 status code indicates the operation was accepted.  Call the GetPartitionRestartProgress API to get the progress."
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/Faults/Services/{serviceId}/$/GetPartitions/{partitionId}/$/GetRestartProgress": {
+      "get": {
+        "summary": "Gets the progress of a PartitionRestart operation started using StartPartitionRestart.",
+        "description": "Gets the progress of a PartitionRestart started with StartPartitionRestart using the provided OperationId.",
+        "operationId": "GetPartitionRestartProgress",
+        "x-ms-examples": {
+          "Get information a completed PartitionRestart operation": {
+            "$ref": "./examples/GetPartitionRestartProgress.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-0_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/ServiceIdRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/PartitionIdRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/FaultOperationIdRequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "tags": [
+          "Faults"
+        ],
+        "responses": {
+          "200": {
+            "description": "Information about the progress of a partition restart operation.",
+            "schema": {
+              "$ref": "#/definitions/PartitionRestartProgress"
+            }
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/Faults/Nodes/{nodeName}/$/StartTransition/": {
+      "post": {
+        "operationId": "StartNodeTransition",
+        "summary": "Starts or stops a cluster node.",
+        "description": "Starts or stops a cluster node.  A cluster node is a process, not the OS instance itself.  To start a node, pass in \"Start\" for the NodeTransitionType parameter.\nTo stop a node, pass in \"Stop\" for the NodeTransitionType parameter.  This API starts the operation - when the API returns the node may not have finished transitioning yet.\nCall GetNodeTransitionProgress with the same OperationId to get the progress of the operation.",
+        "tags": [
+          "Faults"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-0_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/NodeNameRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/FaultOperationIdRequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/NodeTransitionTypeRequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/NodeInstanceIdRequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/StopDurationInSecondsRequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "responses": {
+          "202": {
+            "description": "A 202 status code indicates the operation was accepted.  Call the GetNodeTransitionProgress API to get the progress."
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/Faults/Nodes/{nodeName}/$/GetTransitionProgress": {
+      "get": {
+        "summary": "Gets the progress of an operation started using StartNodeTransition.",
+        "description": "Gets the progress of an operation started with StartNodeTransition using the provided OperationId.",
+        "operationId": "GetNodeTransitionProgress",
+        "x-ms-examples": {
+          "Gets information about a completed NodeTransition operation": {
+            "$ref": "./examples/GetNodeTransitionProgress.json"
+          },
+          "Gets information about a running NodeTransition operation": {
+            "$ref": "./examples/GetNodeTransitionProgress-Running.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-0_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/NodeNameRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/FaultOperationIdRequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "tags": [
+          "Faults"
+        ],
+        "responses": {
+          "200": {
+            "description": "Information about the progress of a node transition operation.",
+            "schema": {
+              "$ref": "#/definitions/NodeTransitionProgress"
+            }
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/Faults/": {
+      "get": {
+        "operationId": "GetFaultOperationList",
+        "summary": "Gets a list of user-induced fault operations filtered by provided input.",
+        "description": "Gets the list of user-induced fault operations filtered by provided input.",
+        "x-ms-examples": {
+          "Gets information on fault operations": {
+            "$ref": "./examples/GetFaultOperationList.json"
+          }
+        },
+        "tags": [
+          "Faults"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-0_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/TypeFilterRequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/StateFilterRequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "A successful operation will return 200 status code.",
+            "schema": {
+              "$ref": "#/definitions/OperationStatusList"
+            }
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/Faults/$/Cancel": {
+      "post": {
+        "operationId": "CancelOperation",
+        "summary": "Cancels a user-induced fault operation.",
+        "description": "The following APIs start fault operations that may be cancelled by using CancelOperation: StartDataLoss, StartQuorumLoss, StartPartitionRestart, StartNodeTransition.\n\nIf force is false, then the specified user-induced operation will be gracefully stopped and cleaned up.  If force is true, the command will be aborted, and some internal state\nmay be left behind.  Specifying force as true should be used with care.  Calling this API with force set to true is not allowed until this API has already\nbeen called on the same test command with force set to false first, or unless the test command already has an OperationState of OperationState.RollingBack.\nClarification: OperationState.RollingBack means that the system will be/is cleaning up internal system state caused by executing the command.  It will not restore data if the\ntest command was to cause data loss.  For example, if you call StartDataLoss then call this API, the system will only clean up internal state from running the command.\nIt will not restore the target partition's data, if the command progressed far enough to cause data loss.\n\nImportant note:  if this API is invoked with force==true, internal state may be left behind.",
+        "tags": [
+          "Faults"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-0_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/FaultOperationIdRequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/ForceRequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "A successful operation will return 200 status code."
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/BackupRestore/BackupPolicies/$/Create": {
+      "post": {
+        "operationId": "CreateBackupPolicy",
+        "summary": "Creates a backup policy.",
+        "description": "Creates a backup policy which can be associated later with a Service Fabric application, service or a partition for periodic backup.",
+        "x-ms-examples": {
+          "Create a time based backup policy with Azure as backup location": {
+            "$ref": "./examples/CreateBackupPolicy-1.json"
+          },
+          "Create a frequency based backup policy with file share as backup location": {
+            "$ref": "./examples/CreateBackupPolicy-2.json"
+          },
+          "Create a time based backup policy with Dsms Azure as backup location": {
+            "$ref": "./examples/CreateBackupPolicy-3.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/BackupPolicyDescriptionRequiredBodyParam"
+          },
+          {
+            "$ref": "#/parameters/ApiVersion_6-4_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "tags": [
+          "BackupRestore"
+        ],
+        "responses": {
+          "201": {
+            "description": "A successful operation returns 201 status code and creates a new backup policy."
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/BackupRestore/BackupPolicies/{backupPolicyName}/$/Delete": {
+      "post": {
+        "operationId": "DeleteBackupPolicy",
+        "summary": "Deletes the backup policy.",
+        "description": "Deletes an existing backup policy. A backup policy must be created before it can be deleted. A currently active backup policy, associated with any Service Fabric application, service or partition, cannot be deleted without first deleting the mapping.",
+        "x-ms-examples": {
+          "Delete backup policy": {
+            "$ref": "./examples/DeleteBackupPolicy.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/BackupPolicyNameRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/ApiVersion_6-4_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "tags": [
+          "BackupRestore"
+        ],
+        "responses": {
+          "200": {
+            "description": "A successful operation returns 200 status code and deletes the backup policy."
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/BackupRestore/BackupPolicies": {
+      "get": {
+        "operationId": "GetBackupPolicyList",
+        "summary": "Gets all the backup policies configured.",
+        "description": "Get a list of all the backup policies configured.",
+        "x-ms-examples": {
+          "Limit maximum results": {
+            "$ref": "./examples/GetBackupPolicyList-1.json"
+          },
+          "Page using continuation token": {
+            "$ref": "./examples/GetBackupPolicyList-2.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-4_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/ContinuationTokenOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/MaxResultsOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "tags": [
+          "BackupRestore"
+        ],
+        "responses": {
+          "200": {
+            "description": "A successful operation will return 200 status code and paged list of backup policies.",
+            "schema": {
+              "$ref": "#/definitions/PagedBackupPolicyDescriptionList"
+            }
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/BackupRestore/BackupPolicies/{backupPolicyName}": {
+      "get": {
+        "operationId": "GetBackupPolicyByName",
+        "summary": "Gets a particular backup policy by name.",
+        "description": "Gets a particular backup policy identified by {backupPolicyName}",
+        "x-ms-examples": {
+          "Get backup policy by name": {
+            "$ref": "./examples/GetBackupPolicyByName.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/BackupPolicyNameRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/ApiVersion_6-4_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "tags": [
+          "BackupRestore"
+        ],
+        "responses": {
+          "200": {
+            "description": "A successful operation will return 200 status code and the backup policy description.",
+            "schema": {
+              "$ref": "#/definitions/BackupPolicyDescription"
+            }
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/BackupRestore/BackupPolicies/{backupPolicyName}/$/GetBackupEnabledEntities": {
+      "get": {
+        "operationId": "GetAllEntitiesBackedUpByPolicy",
+        "summary": "Gets the list of backup entities that are associated with this policy.",
+        "description": "Returns a list of Service Fabric application, service or partition which are associated with this backup policy.",
+        "x-ms-examples": {
+          "Limit maximum results": {
+            "$ref": "./examples/GetAllEntitiesBackedUpByPolicy-1.json"
+          },
+          "Page using continuation token": {
+            "$ref": "./examples/GetAllEntitiesBackedUpByPolicy-2.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/BackupPolicyNameRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/ApiVersion_6-4_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/ContinuationTokenOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/MaxResultsOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "tags": [
+          "BackupRestore"
+        ],
+        "responses": {
+          "200": {
+            "description": "A successful operation will return 200 status code and a paged list of Service Fabric entities that are associated with this policy.",
+            "schema": {
+              "$ref": "#/definitions/PagedBackupEntityList"
+            }
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/BackupRestore/BackupPolicies/{backupPolicyName}/$/Update": {
+      "post": {
+        "operationId": "UpdateBackupPolicy",
+        "summary": "Updates the backup policy.",
+        "description": "Updates the backup policy identified by {backupPolicyName}",
+        "x-ms-examples": {
+          "Update backup policy": {
+            "$ref": "./examples/UpdateBackupPolicy.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/BackupPolicyDescriptionRequiredBodyParam"
+          },
+          {
+            "$ref": "#/parameters/BackupPolicyNameRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/ApiVersion_6-4_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "tags": [
+          "BackupRestore"
+        ],
+        "responses": {
+          "200": {
+            "description": "A successful operation returns 200 status code and updates the backup policy description."
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/Applications/{applicationId}/$/EnableBackup": {
+      "post": {
+        "operationId": "EnableApplicationBackup",
+        "summary": "Enables periodic backup of stateful partitions under this Service Fabric application.",
+        "description": "Enables periodic backup of stateful partitions which are part of this Service Fabric application. Each partition is backed up individually as per the specified backup policy description. \nNote only C# based Reliable Actor and Reliable Stateful services are currently supported for periodic backup.",
+        "x-ms-examples": {
+          "Enable application backup": {
+            "$ref": "./examples/EnableApplicationBackup.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApplicationIdRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/EnableBackupDescriptionRequiredBodyParam"
+          },
+          {
+            "$ref": "#/parameters/ApiVersion_6-4_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "tags": [
+          "BackupRestore"
+        ],
+        "responses": {
+          "202": {
+            "description": "A 202 status code indicates the request to enable application backup has been accepted."
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/Applications/{applicationId}/$/DisableBackup": {
+      "post": {
+        "operationId": "DisableApplicationBackup",
+        "summary": "Disables periodic backup of Service Fabric application.",
+        "description": "Disables periodic backup of Service Fabric application which was previously enabled.",
+        "x-ms-examples": {
+          "Disable application backup": {
+            "$ref": "./examples/DisableApplicationBackup.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApplicationIdRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/ApiVersion_6-4_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/DisableBackupDescriptionOptionalBodyParam"
+          }
+        ],
+        "tags": [
+          "BackupRestore"
+        ],
+        "responses": {
+          "202": {
+            "description": "A 202 status code indicates the request to disable application backup has been accepted."
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/Applications/{applicationId}/$/GetBackupConfigurationInfo": {
+      "get": {
+        "operationId": "GetApplicationBackupConfigurationInfo",
+        "summary": "Gets the Service Fabric application backup configuration information.",
+        "description": "Gets the Service Fabric backup configuration information for the application and the services and partitions under this application.",
+        "x-ms-examples": {
+          "Limit maximum results": {
+            "$ref": "./examples/GetApplicationBackupConfigurationInfo-1.json"
+          },
+          "Page using continuation token": {
+            "$ref": "./examples/GetApplicationBackupConfigurationInfo-2.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApplicationIdRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/ApiVersion_6-4_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/ContinuationTokenOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/MaxResultsOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "tags": [
+          "BackupRestore"
+        ],
+        "responses": {
+          "200": {
+            "description": "A successful operation will return 200 status code and a paged list of backup configuration information for the application, and the services and partitions under this application, for which backup configuration has been overridden.",
+            "schema": {
+              "$ref": "#/definitions/PagedBackupConfigurationInfoList"
+            }
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/Applications/{applicationId}/$/GetBackups": {
+      "get": {
+        "operationId": "GetApplicationBackupList",
+        "summary": "Gets the list of backups available for every partition in this application.",
+        "description": "Returns a list of backups available for every partition in this Service Fabric application. The server enumerates all the backups available at the backup location configured in the backup policy. It also allows filtering of the result based on start and end datetime or just fetching the latest available backup for every partition.",
+        "x-ms-examples": {
+          "Get application backups within a time range": {
+            "$ref": "./examples/GetApplicationBackupList-1.json"
+          },
+          "Get latest backup": {
+            "$ref": "./examples/GetApplicationBackupList-2.json"
+          },
+          "Limit maximum results": {
+            "$ref": "./examples/GetApplicationBackupList-3.json"
+          },
+          "Page using continuation token": {
+            "$ref": "./examples/GetApplicationBackupList-4.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApplicationIdRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/ApiVersion_6-4_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/LatestOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/StartDateTimeFilterOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/EndDateTimeFilterOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/ContinuationTokenOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/MaxResultsOptionalQueryParam"
+          }
+        ],
+        "tags": [
+          "BackupRestore"
+        ],
+        "responses": {
+          "200": {
+            "description": "A successful operation will return 200 status code and a paged list of backup information.",
+            "schema": {
+              "$ref": "#/definitions/PagedBackupInfoList"
+            }
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/Applications/{applicationId}/$/SuspendBackup": {
+      "post": {
+        "operationId": "SuspendApplicationBackup",
+        "summary": "Suspends periodic backup for the specified Service Fabric application.",
+        "description": "The application which is configured to take periodic backups, is suspended for taking further backups till it is resumed again. This operation applies to the entire application's hierarchy. It means all the services and partitions under this application are now suspended for backup.",
+        "x-ms-examples": {
+          "Suspend application backup": {
+            "$ref": "./examples/SuspendApplicationBackup.json"
+          }
+        },
+        "tags": [
+          "BackupRestore"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApplicationIdRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/ApiVersion_6-4_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "responses": {
+          "202": {
+            "description": "A 202 status code indicates the operation request was accepted and application backup will be suspended."
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/Applications/{applicationId}/$/ResumeBackup": {
+      "post": {
+        "operationId": "ResumeApplicationBackup",
+        "summary": "Resumes periodic backup of a Service Fabric application which was previously suspended.",
+        "description": "The previously suspended Service Fabric application resumes taking periodic backup as per the backup policy currently configured for the same.",
+        "x-ms-examples": {
+          "Resume application backup": {
+            "$ref": "./examples/ResumeApplicationBackup.json"
+          }
+        },
+        "tags": [
+          "BackupRestore"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApplicationIdRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/ApiVersion_6-4_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "responses": {
+          "202": {
+            "description": "A 202 status code indicates the operation request was accepted and application backup will be resumed."
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/Services/{serviceId}/$/EnableBackup": {
+      "post": {
+        "operationId": "EnableServiceBackup",
+        "summary": "Enables periodic backup of stateful partitions under this Service Fabric service.",
+        "description": "Enables periodic backup of stateful partitions which are part of this Service Fabric service. Each partition is backed up individually as per the specified backup policy description. In case the application, which the service is part of, is already enabled for backup then this operation would override the policy being used to take the periodic backup for this service and its partitions (unless explicitly overridden at the partition level).\nNote only C# based Reliable Actor and Reliable Stateful services are currently supported for periodic backup.",
+        "x-ms-examples": {
+          "Enable service backup": {
+            "$ref": "./examples/EnableServiceBackup.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/ServiceIdRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/EnableBackupDescriptionRequiredBodyParam"
+          },
+          {
+            "$ref": "#/parameters/ApiVersion_6-4_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "tags": [
+          "BackupRestore"
+        ],
+        "responses": {
+          "202": {
+            "description": "A 202 status code indicates the request to enable service backup has been accepted."
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/Services/{serviceId}/$/DisableBackup": {
+      "post": {
+        "operationId": "DisableServiceBackup",
+        "summary": "Disables periodic backup of Service Fabric service which was previously enabled.",
+        "description": "Disables periodic backup of Service Fabric service which was previously enabled. Backup must be explicitly enabled before it can be disabled.\nIn case the backup is enabled for the Service Fabric application, which this service is part of, this service would continue to be periodically backed up as per the policy mapped at the application level.",
+        "x-ms-examples": {
+          "Disable service backup": {
+            "$ref": "./examples/DisableServiceBackup.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/ServiceIdRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/ApiVersion_6-4_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/DisableBackupDescriptionOptionalBodyParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "tags": [
+          "BackupRestore"
+        ],
+        "responses": {
+          "202": {
+            "description": "A 202 status code indicates the request to disable service backup has been accepted."
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/Services/{serviceId}/$/GetBackupConfigurationInfo": {
+      "get": {
+        "operationId": "GetServiceBackupConfigurationInfo",
+        "summary": "Gets the Service Fabric service backup configuration information.",
+        "description": "Gets the Service Fabric backup configuration information for the service and the partitions under this service.",
+        "x-ms-examples": {
+          "Limit maximum results": {
+            "$ref": "./examples/GetServiceBackupConfigurationInfo-1.json"
+          },
+          "Page using continuation token": {
+            "$ref": "./examples/GetServiceBackupConfigurationInfo-2.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/ServiceIdRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/ApiVersion_6-4_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/ContinuationTokenOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/MaxResultsOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "tags": [
+          "BackupRestore"
+        ],
+        "responses": {
+          "200": {
+            "description": "A successful operation will return 200 status code and a paged list of backup configuration information for the service, and the partitions under this service, for which backup configuration has been overridden.",
+            "schema": {
+              "$ref": "#/definitions/PagedBackupConfigurationInfoList"
+            }
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/Services/{serviceId}/$/GetBackups": {
+      "get": {
+        "operationId": "GetServiceBackupList",
+        "summary": "Gets the list of backups available for every partition in this service.",
+        "description": "Returns a list of backups available for every partition in this Service Fabric service. The server enumerates all the backups available in the backup store configured in the backup policy. It also allows filtering of the result based on start and end datetime or just fetching the latest available backup for every partition.",
+        "x-ms-examples": {
+          "Get application backups within a time range": {
+            "$ref": "./examples/GetServiceBackupList-1.json"
+          },
+          "Get latest backup": {
+            "$ref": "./examples/GetServiceBackupList-2.json"
+          },
+          "Limit maximum results": {
+            "$ref": "./examples/GetServiceBackupList-3.json"
+          },
+          "Page using continuation token": {
+            "$ref": "./examples/GetServiceBackupList-4.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/ServiceIdRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/ApiVersion_6-4_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/LatestOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/StartDateTimeFilterOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/EndDateTimeFilterOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/ContinuationTokenOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/MaxResultsOptionalQueryParam"
+          }
+        ],
+        "tags": [
+          "BackupRestore"
+        ],
+        "responses": {
+          "200": {
+            "description": "A successful operation will return 200 status code and a paged list of backup information.",
+            "schema": {
+              "$ref": "#/definitions/PagedBackupInfoList"
+            }
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/Services/{serviceId}/$/SuspendBackup": {
+      "post": {
+        "operationId": "SuspendServiceBackup",
+        "summary": "Suspends periodic backup for the specified Service Fabric service.",
+        "description": "The service which is configured to take periodic backups, is suspended for taking further backups till it is resumed again. This operation applies to the entire service's hierarchy. It means all the partitions under this service are now suspended for backup.",
+        "x-ms-examples": {
+          "Suspend service backup": {
+            "$ref": "./examples/SuspendServiceBackup.json"
+          }
+        },
+        "tags": [
+          "BackupRestore"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/parameters/ServiceIdRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/ApiVersion_6-4_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "responses": {
+          "202": {
+            "description": "A 202 status code indicates the operation request was accepted and service backup will be suspended."
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/Services/{serviceId}/$/ResumeBackup": {
+      "post": {
+        "operationId": "ResumeServiceBackup",
+        "summary": "Resumes periodic backup of a Service Fabric service which was previously suspended.",
+        "description": "The previously suspended Service Fabric service resumes taking periodic backup as per the backup policy currently configured for the same.",
+        "x-ms-examples": {
+          "Resume service backup": {
+            "$ref": "./examples/ResumeServiceBackup.json"
+          }
+        },
+        "tags": [
+          "BackupRestore"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/parameters/ServiceIdRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/ApiVersion_6-4_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "responses": {
+          "202": {
+            "description": "A 202 status code indicates the operation request was accepted and service backup will be resumed."
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/Partitions/{partitionId}/$/EnableBackup": {
+      "post": {
+        "operationId": "EnablePartitionBackup",
+        "summary": "Enables periodic backup of the stateful persisted partition.",
+        "description": "Enables periodic backup of stateful persisted partition. Each partition is backed up as per the specified backup policy description. In case the application or service, which is partition is part of, is already enabled for backup then this operation would override the policy being used to take the periodic backup of this partition.\nNote only C# based Reliable Actor and Reliable Stateful services are currently supported for periodic backup.",
+        "x-ms-examples": {
+          "Enable partition backup": {
+            "$ref": "./examples/EnablePartitionBackup.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/PartitionIdRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/EnableBackupDescriptionRequiredBodyParam"
+          },
+          {
+            "$ref": "#/parameters/ApiVersion_6-4_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "tags": [
+          "BackupRestore"
+        ],
+        "responses": {
+          "202": {
+            "description": "A 202 status code indicates the request to enable partition backup has been accepted."
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/Partitions/{partitionId}/$/DisableBackup": {
+      "post": {
+        "operationId": "DisablePartitionBackup",
+        "summary": "Disables periodic backup of Service Fabric partition which was previously enabled.",
+        "description": "Disables periodic backup of partition which was previously enabled. Backup must be explicitly enabled before it can be disabled. \nIn case the backup is enabled for the Service Fabric application or service, which this partition is part of, this partition would continue to be periodically backed up as per the policy mapped at the higher level entity.",
+        "x-ms-examples": {
+          "Disable partition backup": {
+            "$ref": "./examples/DisablePartitionBackup.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/PartitionIdRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/ApiVersion_6-4_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/DisableBackupDescriptionOptionalBodyParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "tags": [
+          "BackupRestore"
+        ],
+        "responses": {
+          "202": {
+            "description": "A 202 status code indicates the request to disable partition backup has been accepted."
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/Partitions/{partitionId}/$/GetBackupConfigurationInfo": {
+      "get": {
+        "operationId": "GetPartitionBackupConfigurationInfo",
+        "summary": "Gets the partition backup configuration information",
+        "description": "Gets the Service Fabric Backup configuration information for the specified partition.",
+        "x-ms-examples": {
+          "Get partition backup configuration information": {
+            "$ref": "./examples/GetPartitionBackupConfigurationInfo.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/PartitionIdRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/ApiVersion_6-4_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "tags": [
+          "BackupRestore"
+        ],
+        "responses": {
+          "200": {
+            "description": "A successful operation will return 200 status code and gets the partition's backup configuration information.",
+            "schema": {
+              "$ref": "#/definitions/PartitionBackupConfigurationInfo"
+            }
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/Partitions/{partitionId}/$/GetBackups": {
+      "get": {
+        "operationId": "GetPartitionBackupList",
+        "summary": "Gets the list of backups available for the specified partition.",
+        "description": "Returns a list of backups available for the specified partition. The server enumerates all the backups available in the backup store configured in the backup policy. It also allows filtering of the result based on start and end datetime or just fetching the latest available backup for the partition.",
+        "x-ms-examples": {
+          "Get application backups within a time range": {
+            "$ref": "./examples/GetPartitionBackupList-1.json"
+          },
+          "Get latest backup": {
+            "$ref": "./examples/GetPartitionBackupList-2.json"
+          },
+          "Limit maximum results": {
+            "$ref": "./examples/GetPartitionBackupList-3.json"
+          },
+          "Page using continuation token": {
+            "$ref": "./examples/GetPartitionBackupList-4.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/PartitionIdRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/ApiVersion_6-4_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/LatestOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/StartDateTimeFilterOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/EndDateTimeFilterOptionalQueryParam"
+          }
+        ],
+        "tags": [
+          "BackupRestore"
+        ],
+        "responses": {
+          "200": {
+            "description": "A successful operation will return 200 status code and a paged list of backup information.",
+            "schema": {
+              "$ref": "#/definitions/PagedBackupInfoList"
+            }
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/Partitions/{partitionId}/$/SuspendBackup": {
+      "post": {
+        "operationId": "SuspendPartitionBackup",
+        "summary": "Suspends periodic backup for the specified partition.",
+        "description": "The partition which is configured to take periodic backups, is suspended for taking further backups till it is resumed again.",
+        "x-ms-examples": {
+          "Suspend partition backup": {
+            "$ref": "./examples/SuspendPartitionBackup.json"
+          }
+        },
+        "tags": [
+          "BackupRestore"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/parameters/PartitionIdRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/ApiVersion_6-4_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "responses": {
+          "202": {
+            "description": "A 202 status code indicates the operation request was accepted and partition backup will be suspended."
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/Partitions/{partitionId}/$/ResumeBackup": {
+      "post": {
+        "operationId": "ResumePartitionBackup",
+        "summary": "Resumes periodic backup of partition which was previously suspended.",
+        "description": "The previously suspended partition resumes taking periodic backup as per the backup policy currently configured for the same.",
+        "x-ms-examples": {
+          "Resume partition backup": {
+            "$ref": "./examples/ResumePartitionBackup.json"
+          }
+        },
+        "tags": [
+          "BackupRestore"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/parameters/PartitionIdRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/ApiVersion_6-4_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "responses": {
+          "202": {
+            "description": "A 202 status code indicates the operation request was accepted and partition backup will be resumed."
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/Partitions/{partitionId}/$/Backup": {
+      "post": {
+        "operationId": "BackupPartition",
+        "summary": "Triggers backup of the partition's state.",
+        "description": "Creates a backup of the stateful persisted partition's state. In case the partition is already being periodically backed up, then by default the new backup is created at the same backup storage. One can also override the same by specifying the backup storage details as part of the request body. Once the backup is initiated, its progress can be tracked using the GetBackupProgress operation. \nIn case, the operation times out, specify a greater backup timeout value in the query parameter.",
+        "x-ms-examples": {
+          "Backup partition": {
+            "$ref": "./examples/BackupPartition-1.json"
+          },
+          "Backup partition to a specific Azure storage account": {
+            "$ref": "./examples/BackupPartition-2.json"
+          },
+          "Backup partition to a specific on-premise file share": {
+            "$ref": "./examples/BackupPartition-3.json"
+          },
+          "Backup partition to a specific Dsms Azure storage location": {
+            "$ref": "./examples/BackupPartition-4.json"
+          }
+        },
+        "tags": [
+          "BackupRestore"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/parameters/PartitionIdRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/BackupPartitionDescriptionOptionalBodyParam"
+          },
+          {
+            "$ref": "#/parameters/BackupTimeoutOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/ApiVersion_6-4_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "responses": {
+          "202": {
+            "description": "A 202 status code indicates the operation request was accepted and backup will be initiated. Use GetPartitionBackupProgress operation to get the status of the backup operation."
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/Partitions/{partitionId}/$/GetBackupProgress": {
+      "get": {
+        "operationId": "GetPartitionBackupProgress",
+        "summary": "Gets details for the latest backup triggered for this partition.",
+        "description": "Returns information about the state of the latest backup along with details or failure reason in case of completion.",
+        "x-ms-examples": {
+          "Get backup operation progress": {
+            "$ref": "./examples/GetPartitionBackupProgress.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/PartitionIdRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/ApiVersion_6-4_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "tags": [
+          "BackupRestore"
+        ],
+        "responses": {
+          "200": {
+            "description": "A successful operation returns 200 status code and backup progress details.",
+            "schema": {
+              "$ref": "#/definitions/BackupProgressInfo"
+            }
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/Partitions/{partitionId}/$/Restore": {
+      "post": {
+        "operationId": "RestorePartition",
+        "summary": "Triggers restore of the state of the partition using the specified restore partition description.",
+        "description": "Restores the state of a of the stateful persisted partition using the specified backup point. In case the partition is already being periodically backed up, then by default the backup point is looked for in the storage specified in backup policy. One can also override the same by specifying the backup storage details as part of the restore partition description in body. Once the restore is initiated, its progress can be tracked using the GetRestoreProgress operation. \nIn case, the operation times out, specify a greater restore timeout value in the query parameter.",
+        "x-ms-examples": {
+          "Trigger partition restore": {
+            "$ref": "./examples/RestorePartition.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/PartitionIdRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/RestorePartitionDescriptionRequiredBodyParam"
+          },
+          {
+            "$ref": "#/parameters/RestoreTimeoutOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/ApiVersion_6-4_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "tags": [
+          "BackupRestore"
+        ],
+        "responses": {
+          "202": {
+            "description": "A 202 status code indicates the operation request was accepted and restore will be initiated. Use GetPartitionRestoreProgress operation to get the status of the restore operation."
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/Partitions/{partitionId}/$/GetRestoreProgress": {
+      "get": {
+        "operationId": "GetPartitionRestoreProgress",
+        "summary": "Gets details for the latest restore operation triggered for this partition.",
+        "description": "Returns information about the state of the latest restore operation along with details or failure reason in case of completion.",
+        "x-ms-examples": {
+          "Get restore operation progress": {
+            "$ref": "./examples/GetPartitionRestoreProgress.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/PartitionIdRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/ApiVersion_6-4_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "tags": [
+          "BackupRestore"
+        ],
+        "responses": {
+          "200": {
+            "description": "A successful operation returns 200 status code and restore progress details.",
+            "schema": {
+              "$ref": "#/definitions/RestoreProgressInfo"
+            }
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/BackupRestore/$/GetBackups": {
+      "post": {
+        "operationId": "GetBackupsFromBackupLocation",
+        "summary": "Gets the list of backups available for the specified backed up entity at the specified backup location.",
+        "description": "Gets the list of backups available for the specified backed up entity (Application, Service or Partition) at the specified backup location (FileShare or Azure Blob Storage).",
+        "x-ms-examples": {
+          "Limit maximum results": {
+            "$ref": "./examples/GetBackupsFromBackupLocation-1.json"
+          },
+          "Page using continuation token": {
+            "$ref": "./examples/GetBackupsFromBackupLocation-2.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-4_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/ContinuationTokenOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/MaxResultsOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/GetBackupByStorageQueryDescriptionRequiredBodyParam"
+          }
+        ],
+        "tags": [
+          "BackupRestore"
+        ],
+        "responses": {
+          "200": {
+            "description": "A successful operation will return 200 status code and a paged list of backup information.",
+            "schema": {
+              "$ref": "#/definitions/PagedBackupInfoList"
+            }
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/Names/$/Create": {
+      "post": {
+        "summary": "Creates a Service Fabric name.",
+        "description": "Creates the specified Service Fabric name.",
+        "operationId": "CreateName",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-0_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/NameDescriptionRequiredBodyParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "x-ms-examples": {
+          "Create new name": {
+            "$ref": "examples/CreateName-1.json"
+          }
+        },
+        "tags": [
+          "Property Management"
+        ],
+        "responses": {
+          "201": {
+            "description": "A successful response means that the name has been created."
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/Names/{nameId}": {
+      "get": {
+        "summary": "Returns whether the Service Fabric name exists.",
+        "description": "Returns whether the specified Service Fabric name exists.",
+        "operationId": "GetNameExistsInfo",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-0_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/NameIdRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "tags": [
+          "Property Management"
+        ],
+        "responses": {
+          "200": {
+            "description": "A successful response means that the Service Fabric name exists."
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      },
+      "delete": {
+        "summary": "Deletes a Service Fabric name.",
+        "description": "Deletes the specified Service Fabric name. A name must be created before it can be deleted. Deleting a name with child properties will fail.",
+        "operationId": "DeleteName",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-0_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/NameIdRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "tags": [
+          "Property Management"
+        ],
+        "responses": {
+          "200": {
+            "description": "A successful response means that the Service Fabric name has been deleted."
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/Names/{nameId}/$/GetSubNames": {
+      "get": {
+        "summary": "Enumerates all the Service Fabric names under a given name.",
+        "description": "Enumerates all the Service Fabric names under a given name. If the subnames do not fit in a page, one page of results is returned as well as a continuation token, which can be used to get the next page. Querying a name that doesn't exist will fail.",
+        "operationId": "GetSubNameInfoList",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-0_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/NameIdRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/RecursiveOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/ContinuationTokenOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "x-ms-examples": {
+          "Get sub names": {
+            "$ref": "examples/GetSubNameInfoList-1.json"
+          },
+          "Recursively search sub names": {
+            "$ref": "examples/GetSubNameInfoList-2.json"
+          },
+          "Page using continuation token": {
+            "$ref": "examples/GetSubNameInfoList-3.json"
+          }
+        },
+        "tags": [
+          "Property Management"
+        ],
+        "responses": {
+          "200": {
+            "description": "A paged list of Service Fabric names.",
+            "schema": {
+              "$ref": "#/definitions/PagedSubNameInfoList"
+            }
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/Names/{nameId}/$/GetProperties": {
+      "get": {
+        "summary": "Gets information on all Service Fabric properties under a given name.",
+        "description": "A Service Fabric name can have one or more named properties that store custom information. This operation gets the information about these properties in a paged list. The information includes name, value, and metadata about each of the properties.",
+        "operationId": "GetPropertyInfoList",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-0_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/NameIdRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/IncludeValuesOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/ContinuationTokenOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "x-ms-examples": {
+          "Get property info list": {
+            "$ref": "examples/GetPropertyInfoList-1.json"
+          },
+          "Get property info list with values": {
+            "$ref": "examples/GetPropertyInfoList-2.json"
+          },
+          "Page using continuation token": {
+            "$ref": "examples/GetPropertyInfoList-3.json"
+          }
+        },
+        "tags": [
+          "Property Management"
+        ],
+        "responses": {
+          "200": {
+            "description": "A paged list of Service Fabric properties.",
+            "schema": {
+              "$ref": "#/definitions/PagedPropertyInfoList"
+            }
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/Names/{nameId}/$/GetProperty": {
+      "put": {
+        "summary": "Creates or updates a Service Fabric property.",
+        "description": "Creates or updates the specified Service Fabric property under a given name.",
+        "operationId": "PutProperty",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-0_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/NameIdRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/PropertyDescriptionRequiredBodyParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "x-ms-examples": {
+          "Put property": {
+            "$ref": "examples/PutProperty-1.json"
+          },
+          "Put custom property": {
+            "$ref": "examples/PutProperty-2.json"
+          }
+        },
+        "tags": [
+          "Property Management"
+        ],
+        "responses": {
+          "200": {
+            "description": "A successful response means that the property has been created or updated."
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      },
+      "get": {
+        "summary": "Gets the specified Service Fabric property.",
+        "description": "Gets the specified Service Fabric property under a given name. This will always return both value and metadata.",
+        "operationId": "GetPropertyInfo",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-0_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/NameIdRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/PropertyNameRequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "x-ms-examples": {
+          "Get property info": {
+            "$ref": "examples/GetPropertyInfo-1.json"
+          }
+        },
+        "tags": [
+          "Property Management"
+        ],
+        "responses": {
+          "200": {
+            "description": "Details on the Service Fabric property.",
+            "schema": {
+              "$ref": "#/definitions/PropertyInfo"
+            }
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      },
+      "delete": {
+        "summary": "Deletes the specified Service Fabric property.",
+        "description": "Deletes the specified Service Fabric property under a given name. A property must be created before it can be deleted.",
+        "operationId": "DeleteProperty",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-0_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/NameIdRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/PropertyNameRequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "tags": [
+          "Property Management"
+        ],
+        "responses": {
+          "200": {
+            "description": "A successful response means that the property has been deleted."
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/Names/{nameId}/$/GetProperties/$/SubmitBatch": {
+      "post": {
+        "summary": "Submits a property batch.",
+        "description": "Submits a batch of property operations. Either all or none of the operations will be committed.",
+        "operationId": "SubmitPropertyBatch",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-0_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/NameIdRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/PropertyBatchDescriptionListRequiredBodyParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "x-ms-examples": {
+          "Property batch operation": {
+            "$ref": "examples/SubmitPropertyBatch-1.json"
+          }
+        },
+        "tags": [
+          "Property Management"
+        ],
+        "responses": {
+          "200": {
+            "description": "A successful response means that the property batch succeeded.",
+            "schema": {
+              "$ref": "#/definitions/SuccessfulPropertyBatchInfo"
+            }
+          },
+          "409": {
+            "description": "A 409 response means that one of the property batch operations failed, and contains more information about the failure. None of the operations were committed.",
+            "schema": {
+              "$ref": "#/definitions/FailedPropertyBatchInfo"
+            }
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/EventsStore/Cluster/Events": {
+      "get": {
+        "summary": "Gets all Cluster-related events.",
+        "description": "The response is list of ClusterEvent objects.",
+        "operationId": "GetClusterEventList",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-4_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/StartTimeUtcRequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/EndTimeUtcRequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/EventsTypesFilterOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/ExcludeAnalysisEventsOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/SkipCorrelationLookupOptionalQueryParam"
+          }
+        ],
+        "tags": [
+          "EventsStore"
+        ],
+        "x-ms-examples": {
+          "Get Cluster-related events": {
+            "$ref": "./examples/GetClusterEventList.json"
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "List of events objects with base type ClusterEvent.",
+            "schema": {
+              "$ref": "#/definitions/ClusterEventList"
+            }
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/EventsStore/Containers/Events": {
+      "get": {
+        "summary": "Gets all Containers-related events.",
+        "description": "The response is list of ContainerInstanceEvent objects.",
+        "operationId": "GetContainersEventList",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-2-Preview_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/StartTimeUtcRequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/EndTimeUtcRequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/EventsTypesFilterOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/ExcludeAnalysisEventsOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/SkipCorrelationLookupOptionalQueryParam"
+          }
+        ],
+        "tags": [
+          "EventsStore"
+        ],
+        "responses": {
+          "200": {
+            "description": "List of events objects with base type ContainerInstanceEvent.",
+            "schema": {
+              "$ref": "#/definitions/ContainerInstanceEventList"
+            }
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/EventsStore/Nodes/{nodeName}/$/Events": {
+      "get": {
+        "summary": "Gets a Node-related events.",
+        "description": "The response is list of NodeEvent objects.",
+        "operationId": "GetNodeEventList",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-4_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/NodeNameRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/StartTimeUtcRequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/EndTimeUtcRequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/EventsTypesFilterOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/ExcludeAnalysisEventsOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/SkipCorrelationLookupOptionalQueryParam"
+          }
+        ],
+        "tags": [
+          "EventsStore"
+        ],
+        "x-ms-examples": {
+          "Get Node-related events": {
+            "$ref": "./examples/GetNodeEventList.json"
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "List of events objects with base type NodeEvent.",
+            "schema": {
+              "$ref": "#/definitions/NodeEventList"
+            }
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/EventsStore/Nodes/Events": {
+      "get": {
+        "summary": "Gets all Nodes-related Events.",
+        "description": "The response is list of NodeEvent objects.",
+        "operationId": "GetNodesEventList",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-4_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/StartTimeUtcRequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/EndTimeUtcRequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/EventsTypesFilterOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/ExcludeAnalysisEventsOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/SkipCorrelationLookupOptionalQueryParam"
+          }
+        ],
+        "tags": [
+          "EventsStore"
+        ],
+        "x-ms-examples": {
+          "Get Nodes-related events": {
+            "$ref": "./examples/GetNodesEventList.json"
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "List of events objects with base type NodeEvent.",
+            "schema": {
+              "$ref": "#/definitions/NodeEventList"
+            }
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/EventsStore/Applications/{applicationId}/$/Events": {
+      "get": {
+        "summary": "Gets an Application-related events.",
+        "description": "The response is list of ApplicationEvent objects.",
+        "operationId": "GetApplicationEventList",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-4_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/ApplicationIdRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/StartTimeUtcRequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/EndTimeUtcRequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/EventsTypesFilterOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/ExcludeAnalysisEventsOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/SkipCorrelationLookupOptionalQueryParam"
+          }
+        ],
+        "tags": [
+          "EventsStore"
+        ],
+        "x-ms-examples": {
+          "Get Application-related events": {
+            "$ref": "./examples/GetApplicationEventList.json"
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "List of events objects with base type ApplicationEvent.",
+            "schema": {
+              "$ref": "#/definitions/ApplicationEventList"
+            }
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/EventsStore/Applications/Events": {
+      "get": {
+        "summary": "Gets all Applications-related events.",
+        "description": "The response is list of ApplicationEvent objects.",
+        "operationId": "GetApplicationsEventList",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-4_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/StartTimeUtcRequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/EndTimeUtcRequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/EventsTypesFilterOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/ExcludeAnalysisEventsOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/SkipCorrelationLookupOptionalQueryParam"
+          }
+        ],
+        "tags": [
+          "EventsStore"
+        ],
+        "x-ms-examples": {
+          "Get Applications-related events": {
+            "$ref": "./examples/GetApplicationsEventList.json"
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "List of events objects with base type ApplicationEvent.",
+            "schema": {
+              "$ref": "#/definitions/ApplicationEventList"
+            }
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/EventsStore/Services/{serviceId}/$/Events": {
+      "get": {
+        "summary": "Gets a Service-related events.",
+        "description": "The response is list of ServiceEvent objects.",
+        "operationId": "GetServiceEventList",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-4_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/ServiceIdRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/StartTimeUtcRequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/EndTimeUtcRequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/EventsTypesFilterOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/ExcludeAnalysisEventsOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/SkipCorrelationLookupOptionalQueryParam"
+          }
+        ],
+        "tags": [
+          "EventsStore"
+        ],
+        "x-ms-examples": {
+          "Get Service-related events": {
+            "$ref": "./examples/GetServiceEventList.json"
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "List of events objects with base type ServiceEvent.",
+            "schema": {
+              "$ref": "#/definitions/ServiceEventList"
+            }
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/EventsStore/Services/Events": {
+      "get": {
+        "summary": "Gets all Services-related events.",
+        "description": "The response is list of ServiceEvent objects.",
+        "operationId": "GetServicesEventList",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-4_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/StartTimeUtcRequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/EndTimeUtcRequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/EventsTypesFilterOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/ExcludeAnalysisEventsOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/SkipCorrelationLookupOptionalQueryParam"
+          }
+        ],
+        "tags": [
+          "EventsStore"
+        ],
+        "x-ms-examples": {
+          "Get Services-related events": {
+            "$ref": "./examples/GetServicesEventList.json"
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "List of events objects with base type ServiceEvent.",
+            "schema": {
+              "$ref": "#/definitions/ServiceEventList"
+            }
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/EventsStore/Partitions/{partitionId}/$/Events": {
+      "get": {
+        "summary": "Gets a Partition-related events.",
+        "description": "The response is list of PartitionEvent objects.",
+        "operationId": "GetPartitionEventList",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-4_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/PartitionIdRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/StartTimeUtcRequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/EndTimeUtcRequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/EventsTypesFilterOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/ExcludeAnalysisEventsOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/SkipCorrelationLookupOptionalQueryParam"
+          }
+        ],
+        "tags": [
+          "EventsStore"
+        ],
+        "x-ms-examples": {
+          "Get Partition-related events": {
+            "$ref": "./examples/GetPartitionEventList.json"
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "List of events objects with base type PartitionEvent.",
+            "schema": {
+              "$ref": "#/definitions/PartitionEventList"
+            }
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/EventsStore/Partitions/Events": {
+      "get": {
+        "summary": "Gets all Partitions-related events.",
+        "description": "The response is list of PartitionEvent objects.",
+        "operationId": "GetPartitionsEventList",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-4_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/StartTimeUtcRequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/EndTimeUtcRequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/EventsTypesFilterOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/ExcludeAnalysisEventsOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/SkipCorrelationLookupOptionalQueryParam"
+          }
+        ],
+        "tags": [
+          "EventsStore"
+        ],
+        "x-ms-examples": {
+          "Get Partitions-related events": {
+            "$ref": "./examples/GetPartitionsEventList.json"
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "List of events objects with base type PartitionEvent.",
+            "schema": {
+              "$ref": "#/definitions/PartitionEventList"
+            }
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/EventsStore/Partitions/{partitionId}/$/Replicas/{replicaId}/$/Events": {
+      "get": {
+        "summary": "Gets a Partition Replica-related events.",
+        "description": "The response is list of ReplicaEvent objects.",
+        "operationId": "GetPartitionReplicaEventList",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-4_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/PartitionIdRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/ReplicaIdRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/StartTimeUtcRequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/EndTimeUtcRequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/EventsTypesFilterOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/ExcludeAnalysisEventsOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/SkipCorrelationLookupOptionalQueryParam"
+          }
+        ],
+        "tags": [
+          "EventsStore"
+        ],
+        "x-ms-examples": {
+          "Get Partition Replica-related events": {
+            "$ref": "./examples/GetReplicaEventList.json"
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "List of events objects with base type ReplicaEvent.",
+            "schema": {
+              "$ref": "#/definitions/ReplicaEventList"
+            }
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/EventsStore/Partitions/{partitionId}/$/Replicas/Events": {
+      "get": {
+        "summary": "Gets all Replicas-related events for a Partition.",
+        "description": "The response is list of ReplicaEvent objects.",
+        "operationId": "GetPartitionReplicasEventList",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-4_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/PartitionIdRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/StartTimeUtcRequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/EndTimeUtcRequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/EventsTypesFilterOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/ExcludeAnalysisEventsOptionalQueryParam"
+          },
+          {
+            "$ref": "#/parameters/SkipCorrelationLookupOptionalQueryParam"
+          }
+        ],
+        "tags": [
+          "EventsStore"
+        ],
+        "x-ms-examples": {
+          "Get Partition Replicas-related events": {
+            "$ref": "./examples/GetReplicasEventList.json"
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "List of events objects with base type ReplicaEvent.",
+            "schema": {
+              "$ref": "#/definitions/ReplicaEventList"
+            }
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/EventsStore/CorrelatedEvents/{eventInstanceId}/$/Events": {
+      "get": {
+        "summary": "Gets all correlated events for a given event.",
+        "description": "The response is list of FabricEvents.",
+        "operationId": "GetCorrelatedEventList",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-4_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/EventInstanceIdRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/TimeoutOptionalQueryParam"
+          }
+        ],
+        "tags": [
+          "EventsStore"
+        ],
+        "x-ms-examples": {
+          "Get Correlated events": {
+            "$ref": "./examples/GetCorrelatedEventList.json"
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "List of events objects with base type FabricEvent.",
+            "schema": {
+              "$ref": "#/definitions/EventList"
+            }
+          },
+          "default": {
+            "description": "The detailed error response.",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/Resources/Secrets/{secretResourceName}": {
+      "put": {
+        "operationId": "MeshSecret_CreateOrUpdate",
+        "x-ms-examples": {
+          "CreateOrUpdateMeshSecret": {
+            "$ref": "./examples/Resources/Secrets/create_update.json"
+          }
+        },
+        "summary": "Creates or updates a Secret resource.",
+        "description": "Creates a Secret resource with the specified name, description and properties. If Secret resource with the same name exists, then it is updated with the specified description and properties. Once created, the kind and contentType of a secret resource cannot be updated.",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-4-Preview_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/SecretResourceNameRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/SecretResourceDescriptionRequiredBodyParam"
+          }
+        ],
+        "tags": [
+          "MeshSecrets"
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/SecretResourceDescription"
+            }
+          },
+          "201": {
+            "description": "Created",
+            "schema": {
+              "$ref": "#/definitions/SecretResourceDescription"
+            }
+          },
+          "202": {
+            "description": "Accepted"
+          },
+          "default": {
+            "description": "Error",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      },
+      "get": {
+        "operationId": "MeshSecret_Get",
+        "x-ms-examples": {
+          "GetSecretResource": {
+            "$ref": "./examples/Resources/Secrets/get.json"
+          }
+        },
+        "summary": "Gets the Secret resource with the given name.",
+        "description": "Gets the information about the Secret resource with the given name. The information include the description and other properties of the Secret.",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-4-Preview_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/SecretResourceNameRequiredPathParam"
+          }
+        ],
+        "tags": [
+          "MeshSecrets"
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/SecretResourceDescription"
+            }
+          },
+          "default": {
+            "description": "Error",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      },
+      "delete": {
+        "operationId": "MeshSecret_Delete",
+        "x-ms-examples": {
+          "DeleteSecretResource": {
+            "$ref": "./examples/Resources/Secrets/delete.json"
+          }
+        },
+        "summary": "Deletes the Secret resource.",
+        "description": "Deletes the specified Secret resource and all of its named values.",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-4-Preview_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/SecretResourceNameRequiredPathParam"
+          }
+        ],
+        "tags": [
+          "MeshSecrets"
+        ],
+        "responses": {
+          "200": {
+            "description": "OK"
+          },
+          "202": {
+            "description": "Accepted"
+          },
+          "204": {
+            "description": "No Content - the specified secret was not found."
+          },
+          "default": {
+            "description": "Error",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/Resources/Secrets": {
+      "get": {
+        "operationId": "MeshSecret_List",
+        "x-ms-examples": {
+          "ListMeshSecrets": {
+            "$ref": "./examples/Resources/Secrets/list.json"
+          }
+        },
+        "summary": "Lists all the secret resources.",
+        "description": "Gets the information about all secret resources in a given resource group. The information include the description and other properties of the Secret.",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-4-Preview_RequiredQueryParam"
+          }
+        ],
+        "tags": [
+          "MeshSecrets"
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/PagedSecretResourceDescriptionList"
+            }
+          },
+          "default": {
+            "description": "Error",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/Resources/Secrets/{secretResourceName}/values/{secretValueResourceName}": {
+      "put": {
+        "operationId": "MeshSecretValue_AddValue",
+        "x-ms-examples": {
+          "CreateMeshSecretValue": {
+            "$ref": "./examples/Resources/Secrets/values/create.json"
+          }
+        },
+        "summary": "Adds the specified value as a new version of the specified secret resource.",
+        "description": "Creates a new value of the specified secret resource. The name of the value is typically the version identifier. Once created the value cannot be changed.",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-4-Preview_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/SecretResourceNameRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/SecretValueResourceNameRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/SecretValueResourceDescriptionRequiredBodyParam"
+          }
+        ],
+        "tags": [
+          "MeshSecretValues"
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/SecretValueResourceDescription"
+            }
+          },
+          "201": {
+            "description": "Created",
+            "schema": {
+              "$ref": "#/definitions/SecretValueResourceDescription"
+            }
+          },
+          "202": {
+            "description": "Accepted"
+          },
+          "default": {
+            "description": "Error",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      },
+      "get": {
+        "operationId": "MeshSecretValue_Get",
+        "x-ms-examples": {
+          "GetMeshSecretValue": {
+            "$ref": "./examples/Resources/Secrets/values/get.json"
+          }
+        },
+        "summary": "Gets the specified secret value resource.",
+        "description": "Get the information about the specified named secret value resources. The information does not include the actual value of the secret.",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-4-Preview_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/SecretResourceNameRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/SecretValueResourceNameRequiredPathParam"
+          }
+        ],
+        "tags": [
+          "MeshSecretValues"
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/SecretValueResourceDescription"
+            }
+          },
+          "default": {
+            "description": "Error",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      },
+      "delete": {
+        "operationId": "MeshSecretValue_Delete",
+        "x-ms-examples": {
+          "DeleteSecretValue": {
+            "$ref": "./examples/Resources/Secrets/values/delete.json"
+          }
+        },
+        "summary": "Deletes the specified  value of the named secret resource.",
+        "description": "Deletes the secret value resource identified by the name. The name of the resource is typically the version associated with that value. Deletion will fail if the specified value is in use.",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-4-Preview_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/SecretResourceNameRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/SecretValueResourceNameRequiredPathParam"
+          }
+        ],
+        "tags": [
+          "MeshSecretValues"
+        ],
+        "responses": {
+          "200": {
+            "description": "OK"
+          },
+          "202": {
+            "description": "Accepted"
+          },
+          "204": {
+            "description": "No Content - the specified secret value was not found."
+          },
+          "default": {
+            "description": "Error",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/Resources/Secrets/{secretResourceName}/values": {
+      "get": {
+        "operationId": "MeshSecretValue_List",
+        "x-ms-examples": {
+          "ListMeshSecretValues": {
+            "$ref": "./examples/Resources/Secrets/values/list.json"
+          }
+        },
+        "summary": "List names of all values of the specified secret resource.",
+        "description": "Gets information about all secret value resources of the specified secret resource. The information includes the names of the secret value resources, but not the actual values.",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-4-Preview_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/SecretResourceNameRequiredPathParam"
+          }
+        ],
+        "tags": [
+          "MeshSecretValues"
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/PagedSecretValueResourceDescriptionList"
+            }
+          },
+          "default": {
+            "description": "Error",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/Resources/Secrets/{secretResourceName}/values/{secretValueResourceName}/list_value": {
+      "post": {
+        "operationId": "MeshSecretValue_Show",
+        "x-ms-examples": {
+          "ListMeshSecretValue": {
+            "$ref": "./examples/Resources/Secrets/values/list_value.json"
+          }
+        },
+        "summary": "Lists the specified value of the secret resource.",
+        "description": "Lists the decrypted value of the specified named value of the secret resource. This is a privileged operation.",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-4-Preview_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/SecretResourceNameRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/SecretValueResourceNameRequiredPathParam"
+          }
+        ],
+        "tags": [
+          "MeshSecretValues"
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/SecretValue"
+            }
+          },
+          "default": {
+            "description": "Error",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/Resources/Volumes/{volumeResourceName}": {
+      "put": {
+        "operationId": "MeshVolume_CreateOrUpdate",
+        "x-ms-examples": {
+          "CreateOrUpdateMeshVolume": {
+            "$ref": "./examples/Resources/Volumes/create_update.json"
+          }
+        },
+        "summary": "Creates or updates a Volume resource.",
+        "description": "Creates a Volume resource with the specified name, description and properties. If Volume resource with the same name exists, then it is updated with the specified description and properties.",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-4-Preview_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/VolumeResourceNameRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/VolumeResourceDescriptionRequiredBodyParam"
+          }
+        ],
+        "tags": [
+          "MeshVolumes"
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/VolumeResourceDescription"
+            }
+          },
+          "201": {
+            "description": "Created",
+            "schema": {
+              "$ref": "#/definitions/VolumeResourceDescription"
+            }
+          },
+          "202": {
+            "description": "Accepted"
+          },
+          "default": {
+            "description": "Error",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      },
+      "get": {
+        "operationId": "MeshVolume_Get",
+        "x-ms-examples": {
+          "GetVolumeResource": {
+            "$ref": "./examples/Resources/Volumes/get.json"
+          }
+        },
+        "summary": "Gets the Volume resource with the given name.",
+        "description": "Gets the information about the Volume resource with the given name. The information include the description and other properties of the Volume.",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-4-Preview_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/VolumeResourceNameRequiredPathParam"
+          }
+        ],
+        "tags": [
+          "MeshVolumes"
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/VolumeResourceDescription"
+            }
+          },
+          "default": {
+            "description": "Error",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      },
+      "delete": {
+        "operationId": "MeshVolume_Delete",
+        "x-ms-examples": {
+          "DeleteVolumeResource": {
+            "$ref": "./examples/Resources/Volumes/delete.json"
+          }
+        },
+        "summary": "Deletes the Volume resource.",
+        "description": "Deletes the Volume resource identified by the name.",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-4-Preview_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/VolumeResourceNameRequiredPathParam"
+          }
+        ],
+        "tags": [
+          "MeshVolumes"
+        ],
+        "responses": {
+          "200": {
+            "description": "OK"
+          },
+          "202": {
+            "description": "Accepted"
+          },
+          "204": {
+            "description": "No Content - the specified volume was not found."
+          },
+          "default": {
+            "description": "Error",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/Resources/Volumes": {
+      "get": {
+        "operationId": "MeshVolume_List",
+        "x-ms-examples": {
+          "ListMeshVolumes": {
+            "$ref": "./examples/Resources/Volumes/list.json"
+          }
+        },
+        "summary": "Lists all the volume resources.",
+        "description": "Gets the information about all volume resources in a given resource group. The information include the description and other properties of the Volume.",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-4-Preview_RequiredQueryParam"
+          }
+        ],
+        "tags": [
+          "MeshVolumes"
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/PagedVolumeResourceDescriptionList"
+            }
+          },
+          "default": {
+            "description": "Error",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/Resources/Networks/{networkResourceName}": {
+      "put": {
+        "operationId": "MeshNetwork_CreateOrUpdate",
+        "x-ms-examples": {
+          "CreateOrUpdateMeshNetwork": {
+            "$ref": "./examples/Resources/Networks/create_update.json"
+          }
+        },
+        "summary": "Creates or updates a Network resource.",
+        "description": "Creates a Network resource with the specified name, description and properties. If Network resource with the same name exists, then it is updated with the specified description and properties. Network resource provides connectivity between application services.",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-4-Preview_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/NetworkResourceNameRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/NetworkResourceDescriptionRequiredBodyParam"
+          }
+        ],
+        "tags": [
+          "MeshNetworks"
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/NetworkResourceDescription"
+            }
+          },
+          "201": {
+            "description": "Created",
+            "schema": {
+              "$ref": "#/definitions/NetworkResourceDescription"
+            }
+          },
+          "202": {
+            "description": "Accepted"
+          },
+          "default": {
+            "description": "Error",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      },
+      "get": {
+        "operationId": "MeshNetwork_Get",
+        "x-ms-examples": {
+          "GetNetworkResource": {
+            "$ref": "./examples/Resources/Networks/get.json"
+          }
+        },
+        "summary": "Gets the Network resource with the given name.",
+        "description": "Gets the information about the Network resource with the given name. The information include the description and other properties of the Network.",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-4-Preview_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/NetworkResourceNameRequiredPathParam"
+          }
+        ],
+        "tags": [
+          "MeshNetworks"
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/NetworkResourceDescription"
+            }
+          },
+          "default": {
+            "description": "Error",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      },
+      "delete": {
+        "operationId": "MeshNetwork_Delete",
+        "x-ms-examples": {
+          "DeleteNetworkResource": {
+            "$ref": "./examples/Resources/Networks/delete.json"
+          }
+        },
+        "summary": "Deletes the Network resource.",
+        "description": "Deletes the Network resource identified by the name.",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-4-Preview_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/NetworkResourceNameRequiredPathParam"
+          }
+        ],
+        "tags": [
+          "MeshNetworks"
+        ],
+        "responses": {
+          "200": {
+            "description": "OK"
+          },
+          "202": {
+            "description": "Accepted"
+          },
+          "204": {
+            "description": "No Content - the specified network was not found."
+          },
+          "default": {
+            "description": "Error",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/Resources/Networks": {
+      "get": {
+        "operationId": "MeshNetwork_List",
+        "x-ms-examples": {
+          "ListMeshNetworks": {
+            "$ref": "./examples/Resources/Networks/list.json"
+          }
+        },
+        "summary": "Lists all the network resources.",
+        "description": "Gets the information about all network resources in a given resource group. The information include the description and other properties of the Network.",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-4-Preview_RequiredQueryParam"
+          }
+        ],
+        "tags": [
+          "MeshNetworks"
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/PagedNetworkResourceDescriptionList"
+            }
+          },
+          "default": {
+            "description": "Error",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/Resources/Applications/{applicationResourceName}": {
+      "put": {
+        "operationId": "MeshApplication_CreateOrUpdate",
+        "x-ms-examples": {
+          "CreateOrUpdateMeshApplication": {
+            "$ref": "./examples/Resources/Applications/create_update.json"
+          },
+          "CreateOrUpdateMeshApplicationWithAutoScale": {
+            "$ref": "./examples/Resources/Applications/create_update.autoscale.json"
+          }
+        },
+        "summary": "Creates or updates a Application resource.",
+        "description": "Creates a Application resource with the specified name, description and properties. If Application resource with the same name exists, then it is updated with the specified description and properties.",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-4-Preview_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/ApplicationResourceNameRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/ApplicationResourceDescriptionRequiredBodyParam"
+          }
+        ],
+        "tags": [
+          "MeshApplications"
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/ApplicationResourceDescription"
+            }
+          },
+          "201": {
+            "description": "Created",
+            "schema": {
+              "$ref": "#/definitions/ApplicationResourceDescription"
+            }
+          },
+          "202": {
+            "description": "Accepted"
+          },
+          "default": {
+            "description": "Error",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      },
+      "get": {
+        "operationId": "MeshApplication_Get",
+        "x-ms-examples": {
+          "GetApplicationResource": {
+            "$ref": "./examples/Resources/Applications/get.json"
+          }
+        },
+        "summary": "Gets the Application resource with the given name.",
+        "description": "Gets the information about the Application resource with the given name. The information include the description and other properties of the Application.",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-4-Preview_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/ApplicationResourceNameRequiredPathParam"
+          }
+        ],
+        "tags": [
+          "MeshApplications"
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/ApplicationResourceDescription"
+            }
+          },
+          "default": {
+            "description": "Error",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      },
+      "delete": {
+        "operationId": "MeshApplication_Delete",
+        "x-ms-examples": {
+          "DeleteApplicationResource": {
+            "$ref": "./examples/Resources/Applications/delete.json"
+          }
+        },
+        "summary": "Deletes the Application resource.",
+        "description": "Deletes the Application resource identified by the name.",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-4-Preview_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/ApplicationResourceNameRequiredPathParam"
+          }
+        ],
+        "tags": [
+          "MeshApplications"
+        ],
+        "responses": {
+          "200": {
+            "description": "OK"
+          },
+          "202": {
+            "description": "Accepted"
+          },
+          "204": {
+            "description": "No Content - the specified application was not found."
+          },
+          "default": {
+            "description": "Error",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/Resources/Applications": {
+      "get": {
+        "operationId": "MeshApplication_List",
+        "x-ms-examples": {
+          "ListMeshApplications": {
+            "$ref": "./examples/Resources/Applications/list.json"
+          }
+        },
+        "summary": "Lists all the application resources.",
+        "description": "Gets the information about all application resources in a given resource group. The information include the description and other properties of the Application.",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-4-Preview_RequiredQueryParam"
+          }
+        ],
+        "tags": [
+          "MeshApplications"
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/PagedApplicationResourceDescriptionList"
+            }
+          },
+          "default": {
+            "description": "Error",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/Resources/Applications/{applicationResourceName}/$/GetUpgradeProgress": {
+      "get": {
+        "operationId": "MeshApplication_GetUpgradeProgress",
+        "x-ms-examples": {
+          "GetApplicationResourceUpgrade": {
+            "$ref": "./examples/Resources/Applications/get_upgrade.json"
+          }
+        },
+        "summary": "Gets the progress of the latest upgrade performed on this application resource.",
+        "description": "Gets the upgrade progress information about the Application resource with the given name. The information include percentage of completion and other upgrade state information of the Application resource.",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_7-0_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/ApplicationResourceNameRequiredPathParam"
+          }
+        ],
+        "tags": [
+          "MeshApplications"
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/ApplicationResourceUpgradeProgressInfo"
+            }
+          },
+          "default": {
+            "description": "Error",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/Resources/Applications/{applicationResourceName}/Services/{serviceResourceName}": {
+      "get": {
+        "operationId": "MeshService_Get",
+        "x-ms-examples": {
+          "GetServiceResource": {
+            "$ref": "./examples/Resources/Applications/Services/get.json"
+          }
+        },
+        "summary": "Gets the Service resource with the given name.",
+        "description": "Gets the information about the Service resource with the given name. The information include the description and other properties of the Service.",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-4-Preview_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/ApplicationResourceNameRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/ServiceResourceNameRequiredPathParam"
+          }
+        ],
+        "tags": [
+          "MeshServices"
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/ServiceResourceDescription"
+            }
+          },
+          "default": {
+            "description": "Error",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/Resources/Applications/{applicationResourceName}/Services": {
+      "get": {
+        "operationId": "MeshService_List",
+        "x-ms-examples": {
+          "ListMeshServices": {
+            "$ref": "./examples/Resources/Applications/Services/list.json"
+          }
+        },
+        "summary": "Lists all the service resources.",
+        "description": "Gets the information about all services of an application resource. The information include the description and other properties of the Service.",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-4-Preview_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/ApplicationResourceNameRequiredPathParam"
+          }
+        ],
+        "tags": [
+          "MeshServices"
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/PagedServiceResourceDescriptionList"
+            }
+          },
+          "default": {
+            "description": "Error",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/Resources/Applications/{applicationResourceName}/Services/{serviceResourceName}/Replicas/{replicaName}/CodePackages/{codePackageName}/Logs": {
+      "get": {
+        "operationId": "MeshCodePackage_GetContainerLogs",
+        "x-ms-examples": {
+          "GetContainerLogs": {
+            "$ref": "./examples/Resources/Applications/Services/Replicas/CodePackages/get_logs.json"
+          }
+        },
+        "summary": "Gets the logs from the container.",
+        "description": "Gets the logs for the container of the specified code package of the service replica.",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-4-Preview_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/ApplicationResourceNameRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/ServiceResourceNameRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/ReplicaNameRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/CodePackageNameRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/TailOptionalQueryParam"
+          }
+        ],
+        "tags": [
+          "MeshCodePackages"
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/ContainerLogs"
+            }
+          },
+          "default": {
+            "description": "Error",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/Resources/Applications/{applicationResourceName}/Services/{serviceResourceName}/Replicas/{replicaName}": {
+      "get": {
+        "operationId": "MeshServiceReplica_Get",
+        "x-ms-examples": {
+          "GetServiceReplica": {
+            "$ref": "./examples/Resources/Applications/Services/Replicas/get.json"
+          }
+        },
+        "summary": "Gets the given replica of the service of an application.",
+        "description": "Gets the information about the service replica with the given name. The information include the description and other properties of the service replica.",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-4-Preview_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/ApplicationResourceNameRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/ServiceResourceNameRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/ReplicaNameRequiredPathParam"
+          }
+        ],
+        "tags": [
+          "MeshServiceReplicas"
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/ServiceReplicaDescription"
+            }
+          },
+          "default": {
+            "description": "Error",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/Resources/Applications/{applicationResourceName}/Services/{serviceResourceName}/Replicas": {
+      "get": {
+        "operationId": "MeshServiceReplica_List",
+        "x-ms-examples": {
+          "ListMeshServiceReplicas": {
+            "$ref": "./examples/Resources/Applications/Services/Replicas/list.json"
+          }
+        },
+        "summary": "Lists all the replicas of a service.",
+        "description": "Gets the information about all replicas of a service. The information include the description and other properties of the service replica.",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-4-Preview_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/ApplicationResourceNameRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/ServiceResourceNameRequiredPathParam"
+          }
+        ],
+        "tags": [
+          "MeshServiceReplicas"
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/PagedServiceReplicaDescriptionList"
+            }
+          },
+          "default": {
+            "description": "Error",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/Resources/Gateways/{gatewayResourceName}": {
+      "put": {
+        "operationId": "MeshGateway_CreateOrUpdate",
+        "x-ms-examples": {
+          "CreateOrUpdateMeshGateway": {
+            "$ref": "./examples/Resources/Gateways/create_update.json"
+          }
+        },
+        "summary": "Creates or updates a Gateway resource.",
+        "description": "Creates a Gateway resource with the specified name, description and properties. If Gateway resource with the same name exists, then it is updated with the specified description and properties. Use Gateway resource to provide public connectivity to application services.",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-4-Preview_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/GatewayResourceNameRequiredPathParam"
+          },
+          {
+            "$ref": "#/parameters/GatewayResourceDescriptionRequiredBodyParam"
+          }
+        ],
+        "tags": [
+          "MeshGateways"
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/GatewayResourceDescription"
+            }
+          },
+          "201": {
+            "description": "Created",
+            "schema": {
+              "$ref": "#/definitions/GatewayResourceDescription"
+            }
+          },
+          "202": {
+            "description": "Accepted"
+          },
+          "default": {
+            "description": "Error",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      },
+      "get": {
+        "operationId": "MeshGateway_Get",
+        "x-ms-examples": {
+          "GetGatewayResource": {
+            "$ref": "./examples/Resources/Gateways/get.json"
+          }
+        },
+        "summary": "Gets the Gateway resource with the given name.",
+        "description": "Gets the information about the Gateway resource with the given name. The information include the description and other properties of the Gateway.",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-4-Preview_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/GatewayResourceNameRequiredPathParam"
+          }
+        ],
+        "tags": [
+          "MeshGateways"
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/GatewayResourceDescription"
+            }
+          },
+          "default": {
+            "description": "Error",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      },
+      "delete": {
+        "operationId": "MeshGateway_Delete",
+        "x-ms-examples": {
+          "DeleteGatewayResource": {
+            "$ref": "./examples/Resources/Gateways/delete.json"
+          }
+        },
+        "summary": "Deletes the Gateway resource.",
+        "description": "Deletes the Gateway resource identified by the name.",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-4-Preview_RequiredQueryParam"
+          },
+          {
+            "$ref": "#/parameters/GatewayResourceNameRequiredPathParam"
+          }
+        ],
+        "tags": [
+          "MeshGateways"
+        ],
+        "responses": {
+          "200": {
+            "description": "OK"
+          },
+          "202": {
+            "description": "Accepted"
+          },
+          "204": {
+            "description": "No Content - the specified gateway was not found."
+          },
+          "default": {
+            "description": "Error",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    },
+    "/Resources/Gateways": {
+      "get": {
+        "operationId": "MeshGateway_List",
+        "x-ms-examples": {
+          "ListMeshGateways": {
+            "$ref": "./examples/Resources/Gateways/list.json"
+          }
+        },
+        "summary": "Lists all the gateway resources.",
+        "description": "Gets the information about all gateway resources in a given resource group. The information include the description and other properties of the Gateway.",
+        "parameters": [
+          {
+            "$ref": "#/parameters/ApiVersion_6-4-Preview_RequiredQueryParam"
+          }
+        ],
+        "tags": [
+          "MeshGateways"
+        ],
+        "responses": {
+          "200": {
+            "description": "OK",
+            "schema": {
+              "$ref": "#/definitions/PagedGatewayResourceDescriptionList"
+            }
+          },
+          "default": {
+            "description": "Error",
+            "schema": {
+              "$ref": "#/definitions/FabricError"
+            }
+          }
+        }
+      }
+    }
+  },
+  "definitions": {
+    "HealthState": {
+      "type": "string",
+      "description": "The health state of a Service Fabric entity such as Cluster, Node, Application, Service, Partition, Replica etc.",
+      "enum": [
+        "Invalid",
+        "Ok",
+        "Warning",
+        "Error",
+        "Unknown"
+      ],
+      "x-ms-enum": {
+        "name": "HealthState",
+        "modelAsString": true,
+        "values": [
+          {
+            "value": "Invalid",
+            "description": "Indicates an invalid health state. All Service Fabric enumerations have the invalid type. The value is zero."
+          },
+          {
+            "value": "Ok",
+            "description": "Indicates the health state is okay. The value is 1."
+          },
+          {
+            "value": "Warning",
+            "description": "Indicates the health state is at a warning level. The value is 2."
+          },
+          {
+            "value": "Error",
+            "description": "Indicates the health state is at an error level. Error health state should be investigated, as they can impact the correct functionality of the cluster. The value is 3."
+          },
+          {
+            "value": "Unknown",
+            "description": "Indicates an unknown health status. The value is 65535."
+          }
+        ]
+      }
+    },
+    "FabricErrorCodes": {
+      "type": "string",
+      "description": "Defines the fabric error codes that be returned as part of the error object in response to Service Fabric API operations that are not successful. Following are the error code values that can be returned for a specific HTTP status code.\n\n  - Possible values of the error code for HTTP status code 400 (Bad Request)\n    - \"FABRIC_E_INVALID_PARTITION_KEY\"\n    - \"FABRIC_E_IMAGEBUILDER_VALIDATION_ERROR\"\n    - \"FABRIC_E_INVALID_ADDRESS\"\n    - \"FABRIC_E_APPLICATION_NOT_UPGRADING\"\n    - \"FABRIC_E_APPLICATION_UPGRADE_VALIDATION_ERROR\"\n    - \"FABRIC_E_FABRIC_NOT_UPGRADING\"\n    - \"FABRIC_E_FABRIC_UPGRADE_VALIDATION_ERROR\"\n    - \"FABRIC_E_INVALID_CONFIGURATION\"\n    - \"FABRIC_E_INVALID_NAME_URI\"\n    - \"FABRIC_E_PATH_TOO_LONG\"\n    - \"FABRIC_E_KEY_TOO_LARGE\"\n    - \"FABRIC_E_SERVICE_AFFINITY_CHAIN_NOT_SUPPORTED\"\n    - \"FABRIC_E_INVALID_ATOMIC_GROUP\"\n    - \"FABRIC_E_VALUE_EMPTY\"\n    - \"FABRIC_E_BACKUP_IS_ENABLED\"\n    - \"FABRIC_E_RESTORE_SOURCE_TARGET_PARTITION_MISMATCH\"\n    - \"FABRIC_E_INVALID_FOR_STATELESS_SERVICES\"\n    - \"FABRIC_E_INVALID_SERVICE_SCALING_POLICY\"\n    - \"E_INVALIDARG\"\n\n  - Possible values of the error code for HTTP status code 404 (Not Found)\n    - \"FABRIC_E_NODE_NOT_FOUND\"\n    - \"FABRIC_E_APPLICATION_TYPE_NOT_FOUND\"\n    - \"FABRIC_E_APPLICATION_NOT_FOUND\"\n    - \"FABRIC_E_SERVICE_TYPE_NOT_FOUND\"\n    - \"FABRIC_E_SERVICE_DOES_NOT_EXIST\"\n    - \"FABRIC_E_SERVICE_TYPE_TEMPLATE_NOT_FOUND\"\n    - \"FABRIC_E_CONFIGURATION_SECTION_NOT_FOUND\"\n    - \"FABRIC_E_PARTITION_NOT_FOUND\"\n    - \"FABRIC_E_REPLICA_DOES_NOT_EXIST\"\n    - \"FABRIC_E_SERVICE_GROUP_DOES_NOT_EXIST\"\n    - \"FABRIC_E_CONFIGURATION_PARAMETER_NOT_FOUND\"\n    - \"FABRIC_E_DIRECTORY_NOT_FOUND\"\n    - \"FABRIC_E_FABRIC_VERSION_NOT_FOUND\"\n    - \"FABRIC_E_FILE_NOT_FOUND\"\n    - \"FABRIC_E_NAME_DOES_NOT_EXIST\"\n    - \"FABRIC_E_PROPERTY_DOES_NOT_EXIST\"\n    - \"FABRIC_E_ENUMERATION_COMPLETED\"\n    - \"FABRIC_E_SERVICE_MANIFEST_NOT_FOUND\"\n    - \"FABRIC_E_KEY_NOT_FOUND\"\n    - \"FABRIC_E_HEALTH_ENTITY_NOT_FOUND\"\n    - \"FABRIC_E_BACKUP_NOT_ENABLED\"\n    - \"FABRIC_E_BACKUP_POLICY_NOT_EXISTING\"\n    - \"FABRIC_E_FAULT_ANALYSIS_SERVICE_NOT_EXISTING\"\n    - \"FABRIC_E_IMAGEBUILDER_RESERVED_DIRECTORY_ERROR\"\n\n  - Possible values of the error code for HTTP status code 409 (Conflict)\n    - \"FABRIC_E_APPLICATION_TYPE_ALREADY_EXISTS\"\n    - \"FABRIC_E_APPLICATION_ALREADY_EXISTS\"\n    - \"FABRIC_E_APPLICATION_ALREADY_IN_TARGET_VERSION\"\n    - \"FABRIC_E_APPLICATION_TYPE_PROVISION_IN_PROGRESS\"\n    - \"FABRIC_E_APPLICATION_UPGRADE_IN_PROGRESS\"\n    - \"FABRIC_E_SERVICE_ALREADY_EXISTS\"\n    - \"FABRIC_E_SERVICE_GROUP_ALREADY_EXISTS\"\n    - \"FABRIC_E_APPLICATION_TYPE_IN_USE\"\n    - \"FABRIC_E_FABRIC_ALREADY_IN_TARGET_VERSION\"\n    - \"FABRIC_E_FABRIC_VERSION_ALREADY_EXISTS\"\n    - \"FABRIC_E_FABRIC_VERSION_IN_USE\"\n    - \"FABRIC_E_FABRIC_UPGRADE_IN_PROGRESS\"\n    - \"FABRIC_E_NAME_ALREADY_EXISTS\"\n    - \"FABRIC_E_NAME_NOT_EMPTY\"\n    - \"FABRIC_E_PROPERTY_CHECK_FAILED\"\n    - \"FABRIC_E_SERVICE_METADATA_MISMATCH\"\n    - \"FABRIC_E_SERVICE_TYPE_MISMATCH\"\n    - \"FABRIC_E_HEALTH_STALE_REPORT\"\n    - \"FABRIC_E_SEQUENCE_NUMBER_CHECK_FAILED\"\n    - \"FABRIC_E_NODE_HAS_NOT_STOPPED_YET\"\n    - \"FABRIC_E_INSTANCE_ID_MISMATCH\"\n    - \"FABRIC_E_BACKUP_IN_PROGRESS\"\n    - \"FABRIC_E_RESTORE_IN_PROGRESS\"\n    - \"FABRIC_E_BACKUP_POLICY_ALREADY_EXISTING\"\n\n  - Possible values of the error code for HTTP status code 413 (Request Entity Too Large)\n    - \"FABRIC_E_VALUE_TOO_LARGE\"\n\n  - Possible values of the error code for HTTP status code 500 (Internal Server Error)\n    - \"FABRIC_E_NODE_IS_UP\"\n    - \"E_FAIL\"\n    - \"FABRIC_E_SINGLE_INSTANCE_APPLICATION_ALREADY_EXISTS\"\n    - \"FABRIC_E_SINGLE_INSTANCE_APPLICATION_NOT_FOUND\"\n    - \"FABRIC_E_VOLUME_ALREADY_EXISTS\"\n    - \"FABRIC_E_VOLUME_NOT_FOUND\"\n    - \"SerializationError\"\n\n  - Possible values of the error code for HTTP status code 503 (Service Unavailable)\n    - \"FABRIC_E_NO_WRITE_QUORUM\"\n    - \"FABRIC_E_NOT_PRIMARY\"\n    - \"FABRIC_E_NOT_READY\"\n    - \"FABRIC_E_RECONFIGURATION_PENDING\"\n    - \"FABRIC_E_SERVICE_OFFLINE\"\n    - \"E_ABORT\"\n    - \"FABRIC_E_VALUE_TOO_LARGE\"\n\n  - Possible values of the error code for HTTP status code 504 (Gateway Timeout)\n    - \"FABRIC_E_COMMUNICATION_ERROR\"\n    - \"FABRIC_E_OPERATION_NOT_COMPLETE\"\n    - \"FABRIC_E_TIMEOUT\"",
+      "enum": [
+        "FABRIC_E_INVALID_PARTITION_KEY",
+        "FABRIC_E_IMAGEBUILDER_VALIDATION_ERROR",
+        "FABRIC_E_INVALID_ADDRESS",
+        "FABRIC_E_APPLICATION_NOT_UPGRADING",
+        "FABRIC_E_APPLICATION_UPGRADE_VALIDATION_ERROR",
+        "FABRIC_E_FABRIC_NOT_UPGRADING",
+        "FABRIC_E_FABRIC_UPGRADE_VALIDATION_ERROR",
+        "FABRIC_E_INVALID_CONFIGURATION",
+        "FABRIC_E_INVALID_NAME_URI",
+        "FABRIC_E_PATH_TOO_LONG",
+        "FABRIC_E_KEY_TOO_LARGE",
+        "FABRIC_E_SERVICE_AFFINITY_CHAIN_NOT_SUPPORTED",
+        "FABRIC_E_INVALID_ATOMIC_GROUP",
+        "FABRIC_E_VALUE_EMPTY",
+        "FABRIC_E_NODE_NOT_FOUND",
+        "FABRIC_E_APPLICATION_TYPE_NOT_FOUND",
+        "FABRIC_E_APPLICATION_NOT_FOUND",
+        "FABRIC_E_SERVICE_TYPE_NOT_FOUND",
+        "FABRIC_E_SERVICE_DOES_NOT_EXIST",
+        "FABRIC_E_SERVICE_TYPE_TEMPLATE_NOT_FOUND",
+        "FABRIC_E_CONFIGURATION_SECTION_NOT_FOUND",
+        "FABRIC_E_PARTITION_NOT_FOUND",
+        "FABRIC_E_REPLICA_DOES_NOT_EXIST",
+        "FABRIC_E_SERVICE_GROUP_DOES_NOT_EXIST",
+        "FABRIC_E_CONFIGURATION_PARAMETER_NOT_FOUND",
+        "FABRIC_E_DIRECTORY_NOT_FOUND",
+        "FABRIC_E_FABRIC_VERSION_NOT_FOUND",
+        "FABRIC_E_FILE_NOT_FOUND",
+        "FABRIC_E_NAME_DOES_NOT_EXIST",
+        "FABRIC_E_PROPERTY_DOES_NOT_EXIST",
+        "FABRIC_E_ENUMERATION_COMPLETED",
+        "FABRIC_E_SERVICE_MANIFEST_NOT_FOUND",
+        "FABRIC_E_KEY_NOT_FOUND",
+        "FABRIC_E_HEALTH_ENTITY_NOT_FOUND",
+        "FABRIC_E_APPLICATION_TYPE_ALREADY_EXISTS",
+        "FABRIC_E_APPLICATION_ALREADY_EXISTS",
+        "FABRIC_E_APPLICATION_ALREADY_IN_TARGET_VERSION",
+        "FABRIC_E_APPLICATION_TYPE_PROVISION_IN_PROGRESS",
+        "FABRIC_E_APPLICATION_UPGRADE_IN_PROGRESS",
+        "FABRIC_E_SERVICE_ALREADY_EXISTS",
+        "FABRIC_E_SERVICE_GROUP_ALREADY_EXISTS",
+        "FABRIC_E_APPLICATION_TYPE_IN_USE",
+        "FABRIC_E_FABRIC_ALREADY_IN_TARGET_VERSION",
+        "FABRIC_E_FABRIC_VERSION_ALREADY_EXISTS",
+        "FABRIC_E_FABRIC_VERSION_IN_USE",
+        "FABRIC_E_FABRIC_UPGRADE_IN_PROGRESS",
+        "FABRIC_E_NAME_ALREADY_EXISTS",
+        "FABRIC_E_NAME_NOT_EMPTY",
+        "FABRIC_E_PROPERTY_CHECK_FAILED",
+        "FABRIC_E_SERVICE_METADATA_MISMATCH",
+        "FABRIC_E_SERVICE_TYPE_MISMATCH",
+        "FABRIC_E_HEALTH_STALE_REPORT",
+        "FABRIC_E_SEQUENCE_NUMBER_CHECK_FAILED",
+        "FABRIC_E_NODE_HAS_NOT_STOPPED_YET",
+        "FABRIC_E_INSTANCE_ID_MISMATCH",
+        "FABRIC_E_VALUE_TOO_LARGE",
+        "FABRIC_E_NO_WRITE_QUORUM",
+        "FABRIC_E_NOT_PRIMARY",
+        "FABRIC_E_NOT_READY",
+        "FABRIC_E_RECONFIGURATION_PENDING",
+        "FABRIC_E_SERVICE_OFFLINE",
+        "E_ABORT",
+        "FABRIC_E_COMMUNICATION_ERROR",
+        "FABRIC_E_OPERATION_NOT_COMPLETE",
+        "FABRIC_E_TIMEOUT",
+        "FABRIC_E_NODE_IS_UP",
+        "E_FAIL",
+        "FABRIC_E_BACKUP_IS_ENABLED",
+        "FABRIC_E_RESTORE_SOURCE_TARGET_PARTITION_MISMATCH",
+        "FABRIC_E_INVALID_FOR_STATELESS_SERVICES",
+        "FABRIC_E_BACKUP_NOT_ENABLED",
+        "FABRIC_E_BACKUP_POLICY_NOT_EXISTING",
+        "FABRIC_E_FAULT_ANALYSIS_SERVICE_NOT_EXISTING",
+        "FABRIC_E_BACKUP_IN_PROGRESS",
+        "FABRIC_E_RESTORE_IN_PROGRESS",
+        "FABRIC_E_BACKUP_POLICY_ALREADY_EXISTING",
+        "FABRIC_E_INVALID_SERVICE_SCALING_POLICY",
+        "E_INVALIDARG",
+        "FABRIC_E_SINGLE_INSTANCE_APPLICATION_ALREADY_EXISTS",
+        "FABRIC_E_SINGLE_INSTANCE_APPLICATION_NOT_FOUND",
+        "FABRIC_E_VOLUME_ALREADY_EXISTS",
+        "FABRIC_E_VOLUME_NOT_FOUND",
+        "SerializationError",
+        "FABRIC_E_IMAGEBUILDER_RESERVED_DIRECTORY_ERROR"
+      ],
+      "x-ms-enum": {
+        "name": "FabricErrorCodes",
+        "modelAsString": true,
+        "values": [
+          {
+            "value": "FABRIC_E_INVALID_PARTITION_KEY"
+          },
+          {
+            "value": "FABRIC_E_IMAGEBUILDER_VALIDATION_ERROR"
+          },
+          {
+            "value": "FABRIC_E_INVALID_ADDRESS"
+          },
+          {
+            "value": "FABRIC_E_APPLICATION_NOT_UPGRADING"
+          },
+          {
+            "value": "FABRIC_E_APPLICATION_UPGRADE_VALIDATION_ERROR"
+          },
+          {
+            "value": "FABRIC_E_FABRIC_NOT_UPGRADING"
+          },
+          {
+            "value": "FABRIC_E_FABRIC_UPGRADE_VALIDATION_ERROR"
+          },
+          {
+            "value": "FABRIC_E_INVALID_CONFIGURATION"
+          },
+          {
+            "value": "FABRIC_E_INVALID_NAME_URI"
+          },
+          {
+            "value": "FABRIC_E_PATH_TOO_LONG"
+          },
+          {
+            "value": "FABRIC_E_KEY_TOO_LARGE"
+          },
+          {
+            "value": "FABRIC_E_SERVICE_AFFINITY_CHAIN_NOT_SUPPORTED"
+          },
+          {
+            "value": "FABRIC_E_INVALID_ATOMIC_GROUP"
+          },
+          {
+            "value": "FABRIC_E_VALUE_EMPTY"
+          },
+          {
+            "value": "FABRIC_E_NODE_NOT_FOUND"
+          },
+          {
+            "value": "FABRIC_E_APPLICATION_TYPE_NOT_FOUND"
+          },
+          {
+            "value": "FABRIC_E_APPLICATION_NOT_FOUND"
+          },
+          {
+            "value": "FABRIC_E_SERVICE_TYPE_NOT_FOUND"
+          },
+          {
+            "value": "FABRIC_E_SERVICE_DOES_NOT_EXIST"
+          },
+          {
+            "value": "FABRIC_E_SERVICE_TYPE_TEMPLATE_NOT_FOUND"
+          },
+          {
+            "value": "FABRIC_E_CONFIGURATION_SECTION_NOT_FOUND"
+          },
+          {
+            "value": "FABRIC_E_PARTITION_NOT_FOUND"
+          },
+          {
+            "value": "FABRIC_E_REPLICA_DOES_NOT_EXIST"
+          },
+          {
+            "value": "FABRIC_E_SERVICE_GROUP_DOES_NOT_EXIST"
+          },
+          {
+            "value": "FABRIC_E_CONFIGURATION_PARAMETER_NOT_FOUND"
+          },
+          {
+            "value": "FABRIC_E_DIRECTORY_NOT_FOUND"
+          },
+          {
+            "value": "FABRIC_E_FABRIC_VERSION_NOT_FOUND"
+          },
+          {
+            "value": "FABRIC_E_FILE_NOT_FOUND"
+          },
+          {
+            "value": "FABRIC_E_NAME_DOES_NOT_EXIST"
+          },
+          {
+            "value": "FABRIC_E_PROPERTY_DOES_NOT_EXIST"
+          },
+          {
+            "value": "FABRIC_E_ENUMERATION_COMPLETED"
+          },
+          {
+            "value": "FABRIC_E_SERVICE_MANIFEST_NOT_FOUND"
+          },
+          {
+            "value": "FABRIC_E_KEY_NOT_FOUND"
+          },
+          {
+            "value": "FABRIC_E_HEALTH_ENTITY_NOT_FOUND"
+          },
+          {
+            "value": "FABRIC_E_APPLICATION_TYPE_ALREADY_EXISTS"
+          },
+          {
+            "value": "FABRIC_E_APPLICATION_ALREADY_EXISTS"
+          },
+          {
+            "value": "FABRIC_E_APPLICATION_ALREADY_IN_TARGET_VERSION"
+          },
+          {
+            "value": "FABRIC_E_APPLICATION_TYPE_PROVISION_IN_PROGRESS"
+          },
+          {
+            "value": "FABRIC_E_APPLICATION_UPGRADE_IN_PROGRESS"
+          },
+          {
+            "value": "FABRIC_E_SERVICE_ALREADY_EXISTS"
+          },
+          {
+            "value": "FABRIC_E_SERVICE_GROUP_ALREADY_EXISTS"
+          },
+          {
+            "value": "FABRIC_E_APPLICATION_TYPE_IN_USE"
+          },
+          {
+            "value": "FABRIC_E_FABRIC_ALREADY_IN_TARGET_VERSION"
+          },
+          {
+            "value": "FABRIC_E_FABRIC_VERSION_ALREADY_EXISTS"
+          },
+          {
+            "value": "FABRIC_E_FABRIC_VERSION_IN_USE"
+          },
+          {
+            "value": "FABRIC_E_FABRIC_UPGRADE_IN_PROGRESS"
+          },
+          {
+            "value": "FABRIC_E_NAME_ALREADY_EXISTS"
+          },
+          {
+            "value": "FABRIC_E_NAME_NOT_EMPTY"
+          },
+          {
+            "value": "FABRIC_E_PROPERTY_CHECK_FAILED"
+          },
+          {
+            "value": "FABRIC_E_SERVICE_METADATA_MISMATCH"
+          },
+          {
+            "value": "FABRIC_E_SERVICE_TYPE_MISMATCH"
+          },
+          {
+            "value": "FABRIC_E_HEALTH_STALE_REPORT"
+          },
+          {
+            "value": "FABRIC_E_SEQUENCE_NUMBER_CHECK_FAILED"
+          },
+          {
+            "value": "FABRIC_E_NODE_HAS_NOT_STOPPED_YET"
+          },
+          {
+            "value": "FABRIC_E_INSTANCE_ID_MISMATCH"
+          },
+          {
+            "value": "FABRIC_E_VALUE_TOO_LARGE"
+          },
+          {
+            "value": "FABRIC_E_NO_WRITE_QUORUM"
+          },
+          {
+            "value": "FABRIC_E_NOT_PRIMARY"
+          },
+          {
+            "value": "FABRIC_E_NOT_READY"
+          },
+          {
+            "value": "FABRIC_E_RECONFIGURATION_PENDING"
+          },
+          {
+            "value": "FABRIC_E_SERVICE_OFFLINE"
+          },
+          {
+            "value": "E_ABORT"
+          },
+          {
+            "value": "FABRIC_E_COMMUNICATION_ERROR"
+          },
+          {
+            "value": "FABRIC_E_OPERATION_NOT_COMPLETE"
+          },
+          {
+            "value": "FABRIC_E_TIMEOUT"
+          },
+          {
+            "value": "FABRIC_E_NODE_IS_UP"
+          },
+          {
+            "value": "E_FAIL"
+          },
+          {
+            "value": "FABRIC_E_BACKUP_IS_ENABLED"
+          },
+          {
+            "value": "FABRIC_E_RESTORE_SOURCE_TARGET_PARTITION_MISMATCH"
+          },
+          {
+            "value": "FABRIC_E_INVALID_FOR_STATELESS_SERVICES"
+          },
+          {
+            "value": "FABRIC_E_BACKUP_NOT_ENABLED"
+          },
+          {
+            "value": "FABRIC_E_BACKUP_POLICY_NOT_EXISTING"
+          },
+          {
+            "value": "FABRIC_E_FAULT_ANALYSIS_SERVICE_NOT_EXISTING"
+          },
+          {
+            "value": "FABRIC_E_BACKUP_IN_PROGRESS"
+          },
+          {
+            "value": "FABRIC_E_RESTORE_IN_PROGRESS"
+          },
+          {
+            "value": "FABRIC_E_BACKUP_POLICY_ALREADY_EXISTING"
+          },
+          {
+            "value": "FABRIC_E_INVALID_SERVICE_SCALING_POLICY"
+          },
+          {
+            "value": "E_INVALIDARG"
+          },
+          {
+            "value": "FABRIC_E_SINGLE_INSTANCE_APPLICATION_ALREADY_EXISTS"
+          },
+          {
+            "value": "FABRIC_E_SINGLE_INSTANCE_APPLICATION_NOT_FOUND"
+          },
+          {
+            "value": "FABRIC_E_VOLUME_ALREADY_EXISTS"
+          },
+          {
+            "value": "FABRIC_E_VOLUME_NOT_FOUND"
+          },
+          {
+            "value": "SerializationError"
+          },
+          {
+            "value": "FABRIC_E_IMAGEBUILDER_RESERVED_DIRECTORY_ERROR"
+          }
+        ]
+      }
+    },
+    "FabricError": {
+      "description": "The REST API operations for Service Fabric return standard HTTP status codes. This type defines the additional information returned from the Service Fabric API operations that are not successful.",
+      "properties": {
+        "Error": {
+          "$ref": "#/definitions/FabricErrorError",
+          "description": "Error object containing error code and error message."
+        }
+      },
+      "required": [
+        "Error"
+      ]
+    },
+    "FabricErrorError": {
+      "description": "Error object containing error code and error message.",
+      "properties": {
+        "Code": {
+          "$ref": "#/definitions/FabricErrorCodes",
+          "description": "Defines the fabric error codes that be returned as part of the error object in response to Service Fabric API operations that are not successful. Following are the error code values that can be returned for a specific HTTP status code.\n\n  - Possible values of the error code for HTTP status code 400 (Bad Request)\n    - \"FABRIC_E_INVALID_PARTITION_KEY\"\n    - \"FABRIC_E_IMAGEBUILDER_VALIDATION_ERROR\"\n    - \"FABRIC_E_INVALID_ADDRESS\"\n    - \"FABRIC_E_APPLICATION_NOT_UPGRADING\"\n    - \"FABRIC_E_APPLICATION_UPGRADE_VALIDATION_ERROR\"\n    - \"FABRIC_E_FABRIC_NOT_UPGRADING\"\n    - \"FABRIC_E_FABRIC_UPGRADE_VALIDATION_ERROR\"\n    - \"FABRIC_E_INVALID_CONFIGURATION\"\n    - \"FABRIC_E_INVALID_NAME_URI\"\n    - \"FABRIC_E_PATH_TOO_LONG\"\n    - \"FABRIC_E_KEY_TOO_LARGE\"\n    - \"FABRIC_E_SERVICE_AFFINITY_CHAIN_NOT_SUPPORTED\"\n    - \"FABRIC_E_INVALID_ATOMIC_GROUP\"\n    - \"FABRIC_E_VALUE_EMPTY\"\n    - \"FABRIC_E_BACKUP_IS_ENABLED\"\n    - \"FABRIC_E_RESTORE_SOURCE_TARGET_PARTITION_MISMATCH\"\n    - \"FABRIC_E_INVALID_FOR_STATELESS_SERVICES\"\n    - \"FABRIC_E_INVALID_SERVICE_SCALING_POLICY\"\n    - \"E_INVALIDARG\"\n\n  - Possible values of the error code for HTTP status code 404 (Not Found)\n    - \"FABRIC_E_NODE_NOT_FOUND\"\n    - \"FABRIC_E_APPLICATION_TYPE_NOT_FOUND\"\n    - \"FABRIC_E_APPLICATION_NOT_FOUND\"\n    - \"FABRIC_E_SERVICE_TYPE_NOT_FOUND\"\n    - \"FABRIC_E_SERVICE_DOES_NOT_EXIST\"\n    - \"FABRIC_E_SERVICE_TYPE_TEMPLATE_NOT_FOUND\"\n    - \"FABRIC_E_CONFIGURATION_SECTION_NOT_FOUND\"\n    - \"FABRIC_E_PARTITION_NOT_FOUND\"\n    - \"FABRIC_E_REPLICA_DOES_NOT_EXIST\"\n    - \"FABRIC_E_SERVICE_GROUP_DOES_NOT_EXIST\"\n    - \"FABRIC_E_CONFIGURATION_PARAMETER_NOT_FOUND\"\n    - \"FABRIC_E_DIRECTORY_NOT_FOUND\"\n    - \"FABRIC_E_FABRIC_VERSION_NOT_FOUND\"\n    - \"FABRIC_E_FILE_NOT_FOUND\"\n    - \"FABRIC_E_NAME_DOES_NOT_EXIST\"\n    - \"FABRIC_E_PROPERTY_DOES_NOT_EXIST\"\n    - \"FABRIC_E_ENUMERATION_COMPLETED\"\n    - \"FABRIC_E_SERVICE_MANIFEST_NOT_FOUND\"\n    - \"FABRIC_E_KEY_NOT_FOUND\"\n    - \"FABRIC_E_HEALTH_ENTITY_NOT_FOUND\"\n    - \"FABRIC_E_BACKUP_NOT_ENABLED\"\n    - \"FABRIC_E_BACKUP_POLICY_NOT_EXISTING\"\n    - \"FABRIC_E_FAULT_ANALYSIS_SERVICE_NOT_EXISTING\"\n    - \"FABRIC_E_IMAGEBUILDER_RESERVED_DIRECTORY_ERROR\"\n\n  - Possible values of the error code for HTTP status code 409 (Conflict)\n    - \"FABRIC_E_APPLICATION_TYPE_ALREADY_EXISTS\"\n    - \"FABRIC_E_APPLICATION_ALREADY_EXISTS\"\n    - \"FABRIC_E_APPLICATION_ALREADY_IN_TARGET_VERSION\"\n    - \"FABRIC_E_APPLICATION_TYPE_PROVISION_IN_PROGRESS\"\n    - \"FABRIC_E_APPLICATION_UPGRADE_IN_PROGRESS\"\n    - \"FABRIC_E_SERVICE_ALREADY_EXISTS\"\n    - \"FABRIC_E_SERVICE_GROUP_ALREADY_EXISTS\"\n    - \"FABRIC_E_APPLICATION_TYPE_IN_USE\"\n    - \"FABRIC_E_FABRIC_ALREADY_IN_TARGET_VERSION\"\n    - \"FABRIC_E_FABRIC_VERSION_ALREADY_EXISTS\"\n    - \"FABRIC_E_FABRIC_VERSION_IN_USE\"\n    - \"FABRIC_E_FABRIC_UPGRADE_IN_PROGRESS\"\n    - \"FABRIC_E_NAME_ALREADY_EXISTS\"\n    - \"FABRIC_E_NAME_NOT_EMPTY\"\n    - \"FABRIC_E_PROPERTY_CHECK_FAILED\"\n    - \"FABRIC_E_SERVICE_METADATA_MISMATCH\"\n    - \"FABRIC_E_SERVICE_TYPE_MISMATCH\"\n    - \"FABRIC_E_HEALTH_STALE_REPORT\"\n    - \"FABRIC_E_SEQUENCE_NUMBER_CHECK_FAILED\"\n    - \"FABRIC_E_NODE_HAS_NOT_STOPPED_YET\"\n    - \"FABRIC_E_INSTANCE_ID_MISMATCH\"\n    - \"FABRIC_E_BACKUP_IN_PROGRESS\"\n    - \"FABRIC_E_RESTORE_IN_PROGRESS\"\n    - \"FABRIC_E_BACKUP_POLICY_ALREADY_EXISTING\"\n\n  - Possible values of the error code for HTTP status code 413 (Request Entity Too Large)\n    - \"FABRIC_E_VALUE_TOO_LARGE\"\n\n  - Possible values of the error code for HTTP status code 500 (Internal Server Error)\n    - \"FABRIC_E_NODE_IS_UP\"\n    - \"E_FAIL\"\n    - \"FABRIC_E_SINGLE_INSTANCE_APPLICATION_ALREADY_EXISTS\"\n    - \"FABRIC_E_SINGLE_INSTANCE_APPLICATION_NOT_FOUND\"\n    - \"FABRIC_E_VOLUME_ALREADY_EXISTS\"\n    - \"FABRIC_E_VOLUME_NOT_FOUND\"\n    - \"SerializationError\"\n\n  - Possible values of the error code for HTTP status code 503 (Service Unavailable)\n    - \"FABRIC_E_NO_WRITE_QUORUM\"\n    - \"FABRIC_E_NOT_PRIMARY\"\n    - \"FABRIC_E_NOT_READY\"\n    - \"FABRIC_E_RECONFIGURATION_PENDING\"\n    - \"FABRIC_E_SERVICE_OFFLINE\"\n    - \"E_ABORT\"\n    - \"FABRIC_E_VALUE_TOO_LARGE\"\n\n  - Possible values of the error code for HTTP status code 504 (Gateway Timeout)\n    - \"FABRIC_E_COMMUNICATION_ERROR\"\n    - \"FABRIC_E_OPERATION_NOT_COMPLETE\"\n    - \"FABRIC_E_TIMEOUT\""
+        },
+        "Message": {
+          "type": "string",
+          "description": "Error message."
+        }
+      },
+      "required": [
+        "Code"
+      ]
+    },
+    "ContainerLogs": {
+      "description": "Container logs.",
+      "properties": {
+        "Content": {
+          "type": "string",
+          "description": "Container logs."
+        }
+      }
+    },
+    "AadMetadata": {
+      "description": "Azure Active Directory metadata used for secured connection to cluster.",
+      "properties": {
+        "authority": {
+          "type": "string",
+          "description": "The AAD authority url."
+        },
+        "client": {
+          "type": "string",
+          "description": "The AAD client application Id."
+        },
+        "cluster": {
+          "type": "string",
+          "description": "The AAD cluster application Id."
+        },
+        "login": {
+          "type": "string",
+          "description": "The AAD login url."
+        },
+        "redirect": {
+          "type": "string",
+          "description": "The client application redirect address."
+        },
+        "tenant": {
+          "type": "string",
+          "description": "The AAD tenant Id."
+        }
+      }
+    },
+    "AadMetadataObject": {
+      "description": "Azure Active Directory metadata object used for secured connection to cluster.",
+      "properties": {
+        "type": {
+          "type": "string",
+          "description": "The client authentication method."
+        },
+        "metadata": {
+          "$ref": "#/definitions/AadMetadata",
+          "description": "Azure Active Directory metadata used for secured connection to cluster."
+        }
+      }
+    },
+    "AnalysisEventMetadata": {
+      "description": "Metadata about an Analysis Event.",
+      "properties": {
+        "Delay": {
+          "type": "string",
+          "format": "duration",
+          "description": "The analysis delay."
+        },
+        "Duration": {
+          "type": "string",
+          "format": "duration",
+          "description": "The duration of analysis."
+        }
+      }
+    },
+    "ApplicationDefinitionKind": {
+      "type": "string",
+      "description": "The mechanism used to define a Service Fabric application.",
+      "enum": [
+        "Invalid",
+        "ServiceFabricApplicationDescription",
+        "Compose"
+      ],
+      "x-ms-enum": {
+        "name": "ApplicationDefinitionKind",
+        "modelAsString": true,
+        "values": [
+          {
+            "value": "Invalid",
+            "description": "Indicates the application definition kind is invalid. All Service Fabric enumerations have the invalid type. The value is 65535."
+          },
+          {
+            "value": "ServiceFabricApplicationDescription",
+            "description": "Indicates the application is defined by a Service Fabric application description. The value is 0."
+          },
+          {
+            "value": "Compose",
+            "description": "Indicates the application is defined by compose file(s). The value is 1."
+          }
+        ]
+      }
+    },
+    "ApplicationEvent": {
+      "description": "Represents the base for all Application Events.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/FabricEvent"
+        }
+      ],
+      "properties": {
+        "ApplicationId": {
+          "$ref": "#/definitions/ApplicationId",
+          "description": "The identity of the application. This is an encoded representation of the application name. This is used in the REST APIs to identify the application resource.\nStarting in version 6.0, hierarchical names are delimited with the \"\\~\" character. For example, if the application name is \"fabric:/myapp/app1\",\nthe application identity would be \"myapp\\~app1\" in 6.0+ and \"myapp/app1\" in previous versions."
+        }
+      },
+      "required": [
+        "ApplicationId"
+      ],
+      "x-ms-discriminator-value": "ApplicationEvent"
+    },
+    "ApplicationEventList": {
+      "description": "A list of ApplicationEvent objects.",
+      "type": "array",
+      "items": {
+        "$ref": "#/definitions/ApplicationEvent"
+      }
+    },
+    "ApplicationHealth": {
+      "description": "Represents the health of the application. Contains the application aggregated health state and the service and deployed application health states.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/EntityHealth"
+        }
+      ],
+      "properties": {
+        "Name": {
+          "$ref": "#/definitions/ApplicationName",
+          "description": "The name of the application, including the 'fabric:' URI scheme."
+        },
+        "ServiceHealthStates": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/ServiceHealthState"
+          },
+          "description": "Service health states as found in the health store."
+        },
+        "DeployedApplicationHealthStates": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/DeployedApplicationHealthState"
+          },
+          "description": "Deployed application health states as found in the health store."
+        }
+      }
+    },
+    "ApplicationHealthEvaluation": {
+      "x-ms-discriminator-value": "Application",
+      "description": "Represents health evaluation for an application, containing information about the data and the algorithm used by the health store to evaluate health.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/HealthEvaluation"
+        }
+      ],
+      "properties": {
+        "ApplicationName": {
+          "$ref": "#/definitions/ApplicationName",
+          "description": "The name of the application, including the 'fabric:' URI scheme."
+        },
+        "UnhealthyEvaluations": {
+          "$ref": "#/definitions/UnhealthyEvaluations",
+          "description": "List of unhealthy evaluations that led to the current aggregated health state of the application. The types of the unhealthy evaluations can be DeployedApplicationsHealthEvaluation, ServicesHealthEvaluation or EventHealthEvaluation."
+        }
+      }
+    },
+    "ApplicationHealthPolicies": {
+      "description": "Defines the application health policy map used to evaluate the health of an application or one of its children entities.",
+      "properties": {
+        "ApplicationHealthPolicyMap": {
+          "$ref": "#/definitions/ApplicationHealthPolicyMap",
+          "description": "The wrapper that contains the map with application health policies used to evaluate specific applications in the cluster."
+        }
+      }
+    },
+    "ApplicationHealthPolicy": {
+      "description": "Defines a health policy used to evaluate the health of an application or one of its children entities.",
+      "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.",
+          "default": 0
+        },
+        "DefaultServiceTypeHealthPolicy": {
+          "$ref": "#/definitions/ServiceTypeHealthPolicy",
+          "description": "The health policy used by default to evaluate the health of a service type."
+        },
+        "ServiceTypeHealthPolicyMap": {
+          "$ref": "#/definitions/ServiceTypeHealthPolicyMap",
+          "description": "The map with service type health policy per service type name. The map is empty by default."
+        }
+      }
+    },
+    "ApplicationHealthPolicyMap": {
+      "type": "array",
+      "items": {
+        "$ref": "#/definitions/ApplicationHealthPolicyMapItem"
+      },
+      "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.\nIf an application is not specified in the map, the application health evaluation uses the ApplicationHealthPolicy found in its application manifest or the default application health policy (if no health policy is defined in the manifest).\nThe map is empty by default."
+    },
+    "ApplicationHealthPolicyMapItem": {
+      "description": "Defines an item in ApplicationHealthPolicyMap.",
+      "required": [
+        "Key",
+        "Value"
+      ],
+      "properties": {
+        "Key": {
+          "$ref": "#/definitions/ApplicationName",
+          "description": "The key of the application health policy map item. This is the name of the application."
+        },
+        "Value": {
+          "$ref": "#/definitions/ApplicationHealthPolicy",
+          "description": "The value of the application health policy map item. This is the ApplicationHealthPolicy for this application."
+        }
+      }
+    },
+    "ApplicationHealthPolicyMapObject": {
+      "description": "Represents the map of application health policies for a ServiceFabric cluster upgrade",
+      "properties": {
+        "ApplicationHealthPolicyMap": {
+          "$ref": "#/definitions/ApplicationHealthPolicyMap",
+          "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.\nIf an application is not specified in the map, the application health evaluation uses the ApplicationHealthPolicy found in its application manifest or the default application health policy (if no health policy is defined in the manifest).\nThe map is empty by default."
+        }
+      }
+    },
+    "ApplicationHealthState": {
+      "description": "Represents the health state of an application, which contains the application identifier and the aggregated health state.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/EntityHealthState"
+        }
+      ],
+      "properties": {
+        "Name": {
+          "$ref": "#/definitions/ApplicationName",
+          "description": "The name of the application, including the 'fabric:' URI scheme."
+        }
+      }
+    },
+    "ApplicationHealthStateChunk": {
+      "description": "Represents the health state chunk of a application.\nThe application health state chunk contains the application name, its aggregated health state and any children services and deployed applications that respect the filters in cluster health chunk query description.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/EntityHealthStateChunk"
+        }
+      ],
+      "properties": {
+        "ApplicationName": {
+          "$ref": "#/definitions/ApplicationName",
+          "description": "The name of the application, including the 'fabric:' URI scheme."
+        },
+        "ApplicationTypeName": {
+          "$ref": "#/definitions/ApplicationTypeName",
+          "description": "The application type name as defined in the application manifest."
+        },
+        "ServiceHealthStateChunks": {
+          "$ref": "#/definitions/ServiceHealthStateChunkList",
+          "description": "The list of service health state chunks in the cluster that respect the filters in the cluster health chunk query description."
+        },
+        "DeployedApplicationHealthStateChunks": {
+          "$ref": "#/definitions/DeployedApplicationHealthStateChunkList",
+          "description": "The list of deployed application health state chunks in the cluster that respect the filters in the cluster health chunk query description."
+        }
+      }
+    },
+    "ApplicationHealthStateChunkList": {
+      "description": "The list of application health state chunks in the cluster that respect the input filters in the chunk query. Returned by get cluster health state chunks query.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/EntityHealthStateChunkList"
+        }
+      ],
+      "properties": {
+        "Items": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/ApplicationHealthStateChunk"
+          },
+          "description": "The list of application health state chunks that respect the input filters in the chunk query."
+        }
+      }
+    },
+    "ApplicationHealthStateFilter": {
+      "description": "Defines matching criteria to determine whether a application should be included in the cluster health chunk.\nOne filter can match zero, one or multiple applications, depending on its properties.",
+      "properties": {
+        "ApplicationNameFilter": {
+          "type": "string",
+          "description": "The name of the application that matches the filter, as a fabric uri. The filter is applied only to the specified application, if it exists.\nIf the application doesn't exist, no application is returned in the cluster health chunk based on this filter.\nIf the application exists, it is included in the cluster health chunk if it respects the other filter properties.\nIf not specified, all applications are matched against the other filter members, like health state filter."
+        },
+        "ApplicationTypeNameFilter": {
+          "type": "string",
+          "description": "The name of the application type that matches the filter.\nIf specified, the filter is applied only to applications of the selected application type, if any exists.\nIf no applications of the specified application type exists, no application is returned in the cluster health chunk based on this filter.\nEach application of the specified application type is included in the cluster health chunk if it respects the other filter properties.\nIf not specified, all applications are matched against the other filter members, like health state filter."
+        },
+        "HealthStateFilter": {
+          "type": "integer",
+          "default": 0,
+          "description": "The filter for the health state of the applications. It allows selecting applications if they match the desired health states.\nThe possible values are integer value of one of the following health states. Only applications that match the filter are returned. All applications are used to evaluate the cluster aggregated health state.\nIf not specified, default value is None, unless the application name or the application type name are specified. If the filter has default value and application name is specified, the matching application is returned.\nThe state values are flag-based enumeration, so the value could be a combination of these values obtained using bitwise 'OR' operator.\nFor example, if the provided value is 6, it matches applications with HealthState value of OK (2) and Warning (4).\n\n- Default - Default value. Matches any HealthState. The value is zero.\n- None - Filter that doesn't match any HealthState value. Used in order to return no results on a given collection of states. The value is 1.\n- Ok - Filter that matches input with HealthState value Ok. The value is 2.\n- Warning - Filter that matches input with HealthState value Warning. The value is 4.\n- Error - Filter that matches input with HealthState value Error. The value is 8.\n- All - Filter that matches input with any HealthState value. The value is 65535."
+        },
+        "ServiceFilters": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/ServiceHealthStateFilter"
+          },
+          "description": "Defines a list of filters that specify which services to be included in the returned cluster health chunk as children of the application. The services are returned only if the parent application matches a filter.\nIf the list is empty, no services are returned. All the services are used to evaluate the parent application aggregated health state, regardless of the input filters.\nThe application filter may specify multiple service filters.\nFor example, it can specify a filter to return all services with health state Error and another filter to always include a service identified by its service name."
+        },
+        "DeployedApplicationFilters": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/DeployedApplicationHealthStateFilter"
+          },
+          "description": "Defines a list of filters that specify which deployed applications to be included in the returned cluster health chunk as children of the application. The deployed applications are returned only if the parent application matches a filter.\nIf the list is empty, no deployed applications are returned. All the deployed applications are used to evaluate the parent application aggregated health state, regardless of the input filters.\nThe application filter may specify multiple deployed application filters.\nFor example, it can specify a filter to return all deployed applications with health state Error and another filter to always include a deployed application on a specified node."
+        }
+      }
+    },
+    "ApplicationId": {
+      "type": "string",
+      "description": "The identity of the application. This is an encoded representation of the application name. This is used in the REST APIs to identify the application resource.\nStarting in version 6.0, hierarchical names are delimited with the \"\\~\" character. For example, if the application name is \"fabric:/myapp/app1\",\nthe application identity would be \"myapp\\~app1\" in 6.0+ and \"myapp/app1\" in previous versions."
+    },
+    "ApplicationInfo": {
+      "description": "Information about a Service Fabric application.",
+      "properties": {
+        "Id": {
+          "$ref": "#/definitions/ApplicationId",
+          "description": "The identity of the application. This is an encoded representation of the application name. This is used in the REST APIs to identify the application resource.\nStarting in version 6.0, hierarchical names are delimited with the \"\\~\" character. For example, if the application name is \"fabric:/myapp/app1\",\nthe application identity would be \"myapp\\~app1\" in 6.0+ and \"myapp/app1\" in previous versions."
+        },
+        "Name": {
+          "$ref": "#/definitions/ApplicationName",
+          "description": "The name of the application, including the 'fabric:' URI scheme."
+        },
+        "TypeName": {
+          "$ref": "#/definitions/ApplicationTypeName",
+          "description": "The application type name as defined in the application manifest."
+        },
+        "TypeVersion": {
+          "$ref": "#/definitions/ApplicationTypeVersion",
+          "description": "The version of the application type as defined in the application manifest."
+        },
+        "Status": {
+          "$ref": "#/definitions/ApplicationStatus",
+          "description": "The status of the application."
+        },
+        "Parameters": {
+          "$ref": "#/definitions/ApplicationParameterList",
+          "description": "List of application parameters with overridden values from their default values specified in the application manifest."
+        },
+        "HealthState": {
+          "$ref": "#/definitions/HealthState",
+          "description": "The health state of a Service Fabric entity such as Cluster, Node, Application, Service, Partition, Replica etc."
+        },
+        "ApplicationDefinitionKind": {
+          "$ref": "#/definitions/ApplicationDefinitionKind",
+          "description": "The mechanism used to define a Service Fabric application."
+        }
+      }
+    },
+    "ApplicationLoadInfo": {
+      "description": "Load Information about a Service Fabric application.",
+      "properties": {
+        "Id": {
+          "$ref": "#/definitions/ApplicationId",
+          "description": "The identity of the application. This is an encoded representation of the application name. This is used in the REST APIs to identify the application resource.\nStarting in version 6.0, hierarchical names are delimited with the \"\\~\" character. For example, if the application name is \"fabric:/myapp/app1\",\nthe application identity would be \"myapp\\~app1\" in 6.0+ and \"myapp/app1\" in previous versions."
+        },
+        "MinimumNodes": {
+          "type": "integer",
+          "format": "int64",
+          "description": "The minimum number of nodes for this application.\nIt is the number of nodes where Service Fabric will reserve Capacity in the cluster which equals to ReservedLoad * MinimumNodes for this Application instance.\nFor applications that do not have application capacity defined this value will be zero."
+        },
+        "MaximumNodes": {
+          "type": "integer",
+          "format": "int64",
+          "description": "The maximum number of nodes where this application can be instantiated.\nIt is the number of nodes this application is allowed to span.\nFor applications that do not have application capacity defined this value will be zero."
+        },
+        "NodeCount": {
+          "type": "integer",
+          "format": "int64",
+          "description": "The number of nodes on which this application is instantiated.\nFor applications that do not have application capacity defined this value will be zero."
+        },
+        "ApplicationLoadMetricInformation": {
+          "$ref": "#/definitions/ApplicationLoadMetricInformationList",
+          "description": "List of application load metric information."
+        }
+      }
+    },
+    "ApplicationName": {
+      "type": "string",
+      "description": "The name of the application, including the 'fabric:' URI scheme."
+    },
+    "ApplicationNameInfo": {
+      "description": "Information about the application name.",
+      "properties": {
+        "Id": {
+          "$ref": "#/definitions/ApplicationId",
+          "description": "The identity of the application. This is an encoded representation of the application name. This is used in the REST APIs to identify the application resource.\nStarting in version 6.0, hierarchical names are delimited with the \"\\~\" character. For example, if the application name is \"fabric:/myapp/app1\",\nthe application identity would be \"myapp\\~app1\" in 6.0+ and \"myapp/app1\" in previous versions."
+        },
+        "Name": {
+          "$ref": "#/definitions/ApplicationName",
+          "description": "The name of the application, including the 'fabric:' URI scheme."
+        }
+      }
+    },
+    "ApplicationPackageCleanupPolicy": {
+      "type": "string",
+      "description": "The kind of action that needs to be taken for cleaning up the application package after successful provision.",
+      "enum": [
+        "Invalid",
+        "Default",
+        "Automatic",
+        "Manual"
+      ],
+      "x-ms-enum": {
+        "name": "ApplicationPackageCleanupPolicy",
+        "modelAsString": true,
+        "values": [
+          {
+            "value": "Invalid",
+            "description": "Indicates that the application package cleanup policy is invalid. This value is default. The value is zero."
+          },
+          {
+            "value": "Default",
+            "description": "Indicates that the cleanup policy of application packages is based on the cluster setting \"CleanupApplicationPackageOnProvisionSuccess.\" The value is 1."
+          },
+          {
+            "value": "Automatic",
+            "description": "Indicates that the service fabric runtime determines when to do the application package cleanup. By default, cleanup is done on successful provision. The value is 2."
+          },
+          {
+            "value": "Manual",
+            "description": "Indicates that the user has to explicitly clean up the application package. The value is 3."
+          }
+        ]
+      }
+    },
+    "ApplicationParameter": {
+      "description": "Describes an application parameter override to be applied when creating or upgrading an application.",
+      "required": [
+        "Key",
+        "Value"
+      ],
+      "properties": {
+        "Key": {
+          "type": "string",
+          "description": "The name of the parameter."
+        },
+        "Value": {
+          "type": "string",
+          "description": "The value of the parameter."
+        }
+      }
+    },
+    "ApplicationParameterList": {
+      "type": "array",
+      "items": {
+        "$ref": "#/definitions/ApplicationParameter"
+      },
+      "description": "List of application parameters with overridden values from their default values specified in the application manifest."
+    },
+    "ApplicationsHealthEvaluation": {
+      "x-ms-discriminator-value": "Applications",
+      "description": "Represents health evaluation for applications, containing health evaluations for each unhealthy application that impacted current aggregated health state.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/HealthEvaluation"
+        }
+      ],
+      "properties": {
+        "MaxPercentUnhealthyApplications": {
+          "type": "integer",
+          "description": "Maximum allowed percentage of unhealthy applications from the ClusterHealthPolicy."
+        },
+        "TotalCount": {
+          "type": "integer",
+          "format": "int64",
+          "description": "Total number of applications from the health store."
+        },
+        "UnhealthyEvaluations": {
+          "$ref": "#/definitions/UnhealthyEvaluations",
+          "description": "List of unhealthy evaluations that led to the aggregated health state. Includes all the unhealthy ApplicationHealthEvaluation that impacted the aggregated health."
+        }
+      }
+    },
+    "ApplicationStatus": {
+      "type": "string",
+      "description": "The status of the application.",
+      "enum": [
+        "Invalid",
+        "Ready",
+        "Upgrading",
+        "Creating",
+        "Deleting",
+        "Failed"
+      ],
+      "x-ms-enum": {
+        "name": "ApplicationStatus",
+        "modelAsString": true,
+        "values": [
+          {
+            "value": "Invalid",
+            "description": "Indicates the application status is invalid. All Service Fabric enumerations have the invalid type. The value is zero."
+          },
+          {
+            "value": "Ready",
+            "description": "Indicates the application status is ready. The value is 1."
+          },
+          {
+            "value": "Upgrading",
+            "description": "Indicates the application status is upgrading. The value is 2."
+          },
+          {
+            "value": "Creating",
+            "description": "Indicates the application status is creating. The value is 3."
+          },
+          {
+            "value": "Deleting",
+            "description": "Indicates the application status is deleting. The value is 4."
+          },
+          {
+            "value": "Failed",
+            "description": "Indicates the creation or deletion of application was terminated due to persistent failures. Another create/delete request can be accepted to resume a failed application. The value is 5."
+          }
+        ]
+      }
+    },
+    "ApplicationTypeApplicationsHealthEvaluation": {
+      "x-ms-discriminator-value": "ApplicationTypeApplications",
+      "description": "Represents health evaluation for applications of a particular application type. The application type applications evaluation can be returned when cluster health evaluation returns unhealthy aggregated health state, either Error or Warning. It contains health evaluations for each unhealthy application of the included application type that impacted current aggregated health state.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/HealthEvaluation"
+        }
+      ],
+      "properties": {
+        "ApplicationTypeName": {
+          "$ref": "#/definitions/ApplicationTypeName",
+          "description": "The application type name as defined in the application manifest."
+        },
+        "MaxPercentUnhealthyApplications": {
+          "type": "integer",
+          "description": "Maximum allowed percentage of unhealthy applications for the application type, specified as an entry in ApplicationTypeHealthPolicyMap."
+        },
+        "TotalCount": {
+          "type": "integer",
+          "format": "int64",
+          "description": "Total number of applications of the application type found in the health store."
+        },
+        "UnhealthyEvaluations": {
+          "$ref": "#/definitions/UnhealthyEvaluations",
+          "description": "List of unhealthy evaluations that led to the aggregated health state. Includes all the unhealthy ApplicationHealthEvaluation of this application type that impacted the aggregated health."
+        }
+      }
+    },
+    "ApplicationTypeDefinitionKind": {
+      "type": "string",
+      "description": "The mechanism used to define a Service Fabric application type.",
+      "enum": [
+        "Invalid",
+        "ServiceFabricApplicationPackage",
+        "Compose"
+      ],
+      "x-ms-enum": {
+        "name": "ApplicationTypeDefinitionKind",
+        "modelAsString": true,
+        "values": [
+          {
+            "value": "Invalid",
+            "description": "Indicates the application type definition kind is invalid. All Service Fabric enumerations have the invalid type. The value is 0."
+          },
+          {
+            "value": "ServiceFabricApplicationPackage",
+            "description": "Indicates the application type is defined and created by a Service Fabric application package provided by the user. The value is 1."
+          },
+          {
+            "value": "Compose",
+            "description": "Indicates the application type is defined and created implicitly as part of a compose deployment. The value is 2."
+          }
+        ]
+      }
+    },
+    "ApplicationTypeHealthPolicyMap": {
+      "type": "array",
+      "items": {
+        "$ref": "#/definitions/ApplicationTypeHealthPolicyMapItem"
+      },
+      "description": "Defines a map with max percentage unhealthy applications for specific application types.\nEach entry specifies as key the application type name and as value an integer that represents the MaxPercentUnhealthyApplications percentage used to evaluate the applications of the specified application type.\n\nThe application type health policy map can be used during cluster health evaluation to describe special application types.\nThe application types included in the map are evaluated against the percentage specified in the map, and not with the global MaxPercentUnhealthyApplications defined in the cluster health policy.\nThe applications of application types specified in the map are not counted against the global pool of applications.\nFor example, if some applications of a type are critical, the cluster administrator can add an entry to the map for that application type\nand assign it a value of 0% (that is, do not tolerate any failures).\nAll other applications can be evaluated with MaxPercentUnhealthyApplications set to 20% to tolerate some failures out of the thousands of application instances.\nThe application type health policy map is used only if the cluster manifest enables application type health evaluation using the configuration entry for HealthManager/EnableApplicationTypeHealthEvaluation."
+    },
+    "ApplicationTypeHealthPolicyMapItem": {
+      "description": "Defines an item in ApplicationTypeHealthPolicyMap.",
+      "required": [
+        "Key",
+        "Value"
+      ],
+      "properties": {
+        "Key": {
+          "type": "string",
+          "description": "The key of the application type health policy map item. This is the name of the application type."
+        },
+        "Value": {
+          "type": "integer",
+          "description": "The value of the application type health policy map item.\nThe max percent unhealthy applications allowed for the application type. Must be between zero and 100."
+        }
+      }
+    },
+    "ApplicationTypeInfo": {
+      "description": "Information about an application type.",
+      "properties": {
+        "Name": {
+          "$ref": "#/definitions/ApplicationTypeName",
+          "description": "The application type name as defined in the application manifest."
+        },
+        "Version": {
+          "$ref": "#/definitions/ApplicationTypeVersion",
+          "description": "The version of the application type as defined in the application manifest."
+        },
+        "DefaultParameterList": {
+          "$ref": "#/definitions/ApplicationTypeParameterList",
+          "description": "List of application type parameters that can be overridden when creating or updating the application."
+        },
+        "Status": {
+          "$ref": "#/definitions/ApplicationTypeStatus",
+          "description": "The status of the application type."
+        },
+        "StatusDetails": {
+          "type": "string",
+          "description": "Additional detailed information about the status of the application type."
+        },
+        "ApplicationTypeDefinitionKind": {
+          "$ref": "#/definitions/ApplicationTypeDefinitionKind",
+          "description": "The mechanism used to define a Service Fabric application type."
+        }
+      }
+    },
+    "PagedApplicationTypeInfoList": {
+      "description": "The list of application types that are provisioned or being provisioned in the cluster. The list is paged when all of the results cannot fit in a single message. The next set of results can be obtained by executing the same query with the continuation token provided in this list.",
+      "properties": {
+        "ContinuationToken": {
+          "$ref": "#/definitions/ContinuationToken",
+          "description": "The continuation token parameter is used to obtain next set of results. The continuation token is included in the response of the API when the results from the system do not fit in a single response. When this value is passed to the next API call, the API returns next set of results. If there are no further results, then the continuation token is not included in the response."
+        },
+        "Items": {
+          "type": "array",
+          "description": "List of application type information.",
+          "items": {
+            "$ref": "#/definitions/ApplicationTypeInfo"
+          }
+        }
+      }
+    },
+    "ApplicationTypeManifest": {
+      "description": "Contains the manifest describing an application type registered in a Service Fabric cluster.",
+      "properties": {
+        "Manifest": {
+          "type": "string",
+          "description": "The XML manifest as a string."
+        }
+      }
+    },
+    "ApplicationTypeName": {
+      "type": "string",
+      "description": "The application type name as defined in the application manifest."
+    },
+    "ApplicationTypeParameterList": {
+      "type": "array",
+      "items": {
+        "$ref": "#/definitions/ApplicationParameter"
+      },
+      "description": "List of application type parameters that can be overridden when creating or updating the application."
+    },
+    "ApplicationTypeStatus": {
+      "type": "string",
+      "description": "The status of the application type.",
+      "enum": [
+        "Invalid",
+        "Provisioning",
+        "Available",
+        "Unprovisioning",
+        "Failed"
+      ],
+      "x-ms-enum": {
+        "name": "ApplicationTypeStatus",
+        "modelAsString": true,
+        "values": [
+          {
+            "value": "Invalid",
+            "description": "Indicates the application type status is invalid. All Service Fabric enumerations have the invalid type. The value is zero."
+          },
+          {
+            "value": "Provisioning",
+            "description": "Indicates that the application type is being provisioned in the cluster. The value is 1."
+          },
+          {
+            "value": "Available",
+            "description": "Indicates that the application type is fully provisioned and is available for use. An application of this type and version can be created. The value is 2."
+          },
+          {
+            "value": "Unprovisioning",
+            "description": "Indicates that the application type is in process of being unprovisioned from the cluster. The value is 3."
+          },
+          {
+            "value": "Failed",
+            "description": "Indicates that the application type provisioning failed and it is unavailable for use. The failure details can be obtained from the application type information query. The failed application type information remains in the cluster until it is unprovisioned or reprovisioned successfully. The value is 4."
+          }
+        ]
+      }
+    },
+    "ApplicationUnhealthyEvaluations": {
+      "description": "List of health evaluations that resulted in the current aggregated health state.",
+      "type": "array",
+      "items": {
+        "$ref": "#/definitions/HealthEvaluationWrapper"
+      }
+    },
+    "ApplicationUpgradeDescription": {
+      "description": "Describes the parameters for an application upgrade. Note that upgrade description replaces the existing application description. This means that if the parameters are not specified, the existing parameters on the applications will be overwritten with the empty parameters list. This would result in the application using the default value of the parameters from the application manifest. If you do not want to change any existing parameter values, please get the application parameters first using the GetApplicationInfo query and then supply those values as Parameters in this ApplicationUpgradeDescription.",
+      "properties": {
+        "Name": {
+          "$ref": "#/definitions/TargetApplicationName",
+          "description": "The name of the target application, including the 'fabric:' URI scheme."
+        },
+        "TargetApplicationTypeVersion": {
+          "$ref": "#/definitions/TargetApplicationTypeVersion",
+          "description": "The target application type version (found in the application manifest) for the application upgrade."
+        },
+        "Parameters": {
+          "$ref": "#/definitions/ApplicationParameterList",
+          "description": "List of application parameters with overridden values from their default values specified in the application manifest."
+        },
+        "UpgradeKind": {
+          "$ref": "#/definitions/UpgradeKind",
+          "description": "The kind of upgrade out of the following possible values."
+        },
+        "RollingUpgradeMode": {
+          "$ref": "#/definitions/UpgradeMode",
+          "description": "The mode used to monitor health during a rolling upgrade. The values are UnmonitoredAuto, UnmonitoredManual, and Monitored."
+        },
+        "UpgradeReplicaSetCheckTimeoutInSeconds": {
+          "$ref": "#/definitions/UpgradeReplicaSetCheckTimeout",
+          "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)."
+        },
+        "SortOrder": {
+          "$ref": "#/definitions/UpgradeSortOrder",
+          "description": "Defines the order in which an upgrade proceeds through the cluster."
+        },
+        "MonitoringPolicy": {
+          "$ref": "#/definitions/MonitoringPolicyDescription",
+          "description": "Describes the parameters for monitoring an upgrade in Monitored mode."
+        },
+        "ApplicationHealthPolicy": {
+          "$ref": "#/definitions/ApplicationHealthPolicy",
+          "description": "Defines a health policy used to evaluate the health of an application or one of its children entities."
+        },
+        "InstanceCloseDelayDurationInSeconds": {
+          "$ref": "#/definitions/InstanceCloseDelayDurationInSeconds",
+          "description": "Duration in seconds, to wait before a stateless instance is closed, to allow the active requests to drain gracefully. This would be effective when the instance is closing during the application/cluster\nupgrade, only for those instances which have a non-zero delay duration configured in the service description. See InstanceCloseDelayDurationSeconds property in $ref: \"#/definitions/StatelessServiceDescription.yaml\" for details.\nNote, the default value of InstanceCloseDelayDurationInSeconds is 4294967295, which indicates that the behavior will entirely depend on the delay configured in the stateless service description."
+        }
+      },
+      "required": [
+        "Name",
+        "TargetApplicationTypeVersion",
+        "UpgradeKind"
+      ]
+    },
+    "ApplicationUpgradeProgressInfo": {
+      "description": "Describes the parameters for an application upgrade.",
+      "properties": {
+        "Name": {
+          "$ref": "#/definitions/TargetApplicationName",
+          "description": "The name of the target application, including the 'fabric:' URI scheme."
+        },
+        "TypeName": {
+          "$ref": "#/definitions/ApplicationTypeName",
+          "description": "The application type name as defined in the application manifest."
+        },
+        "TargetApplicationTypeVersion": {
+          "$ref": "#/definitions/TargetApplicationTypeVersion",
+          "description": "The target application type version (found in the application manifest) for the application upgrade."
+        },
+        "UpgradeDomains": {
+          "$ref": "#/definitions/UpgradeDomainInfoList",
+          "description": "List of upgrade domains and their statuses."
+        },
+        "UpgradeState": {
+          "$ref": "#/definitions/UpgradeState",
+          "description": "The state of the upgrade domain."
+        },
+        "NextUpgradeDomain": {
+          "$ref": "#/definitions/NextUpgradeDomain",
+          "description": "The name of the next upgrade domain to be processed."
+        },
+        "RollingUpgradeMode": {
+          "$ref": "#/definitions/UpgradeMode",
+          "description": "The mode used to monitor health during a rolling upgrade. The values are UnmonitoredAuto, UnmonitoredManual, and Monitored."
+        },
+        "UpgradeDescription": {
+          "$ref": "#/definitions/ApplicationUpgradeDescription",
+          "description": "Describes the parameters for an application upgrade. Note that upgrade description replaces the existing application description. This means that if the parameters are not specified, the existing parameters on the applications will be overwritten with the empty parameters list. This would result in the application using the default value of the parameters from the application manifest. If you do not want to change any existing parameter values, please get the application parameters first using the GetApplicationInfo query and then supply those values as Parameters in this ApplicationUpgradeDescription."
+        },
+        "UpgradeDurationInMilliseconds": {
+          "type": "string",
+          "description": "The estimated total amount of time spent processing the overall upgrade."
+        },
+        "UpgradeDomainDurationInMilliseconds": {
+          "type": "string",
+          "description": "The estimated total amount of time spent processing the current upgrade domain."
+        },
+        "UnhealthyEvaluations": {
+          "$ref": "#/definitions/UnhealthyEvaluations",
+          "description": "List of health evaluations that resulted in the current aggregated health state."
+        },
+        "CurrentUpgradeDomainProgress": {
+          "$ref": "#/definitions/CurrentUpgradeDomainProgressInfo",
+          "description": "Information about the current in-progress upgrade domain."
+        },
+        "StartTimestampUtc": {
+          "type": "string",
+          "description": "The estimated UTC datetime when the upgrade started."
+        },
+        "FailureTimestampUtc": {
+          "type": "string",
+          "description": "The estimated UTC datetime when the upgrade failed and FailureAction was executed."
+        },
+        "FailureReason": {
+          "$ref": "#/definitions/FailureReason",
+          "description": "The cause of an upgrade failure that resulted in FailureAction being executed."
+        },
+        "UpgradeDomainProgressAtFailure": {
+          "$ref": "#/definitions/FailureUpgradeDomainProgressInfo",
+          "description": "Information about the upgrade domain progress at the time of upgrade failure."
+        },
+        "UpgradeStatusDetails": {
+          "type": "string",
+          "description": "Additional detailed information about the status of the pending upgrade."
+        }
+      }
+    },
+    "ByteArray": {
+      "description": "Array of bytes to be sent as an integer array. Each element of array is a number between 0 and 255.",
+      "type": "array",
+      "items": {
+        "type": "integer"
+      }
+    },
+    "ClusterConfiguration": {
+      "description": "Information about the standalone cluster configuration.",
+      "properties": {
+        "ClusterConfiguration": {
+          "type": "string",
+          "description": "The contents of the cluster configuration file."
+        }
+      }
+    },
+    "ClusterEvent": {
+      "description": "Represents the base for all Cluster Events.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/FabricEvent"
+        }
+      ],
+      "x-ms-discriminator-value": "ClusterEvent"
+    },
+    "ClusterEventList": {
+      "description": "A list of ClusterEvent objects.",
+      "type": "array",
+      "items": {
+        "$ref": "#/definitions/ClusterEvent"
+      }
+    },
+    "ClusterHealth": {
+      "description": "Represents the health of the cluster.\nContains the cluster aggregated health state, the cluster application and node health states as well as the health events and the unhealthy evaluations.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/EntityHealth"
+        }
+      ],
+      "properties": {
+        "NodeHealthStates": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/NodeHealthState"
+          },
+          "description": "Cluster node health states as found in the health store."
+        },
+        "ApplicationHealthStates": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/ApplicationHealthState"
+          },
+          "description": "Cluster application health states as found in the health store."
+        }
+      }
+    },
+    "ClusterHealthChunk": {
+      "description": "Represents the health chunk of the cluster.\nContains the cluster aggregated health state, and the cluster entities that respect the input filter.",
+      "properties": {
+        "HealthState": {
+          "$ref": "#/definitions/HealthState",
+          "description": "The HealthState representing the aggregated health state of the cluster computed by Health Manager.\nThe health evaluation of the entity reflects all events reported on the entity and its children (if any).\nThe aggregation is done by applying the desired cluster health policy and the application health policies."
+        },
+        "NodeHealthStateChunks": {
+          "$ref": "#/definitions/NodeHealthStateChunkList",
+          "description": "The list of node health state chunks in the cluster that respect the filters in the cluster health chunk query description."
+        },
+        "ApplicationHealthStateChunks": {
+          "$ref": "#/definitions/ApplicationHealthStateChunkList",
+          "description": "The list of application health state chunks in the cluster that respect the filters in the cluster health chunk query description."
+        }
+      }
+    },
+    "ClusterHealthChunkQueryDescription": {
+      "description": "The cluster health chunk query description, which can specify the health policies to evaluate cluster health and very expressive filters to select which cluster entities to include in response.",
+      "properties": {
+        "NodeFilters": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/NodeHealthStateFilter"
+          },
+          "description": "Defines a list of filters that specify which nodes to be included in the returned cluster health chunk.\nIf no filters are specified, no nodes are returned. All the nodes are used to evaluate the cluster's aggregated health state, regardless of the input filters.\nThe cluster health chunk query may specify multiple node filters.\nFor example, it can specify a filter to return all nodes with health state Error and another filter to always include a node identified by its NodeName."
+        },
+        "ApplicationFilters": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/ApplicationHealthStateFilter"
+          },
+          "description": "Defines a list of filters that specify which applications to be included in the returned cluster health chunk.\nIf no filters are specified, no applications are returned. All the applications are used to evaluate the cluster's aggregated health state, regardless of the input filters.\nThe cluster health chunk query may specify multiple application filters.\nFor example, it can specify a filter to return all applications with health state Error and another filter to always include applications of a specified application type."
+        },
+        "ClusterHealthPolicy": {
+          "$ref": "#/definitions/ClusterHealthPolicy",
+          "description": "Defines a health policy used to evaluate the health of the cluster or of a cluster node."
+        },
+        "ApplicationHealthPolicies": {
+          "$ref": "#/definitions/ApplicationHealthPolicies",
+          "description": "Defines the application health policy map used to evaluate the health of an application or one of its children entities."
+        }
+      }
+    },
+    "ClusterHealthPolicies": {
+      "description": "Health policies to evaluate cluster health.",
+      "properties": {
+        "ApplicationHealthPolicyMap": {
+          "$ref": "#/definitions/ApplicationHealthPolicyMap",
+          "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.\nIf an application is not specified in the map, the application health evaluation uses the ApplicationHealthPolicy found in its application manifest or the default application health policy (if no health policy is defined in the manifest).\nThe map is empty by default."
+        },
+        "ClusterHealthPolicy": {
+          "$ref": "#/definitions/ClusterHealthPolicy",
+          "description": "Defines a health policy used to evaluate the health of the cluster or of a cluster node."
+        }
+      }
+    },
+    "ClusterHealthPolicy": {
+      "description": "Defines a health policy used to evaluate the health of the cluster or of a cluster node.",
+      "properties": {
+        "ConsiderWarningAsError": {
+          "type": "boolean",
+          "description": "Indicates whether warnings are treated with the same severity as errors.",
+          "default": false
+        },
+        "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.",
+          "default": 0
+        },
+        "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.",
+          "default": 0
+        },
+        "ApplicationTypeHealthPolicyMap": {
+          "$ref": "#/definitions/ApplicationTypeHealthPolicyMap",
+          "description": "Defines a map with max percentage unhealthy applications for specific application types.\nEach entry specifies as key the application type name and as value an integer that represents the MaxPercentUnhealthyApplications percentage used to evaluate the applications of the specified application type.\n\nThe application type health policy map can be used during cluster health evaluation to describe special application types.\nThe application types included in the map are evaluated against the percentage specified in the map, and not with the global MaxPercentUnhealthyApplications defined in the cluster health policy.\nThe applications of application types specified in the map are not counted against the global pool of applications.\nFor example, if some applications of a type are critical, the cluster administrator can add an entry to the map for that application type\nand assign it a value of 0% (that is, do not tolerate any failures).\nAll other applications can be evaluated with MaxPercentUnhealthyApplications set to 20% to tolerate some failures out of the thousands of application instances.\nThe application type health policy map is used only if the cluster manifest enables application type health evaluation using the configuration entry for HealthManager/EnableApplicationTypeHealthEvaluation."
+        }
+      }
+    },
+    "ClusterManifest": {
+      "description": "Information about the cluster manifest.",
+      "properties": {
+        "Manifest": {
+          "type": "string",
+          "description": "The contents of the cluster manifest file."
+        }
+      }
+    },
+    "ClusterLoadInfo": {
+      "description": "Information about load in a Service Fabric cluster. It holds a summary of all metrics and their load in a cluster.",
+      "properties": {
+        "LastBalancingStartTimeUtc": {
+          "type": "string",
+          "format": "date-time",
+          "description": "The starting time of last resource balancing run."
+        },
+        "LastBalancingEndTimeUtc": {
+          "type": "string",
+          "format": "date-time",
+          "description": "The end time of last resource balancing run."
+        },
+        "LoadMetricInformation": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/LoadMetricInformation"
+          },
+          "description": "List that contains metrics and their load information in this cluster."
+        }
+      }
+    },
+    "LoadMetricInformation": {
+      "description": "Represents data structure that contains load information for a certain metric in a cluster.",
+      "properties": {
+        "Name": {
+          "type": "string",
+          "description": "Name of the metric for which this load information is provided."
+        },
+        "IsBalancedBefore": {
+          "type": "boolean",
+          "description": "Value that indicates whether the metrics is balanced or not before resource balancer run"
+        },
+        "IsBalancedAfter": {
+          "type": "boolean",
+          "description": "Value that indicates whether the metrics is balanced or not after resource balancer run."
+        },
+        "DeviationBefore": {
+          "type": "string",
+          "format": "double",
+          "description": "The standard average deviation of the metrics before resource balancer run."
+        },
+        "DeviationAfter": {
+          "type": "string",
+          "format": "double",
+          "description": "The standard average deviation of the metrics after resource balancer run."
+        },
+        "BalancingThreshold": {
+          "type": "string",
+          "format": "double",
+          "description": "The balancing threshold for a certain metric."
+        },
+        "Action": {
+          "type": "string",
+          "description": "The current action being taken with regard to this metric"
+        },
+        "ActivityThreshold": {
+          "type": "string",
+          "format": "double",
+          "description": "The Activity Threshold specified for this metric in the system Cluster Manifest."
+        },
+        "ClusterCapacity": {
+          "type": "string",
+          "description": "The total cluster capacity for a given metric"
+        },
+        "ClusterLoad": {
+          "type": "string",
+          "description": "The total cluster load. In future releases of Service Fabric this parameter will be deprecated in favor of CurrentClusterLoad."
+        },
+        "CurrentClusterLoad": {
+          "type": "string",
+          "format": "double",
+          "description": "The total cluster load."
+        },
+        "ClusterRemainingCapacity": {
+          "type": "string",
+          "description": "The remaining capacity for the metric in the cluster. In future releases of Service Fabric this parameter will be deprecated in favor of ClusterCapacityRemaining."
+        },
+        "ClusterCapacityRemaining": {
+          "type": "string",
+          "description": "The remaining capacity for the metric in the cluster."
+        },
+        "IsClusterCapacityViolation": {
+          "type": "boolean",
+          "description": "Indicates that the metric is currently over capacity in the cluster."
+        },
+        "NodeBufferPercentage": {
+          "type": "string",
+          "format": "double",
+          "description": "The reserved percentage of total node capacity for this metric."
+        },
+        "ClusterBufferedCapacity": {
+          "type": "string",
+          "description": "Remaining capacity in the cluster excluding the reserved space. In future releases of Service Fabric this parameter will be deprecated in favor of BufferedClusterCapacityRemaining."
+        },
+        "BufferedClusterCapacityRemaining": {
+          "type": "string",
+          "format": "double",
+          "description": "Remaining capacity in the cluster excluding the reserved space."
+        },
+        "ClusterRemainingBufferedCapacity": {
+          "type": "string",
+          "description": "The remaining percentage of cluster total capacity for this metric."
+        },
+        "MinNodeLoadValue": {
+          "type": "string",
+          "description": "The minimum load on any node for this metric. In future releases of Service Fabric this parameter will be deprecated in favor of MinimumNodeLoad."
+        },
+        "MinimumNodeLoad": {
+          "type": "string",
+          "format": "double",
+          "description": "The minimum load on any node for this metric."
+        },
+        "MinNodeLoadNodeId": {
+          "$ref": "#/definitions/NodeId",
+          "description": "The node id of the node with the minimum load for this metric."
+        },
+        "MaxNodeLoadValue": {
+          "type": "string",
+          "description": "The maximum load on any node for this metric. In future releases of Service Fabric this parameter will be deprecated in favor of MaximumNodeLoad."
+        },
+        "MaximumNodeLoad": {
+          "type": "string",
+          "format": "double",
+          "description": "The maximum load on any node for this metric."
+        },
+        "MaxNodeLoadNodeId": {
+          "$ref": "#/definitions/NodeId",
+          "description": "The node id of the node with the maximum load for this metric."
+        },
+        "PlannedLoadRemoval": {
+          "type": "string",
+          "format": "double",
+          "description": "This value represents the load of the replicas that are planned to be removed in the future within the cluster.\nThis kind of load is reported for replicas that are currently being moving to other nodes and for replicas that are currently being dropped but still use the load on the source node."
+        }
+      }
+    },
+    "ClusterVersion": {
+      "description": "The cluster version.",
+      "properties": {
+        "Version": {
+          "type": "string",
+          "description": "The Service Fabric cluster runtime version."
+        }
+      }
+    },
+    "ContainerApiRequestBody": {
+      "description": "parameters for making container API call.",
+      "properties": {
+        "HttpVerb": {
+          "type": "string",
+          "description": "HTTP verb of container REST API, defaults to \"GET\""
+        },
+        "UriPath": {
+          "type": "string",
+          "description": "URI path of container REST API"
+        },
+        "Content-Type": {
+          "type": "string",
+          "description": "Content type of container REST API request, defaults to \"application/json\""
+        },
+        "Body": {
+          "type": "string",
+          "description": "HTTP request body of container REST API"
+        }
+      },
+      "required": [
+        "UriPath"
+      ]
+    },
+    "ContainerApiResponse": {
+      "description": "Response body that wraps container API result.",
+      "properties": {
+        "ContainerApiResult": {
+          "$ref": "#/definitions/ContainerApiResult",
+          "description": "Container API result."
+        }
+      },
+      "required": [
+        "ContainerApiResult"
+      ]
+    },
+    "ContainerApiResult": {
+      "description": "Container API result.",
+      "properties": {
+        "Status": {
+          "type": "integer",
+          "description": "HTTP status code returned by the target container API"
+        },
+        "Content-Type": {
+          "type": "string",
+          "description": "HTTP content type"
+        },
+        "Content-Encoding": {
+          "type": "string",
+          "description": "HTTP content encoding"
+        },
+        "Body": {
+          "type": "string",
+          "description": "container API result body"
+        }
+      },
+      "required": [
+        "Status"
+      ]
+    },
+    "ContainerInstanceEvent": {
+      "description": "Represents the base for all Container Events.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/FabricEvent"
+        }
+      ],
+      "x-ms-discriminator-value": "ContainerInstanceEvent"
+    },
+    "ContainerInstanceEventList": {
+      "description": "A list of ContainerInstanceEvent objects.",
+      "type": "array",
+      "items": {
+        "$ref": "#/definitions/ContainerInstanceEvent"
+      }
+    },
+    "ContinuationToken": {
+      "type": "string",
+      "description": "The continuation token parameter is used to obtain next set of results. The continuation token is included in the response of the API when the results from the system do not fit in a single response. When this value is passed to the next API call, the API returns next set of results. If there are no further results, then the continuation token is not included in the response."
+    },
+    "ConfigParameterOverrideList": {
+      "type": "array",
+      "items": {
+        "$ref": "#/definitions/ConfigParameterOverride"
+      },
+      "description": "List that contains parameters, sections that they belong and their values."
+    },
+    "ConfigParameterOverride": {
+      "description": "Information about a configuration parameter override.",
+      "properties": {
+        "SectionName": {
+          "type": "string",
+          "description": "Name of the section for the parameter override."
+        },
+        "ParameterName": {
+          "type": "string",
+          "description": "Name of the parameter that has been overridden."
+        },
+        "ParameterValue": {
+          "type": "string",
+          "description": "Value of the overridden parameter."
+        },
+        "Timeout": {
+          "type": "string",
+          "format": "duration",
+          "description": "The duration until config override is considered as valid."
+        },
+        "PersistAcrossUpgrade": {
+          "type": "boolean",
+          "description": "A value that indicates whether config override will be removed on upgrade or will still be considered as valid."
+        }
+      },
+      "required": [
+        "SectionName",
+        "ParameterName",
+        "ParameterValue"
+      ]
+    },
+    "CurrentUpgradeDomainProgressInfo": {
+      "description": "Information about the current in-progress upgrade domain.",
+      "properties": {
+        "DomainName": {
+          "$ref": "#/definitions/UpgradeDomainName",
+          "description": "The name of the upgrade domain"
+        },
+        "NodeUpgradeProgressList": {
+          "$ref": "#/definitions/NodeUpgradeProgressInfoList",
+          "description": "List of upgrading nodes and their statuses"
+        }
+      }
+    },
+    "CurrentUpgradeDomainDuration": {
+      "type": "string",
+      "description": "The estimated amount of time spent processing current 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"
+    },
+    "DeactivationIntentDescription": {
+      "description": "Describes the intent or reason for deactivating the node.",
+      "properties": {
+        "DeactivationIntent": {
+          "type": "string",
+          "description": "Describes the intent or reason for deactivating the node. The possible values are following.",
+          "enum": [
+            "Pause",
+            "Restart",
+            "RemoveData"
+          ],
+          "x-ms-enum": {
+            "name": "DeactivationIntent",
+            "modelAsString": true,
+            "values": [
+              {
+                "value": "Pause",
+                "description": "Indicates that the node should be paused. The value is 1."
+              },
+              {
+                "value": "Restart",
+                "description": "Indicates that the intent is for the node to be restarted after a short period of time. The value is 2."
+              },
+              {
+                "value": "RemoveData",
+                "description": "Indicates the intent is for the node to remove data. The value is 3."
+              }
+            ]
+          }
+        }
+      }
+    },
+    "DeltaNodesCheckHealthEvaluation": {
+      "x-ms-discriminator-value": "DeltaNodesCheck",
+      "description": "Represents health evaluation for delta nodes, containing health evaluations for each unhealthy node that impacted current aggregated health state.\nCan be returned during cluster upgrade when the aggregated health state of the cluster is Warning or Error.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/HealthEvaluation"
+        }
+      ],
+      "properties": {
+        "BaselineErrorCount": {
+          "type": "integer",
+          "format": "int64",
+          "description": "Number of nodes with aggregated heath state Error in the health store at the beginning of the cluster upgrade."
+        },
+        "BaselineTotalCount": {
+          "type": "integer",
+          "format": "int64",
+          "description": "Total number of nodes in the health store at the beginning of the cluster upgrade."
+        },
+        "MaxPercentDeltaUnhealthyNodes": {
+          "type": "integer",
+          "description": "Maximum allowed percentage of delta unhealthy nodes from the ClusterUpgradeHealthPolicy."
+        },
+        "TotalCount": {
+          "type": "integer",
+          "format": "int64",
+          "description": "Total number of nodes in the health store."
+        },
+        "UnhealthyEvaluations": {
+          "$ref": "#/definitions/UnhealthyEvaluations",
+          "description": "List of unhealthy evaluations that led to the aggregated health state.\nIncludes all the unhealthy NodeHealthEvaluation that impacted the aggregated health."
+        }
+      }
+    },
+    "DeployedApplicationHealth": {
+      "description": "Information about the health of an application deployed on a Service Fabric node.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/EntityHealth"
+        }
+      ],
+      "properties": {
+        "Name": {
+          "$ref": "#/definitions/ApplicationName",
+          "description": "Name of the application deployed on the node whose health information is described by this object."
+        },
+        "NodeName": {
+          "$ref": "#/definitions/NodeName",
+          "description": "Name of the node where this application is deployed."
+        },
+        "DeployedServicePackageHealthStates": {
+          "$ref": "#/definitions/DeployedServicePackageHealthStateList",
+          "description": "Deployed service package health states for the current deployed application as found in the health store."
+        }
+      }
+    },
+    "DeployedApplicationHealthEvaluation": {
+      "x-ms-discriminator-value": "DeployedApplication",
+      "description": "Represents health evaluation for a deployed application, containing information about the data and the algorithm used by the health store to evaluate health.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/HealthEvaluation"
+        }
+      ],
+      "properties": {
+        "NodeName": {
+          "$ref": "#/definitions/NodeName",
+          "description": "Name of the node where the application is deployed to."
+        },
+        "ApplicationName": {
+          "$ref": "#/definitions/ApplicationName",
+          "description": "The name of the application, including the 'fabric:' URI scheme."
+        },
+        "UnhealthyEvaluations": {
+          "$ref": "#/definitions/UnhealthyEvaluations",
+          "description": "List of  unhealthy evaluations that led to the current aggregated health state of the deployed application.\nThe types of the unhealthy evaluations can be DeployedServicePackagesHealthEvaluation or EventHealthEvaluation."
+        }
+      }
+    },
+    "DeployedApplicationHealthState": {
+      "description": "Represents the health state of a deployed application, which contains the entity identifier and the aggregated health state.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/EntityHealthState"
+        }
+      ],
+      "properties": {
+        "NodeName": {
+          "$ref": "#/definitions/NodeName",
+          "description": "Name of the node on which the service package is deployed."
+        },
+        "ApplicationName": {
+          "$ref": "#/definitions/ApplicationName",
+          "description": "The name of the application, including the 'fabric:' URI scheme."
+        }
+      }
+    },
+    "DeployedApplicationHealthStateChunk": {
+      "description": "Represents the health state chunk of a deployed application, which contains the node where the application is deployed, the aggregated health state and any deployed service packages that respect the chunk query description filters.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/EntityHealthStateChunk"
+        }
+      ],
+      "properties": {
+        "NodeName": {
+          "type": "string",
+          "description": "The name of node where the application is deployed."
+        },
+        "DeployedServicePackageHealthStateChunks": {
+          "$ref": "#/definitions/DeployedServicePackageHealthStateChunkList",
+          "description": "The list of deployed service package health state chunks belonging to the deployed application that respect the filters in the cluster health chunk query description."
+        }
+      }
+    },
+    "DeployedApplicationHealthStateChunkList": {
+      "description": "The list of deployed application health state chunks that respect the input filters in the chunk query. Returned by get cluster health state chunks query.",
+      "properties": {
+        "Items": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/DeployedApplicationHealthStateChunk"
+          },
+          "description": "The list of deployed application health state chunks that respect the input filters in the chunk query."
+        }
+      }
+    },
+    "DeployedApplicationHealthStateFilter": {
+      "description": "Defines matching criteria to determine whether a deployed application should be included as a child of an application in the cluster health chunk.\nThe deployed applications are only returned if the parent application matches a filter specified in the cluster health chunk query description.\nOne filter can match zero, one or multiple deployed applications, depending on its properties.",
+      "properties": {
+        "NodeNameFilter": {
+          "type": "string",
+          "description": "The name of the node where the application is deployed in order to match the filter.\nIf specified, the filter is applied only to the application deployed on the specified node.\nIf the application is not deployed on the node with the specified name, no deployed application is returned in the cluster health chunk based on this filter.\nOtherwise, the deployed application is included in the cluster health chunk if it respects the other filter properties.\nIf not specified, all deployed applications that match the parent filters (if any) are taken into consideration and matched against the other filter members, like health state filter."
+        },
+        "HealthStateFilter": {
+          "type": "integer",
+          "default": 0,
+          "description": "The filter for the health state of the deployed applications. It allows selecting deployed applications if they match the desired health states.\nThe possible values are integer value of one of the following health states. Only deployed applications that match the filter are returned. All deployed applications are used to evaluate the cluster aggregated health state.\nIf not specified, default value is None, unless the node name is specified. If the filter has default value and node name is specified, the matching deployed application is returned.\nThe state values are flag-based enumeration, so the value could be a combination of these values obtained using bitwise 'OR' operator.\nFor example, if the provided value is 6, it matches deployed applications with HealthState value of OK (2) and Warning (4).\n\n- Default - Default value. Matches any HealthState. The value is zero.\n- None - Filter that doesn't match any HealthState value. Used in order to return no results on a given collection of states. The value is 1.\n- Ok - Filter that matches input with HealthState value Ok. The value is 2.\n- Warning - Filter that matches input with HealthState value Warning. The value is 4.\n- Error - Filter that matches input with HealthState value Error. The value is 8.\n- All - Filter that matches input with any HealthState value. The value is 65535."
+        },
+        "DeployedServicePackageFilters": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/DeployedServicePackageHealthStateFilter"
+          },
+          "description": "Defines a list of filters that specify which deployed service packages to be included in the returned cluster health chunk as children of the parent deployed application. The deployed service packages are returned only if the parent deployed application matches a filter.\nIf the list is empty, no deployed service packages are returned. All the deployed service packages are used to evaluate the parent deployed application aggregated health state, regardless of the input filters.\nThe deployed application filter may specify multiple deployed service package filters.\nFor example, it can specify a filter to return all deployed service packages with health state Error and another filter to always include a deployed service package on a node."
+        }
+      }
+    },
+    "DeployedApplicationInfo": {
+      "description": "Information about application deployed on the node.",
+      "properties": {
+        "Id": {
+          "$ref": "#/definitions/ApplicationId",
+          "description": "The identity of the application. This is an encoded representation of the application name. This is used in the REST APIs to identify the application resource.\nStarting in version 6.0, hierarchical names are delimited with the \"\\~\" character. For example, if the application name is \"fabric:/myapp/app1\",\nthe application identity would be \"myapp\\~app1\" in 6.0+ and \"myapp/app1\" in previous versions."
+        },
+        "Name": {
+          "$ref": "#/definitions/ApplicationName",
+          "description": "The name of the application, including the 'fabric:' URI scheme."
+        },
+        "TypeName": {
+          "$ref": "#/definitions/ApplicationTypeName",
+          "description": "The application type name as defined in the application manifest."
+        },
+        "Status": {
+          "$ref": "#/definitions/DeployedApplicationStatus",
+          "description": "The status of the application deployed on the node. Following are the possible values."
+        },
+        "WorkDirectory": {
+          "type": "string",
+          "description": "The work directory of the application on the node. The work directory can be used to store application data."
+        },
+        "LogDirectory": {
+          "type": "string",
+          "description": "The log directory of the application on the node. The log directory can be used to store application logs."
+        },
+        "TempDirectory": {
+          "type": "string",
+          "description": "The temp directory of the application on the node. The code packages belonging to the application are forked with this directory set as their temporary directory."
+        },
+        "HealthState": {
+          "$ref": "#/definitions/HealthState",
+          "description": "The health state of a Service Fabric entity such as Cluster, Node, Application, Service, Partition, Replica etc."
+        }
+      }
+    },
+    "DeployedApplicationInfoList": {
+      "type": "array",
+      "items": {
+        "$ref": "#/definitions/DeployedApplicationInfo"
+      },
+      "description": "List of deployed application information."
+    },
+    "DeployedApplicationsHealthEvaluation": {
+      "x-ms-discriminator-value": "DeployedApplications",
+      "description": "Represents health evaluation for deployed applications, containing health evaluations for each unhealthy deployed application that impacted current aggregated health state.\nCan be returned when evaluating application health and the aggregated health state is either Error or Warning.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/HealthEvaluation"
+        }
+      ],
+      "properties": {
+        "MaxPercentUnhealthyDeployedApplications": {
+          "type": "integer",
+          "description": "Maximum allowed percentage of unhealthy deployed applications from the ApplicationHealthPolicy."
+        },
+        "TotalCount": {
+          "type": "integer",
+          "format": "int64",
+          "description": "Total number of deployed applications of the application in the health store."
+        },
+        "UnhealthyEvaluations": {
+          "$ref": "#/definitions/UnhealthyEvaluations",
+          "description": "List of unhealthy evaluations that led to the aggregated health state. Includes all the unhealthy DeployedApplicationHealthEvaluation that impacted the aggregated health."
+        }
+      }
+    },
+    "DeployedApplicationStatus": {
+      "type": "string",
+      "description": "The status of the application deployed on the node. Following are the possible values.",
+      "enum": [
+        "Invalid",
+        "Downloading",
+        "Activating",
+        "Active",
+        "Upgrading",
+        "Deactivating"
+      ],
+      "x-ms-enum": {
+        "name": "DeployedApplicationStatus",
+        "modelAsString": true,
+        "values": [
+          {
+            "value": "Invalid",
+            "description": "Indicates that deployment status is not valid. All Service Fabric enumerations have the invalid type. The value is zero."
+          },
+          {
+            "value": "Downloading",
+            "description": "Indicates that the package is downloading from the ImageStore. The value is 1."
+          },
+          {
+            "value": "Activating",
+            "description": "Indicates that the package is activating. The value is 2."
+          },
+          {
+            "value": "Active",
+            "description": "Indicates that the package is active. The value is 3."
+          },
+          {
+            "value": "Upgrading",
+            "description": "Indicates that the package is upgrading. The value is 4."
+          },
+          {
+            "value": "Deactivating",
+            "description": "Indicates that the package is deactivating. The value is 5."
+          }
+        ]
+      }
+    },
+    "DeployedServicePackageHealth": {
+      "description": "Information about the health of a service package for a specific application deployed on a Service Fabric node.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/EntityHealth"
+        }
+      ],
+      "properties": {
+        "ApplicationName": {
+          "$ref": "#/definitions/ApplicationName",
+          "description": "The name of the application, including the 'fabric:' URI scheme."
+        },
+        "ServiceManifestName": {
+          "$ref": "#/definitions/ServiceManifestName",
+          "description": "Name of the service manifest."
+        },
+        "NodeName": {
+          "$ref": "#/definitions/NodeName",
+          "description": "Name of the node where this service package is deployed."
+        }
+      }
+    },
+    "DeployedServicePackageHealthEvaluation": {
+      "x-ms-discriminator-value": "DeployedServicePackage",
+      "description": "Represents health evaluation for a deployed service package, containing information about the data and the algorithm used by health store to evaluate health. The evaluation is returned only when the aggregated health state is either Error or Warning.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/HealthEvaluation"
+        }
+      ],
+      "properties": {
+        "NodeName": {
+          "$ref": "#/definitions/NodeName",
+          "description": "The name of a Service Fabric node."
+        },
+        "ApplicationName": {
+          "$ref": "#/definitions/ApplicationName",
+          "description": "The name of the application, including the 'fabric:' URI scheme."
+        },
+        "ServiceManifestName": {
+          "$ref": "#/definitions/ServiceManifestName",
+          "description": "The name of the service manifest."
+        },
+        "UnhealthyEvaluations": {
+          "$ref": "#/definitions/UnhealthyEvaluations",
+          "description": "List of unhealthy evaluations that led to the current aggregated health state. The type of the unhealthy evaluations can be EventHealthEvaluation."
+        }
+      }
+    },
+    "DeployedServicePackageHealthState": {
+      "description": "Represents the health state of a deployed service package, containing the entity identifier and the aggregated health state.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/EntityHealthState"
+        }
+      ],
+      "properties": {
+        "NodeName": {
+          "$ref": "#/definitions/NodeName",
+          "description": "Name of the node on which the service package is deployed."
+        },
+        "ApplicationName": {
+          "$ref": "#/definitions/ApplicationName",
+          "description": "The name of the application, including the 'fabric:' URI scheme."
+        },
+        "ServiceManifestName": {
+          "$ref": "#/definitions/ServiceManifestName",
+          "description": "Name of the manifest describing the service package."
+        },
+        "ServicePackageActivationId": {
+          "$ref": "#/definitions/ServicePackageActivationId",
+          "description": "The ActivationId of a deployed service package. If ServicePackageActivationMode specified at the time of creating the service\nis 'SharedProcess' (or if it is not specified, in which case it defaults to 'SharedProcess'), then value of ServicePackageActivationId\nis always an empty string."
+        }
+      }
+    },
+    "DeployedServicePackageHealthStateChunk": {
+      "description": "Represents the health state chunk of a deployed service package, which contains the service manifest name and the service package aggregated health state.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/EntityHealthStateChunk"
+        }
+      ],
+      "properties": {
+        "ServiceManifestName": {
+          "$ref": "#/definitions/ServiceManifestName",
+          "description": "The name of the service manifest."
+        },
+        "ServicePackageActivationId": {
+          "$ref": "#/definitions/ServicePackageActivationId",
+          "description": "The ActivationId of a deployed service package. If ServicePackageActivationMode specified at the time of creating the service\nis 'SharedProcess' (or if it is not specified, in which case it defaults to 'SharedProcess'), then value of ServicePackageActivationId\nis always an empty string."
+        }
+      }
+    },
+    "DeployedServicePackageHealthStateChunkList": {
+      "description": "The list of deployed service package health state chunks that respect the input filters in the chunk query. Returned by get cluster health state chunks query.",
+      "properties": {
+        "Items": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/DeployedServicePackageHealthStateChunk"
+          },
+          "description": "The list of deployed service package health state chunks that respect the input filters in the chunk query."
+        }
+      }
+    },
+    "DeployedServicePackageHealthStateFilter": {
+      "description": "Defines matching criteria to determine whether a deployed service package should be included as a child of a deployed application in the cluster health chunk.\nThe deployed service packages are only returned if the parent entities match a filter specified in the cluster health chunk query description. The parent deployed application and its parent application must be included in the cluster health chunk.\nOne filter can match zero, one or multiple deployed service packages, depending on its properties.",
+      "properties": {
+        "ServiceManifestNameFilter": {
+          "type": "string",
+          "description": "The name of the service manifest which identifies the deployed service packages that matches the filter.\nIf specified, the filter is applied only to the specified deployed service packages, if any.\nIf no deployed service packages with specified manifest name exist, nothing is returned in the cluster health chunk based on this filter.\nIf any deployed service package exists, they are included in the cluster health chunk if it respects the other filter properties.\nIf not specified, all deployed service packages that match the parent filters (if any) are taken into consideration and matched against the other filter members, like health state filter."
+        },
+        "ServicePackageActivationIdFilter": {
+          "type": "string",
+          "description": "The activation ID of a deployed service package that matches the filter.\nIf not specified, the filter applies to all deployed service packages that match the other parameters.\nIf specified, the filter matches only the deployed service package with the specified activation ID."
+        },
+        "HealthStateFilter": {
+          "type": "integer",
+          "default": 0,
+          "description": "The filter for the health state of the deployed service packages. It allows selecting deployed service packages if they match the desired health states.\nThe possible values are integer value of one of the following health states. Only deployed service packages that match the filter are returned. All deployed service packages are used to evaluate the parent deployed application aggregated health state.\nIf not specified, default value is None, unless the deployed service package ID is specified. If the filter has default value and deployed service package ID is specified, the matching deployed service package is returned.\nThe state values are flag-based enumeration, so the value could be a combination of these values obtained using bitwise 'OR' operator.\nFor example, if the provided value is 6, it matches deployed service packages with HealthState value of OK (2) and Warning (4).\n\n- Default - Default value. Matches any HealthState. The value is zero.\n- None - Filter that doesn't match any HealthState value. Used in order to return no results on a given collection of states. The value is 1.\n- Ok - Filter that matches input with HealthState value Ok. The value is 2.\n- Warning - Filter that matches input with HealthState value Warning. The value is 4.\n- Error - Filter that matches input with HealthState value Error. The value is 8.\n- All - Filter that matches input with any HealthState value. The value is 65535."
+        }
+      }
+    },
+    "DeployedServicePackageHealthStateList": {
+      "description": "List of health states for a service package deployed on a Service Fabric node.",
+      "type": "array",
+      "items": {
+        "$ref": "#/definitions/DeployedServicePackageHealthState"
+      }
+    },
+    "DeployedServicePackagesHealthEvaluation": {
+      "x-ms-discriminator-value": "DeployedServicePackages",
+      "description": "Represents health evaluation for deployed service packages, containing health evaluations for each unhealthy deployed service package that impacted current aggregated health state. Can be returned when evaluating deployed application health and the aggregated health state is either Error or Warning.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/HealthEvaluation"
+        }
+      ],
+      "properties": {
+        "TotalCount": {
+          "type": "integer",
+          "format": "int64",
+          "description": "Total number of deployed service packages of the deployed application in the health store."
+        },
+        "UnhealthyEvaluations": {
+          "$ref": "#/definitions/UnhealthyEvaluations",
+          "description": "List of unhealthy evaluations that led to the aggregated health state. Includes all the unhealthy DeployedServicePackageHealthEvaluation that impacted the aggregated health."
+        }
+      }
+    },
+    "DeployedServiceReplicaInfo": {
+      "discriminator": "ServiceKind",
+      "description": "Information about a Service Fabric service replica deployed on a node.",
+      "required": [
+        "ServiceKind"
+      ],
+      "properties": {
+        "ServiceKind": {
+          "$ref": "#/definitions/ServiceKind",
+          "description": "The kind of service (Stateless or Stateful)."
+        },
+        "ServiceName": {
+          "$ref": "#/definitions/ServiceName",
+          "description": "The full name of the service with 'fabric:' URI scheme."
+        },
+        "ServiceTypeName": {
+          "$ref": "#/definitions/ServiceTypeName",
+          "description": "Name of the service type as specified in the service manifest."
+        },
+        "ServiceManifestName": {
+          "$ref": "#/definitions/ServiceManifestName",
+          "description": "The name of the service manifest in which this service type is defined."
+        },
+        "CodePackageName": {
+          "$ref": "#/definitions/CodePackageName",
+          "description": "The name of the code package that hosts this replica."
+        },
+        "PartitionId": {
+          "$ref": "#/definitions/PartitionId",
+          "description": "An internal ID used by Service Fabric to uniquely identify a partition. This is a randomly generated GUID when the service was created. The partition ID is unique and does not change for the lifetime of the service. If the same service was deleted and recreated the IDs of its partitions would be different."
+        },
+        "ReplicaStatus": {
+          "$ref": "#/definitions/ReplicaStatus",
+          "description": "The status of a replica of a service."
+        },
+        "Address": {
+          "type": "string",
+          "description": "The last address returned by the replica in Open or ChangeRole."
+        },
+        "ServicePackageActivationId": {
+          "$ref": "#/definitions/ServicePackageActivationId",
+          "description": "The ActivationId of a deployed service package. If ServicePackageActivationMode specified at the time of creating the service\nis 'SharedProcess' (or if it is not specified, in which case it defaults to 'SharedProcess'), then value of ServicePackageActivationId\nis always an empty string."
+        },
+        "HostProcessId": {
+          "type": "string",
+          "description": "Host process ID of the process that is hosting the replica. This will be zero if the replica is down. In hyper-v containers this host process ID will be from different kernel."
+        }
+      }
+    },
+    "DeployedServiceReplicaInfoList": {
+      "type": "array",
+      "items": {
+        "$ref": "#/definitions/DeployedServiceReplicaInfo"
+      },
+      "description": "List of deployed service replica information."
+    },
+    "DeployedStatefulServiceReplicaInfo": {
+      "description": "Information about a stateful service replica deployed on a node.",
+      "x-ms-discriminator-value": "Stateful",
+      "allOf": [
+        {
+          "$ref": "#/definitions/DeployedServiceReplicaInfo"
+        }
+      ],
+      "properties": {
+        "ReplicaId": {
+          "$ref": "#/definitions/ReplicaId",
+          "description": "Id of a stateful service replica. ReplicaId is used by Service Fabric to uniquely identify a replica of a partition. It is unique within a partition and does not change for the lifetime of the replica. If a replica gets dropped and another replica gets created on the same node for the same partition, it will get a different value for the id. Sometimes the id of a stateless service instance is also referred as a replica id."
+        },
+        "ReplicaRole": {
+          "$ref": "#/definitions/ReplicaRole",
+          "description": "The role of a replica of a stateful service."
+        },
+        "ReconfigurationInformation": {
+          "$ref": "#/definitions/ReconfigurationInformation",
+          "description": "Information about current reconfiguration like phase, type, previous configuration role of replica and reconfiguration start date time."
+        }
+      }
+    },
+    "DeployedStatelessServiceInstanceInfo": {
+      "description": "Information about a stateless service instance deployed on a node.",
+      "x-ms-discriminator-value": "Stateless",
+      "allOf": [
+        {
+          "$ref": "#/definitions/DeployedServiceReplicaInfo"
+        }
+      ],
+      "properties": {
+        "InstanceId": {
+          "$ref": "#/definitions/InstanceId",
+          "description": "Id of a stateless service instance. InstanceId is used by Service Fabric to uniquely identify an instance of a partition of a stateless service. It is unique within a partition and does not change for the lifetime of the instance. If the instance has failed over on the same or different node, it will get a different value for the InstanceId."
+        }
+      }
+    },
+    "EntityHealth": {
+      "description": "Health information common to all entities in the cluster. It contains the aggregated health state, health events and unhealthy evaluation.",
+      "properties": {
+        "AggregatedHealthState": {
+          "$ref": "#/definitions/HealthState",
+          "description": "The HealthState representing the aggregated health state of the entity computed by Health Manager.\nThe health evaluation of the entity reflects all events reported on the entity and its children (if any).\nThe aggregation is done by applying the desired health policy."
+        },
+        "HealthEvents": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/HealthEvent"
+          },
+          "description": "The list of health events reported on the entity."
+        },
+        "UnhealthyEvaluations": {
+          "$ref": "#/definitions/UnhealthyEvaluations",
+          "description": "The unhealthy evaluations that show why the current aggregated health state was returned by Health Manager."
+        },
+        "HealthStatistics": {
+          "$ref": "#/definitions/HealthStatistics",
+          "description": "Shows the health statistics for all children types of the queried entity."
+        }
+      }
+    },
+    "EntityHealthState": {
+      "description": "A base type for the health state of various entities in the cluster. It contains the aggregated health state.",
+      "properties": {
+        "AggregatedHealthState": {
+          "$ref": "#/definitions/HealthState",
+          "description": "The health state of a Service Fabric entity such as Cluster, Node, Application, Service, Partition, Replica etc."
+        }
+      }
+    },
+    "EntityHealthStateChunk": {
+      "description": "A base type for the health state chunk of various entities in the cluster. It contains the aggregated health state.",
+      "properties": {
+        "HealthState": {
+          "$ref": "#/definitions/HealthState",
+          "description": "The health state of a Service Fabric entity such as Cluster, Node, Application, Service, Partition, Replica etc."
+        }
+      }
+    },
+    "EntityHealthStateChunkList": {
+      "description": "A base type for the list of health state chunks found in the cluster. It contains the total number of health states that match the input filters.",
+      "properties": {
+        "TotalCount": {
+          "type": "integer",
+          "format": "int64",
+          "description": "Total number of entity health state objects that match the specified filters from the cluster health chunk query description."
+        }
+      }
+    },
+    "Epoch": {
+      "description": "An Epoch is a configuration number for the partition as a whole. When the configuration of the replica set changes, for example when the Primary replica changes, the operations that are replicated from the new Primary replica are said to be a new Epoch from the ones which were sent by the old Primary replica.",
+      "properties": {
+        "ConfigurationVersion": {
+          "type": "string",
+          "description": "The current configuration number of this Epoch. The configuration number is an increasing value that is updated whenever the configuration of this replica set changes."
+        },
+        "DataLossVersion": {
+          "type": "string",
+          "description": "The current data loss number of this Epoch. The data loss number property is an increasing value which is updated whenever data loss is suspected, as when loss of a quorum of replicas in the replica set that includes the Primary replica."
+        }
+      }
+    },
+    "EventHealthEvaluation": {
+      "x-ms-discriminator-value": "Event",
+      "description": "Represents health evaluation of a HealthEvent that was reported on the entity.\nThe health evaluation is returned when evaluating health of an entity results in Error or Warning.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/HealthEvaluation"
+        }
+      ],
+      "properties": {
+        "ConsiderWarningAsError": {
+          "type": "boolean",
+          "description": "Indicates whether warnings are treated with the same severity as errors. The field is specified in the health policy used to evaluate the entity."
+        },
+        "UnhealthyEvent": {
+          "$ref": "#/definitions/HealthEvent",
+          "description": "Represents health information reported on a health entity, such as cluster, application or node, with additional metadata added by the Health Manager."
+        }
+      }
+    },
+    "EventList": {
+      "description": "A list of FabricEvent objects.",
+      "type": "array",
+      "items": {
+        "$ref": "#/definitions/FabricEvent"
+      }
+    },
+    "FabricCodeVersionInfo": {
+      "description": "Information about a Service Fabric code version.",
+      "properties": {
+        "CodeVersion": {
+          "description": "The product version of Service Fabric.",
+          "type": "string"
+        }
+      }
+    },
+    "FabricCodeVersionInfoList": {
+      "type": "array",
+      "items": {
+        "$ref": "#/definitions/FabricCodeVersionInfo"
+      },
+      "description": "List of all Service Fabric code versions."
+    },
+    "FabricConfigVersionInfo": {
+      "description": "Information about a Service Fabric config version.",
+      "properties": {
+        "ConfigVersion": {
+          "description": "The config version of Service Fabric.",
+          "type": "string"
+        }
+      }
+    },
+    "FabricConfigVersionInfoList": {
+      "type": "array",
+      "items": {
+        "$ref": "#/definitions/FabricConfigVersionInfo"
+      },
+      "description": "List of all Service Fabric config versions."
+    },
+    "FabricEvent": {
+      "discriminator": "Kind",
+      "description": "Represents the base for all Fabric Events.",
+      "properties": {
+        "Kind": {
+          "$ref": "#/definitions/FabricEventKind",
+          "description": "The kind of FabricEvent."
+        },
+        "EventInstanceId": {
+          "type": "string",
+          "format": "uuid",
+          "description": "The identifier for the FabricEvent instance."
+        },
+        "Category": {
+          "type": "string",
+          "description": "The category of event."
+        },
+        "TimeStamp": {
+          "type": "string",
+          "format": "date-time",
+          "description": "The time event was logged."
+        },
+        "HasCorrelatedEvents": {
+          "type": "boolean",
+          "description": "Shows there is existing related events available."
+        }
+      },
+      "required": [
+        "Kind",
+        "EventInstanceId",
+        "TimeStamp"
+      ]
+    },
+    "FabricEventKind": {
+      "type": "string",
+      "description": "The kind of FabricEvent.",
+      "enum": [
+        "ClusterEvent",
+        "ContainerInstanceEvent",
+        "NodeEvent",
+        "ApplicationEvent",
+        "ServiceEvent",
+        "PartitionEvent",
+        "ReplicaEvent",
+        "PartitionAnalysisEvent",
+        "ApplicationCreated",
+        "ApplicationDeleted",
+        "ApplicationNewHealthReport",
+        "ApplicationHealthReportExpired",
+        "ApplicationUpgradeCompleted",
+        "ApplicationUpgradeDomainCompleted",
+        "ApplicationUpgradeRollbackCompleted",
+        "ApplicationUpgradeRollbackStarted",
+        "ApplicationUpgradeStarted",
+        "DeployedApplicationNewHealthReport",
+        "DeployedApplicationHealthReportExpired",
+        "ApplicationProcessExited",
+        "ApplicationContainerInstanceExited",
+        "NodeAborted",
+        "NodeAddedToCluster",
+        "NodeClosed",
+        "NodeDeactivateCompleted",
+        "NodeDeactivateStarted",
+        "NodeDown",
+        "NodeNewHealthReport",
+        "NodeHealthReportExpired",
+        "NodeOpenSucceeded",
+        "NodeOpenFailed",
+        "NodeRemovedFromCluster",
+        "NodeUp",
+        "PartitionNewHealthReport",
+        "PartitionHealthReportExpired",
+        "PartitionReconfigured",
+        "PartitionPrimaryMoveAnalysis",
+        "ServiceCreated",
+        "ServiceDeleted",
+        "ServiceNewHealthReport",
+        "ServiceHealthReportExpired",
+        "DeployedServicePackageNewHealthReport",
+        "DeployedServicePackageHealthReportExpired",
+        "StatefulReplicaNewHealthReport",
+        "StatefulReplicaHealthReportExpired",
+        "StatelessReplicaNewHealthReport",
+        "StatelessReplicaHealthReportExpired",
+        "ClusterNewHealthReport",
+        "ClusterHealthReportExpired",
+        "ClusterUpgradeCompleted",
+        "ClusterUpgradeDomainCompleted",
+        "ClusterUpgradeRollbackCompleted",
+        "ClusterUpgradeRollbackStarted",
+        "ClusterUpgradeStarted",
+        "ChaosStopped",
+        "ChaosStarted",
+        "ChaosCodePackageRestartScheduled",
+        "ChaosReplicaRemovalScheduled",
+        "ChaosPartitionSecondaryMoveScheduled",
+        "ChaosPartitionPrimaryMoveScheduled",
+        "ChaosReplicaRestartScheduled",
+        "ChaosNodeRestartScheduled"
+      ],
+      "x-ms-enum": {
+        "name": "FabricEventKind",
+        "modelAsString": true,
+        "values": [
+          {
+            "value": "ClusterEvent"
+          },
+          {
+            "value": "ContainerInstanceEvent"
+          },
+          {
+            "value": "NodeEvent"
+          },
+          {
+            "value": "ApplicationEvent"
+          },
+          {
+            "value": "ServiceEvent"
+          },
+          {
+            "value": "PartitionEvent"
+          },
+          {
+            "value": "ReplicaEvent"
+          },
+          {
+            "value": "PartitionAnalysisEvent"
+          },
+          {
+            "value": "ApplicationCreated"
+          },
+          {
+            "value": "ApplicationDeleted"
+          },
+          {
+            "value": "ApplicationNewHealthReport"
+          },
+          {
+            "value": "ApplicationHealthReportExpired"
+          },
+          {
+            "value": "ApplicationUpgradeCompleted"
+          },
+          {
+            "value": "ApplicationUpgradeDomainCompleted"
+          },
+          {
+            "value": "ApplicationUpgradeRollbackCompleted"
+          },
+          {
+            "value": "ApplicationUpgradeRollbackStarted"
+          },
+          {
+            "value": "ApplicationUpgradeStarted"
+          },
+          {
+            "value": "DeployedApplicationNewHealthReport"
+          },
+          {
+            "value": "DeployedApplicationHealthReportExpired"
+          },
+          {
+            "value": "ApplicationProcessExited"
+          },
+          {
+            "value": "ApplicationContainerInstanceExited"
+          },
+          {
+            "value": "NodeAborted"
+          },
+          {
+            "value": "NodeAddedToCluster"
+          },
+          {
+            "value": "NodeClosed"
+          },
+          {
+            "value": "NodeDeactivateCompleted"
+          },
+          {
+            "value": "NodeDeactivateStarted"
+          },
+          {
+            "value": "NodeDown"
+          },
+          {
+            "value": "NodeNewHealthReport"
+          },
+          {
+            "value": "NodeHealthReportExpired"
+          },
+          {
+            "value": "NodeOpenSucceeded"
+          },
+          {
+            "value": "NodeOpenFailed"
+          },
+          {
+            "value": "NodeRemovedFromCluster"
+          },
+          {
+            "value": "NodeUp"
+          },
+          {
+            "value": "PartitionNewHealthReport"
+          },
+          {
+            "value": "PartitionHealthReportExpired"
+          },
+          {
+            "value": "PartitionReconfigured"
+          },
+          {
+            "value": "PartitionPrimaryMoveAnalysis"
+          },
+          {
+            "value": "ServiceCreated"
+          },
+          {
+            "value": "ServiceDeleted"
+          },
+          {
+            "value": "ServiceNewHealthReport"
+          },
+          {
+            "value": "ServiceHealthReportExpired"
+          },
+          {
+            "value": "DeployedServicePackageNewHealthReport"
+          },
+          {
+            "value": "DeployedServicePackageHealthReportExpired"
+          },
+          {
+            "value": "StatefulReplicaNewHealthReport"
+          },
+          {
+            "value": "StatefulReplicaHealthReportExpired"
+          },
+          {
+            "value": "StatelessReplicaNewHealthReport"
+          },
+          {
+            "value": "StatelessReplicaHealthReportExpired"
+          },
+          {
+            "value": "ClusterNewHealthReport"
+          },
+          {
+            "value": "ClusterHealthReportExpired"
+          },
+          {
+            "value": "ClusterUpgradeCompleted"
+          },
+          {
+            "value": "ClusterUpgradeDomainCompleted"
+          },
+          {
+            "value": "ClusterUpgradeRollbackCompleted"
+          },
+          {
+            "value": "ClusterUpgradeRollbackStarted"
+          },
+          {
+            "value": "ClusterUpgradeStarted"
+          },
+          {
+            "value": "ChaosStopped"
+          },
+          {
+            "value": "ChaosStarted"
+          },
+          {
+            "value": "ChaosCodePackageRestartScheduled"
+          },
+          {
+            "value": "ChaosReplicaRemovalScheduled"
+          },
+          {
+            "value": "ChaosPartitionSecondaryMoveScheduled"
+          },
+          {
+            "value": "ChaosPartitionPrimaryMoveScheduled"
+          },
+          {
+            "value": "ChaosReplicaRestartScheduled"
+          },
+          {
+            "value": "ChaosNodeRestartScheduled"
+          }
+        ]
+      }
+    },
+    "ClusterConfigurationUpgradeStatusInfo": {
+      "description": "Information about a standalone cluster configuration upgrade status.",
+      "properties": {
+        "UpgradeState": {
+          "$ref": "#/definitions/UpgradeState",
+          "description": "The state of the upgrade domain."
+        },
+        "ProgressStatus": {
+          "type": "integer",
+          "description": "The cluster manifest version."
+        },
+        "ConfigVersion": {
+          "type": "string",
+          "description": "The cluster configuration version."
+        },
+        "Details": {
+          "type": "string",
+          "description": "The cluster upgrade status details."
+        }
+      }
+    },
+    "FailureAction": {
+      "type": "string",
+      "description": "The compensating action to perform when a Monitored upgrade encounters monitoring policy or health policy violations.\nInvalid indicates the failure action is invalid. Rollback specifies that the upgrade will start rolling back automatically.\nManual indicates that the upgrade will switch to UnmonitoredManual upgrade mode.",
+      "enum": [
+        "Invalid",
+        "Rollback",
+        "Manual"
+      ],
+      "x-ms-enum": {
+        "name": "FailureAction",
+        "modelAsString": true,
+        "values": [
+          {
+            "value": "Invalid",
+            "description": "Indicates the failure action is invalid. All Service Fabric enumerations have the invalid type. The value is zero."
+          },
+          {
+            "value": "Rollback",
+            "description": "The upgrade will start rolling back automatically. The value is 1"
+          },
+          {
+            "value": "Manual",
+            "description": "The upgrade will switch to UnmonitoredManual upgrade mode. The value is 2"
+          }
+        ]
+      }
+    },
+    "FailureReason": {
+      "type": "string",
+      "description": "The cause of an upgrade failure that resulted in FailureAction being executed.",
+      "enum": [
+        "None",
+        "Interrupted",
+        "HealthCheck",
+        "UpgradeDomainTimeout",
+        "OverallUpgradeTimeout"
+      ],
+      "x-ms-enum": {
+        "name": "FailureReason",
+        "modelAsString": true,
+        "values": [
+          {
+            "value": "None",
+            "description": "Indicates the reason is invalid or unknown. All Service Fabric enumerations have the invalid type. The value is zero."
+          },
+          {
+            "value": "Interrupted",
+            "description": "There was an external request to roll back the upgrade. The value is 1"
+          },
+          {
+            "value": "HealthCheck",
+            "description": "The upgrade failed due to health policy violations. The value is 2"
+          },
+          {
+            "value": "UpgradeDomainTimeout",
+            "description": "An upgrade domain took longer than the allowed upgrade domain timeout to process. The value is 3"
+          },
+          {
+            "value": "OverallUpgradeTimeout",
+            "description": "The overall upgrade took longer than the allowed upgrade timeout to process. The value is 4"
+          }
+        ]
+      }
+    },
+    "FailureUpgradeDomainProgressInfo": {
+      "description": "Information about the upgrade domain progress at the time of upgrade failure.",
+      "properties": {
+        "DomainName": {
+          "$ref": "#/definitions/UpgradeDomainName",
+          "description": "The name of the upgrade domain"
+        },
+        "NodeUpgradeProgressList": {
+          "$ref": "#/definitions/NodeUpgradeProgressInfoList",
+          "description": "List of upgrading nodes and their statuses"
+        }
+      }
+    },
+    "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"
+    },
+    "HealthEvaluation": {
+      "discriminator": "Kind",
+      "description": "Represents a health evaluation which describes the data and the algorithm used by health manager to evaluate the health of an entity.",
+      "properties": {
+        "Kind": {
+          "$ref": "#/definitions/HealthEvaluationKind",
+          "description": "The health manager in the cluster performs health evaluations in determining the aggregated health state of an entity. This enumeration provides information on the kind of evaluation that was performed. Following are the possible values."
+        },
+        "AggregatedHealthState": {
+          "$ref": "#/definitions/HealthState",
+          "description": "The health state of a Service Fabric entity such as Cluster, Node, Application, Service, Partition, Replica etc."
+        },
+        "Description": {
+          "type": "string",
+          "description": "Description of the health evaluation, which represents a summary of the evaluation process."
+        }
+      },
+      "required": [
+        "Kind"
+      ]
+    },
+    "HealthEvaluationKind": {
+      "type": "string",
+      "description": "The health manager in the cluster performs health evaluations in determining the aggregated health state of an entity. This enumeration provides information on the kind of evaluation that was performed. Following are the possible values.",
+      "enum": [
+        "Invalid",
+        "Event",
+        "Replicas",
+        "Partitions",
+        "DeployedServicePackages",
+        "DeployedApplications",
+        "Services",
+        "Nodes",
+        "Applications",
+        "SystemApplication",
+        "UpgradeDomainDeployedApplications",
+        "UpgradeDomainNodes",
+        "Replica",
+        "Partition",
+        "DeployedServicePackage",
+        "DeployedApplication",
+        "Service",
+        "Node",
+        "Application",
+        "DeltaNodesCheck",
+        "UpgradeDomainDeltaNodesCheck",
+        "ApplicationTypeApplications"
+      ],
+      "x-ms-enum": {
+        "name": "HealthEvaluationKind",
+        "modelAsString": true,
+        "values": [
+          {
+            "value": "Invalid",
+            "description": "Indicates that the health evaluation is invalid. The value is zero."
+          },
+          {
+            "value": "Event",
+            "description": "Indicates that the health evaluation is for a health event. The value is 1."
+          },
+          {
+            "value": "Replicas",
+            "description": "Indicates that the health evaluation is for the replicas of a partition. The value is 2."
+          },
+          {
+            "value": "Partitions",
+            "description": "Indicates that the health evaluation is for the partitions of a service. The value is 3."
+          },
+          {
+            "value": "DeployedServicePackages",
+            "description": "Indicates that the health evaluation is for the deployed service packages of a deployed application. The value is 4."
+          },
+          {
+            "value": "DeployedApplications",
+            "description": "Indicates that the health evaluation is for the deployed applications of an application. The value is 5."
+          },
+          {
+            "value": "Services",
+            "description": "Indicates that the health evaluation is for services of an application. The value is 6."
+          },
+          {
+            "value": "Nodes",
+            "description": "Indicates that the health evaluation is for the cluster nodes. The value is 7."
+          },
+          {
+            "value": "Applications",
+            "description": "Indicates that the health evaluation is for the cluster applications. The value is 8."
+          },
+          {
+            "value": "SystemApplication",
+            "description": "Indicates that the health evaluation is for the system application. The value is 9."
+          },
+          {
+            "value": "UpgradeDomainDeployedApplications",
+            "description": "Indicates that the health evaluation is for the deployed applications of an application in an upgrade domain. The value is 10."
+          },
+          {
+            "value": "UpgradeDomainNodes",
+            "description": "Indicates that the health evaluation is for the cluster nodes in an upgrade domain. The value is 11."
+          },
+          {
+            "value": "Replica",
+            "description": "Indicates that the health evaluation is for a replica. The value is 13."
+          },
+          {
+            "value": "Partition",
+            "description": "Indicates that the health evaluation is for a partition. The value is 14."
+          },
+          {
+            "value": "DeployedServicePackage",
+            "description": "Indicates that the health evaluation is for a deployed service package. The value is 16."
+          },
+          {
+            "value": "DeployedApplication",
+            "description": "Indicates that the health evaluation is for a deployed application. The value is 17."
+          },
+          {
+            "value": "Service",
+            "description": "Indicates that the health evaluation is for a service. The value is 15."
+          },
+          {
+            "value": "Node",
+            "description": "Indicates that the health evaluation is for a node. The value is 12."
+          },
+          {
+            "value": "Application",
+            "description": "Indicates that the health evaluation is for an application. The value is 18."
+          },
+          {
+            "value": "DeltaNodesCheck",
+            "description": "Indicates that the health evaluation is for the delta of unhealthy cluster nodes. The value is 19."
+          },
+          {
+            "value": "UpgradeDomainDeltaNodesCheck",
+            "description": "Indicates that the health evaluation is for the delta of unhealthy upgrade domain cluster nodes. The value is 20."
+          },
+          {
+            "value": "ApplicationTypeApplications",
+            "description": "– Indicates that the health evaluation is for applications of an application type. The value is 21."
+          }
+        ]
+      }
+    },
+    "HealthEvaluationWrapper": {
+      "description": "Wrapper object for health evaluation.",
+      "properties": {
+        "HealthEvaluation": {
+          "$ref": "#/definitions/HealthEvaluation",
+          "description": "Represents a health evaluation which describes the data and the algorithm used by health manager to evaluate the health of an entity."
+        }
+      }
+    },
+    "HealthEvent": {
+      "description": "Represents health information reported on a health entity, such as cluster, application or node, with additional metadata added by the Health Manager.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/HealthInformation"
+        }
+      ],
+      "properties": {
+        "IsExpired": {
+          "type": "boolean",
+          "description": "Returns true if the health event is expired, otherwise false."
+        },
+        "SourceUtcTimestamp": {
+          "type": "string",
+          "format": "date-time",
+          "description": "The date and time when the health report was sent by the source."
+        },
+        "LastModifiedUtcTimestamp": {
+          "type": "string",
+          "format": "date-time",
+          "description": "The date and time when the health report was last modified by the health store."
+        },
+        "LastOkTransitionAt": {
+          "type": "string",
+          "format": "date-time",
+          "description": "If the current health state is 'Ok', this property returns the time at which the health report was first reported with 'Ok'.\nFor periodic reporting, many reports with the same state may have been generated.\nThis property returns the date and time when the first 'Ok' health report was received.\n\nIf the current health state is 'Error' or 'Warning', returns the date and time at which the health state was last in 'Ok', before transitioning to a different state.\n\nIf the health state was never 'Ok', the value will be zero date-time."
+        },
+        "LastWarningTransitionAt": {
+          "type": "string",
+          "format": "date-time",
+          "description": "If the current health state is 'Warning', this property returns the time at which the health report was first reported with 'Warning'. For periodic reporting, many reports with the same state may have been generated however, this property returns only the date and time at the first 'Warning' health report was received.\n\nIf the current health state is 'Ok' or 'Error', returns the date and time at which the health state was last in 'Warning', before transitioning to a different state.\n\nIf the health state was never 'Warning', the value will be zero date-time."
+        },
+        "LastErrorTransitionAt": {
+          "type": "string",
+          "format": "date-time",
+          "description": "If the current health state is 'Error', this property returns the time at which the health report was first reported with 'Error'. For periodic reporting, many reports with the same state may have been generated however, this property returns only the date and time at the first 'Error' health report was received.\n\nIf the current health state is 'Ok' or 'Warning', returns the date and time at which the health state was last in 'Error', before transitioning to a different state.\n\nIf the health state was never 'Error', the value will be zero date-time."
+        }
+      }
+    },
+    "HealthInformation": {
+      "description": "Represents common health report information. It is included in all health reports sent to health store and in all health events returned by health queries.",
+      "required": [
+        "SourceId",
+        "Property",
+        "HealthState"
+      ],
+      "properties": {
+        "SourceId": {
+          "type": "string",
+          "description": "The source name that identifies the client/watchdog/system component that generated the health information."
+        },
+        "Property": {
+          "type": "string",
+          "description": "The property of the health information. An entity can have health reports for different properties.\nThe property is a string and not a fixed enumeration to allow the reporter flexibility to categorize the state condition that triggers the report.\nFor example, a reporter with SourceId \"LocalWatchdog\" can monitor the state of the available disk on a node,\nso it can report \"AvailableDisk\" property on that node.\nThe same reporter can monitor the node connectivity, so it can report a property \"Connectivity\" on the same node.\nIn the health store, these reports are treated as separate health events for the specified node.\n\nTogether with the SourceId, the property uniquely identifies the health information."
+        },
+        "HealthState": {
+          "$ref": "#/definitions/HealthState",
+          "description": "The health state of a Service Fabric entity such as Cluster, Node, Application, Service, Partition, Replica etc."
+        },
+        "TimeToLiveInMilliSeconds": {
+          "type": "string",
+          "format": "duration",
+          "description": "The duration for which this health report is valid. This field uses ISO8601 format for specifying the duration.\nWhen clients report periodically, they should send reports with higher frequency than time to live.\nIf clients report on transition, they can set the time to live to infinite.\nWhen time to live expires, the health event that contains the health information\nis either removed from health store, if RemoveWhenExpired is true, or evaluated at error, if RemoveWhenExpired false.\n\nIf not specified, time to live defaults to infinite value."
+        },
+        "Description": {
+          "type": "string",
+          "description": "The description of the health information. It represents free text used to add human readable information about the report.\nThe maximum string length for the description is 4096 characters.\nIf the provided string is longer, it will be automatically truncated.\nWhen truncated, the last characters of the description contain a marker \"[Truncated]\", and total string size is 4096 characters.\nThe presence of the marker indicates to users that truncation occurred.\nNote that when truncated, the description has less than 4096 characters from the original string."
+        },
+        "SequenceNumber": {
+          "type": "string",
+          "description": "The sequence number for this health report as a numeric string.\nThe report sequence number is used by the health store to detect stale reports.\nIf not specified, a sequence number is auto-generated by the health client when a report is added."
+        },
+        "RemoveWhenExpired": {
+          "type": "boolean",
+          "description": "Value that indicates whether the report is removed from health store when it expires.\nIf set to true, the report is removed from the health store after it expires.\nIf set to false, the report is treated as an error when expired. The value of this property is false by default.\nWhen clients report periodically, they should set RemoveWhenExpired false (default).\nThis way, if the reporter has issues (e.g. deadlock) and can't report, the entity is evaluated at error when the health report expires.\nThis flags the entity as being in Error health state."
+        },
+        "HealthReportId": {
+          "type": "string",
+          "description": "A health report ID which identifies the health report and can be used to find more detailed information about a specific health event at\naka.ms/sfhealthid"
+        }
+      }
+    },
+    "Int64RangePartitionInformation": {
+      "description": "Describes the partition information for the integer range that is based on partition schemes.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/PartitionInformation"
+        }
+      ],
+      "x-ms-discriminator-value": "Int64Range",
+      "properties": {
+        "LowKey": {
+          "type": "string",
+          "description": "Specifies the minimum key value handled by this partition."
+        },
+        "HighKey": {
+          "type": "string",
+          "description": "Specifies the maximum key value handled by this partition."
+        }
+      }
+    },
+    "MinInstanceCount": {
+      "type": "integer",
+      "default": 1,
+      "minimum": 1,
+      "description": "MinInstanceCount is the minimum number of instances that must be up to meet the EnsureAvailability safety check during operations like upgrade or deactivate node.\nThe actual number that is used is max( MinInstanceCount, ceil( MinInstancePercentage/100.0 * InstanceCount) ).\nNote, if InstanceCount is set to -1, during MinInstanceCount computation -1 is first converted into the number of nodes on which the instances are allowed to be placed according to the placement constraints on the service."
+    },
+    "MinInstancePercentage": {
+      "type": "integer",
+      "default": 0,
+      "minimum": 0,
+      "maximum": 100,
+      "description": "MinInstancePercentage is the minimum percentage of InstanceCount that must be up to meet the EnsureAvailability safety check during operations like upgrade or deactivate node.\nThe actual number that is used is max( MinInstanceCount, ceil( MinInstancePercentage/100.0 * InstanceCount) ).\nNote, if InstanceCount is set to -1, during MinInstancePercentage computation, -1 is first converted into the number of nodes on which the instances are allowed to be placed according to the placement constraints on the service."
+    },
+    "MonitoringPolicyDescription": {
+      "description": "Describes the parameters for monitoring an upgrade in Monitored mode.",
+      "properties": {
+        "FailureAction": {
+          "$ref": "#/definitions/FailureAction",
+          "description": "The compensating action to perform when a Monitored upgrade encounters monitoring policy or health policy violations.\nInvalid indicates the failure action is invalid. Rollback specifies that the upgrade will start rolling back automatically.\nManual indicates that the upgrade will switch to UnmonitoredManual upgrade mode."
+        },
+        "HealthCheckWaitDurationInMilliseconds": {
+          "$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."
+        },
+        "HealthCheckStableDurationInMilliseconds": {
+          "$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."
+        },
+        "HealthCheckRetryTimeoutInMilliseconds": {
+          "$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."
+        },
+        "UpgradeTimeoutInMilliseconds": {
+          "$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."
+        },
+        "UpgradeDomainTimeoutInMilliseconds": {
+          "$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."
+        }
+      }
+    },
+    "NamedPartitionInformation": {
+      "description": "Describes the partition information for the name as a string that is based on partition schemes.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/PartitionInformation"
+        }
+      ],
+      "x-ms-discriminator-value": "Named",
+      "properties": {
+        "Name": {
+          "type": "string",
+          "description": "Name of the partition."
+        }
+      }
+    },
+    "NextUpgradeDomain": {
+      "type": "string",
+      "description": "The name of the next upgrade domain to be processed."
+    },
+    "NodeDeactivationInfo": {
+      "description": "Information about the node deactivation. This information is valid for a node that is undergoing deactivation or has already been deactivated.",
+      "properties": {
+        "NodeDeactivationIntent": {
+          "$ref": "#/definitions/NodeDeactivationIntent",
+          "description": "The intent or the reason for deactivating the node. Following are the possible values for it."
+        },
+        "NodeDeactivationStatus": {
+          "$ref": "#/definitions/NodeDeactivationStatus",
+          "description": "The status of node deactivation operation. Following are the possible values."
+        },
+        "NodeDeactivationTask": {
+          "$ref": "#/definitions/NodeDeactivationTaskList",
+          "description": "List of tasks representing the deactivation operation on the node."
+        },
+        "PendingSafetyChecks": {
+          "$ref": "#/definitions/SafetyCheckInfoList",
+          "description": "List of pending safety checks"
+        }
+      }
+    },
+    "NodeDeactivationIntent": {
+      "type": "string",
+      "description": "The intent or the reason for deactivating the node. Following are the possible values for it.",
+      "enum": [
+        "Invalid",
+        "Pause",
+        "Restart",
+        "RemoveData",
+        "RemoveNode"
+      ],
+      "x-ms-enum": {
+        "name": "NodeDeactivationIntent",
+        "modelAsString": true,
+        "values": [
+          {
+            "value": "Invalid",
+            "description": "Indicates the node deactivation intent is invalid. All Service Fabric enumerations have the invalid type. The value is zero. This value is not used."
+          },
+          {
+            "value": "Pause",
+            "description": "Indicates that the node should be paused. The value is 1."
+          },
+          {
+            "value": "Restart",
+            "description": "Indicates that the intent is for the node to be restarted after a short period of time. Service Fabric does not restart the node, this action is done outside of Service Fabric. The value is 2."
+          },
+          {
+            "value": "RemoveData",
+            "description": "Indicates that the intent is to reimage the node. Service Fabric does not reimage the node, this action is done outside of Service Fabric. The value is 3."
+          },
+          {
+            "value": "RemoveNode",
+            "description": "Indicates that the node is being decommissioned and is not expected to return. Service Fabric does not decommission the node, this action is done outside of Service Fabric. The value is 4."
+          }
+        ]
+      }
+    },
+    "NodeDeactivationStatus": {
+      "type": "string",
+      "description": "The status of node deactivation operation. Following are the possible values.",
+      "enum": [
+        "None",
+        "SafetyCheckInProgress",
+        "SafetyCheckComplete",
+        "Completed"
+      ],
+      "x-ms-enum": {
+        "name": "NodeDeactivationStatus",
+        "modelAsString": true,
+        "values": [
+          {
+            "value": "None",
+            "description": "No status is associated with the task. The value is zero."
+          },
+          {
+            "value": "SafetyCheckInProgress",
+            "description": "When a node is deactivated Service Fabric performs checks to ensure that the operation is safe to proceed to ensure availability of the service and reliability of the state. This value indicates that one or more safety checks are in progress. The value is 1."
+          },
+          {
+            "value": "SafetyCheckComplete",
+            "description": "When a node is deactivated Service Fabric performs checks to ensure that the operation is safe to proceed to ensure availability of the service and reliability of the state. This value indicates that all safety checks have been completed. The value is 2."
+          },
+          {
+            "value": "Completed",
+            "description": "The task is completed. The value is 3."
+          }
+        ]
+      }
+    },
+    "NodeDeactivationTask": {
+      "description": "The task representing the deactivation operation on the node.",
+      "properties": {
+        "NodeDeactivationTaskId": {
+          "$ref": "#/definitions/NodeDeactivationTaskId",
+          "description": "Identity of the task related to deactivation operation on the node."
+        },
+        "NodeDeactivationIntent": {
+          "$ref": "#/definitions/NodeDeactivationIntent",
+          "description": "The intent or the reason for deactivating the node. Following are the possible values for it."
+        }
+      }
+    },
+    "NodeDeactivationTaskId": {
+      "description": "Identity of the task related to deactivation operation on the node.",
+      "properties": {
+        "Id": {
+          "type": "string",
+          "description": "Value of the task id."
+        },
+        "NodeDeactivationTaskType": {
+          "$ref": "#/definitions/NodeDeactivationTaskType",
+          "description": "The type of the task that performed the node deactivation. Following are the possible values."
+        }
+      }
+    },
+    "NodeDeactivationTaskList": {
+      "type": "array",
+      "items": {
+        "$ref": "#/definitions/NodeDeactivationTask"
+      },
+      "description": "List of tasks representing the deactivation operation on the node."
+    },
+    "NodeDeactivationTaskType": {
+      "type": "string",
+      "description": "The type of the task that performed the node deactivation. Following are the possible values.",
+      "enum": [
+        "Invalid",
+        "Infrastructure",
+        "Repair",
+        "Client"
+      ],
+      "x-ms-enum": {
+        "name": "NodeDeactivationTaskType",
+        "modelAsString": true,
+        "values": [
+          {
+            "value": "Invalid",
+            "description": "Indicates the node deactivation task type is invalid. All Service Fabric enumerations have the invalid type. The value is zero. This value is not used."
+          },
+          {
+            "value": "Infrastructure",
+            "description": "Specifies the task created by Infrastructure hosting the nodes. The value is 1."
+          },
+          {
+            "value": "Repair",
+            "description": "Specifies the task that was created by the Repair Manager service. The value is 2."
+          },
+          {
+            "value": "Client",
+            "description": "Specifies that the task was created by using the public API. The value is 3."
+          }
+        ]
+      }
+    },
+    "NodeEvent": {
+      "description": "Represents the base for all Node Events.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/FabricEvent"
+        }
+      ],
+      "properties": {
+        "NodeName": {
+          "$ref": "#/definitions/NodeName",
+          "description": "The name of a Service Fabric node."
+        }
+      },
+      "required": [
+        "NodeName"
+      ],
+      "x-ms-discriminator-value": "NodeEvent"
+    },
+    "NodeEventList": {
+      "description": "A list of NodeEvent objects.",
+      "type": "array",
+      "items": {
+        "$ref": "#/definitions/NodeEvent"
+      }
+    },
+    "NodeHealth": {
+      "description": "Information about the health of a Service Fabric node.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/EntityHealth"
+        }
+      ],
+      "properties": {
+        "Name": {
+          "$ref": "#/definitions/NodeName",
+          "description": "Name of the node whose health information is described by this object."
+        }
+      }
+    },
+    "NodeHealthEvaluation": {
+      "x-ms-discriminator-value": "Node",
+      "description": "Represents health evaluation for a node, containing information about the data and the algorithm used by health store to evaluate health. The evaluation is returned only when the aggregated health state is either Error or Warning.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/HealthEvaluation"
+        }
+      ],
+      "properties": {
+        "NodeName": {
+          "$ref": "#/definitions/NodeName",
+          "description": "The name of a Service Fabric node."
+        },
+        "UnhealthyEvaluations": {
+          "$ref": "#/definitions/UnhealthyEvaluations",
+          "description": "List of unhealthy evaluations that led to the current aggregated health state of the node. The types of the unhealthy evaluations can be EventHealthEvaluation."
+        }
+      }
+    },
+    "NodeHealthState": {
+      "description": "Represents the health state of a node, which contains the node identifier and its aggregated health state.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/EntityHealthState"
+        }
+      ],
+      "properties": {
+        "Name": {
+          "$ref": "#/definitions/NodeName",
+          "description": "The name of a Service Fabric node."
+        },
+        "Id": {
+          "$ref": "#/definitions/NodeId",
+          "description": "An internal ID used by Service Fabric to uniquely identify a node. Node Id is deterministically generated from node name."
+        }
+      }
+    },
+    "NodeHealthStateChunk": {
+      "description": "Represents the health state chunk of a node, which contains the node name and its aggregated health state.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/EntityHealthStateChunk"
+        }
+      ],
+      "properties": {
+        "NodeName": {
+          "$ref": "#/definitions/NodeName",
+          "description": "The name of a Service Fabric node."
+        }
+      }
+    },
+    "NodeHealthStateChunkList": {
+      "description": "The list of node health state chunks in the cluster that respect the input filters in the chunk query. Returned by get cluster health state chunks query.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/EntityHealthStateChunkList"
+        }
+      ],
+      "properties": {
+        "Items": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/NodeHealthStateChunk"
+          },
+          "description": "The list of node health state chunks that respect the input filters in the chunk query."
+        }
+      }
+    },
+    "NodeHealthStateFilter": {
+      "description": "Defines matching criteria to determine whether a node should be included in the returned cluster health chunk.\nOne filter can match zero, one or multiple nodes, depending on its properties.\nCan be specified in the cluster health chunk query description.",
+      "properties": {
+        "NodeNameFilter": {
+          "type": "string",
+          "description": "Name of the node that matches the filter. The filter is applied only to the specified node, if it exists.\nIf the node doesn't exist, no node is returned in the cluster health chunk based on this filter.\nIf the node exists, it is included in the cluster health chunk if the health state matches the other filter properties.\nIf not specified, all nodes that match the parent filters (if any) are taken into consideration and matched against the other filter members, like health state filter."
+        },
+        "HealthStateFilter": {
+          "type": "integer",
+          "default": 0,
+          "description": "The filter for the health state of the nodes. It allows selecting nodes if they match the desired health states.\nThe possible values are integer value of one of the following health states. Only nodes that match the filter are returned. All nodes are used to evaluate the cluster aggregated health state.\nIf not specified, default value is None, unless the node name is specified. If the filter has default value and node name is specified, the matching node is returned.\nThe state values are flag-based enumeration, so the value could be a combination of these values obtained using bitwise 'OR' operator.\nFor example, if the provided value is 6, it matches nodes with HealthState value of OK (2) and Warning (4).\n\n- Default - Default value. Matches any HealthState. The value is zero.\n- None - Filter that doesn't match any HealthState value. Used in order to return no results on a given collection of states. The value is 1.\n- Ok - Filter that matches input with HealthState value Ok. The value is 2.\n- Warning - Filter that matches input with HealthState value Warning. The value is 4.\n- Error - Filter that matches input with HealthState value Error. The value is 8.\n- All - Filter that matches input with any HealthState value. The value is 65535."
+        }
+      }
+    },
+    "NodeId": {
+      "description": "An internal ID used by Service Fabric to uniquely identify a node. Node Id is deterministically generated from node name.",
+      "properties": {
+        "Id": {
+          "type": "string",
+          "description": "Value of the node Id. This is a 128 bit integer."
+        }
+      }
+    },
+    "NodeIdList": {
+      "description": "A list of NodeIds.",
+      "type": "array",
+      "items": {
+        "$ref": "#/definitions/NodeId"
+      }
+    },
+    "NodeInfo": {
+      "description": "Information about a node in Service Fabric cluster.",
+      "properties": {
+        "Name": {
+          "$ref": "#/definitions/NodeName",
+          "description": "The name of a Service Fabric node."
+        },
+        "IpAddressOrFQDN": {
+          "type": "string",
+          "description": "The IP address or fully qualified domain name of the node."
+        },
+        "Type": {
+          "type": "string",
+          "description": "The type of the node."
+        },
+        "CodeVersion": {
+          "type": "string",
+          "description": "The version of Service Fabric binaries that the node is running."
+        },
+        "ConfigVersion": {
+          "type": "string",
+          "description": "The version of Service Fabric cluster manifest that the node is using."
+        },
+        "NodeStatus": {
+          "$ref": "#/definitions/NodeStatus",
+          "description": "The status of the node."
+        },
+        "NodeUpTimeInSeconds": {
+          "type": "string",
+          "description": "Time in seconds since the node has been in NodeStatus Up. Value zero indicates that the node is not Up."
+        },
+        "HealthState": {
+          "$ref": "#/definitions/HealthState",
+          "description": "The health state of a Service Fabric entity such as Cluster, Node, Application, Service, Partition, Replica etc."
+        },
+        "IsSeedNode": {
+          "type": "boolean",
+          "description": "Indicates if the node is a seed node or not. Returns true if the node is a seed node, otherwise false. A quorum of seed nodes are required for proper operation of Service Fabric cluster."
+        },
+        "UpgradeDomain": {
+          "type": "string",
+          "description": "The upgrade domain of the node."
+        },
+        "FaultDomain": {
+          "type": "string",
+          "description": "The fault domain of the node."
+        },
+        "Id": {
+          "$ref": "#/definitions/NodeId",
+          "description": "An internal ID used by Service Fabric to uniquely identify a node. Node Id is deterministically generated from node name."
+        },
+        "InstanceId": {
+          "type": "string",
+          "description": "The ID representing the node instance. While the ID of the node is deterministically generated from the node name and remains same across restarts, the InstanceId changes every time node restarts."
+        },
+        "NodeDeactivationInfo": {
+          "$ref": "#/definitions/NodeDeactivationInfo",
+          "description": "Information about the node deactivation. This information is valid for a node that is undergoing deactivation or has already been deactivated."
+        },
+        "IsStopped": {
+          "type": "boolean",
+          "description": "Indicates if the node is stopped by calling stop node API or not. Returns true if the node is stopped, otherwise false."
+        },
+        "NodeDownTimeInSeconds": {
+          "type": "string",
+          "description": "Time in seconds since the node has been in NodeStatus Down. Value zero indicates node is not NodeStatus Down."
+        },
+        "NodeUpAt": {
+          "type": "string",
+          "format": "date-time",
+          "description": "Date time in UTC when the node came up. If the node has never been up then this value will be zero date time."
+        },
+        "NodeDownAt": {
+          "type": "string",
+          "format": "date-time",
+          "description": "Date time in UTC when the node went down. If node has never been down then this value will be zero date time."
+        }
+      }
+    },
+    "NodeLoadInfo": {
+      "description": "Information about load on a Service Fabric node. It holds a summary of all metrics and their load on a node.",
+      "properties": {
+        "NodeName": {
+          "$ref": "#/definitions/NodeName",
+          "description": "Name of the node for which the load information is provided by this object."
+        },
+        "NodeLoadMetricInformation": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/NodeLoadMetricInformation"
+          },
+          "description": "List that contains metrics and their load information on this node."
+        }
+      }
+    },
+    "NodeLoadMetricInformation": {
+      "description": "Represents data structure that contains load information for a certain metric on a node.",
+      "properties": {
+        "Name": {
+          "type": "string",
+          "description": "Name of the metric for which this load information is provided."
+        },
+        "NodeCapacity": {
+          "type": "string",
+          "description": "Total capacity on the node for this metric."
+        },
+        "NodeLoad": {
+          "type": "string",
+          "description": "Current load on the node for this metric. In future releases of Service Fabric this parameter will be deprecated in favor of CurrentNodeLoad."
+        },
+        "NodeRemainingCapacity": {
+          "type": "string",
+          "description": "The remaining capacity on the node for this metric. In future releases of Service Fabric this parameter will be deprecated in favor of NodeCapacityRemaining."
+        },
+        "IsCapacityViolation": {
+          "type": "boolean",
+          "description": "Indicates if there is a capacity violation for this metric on the node."
+        },
+        "NodeBufferedCapacity": {
+          "type": "string",
+          "description": "The value that indicates the reserved capacity for this metric on the node."
+        },
+        "NodeRemainingBufferedCapacity": {
+          "type": "string",
+          "description": "The remaining reserved capacity for this metric on the node. In future releases of Service Fabric this parameter will be deprecated in favor of BufferedNodeCapacityRemaining."
+        },
+        "CurrentNodeLoad": {
+          "type": "string",
+          "format": "double",
+          "description": "Current load on the node for this metric."
+        },
+        "NodeCapacityRemaining": {
+          "type": "string",
+          "format": "double",
+          "description": "The remaining capacity on the node for the metric."
+        },
+        "BufferedNodeCapacityRemaining": {
+          "type": "string",
+          "format": "double",
+          "description": "The remaining capacity which is not reserved by NodeBufferPercentage for this metric on the node."
+        },
+        "PlannedNodeLoadRemoval": {
+          "type": "string",
+          "format": "double",
+          "description": "This value represents the load of the replicas that are planned to be removed in the future.\nThis kind of load is reported for replicas that are currently being moving to other nodes and for replicas that are currently being dropped but still use the load on the source node."
+        }
+      }
+    },
+    "NodeName": {
+      "type": "string",
+      "description": "The name of a Service Fabric node."
+    },
+    "NodeType": {
+      "type": "string",
+      "description": "The type name of a Service Fabric node.\nRefer to the article [The relationship between Service Fabric node types and Virtual Machine Scale Sets](https://docs.microsoft.com/azure/service-fabric/service-fabric-cluster-nodetypes) for more details."
+    },
+    "NodesHealthEvaluation": {
+      "x-ms-discriminator-value": "Nodes",
+      "description": "Represents health evaluation for nodes, containing health evaluations for each unhealthy node that impacted current aggregated health state. Can be returned when evaluating cluster health and the aggregated health state is either Error or Warning.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/HealthEvaluation"
+        }
+      ],
+      "properties": {
+        "MaxPercentUnhealthyNodes": {
+          "type": "integer",
+          "description": "Maximum allowed percentage of unhealthy nodes from the ClusterHealthPolicy."
+        },
+        "TotalCount": {
+          "type": "integer",
+          "format": "int64",
+          "description": "Total number of nodes found in the health store."
+        },
+        "UnhealthyEvaluations": {
+          "$ref": "#/definitions/UnhealthyEvaluations",
+          "description": "List of unhealthy evaluations that led to the aggregated health state. Includes all the unhealthy NodeHealthEvaluation that impacted the aggregated health."
+        }
+      }
+    },
+    "NodeStatus": {
+      "type": "string",
+      "description": "The status of the node.",
+      "enum": [
+        "Invalid",
+        "Up",
+        "Down",
+        "Enabling",
+        "Disabling",
+        "Disabled",
+        "Unknown",
+        "Removed"
+      ],
+      "x-ms-enum": {
+        "name": "NodeStatus",
+        "modelAsString": true,
+        "values": [
+          {
+            "value": "Invalid",
+            "description": "Indicates the node status is invalid. All Service Fabric enumerations have the invalid type. The value is zero."
+          },
+          {
+            "value": "Up",
+            "description": "Indicates the node is up. The value is 1."
+          },
+          {
+            "value": "Down",
+            "description": "Indicates the node is down. The value is 2."
+          },
+          {
+            "value": "Enabling",
+            "description": "Indicates the node is in process of being enabled. The value is 3."
+          },
+          {
+            "value": "Disabling",
+            "description": "Indicates the node is in the process of being disabled. The value is 4."
+          },
+          {
+            "value": "Disabled",
+            "description": "Indicates the node is disabled. The value is 5."
+          },
+          {
+            "value": "Unknown",
+            "description": "Indicates the node is unknown. A node would be in Unknown state if Service Fabric does not have authoritative information about that node. This can happen if the system learns about a node at runtime.The value is 6."
+          },
+          {
+            "value": "Removed",
+            "description": "Indicates the node is removed. A node would be in Removed state if NodeStateRemoved API has been called for this node. In other words, Service Fabric has been informed that the persisted state on the node has been permanently lost. The value is 7."
+          }
+        ]
+      }
+    },
+    "NodeUpgradePhase": {
+      "type": "string",
+      "description": "The state of the upgrading node.",
+      "enum": [
+        "Invalid",
+        "PreUpgradeSafetyCheck",
+        "Upgrading",
+        "PostUpgradeSafetyCheck"
+      ],
+      "x-ms-enum": {
+        "name": "NodeUpgradePhase",
+        "modelAsString": true,
+        "values": [
+          {
+            "value": "Invalid",
+            "description": "Indicates the upgrade state is invalid. All Service Fabric enumerations have the invalid type. The value is zero."
+          },
+          {
+            "value": "PreUpgradeSafetyCheck",
+            "description": "The upgrade has not started yet due to pending safety checks. The value is 1"
+          },
+          {
+            "value": "Upgrading",
+            "description": "The upgrade is in progress. The value is 2"
+          },
+          {
+            "value": "PostUpgradeSafetyCheck",
+            "description": "The upgrade has completed and post upgrade safety checks are being performed. The value is 3"
+          }
+        ]
+      }
+    },
+    "NodeUpgradeProgressInfo": {
+      "description": "Information about the upgrading node and its status",
+      "properties": {
+        "NodeName": {
+          "$ref": "#/definitions/NodeName",
+          "description": "The name of a Service Fabric node."
+        },
+        "UpgradePhase": {
+          "$ref": "#/definitions/NodeUpgradePhase",
+          "description": "The state of the upgrading node."
+        },
+        "PendingSafetyChecks": {
+          "$ref": "#/definitions/SafetyCheckInfoList",
+          "description": "List of pending safety checks"
+        }
+      }
+    },
+    "NodeUpgradeProgressInfoList": {
+      "type": "array",
+      "description": "List of upgrading nodes and their statuses",
+      "items": {
+        "$ref": "#/definitions/NodeUpgradeProgressInfo"
+      }
+    },
+    "PagedApplicationInfoList": {
+      "description": "The list of applications in the cluster. The list is paged when all of the results cannot fit in a single message. The next set of results can be obtained by executing the same query with the continuation token provided in this list.",
+      "properties": {
+        "ContinuationToken": {
+          "$ref": "#/definitions/ContinuationToken",
+          "description": "The continuation token parameter is used to obtain next set of results. The continuation token is included in the response of the API when the results from the system do not fit in a single response. When this value is passed to the next API call, the API returns next set of results. If there are no further results, then the continuation token is not included in the response."
+        },
+        "Items": {
+          "type": "array",
+          "description": "List of application information.",
+          "items": {
+            "$ref": "#/definitions/ApplicationInfo"
+          }
+        }
+      }
+    },
+    "PagedDeployedApplicationInfoList": {
+      "description": "The list of deployed applications in activating, downloading, or active states on a node.\nThe list is paged when all of the results cannot fit in a single message.\nThe next set of results can be obtained by executing the same query with the continuation token provided in this list.",
+      "properties": {
+        "ContinuationToken": {
+          "$ref": "#/definitions/ContinuationToken",
+          "description": "The continuation token parameter is used to obtain next set of results. The continuation token is included in the response of the API when the results from the system do not fit in a single response. When this value is passed to the next API call, the API returns next set of results. If there are no further results, then the continuation token is not included in the response."
+        },
+        "Items": {
+          "type": "array",
+          "description": "List of deployed application information.",
+          "items": {
+            "$ref": "#/definitions/DeployedApplicationInfo"
+          }
+        }
+      }
+    },
+    "PagedNodeInfoList": {
+      "description": "The list of nodes in the cluster. The list is paged when all of the results cannot fit in a single message. The next set of results can be obtained by executing the same query with the continuation token provided in this list.",
+      "properties": {
+        "ContinuationToken": {
+          "$ref": "#/definitions/ContinuationToken",
+          "description": "The continuation token parameter is used to obtain next set of results. The continuation token is included in the response of the API when the results from the system do not fit in a single response. When this value is passed to the next API call, the API returns next set of results. If there are no further results, then the continuation token is not included in the response."
+        },
+        "Items": {
+          "type": "array",
+          "description": "List of node information.",
+          "items": {
+            "$ref": "#/definitions/NodeInfo"
+          }
+        }
+      }
+    },
+    "PagedServicePartitionInfoList": {
+      "description": "The list of partition in the cluster for a service. The list is paged when all of the results cannot fit in a single message. The next set of results can be obtained by executing the same query with the continuation token provided in this list.",
+      "properties": {
+        "ContinuationToken": {
+          "$ref": "#/definitions/ContinuationToken",
+          "description": "The continuation token parameter is used to obtain next set of results. The continuation token is included in the response of the API when the results from the system do not fit in a single response. When this value is passed to the next API call, the API returns next set of results. If there are no further results, then the continuation token is not included in the response."
+        },
+        "Items": {
+          "type": "array",
+          "description": "List of service partition information.",
+          "items": {
+            "$ref": "#/definitions/ServicePartitionInfo"
+          }
+        }
+      }
+    },
+    "PagedReplicaInfoList": {
+      "description": "The list of replicas in the cluster for a given partition. The list is paged when all of the results cannot fit in a single message. The next set of results can be obtained by executing the same query with the continuation token provided in this list.",
+      "properties": {
+        "ContinuationToken": {
+          "$ref": "#/definitions/ContinuationToken",
+          "description": "The continuation token parameter is used to obtain next set of results. The continuation token is included in the response of the API when the results from the system do not fit in a single response. When this value is passed to the next API call, the API returns next set of results. If there are no further results, then the continuation token is not included in the response."
+        },
+        "Items": {
+          "type": "array",
+          "description": "List of replica information.",
+          "items": {
+            "$ref": "#/definitions/ReplicaInfo"
+          }
+        }
+      }
+    },
+    "PagedServiceInfoList": {
+      "description": "The list of services in the cluster for an application. The list is paged when all of the results cannot fit in a single message. The next set of results can be obtained by executing the same query with the continuation token provided in this list.",
+      "properties": {
+        "ContinuationToken": {
+          "$ref": "#/definitions/ContinuationToken",
+          "description": "The continuation token parameter is used to obtain next set of results. The continuation token is included in the response of the API when the results from the system do not fit in a single response. When this value is passed to the next API call, the API returns next set of results. If there are no further results, then the continuation token is not included in the response."
+        },
+        "Items": {
+          "type": "array",
+          "description": "List of service information.",
+          "items": {
+            "$ref": "#/definitions/ServiceInfo"
+          }
+        }
+      }
+    },
+    "PartitionAnalysisEvent": {
+      "description": "Represents the base for all Partition Analysis Events.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/PartitionEvent"
+        }
+      ],
+      "properties": {
+        "Metadata": {
+          "$ref": "#/definitions/AnalysisEventMetadata",
+          "description": "Metadata about an Analysis Event."
+        }
+      },
+      "required": [
+        "Metadata"
+      ],
+      "x-ms-discriminator-value": "PartitionAnalysisEvent"
+    },
+    "PartitionEvent": {
+      "description": "Represents the base for all Partition Events.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/FabricEvent"
+        }
+      ],
+      "properties": {
+        "PartitionId": {
+          "$ref": "#/definitions/PartitionId",
+          "description": "An internal ID used by Service Fabric to uniquely identify a partition. This is a randomly generated GUID when the service was created. The partition ID is unique and does not change for the lifetime of the service. If the same service was deleted and recreated the IDs of its partitions would be different."
+        }
+      },
+      "required": [
+        "PartitionId"
+      ],
+      "x-ms-discriminator-value": "PartitionEvent"
+    },
+    "PartitionEventList": {
+      "description": "A list of PartitionEvent objects.",
+      "type": "array",
+      "items": {
+        "$ref": "#/definitions/PartitionEvent"
+      }
+    },
+    "PartitionHealth": {
+      "description": "Information about the health of a Service Fabric partition.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/EntityHealth"
+        }
+      ],
+      "properties": {
+        "PartitionId": {
+          "$ref": "#/definitions/PartitionId",
+          "description": "ID of the partition whose health information is described by this object."
+        },
+        "ReplicaHealthStates": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/ReplicaHealthState"
+          },
+          "description": "The list of replica health states associated with the partition."
+        }
+      }
+    },
+    "PartitionHealthEvaluation": {
+      "x-ms-discriminator-value": "Partition",
+      "description": "Represents health evaluation for a partition, containing information about the data and the algorithm used by health store to evaluate health. The evaluation is returned only when the aggregated health state is either Error or Warning.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/HealthEvaluation"
+        }
+      ],
+      "properties": {
+        "PartitionId": {
+          "$ref": "#/definitions/PartitionId",
+          "description": "Id of the partition whose health evaluation is described by this object."
+        },
+        "UnhealthyEvaluations": {
+          "$ref": "#/definitions/UnhealthyEvaluations",
+          "description": "List of unhealthy evaluations that led to the current aggregated health state of the partition. The types of the unhealthy evaluations can be ReplicasHealthEvaluation or EventHealthEvaluation."
+        }
+      }
+    },
+    "PartitionHealthState": {
+      "description": "Represents the health state of a partition, which contains the partition identifier and its aggregated health state.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/EntityHealthState"
+        }
+      ],
+      "properties": {
+        "PartitionId": {
+          "$ref": "#/definitions/PartitionId",
+          "description": "Id of the partition whose health state is described by this object."
+        }
+      }
+    },
+    "PartitionHealthStateChunk": {
+      "description": "Represents the health state chunk of a partition, which contains the partition ID, its aggregated health state and any replicas that respect the filters in the cluster health chunk query description.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/EntityHealthStateChunk"
+        }
+      ],
+      "properties": {
+        "PartitionId": {
+          "$ref": "#/definitions/PartitionId",
+          "description": "The Id of the partition."
+        },
+        "ReplicaHealthStateChunks": {
+          "$ref": "#/definitions/ReplicaHealthStateChunkList",
+          "description": "The list of replica health state chunks belonging to the partition that respect the filters in the cluster health chunk query description."
+        }
+      }
+    },
+    "PartitionHealthStateChunkList": {
+      "description": "The list of partition health state chunks that respect the input filters in the chunk query description.\nReturned by get cluster health state chunks query as part of the parent application hierarchy.",
+      "properties": {
+        "Items": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/PartitionHealthStateChunk"
+          },
+          "description": "The list of partition health state chunks that respect the input filters in the chunk query."
+        }
+      }
+    },
+    "PartitionHealthStateFilter": {
+      "description": "Defines matching criteria to determine whether a partition should be included as a child of a service in the cluster health chunk.\nThe partitions are only returned if the parent entities match a filter specified in the cluster health chunk query description. The parent service and application must be included in the cluster health chunk.\nOne filter can match zero, one or multiple partitions, depending on its properties.",
+      "properties": {
+        "PartitionIdFilter": {
+          "type": "string",
+          "format": "uuid",
+          "description": "ID of the partition that matches the filter. The filter is applied only to the specified partition, if it exists.\nIf the partition doesn't exist, no partition is returned in the cluster health chunk based on this filter.\nIf the partition exists, it is included in the cluster health chunk if it respects the other filter properties.\nIf not specified, all partitions that match the parent filters (if any) are taken into consideration and matched against the other filter members, like health state filter."
+        },
+        "HealthStateFilter": {
+          "type": "integer",
+          "default": 0,
+          "description": "The filter for the health state of the partitions. It allows selecting partitions if they match the desired health states.\nThe possible values are integer value of one of the following health states. Only partitions that match the filter are returned. All partitions are used to evaluate the cluster aggregated health state.\nIf not specified, default value is None, unless the partition ID is specified. If the filter has default value and partition ID is specified, the matching partition is returned.\nThe state values are flag-based enumeration, so the value could be a combination of these values obtained using bitwise 'OR' operator.\nFor example, if the provided value is 6, it matches partitions with HealthState value of OK (2) and Warning (4).\n\n- Default - Default value. Matches any HealthState. The value is zero.\n- None - Filter that doesn't match any HealthState value. Used in order to return no results on a given collection of states. The value is 1.\n- Ok - Filter that matches input with HealthState value Ok. The value is 2.\n- Warning - Filter that matches input with HealthState value Warning. The value is 4.\n- Error - Filter that matches input with HealthState value Error. The value is 8.\n- All - Filter that matches input with any HealthState value. The value is 65535."
+        },
+        "ReplicaFilters": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/ReplicaHealthStateFilter"
+          },
+          "description": "Defines a list of filters that specify which replicas to be included in the returned cluster health chunk as children of the parent partition. The replicas are returned only if the parent partition matches a filter.\nIf the list is empty, no replicas are returned. All the replicas are used to evaluate the parent partition aggregated health state, regardless of the input filters.\nThe partition filter may specify multiple replica filters.\nFor example, it can specify a filter to return all replicas with health state Error and another filter to always include a replica identified by its replica id."
+        }
+      }
+    },
+    "PartitionId": {
+      "type": "string",
+      "format": "uuid",
+      "description": "An internal ID used by Service Fabric to uniquely identify a partition. This is a randomly generated GUID when the service was created. The partition ID is unique and does not change for the lifetime of the service. If the same service was deleted and recreated the IDs of its partitions would be different."
+    },
+    "PartitionInformation": {
+      "discriminator": "ServicePartitionKind",
+      "description": "Information about the partition identity, partitioning scheme and keys supported by it.",
+      "required": [
+        "ServicePartitionKind"
+      ],
+      "properties": {
+        "ServicePartitionKind": {
+          "$ref": "#/definitions/ServicePartitionKind",
+          "description": "The kind of partitioning scheme used to partition the service."
+        },
+        "Id": {
+          "$ref": "#/definitions/PartitionId",
+          "description": "An internal ID used by Service Fabric to uniquely identify a partition. This is a randomly generated GUID when the service was created. The partition ID is unique and does not change for the lifetime of the service. If the same service was deleted and recreated the IDs of its partitions would be different."
+        }
+      }
+    },
+    "ProvisionFabricDescription": {
+      "description": "Describes the parameters for provisioning a cluster.",
+      "properties": {
+        "CodeFilePath": {
+          "type": "string",
+          "description": "The cluster code package file path."
+        },
+        "ClusterManifestFilePath": {
+          "type": "string",
+          "description": "The cluster manifest file path."
+        }
+      }
+    },
+    "ProvisionApplicationTypeKind": {
+      "type": "string",
+      "description": "The kind of application type registration or provision requested. The application package can be registered or provisioned either from the image store or from an external store. Following are the kinds of the application type provision.",
+      "enum": [
+        "Invalid",
+        "ImageStorePath",
+        "ExternalStore"
+      ],
+      "x-ms-enum": {
+        "name": "ProvisionApplicationTypeKind",
+        "modelAsString": true,
+        "values": [
+          {
+            "value": "Invalid",
+            "description": "Indicates that the provision kind is invalid. This value is default and should not be used. The value is zero."
+          },
+          {
+            "value": "ImageStorePath",
+            "description": "Indicates that the provision is for a package that was previously uploaded to the image store. The value is 1."
+          },
+          {
+            "value": "ExternalStore",
+            "description": "Indicates that the provision is for an application package that was previously uploaded to an external store. The application package ends with the extension *.sfpkg. The value is 2."
+          }
+        ]
+      }
+    },
+    "ProvisionApplicationTypeDescriptionBase": {
+      "discriminator": "Kind",
+      "description": "Represents the type of registration or provision requested, and if the operation needs to be asynchronous or not. Supported types of provision operations are from either image store or external store.",
+      "properties": {
+        "Kind": {
+          "$ref": "#/definitions/ProvisionApplicationTypeKind",
+          "description": "The kind of application type registration or provision requested. The application package can be registered or provisioned either from the image store or from an external store. Following are the kinds of the application type provision."
+        },
+        "Async": {
+          "type": "boolean",
+          "description": "Indicates whether or not provisioning should occur asynchronously. When set to true, the provision operation returns when the request is accepted by the system, and the provision operation continues without any timeout limit. The default value is false. For large application packages, we recommend setting the value to true."
+        }
+      },
+      "required": [
+        "Kind",
+        "Async"
+      ]
+    },
+    "ProvisionApplicationTypeDescription": {
+      "description": "Describes the operation to register or provision an application type using an application package uploaded to the Service Fabric image store.",
+      "required": [
+        "ApplicationTypeBuildPath"
+      ],
+      "allOf": [
+        {
+          "$ref": "#/definitions/ProvisionApplicationTypeDescriptionBase"
+        }
+      ],
+      "properties": {
+        "ApplicationTypeBuildPath": {
+          "description": "The relative path for the application package in the image store specified during the prior upload operation.",
+          "type": "string"
+        },
+        "ApplicationPackageCleanupPolicy": {
+          "$ref": "#/definitions/ApplicationPackageCleanupPolicy",
+          "description": "The kind of action that needs to be taken for cleaning up the application package after successful provision."
+        }
+      },
+      "x-ms-discriminator-value": "ImageStorePath"
+    },
+    "ExternalStoreProvisionApplicationTypeDescription": {
+      "description": "Describes the operation to register or provision an application type using an application package from an external store instead of a package uploaded to the Service Fabric image store.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/ProvisionApplicationTypeDescriptionBase"
+        }
+      ],
+      "properties": {
+        "ApplicationPackageDownloadUri": {
+          "description": "The path to the '.sfpkg' application package from where the application package can be downloaded using HTTP or HTTPS protocols. The application package can be stored in an external store that provides GET operation to download the file. Supported protocols are HTTP and HTTPS, and the path must allow READ access.",
+          "type": "string"
+        },
+        "ApplicationTypeName": {
+          "description": "The application type name represents the name of the application type found in the application manifest.",
+          "type": "string"
+        },
+        "ApplicationTypeVersion": {
+          "description": "The application type version represents the version of the application type found in the application manifest.",
+          "type": "string"
+        }
+      },
+      "x-ms-discriminator-value": "ExternalStore",
+      "required": [
+        "ApplicationPackageDownloadUri",
+        "ApplicationTypeName",
+        "ApplicationTypeVersion"
+      ]
+    },
+    "UnprovisionFabricDescription": {
+      "description": "Describes the parameters for unprovisioning a cluster.",
+      "properties": {
+        "CodeVersion": {
+          "type": "string",
+          "description": "The cluster code package version."
+        },
+        "ConfigVersion": {
+          "type": "string",
+          "description": "The cluster manifest version."
+        }
+      }
+    },
+    "ResumeClusterUpgradeDescription": {
+      "description": "Describes the parameters for resuming a cluster upgrade.",
+      "properties": {
+        "UpgradeDomain": {
+          "type": "string",
+          "description": "The next upgrade domain for this cluster upgrade."
+        }
+      },
+      "required": [
+        "UpgradeDomain"
+      ]
+    },
+    "StartClusterUpgradeDescription": {
+      "description": "Describes the parameters for starting a cluster upgrade.",
+      "properties": {
+        "CodeVersion": {
+          "type": "string",
+          "description": "The cluster code version."
+        },
+        "ConfigVersion": {
+          "type": "string",
+          "description": "The cluster configuration version."
+        },
+        "UpgradeKind": {
+          "$ref": "#/definitions/UpgradeKind",
+          "description": "The kind of upgrade out of the following possible values."
+        },
+        "RollingUpgradeMode": {
+          "$ref": "#/definitions/UpgradeMode",
+          "description": "The mode used to monitor health during a rolling upgrade. The values are UnmonitoredAuto, UnmonitoredManual, and Monitored."
+        },
+        "UpgradeReplicaSetCheckTimeoutInSeconds": {
+          "$ref": "#/definitions/UpgradeReplicaSetCheckTimeout",
+          "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)."
+        },
+        "SortOrder": {
+          "$ref": "#/definitions/UpgradeSortOrder",
+          "description": "Defines the order in which an upgrade proceeds through the cluster."
+        },
+        "MonitoringPolicy": {
+          "$ref": "#/definitions/MonitoringPolicyDescription",
+          "description": "Describes the parameters for monitoring an upgrade in Monitored mode."
+        },
+        "ClusterHealthPolicy": {
+          "$ref": "#/definitions/ClusterHealthPolicy",
+          "description": "Defines a health policy used to evaluate the health of the cluster or of a cluster node."
+        },
+        "EnableDeltaHealthEvaluation": {
+          "type": "boolean",
+          "description": "When true, enables delta health evaluation rather than absolute health evaluation after completion of each upgrade domain."
+        },
+        "ClusterUpgradeHealthPolicy": {
+          "$ref": "#/definitions/ClusterUpgradeHealthPolicyObject",
+          "description": "Defines a health policy used to evaluate the health of the cluster during a cluster upgrade."
+        },
+        "ApplicationHealthPolicyMap": {
+          "$ref": "#/definitions/ApplicationHealthPolicies",
+          "description": "Defines the application health policy map used to evaluate the health of an application or one of its children entities."
+        },
+        "InstanceCloseDelayDurationInSeconds": {
+          "$ref": "#/definitions/InstanceCloseDelayDurationInSeconds",
+          "description": "Duration in seconds, to wait before a stateless instance is closed, to allow the active requests to drain gracefully. This would be effective when the instance is closing during the application/cluster\nupgrade, only for those instances which have a non-zero delay duration configured in the service description. See InstanceCloseDelayDurationSeconds property in $ref: \"#/definitions/StatelessServiceDescription.yaml\" for details.\nNote, the default value of InstanceCloseDelayDurationInSeconds is 4294967295, which indicates that the behavior will entirely depend on the delay configured in the stateless service description."
+        }
+      }
+    },
+    "UpdateClusterUpgradeDescription": {
+      "description": "Parameters for updating a cluster upgrade.",
+      "properties": {
+        "UpgradeKind": {
+          "$ref": "#/definitions/UpgradeType",
+          "description": "The type of upgrade out of the following possible values."
+        },
+        "UpdateDescription": {
+          "$ref": "#/definitions/RollingUpgradeUpdateDescription",
+          "description": "Describes the parameters for updating a rolling upgrade of application or cluster."
+        },
+        "ClusterHealthPolicy": {
+          "$ref": "#/definitions/ClusterHealthPolicy",
+          "description": "Defines a health policy used to evaluate the health of the cluster or of a cluster node."
+        },
+        "EnableDeltaHealthEvaluation": {
+          "$ref": "#/definitions/DeltaHealthEvaluationBool",
+          "description": "When true, enables delta health evaluation rather than absolute health evaluation after completion of each upgrade domain."
+        },
+        "ClusterUpgradeHealthPolicy": {
+          "$ref": "#/definitions/ClusterUpgradeHealthPolicyObject",
+          "description": "Defines a health policy used to evaluate the health of the cluster during a cluster upgrade."
+        },
+        "ApplicationHealthPolicyMap": {
+          "$ref": "#/definitions/ApplicationHealthPolicies",
+          "description": "Defines the application health policy map used to evaluate the health of an application or one of its children entities."
+        }
+      }
+    },
+    "SafetyCheckKind": {
+      "type": "string",
+      "description": "The kind of safety check performed by service fabric before continuing with the operations. These checks ensure the availability of the service and the reliability of the state. Following are the kinds of safety checks.",
+      "enum": [
+        "Invalid",
+        "EnsureSeedNodeQuorum",
+        "EnsurePartitionQuorum",
+        "WaitForPrimaryPlacement",
+        "WaitForPrimarySwap",
+        "WaitForReconfiguration",
+        "WaitForInbuildReplica",
+        "EnsureAvailability"
+      ],
+      "x-ms-enum": {
+        "name": "SafetyCheckKind",
+        "modelAsString": true,
+        "values": [
+          {
+            "value": "Invalid",
+            "description": "Indicates that the upgrade safety check kind is invalid. All Service Fabric enumerations have the invalid type. The value is zero."
+          },
+          {
+            "value": "EnsureSeedNodeQuorum",
+            "description": "Indicates that if we bring down the node then this will result in global seed node quorum loss. The value is 1."
+          },
+          {
+            "value": "EnsurePartitionQuorum",
+            "description": "Indicates that there is some partition for which if we bring down the replica on the node, it will result in quorum loss for that partition. The value is 2."
+          },
+          {
+            "value": "WaitForPrimaryPlacement",
+            "description": "Indicates that there is some replica on the node that was moved out of this node due to upgrade. Service Fabric is now waiting for the primary to be moved back to this node. The value is 3."
+          },
+          {
+            "value": "WaitForPrimarySwap",
+            "description": "Indicates that Service Fabric is waiting for a primary replica to be moved out of the node before starting upgrade on that node. The value is 4."
+          },
+          {
+            "value": "WaitForReconfiguration",
+            "description": "Indicates that there is some replica on the node that is involved in a reconfiguration. Service Fabric is waiting for the reconfiguration to be complete before staring upgrade on that node. The value is 5."
+          },
+          {
+            "value": "WaitForInbuildReplica",
+            "description": "Indicates that there is either a replica on the node that is going through copy, or there is a primary replica on the node that is copying data to some other replica. In both cases, bringing down the replica on the node due to upgrade will abort the copy. The value is 6."
+          },
+          {
+            "value": "EnsureAvailability",
+            "description": "Indicates that there is either a stateless service partition on the node having exactly one instance, or there is a primary replica on the node for which the partition is quorum loss. In both cases, bringing down the replicas due to upgrade will result in loss of availability. The value is 7."
+          }
+        ]
+      }
+    },
+    "SafetyCheck": {
+      "discriminator": "Kind",
+      "description": "Represents a safety check performed by service fabric before continuing with the operations. These checks ensure the availability of the service and the reliability of the state.",
+      "properties": {
+        "Kind": {
+          "$ref": "#/definitions/SafetyCheckKind",
+          "description": "The kind of safety check performed by service fabric before continuing with the operations. These checks ensure the availability of the service and the reliability of the state. Following are the kinds of safety checks."
+        }
+      },
+      "required": [
+        "Kind"
+      ]
+    },
+    "PartitionSafetyCheck": {
+      "description": "Represents a safety check for the service partition being performed by service fabric before continuing with operations.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/SafetyCheck"
+        }
+      ],
+      "properties": {
+        "PartitionId": {
+          "$ref": "#/definitions/PartitionId",
+          "description": "Id of the partition which is undergoing the safety check."
+        }
+      }
+    },
+    "EnsureAvailabilitySafetyCheck": {
+      "description": "Safety check that waits to ensure the availability of the partition. It waits until there are replicas available such that bringing down this replica will not cause availability loss for the partition.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/PartitionSafetyCheck"
+        }
+      ],
+      "x-ms-discriminator-value": "EnsureAvailability"
+    },
+    "EnsurePartitionQuorumSafetyCheck": {
+      "description": "Safety check that ensures that a quorum of replicas are not lost for a partition.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/PartitionSafetyCheck"
+        }
+      ],
+      "x-ms-discriminator-value": "EnsurePartitionQuorum"
+    },
+    "SeedNodeSafetyCheck": {
+      "description": "Represents a safety check for the seed nodes being performed by service fabric before continuing with node level operations.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/SafetyCheck"
+        }
+      ],
+      "x-ms-discriminator-value": "EnsureSeedNodeQuorum"
+    },
+    "PartitionsHealthEvaluation": {
+      "x-ms-discriminator-value": "Partitions",
+      "description": "Represents health evaluation for the partitions of a service, containing health evaluations for each unhealthy partition that impacts current aggregated health state. Can be returned when evaluating service health and the aggregated health state is either Error or Warning.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/HealthEvaluation"
+        }
+      ],
+      "properties": {
+        "MaxPercentUnhealthyPartitionsPerService": {
+          "type": "integer",
+          "description": "Maximum allowed percentage of unhealthy partitions per service from the ServiceTypeHealthPolicy."
+        },
+        "TotalCount": {
+          "type": "integer",
+          "format": "int64",
+          "description": "Total number of partitions of the service from the health store."
+        },
+        "UnhealthyEvaluations": {
+          "$ref": "#/definitions/UnhealthyEvaluations",
+          "description": "List of unhealthy evaluations that led to the aggregated health state. Includes all the unhealthy PartitionHealthEvaluation that impacted the aggregated health."
+        }
+      }
+    },
+    "ReplicaEvent": {
+      "description": "Represents the base for all Replica Events.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/FabricEvent"
+        }
+      ],
+      "properties": {
+        "PartitionId": {
+          "$ref": "#/definitions/PartitionId",
+          "description": "An internal ID used by Service Fabric to uniquely identify a partition. This is a randomly generated GUID when the service was created. The partition ID is unique and does not change for the lifetime of the service. If the same service was deleted and recreated the IDs of its partitions would be different."
+        },
+        "ReplicaId": {
+          "$ref": "#/definitions/ReplicaId_Integer",
+          "description": "Id of a stateful service replica. ReplicaId is used by Service Fabric to uniquely identify a replica of a partition. It is unique within a partition and does not change for the lifetime of the replica. If a replica gets dropped and another replica gets created on the same node for the same partition, it will get a different value for the id. Sometimes the id of a stateless service instance is also referred as a replica id."
+        }
+      },
+      "required": [
+        "PartitionId",
+        "ReplicaId"
+      ],
+      "x-ms-discriminator-value": "ReplicaEvent"
+    },
+    "ReplicaEventList": {
+      "description": "A list of ReplicaEvent objects.",
+      "type": "array",
+      "items": {
+        "$ref": "#/definitions/ReplicaEvent"
+      }
+    },
+    "ReplicaHealth": {
+      "allOf": [
+        {
+          "$ref": "#/definitions/EntityHealth"
+        }
+      ],
+      "discriminator": "ServiceKind",
+      "description": "Represents a base class for stateful service replica or stateless service instance health.\nContains the replica aggregated health state, the health events and the unhealthy evaluations.",
+      "properties": {
+        "ServiceKind": {
+          "$ref": "#/definitions/ServiceKind",
+          "description": "The kind of service (Stateless or Stateful)."
+        },
+        "PartitionId": {
+          "$ref": "#/definitions/PartitionId",
+          "description": "Id of the partition to which this replica belongs."
+        }
+      },
+      "required": [
+        "ServiceKind"
+      ]
+    },
+    "ReplicaHealthEvaluation": {
+      "x-ms-discriminator-value": "Replica",
+      "description": "Represents health evaluation for a replica, containing information about the data and the algorithm used by health store to evaluate health. The evaluation is returned only when the aggregated health state is either Error or Warning.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/HealthEvaluation"
+        }
+      ],
+      "properties": {
+        "PartitionId": {
+          "$ref": "#/definitions/PartitionId",
+          "description": "Id of the partition to which the replica belongs."
+        },
+        "ReplicaOrInstanceId": {
+          "$ref": "#/definitions/ReplicaOrInstanceId",
+          "description": "Id of a stateful service replica or a stateless service instance. This ID is used in the queries that apply to both stateful and stateless services. It is used by Service Fabric to uniquely identify a replica of a partition of a stateful service or an instance of a stateless service partition. It is unique within a partition and does not change for the lifetime of the replica or the instance. If a stateful replica gets dropped and another replica gets created on the same node for the same partition, it will get a different value for the ID. If a stateless instance is failed over on the same or different node it will get a different value for the ID."
+        },
+        "UnhealthyEvaluations": {
+          "$ref": "#/definitions/UnhealthyEvaluations",
+          "description": "List of unhealthy evaluations that led to the current aggregated health state of the replica. The types of the unhealthy evaluations can be EventHealthEvaluation."
+        }
+      }
+    },
+    "ReplicaHealthState": {
+      "discriminator": "ServiceKind",
+      "required": [
+        "ServiceKind"
+      ],
+      "description": "Represents a base class for stateful service replica or stateless service instance health state.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/EntityHealthState"
+        }
+      ],
+      "properties": {
+        "ServiceKind": {
+          "$ref": "#/definitions/ServiceKind",
+          "description": "The kind of service (Stateless or Stateful)."
+        },
+        "PartitionId": {
+          "$ref": "#/definitions/PartitionId",
+          "description": "The ID of the partition to which this replica belongs."
+        }
+      }
+    },
+    "ReplicaHealthStateChunk": {
+      "description": "Represents the health state chunk of a stateful service replica or a stateless service instance.\nThe replica health state contains the replica ID and its aggregated health state.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/EntityHealthStateChunk"
+        }
+      ],
+      "properties": {
+        "ReplicaOrInstanceId": {
+          "$ref": "#/definitions/ReplicaOrInstanceId",
+          "description": "Id of a stateful service replica or a stateless service instance. This ID is used in the queries that apply to both stateful and stateless services. It is used by Service Fabric to uniquely identify a replica of a partition of a stateful service or an instance of a stateless service partition. It is unique within a partition and does not change for the lifetime of the replica or the instance. If a stateful replica gets dropped and another replica gets created on the same node for the same partition, it will get a different value for the ID. If a stateless instance is failed over on the same or different node it will get a different value for the ID."
+        }
+      }
+    },
+    "ReplicaHealthStateChunkList": {
+      "description": "The list of replica health state chunks that respect the input filters in the chunk query. Returned by get cluster health state chunks query.",
+      "properties": {
+        "Items": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/ReplicaHealthStateChunk"
+          },
+          "description": "The list of replica health state chunks that respect the input filters in the chunk query."
+        }
+      }
+    },
+    "ReplicaHealthStateFilter": {
+      "description": "Defines matching criteria to determine whether a replica should be included as a child of a partition in the cluster health chunk.\nThe replicas are only returned if the parent entities match a filter specified in the cluster health chunk query description. The parent partition, service and application must be included in the cluster health chunk.\nOne filter can match zero, one or multiple replicas, depending on its properties.",
+      "properties": {
+        "ReplicaOrInstanceIdFilter": {
+          "type": "string",
+          "description": "Id of the stateful service replica or stateless service instance that matches the filter. The filter is applied only to the specified replica, if it exists.\nIf the replica doesn't exist, no replica is returned in the cluster health chunk based on this filter.\nIf the replica exists, it is included in the cluster health chunk if it respects the other filter properties.\nIf not specified, all replicas that match the parent filters (if any) are taken into consideration and matched against the other filter members, like health state filter."
+        },
+        "HealthStateFilter": {
+          "type": "integer",
+          "default": 0,
+          "description": "The filter for the health state of the replicas. It allows selecting replicas if they match the desired health states.\nThe possible values are integer value of one of the following health states. Only replicas that match the filter are returned. All replicas are used to evaluate the parent partition aggregated health state.\nIf not specified, default value is None, unless the replica ID is specified. If the filter has default value and replica ID is specified, the matching replica is returned.\nThe state values are flag-based enumeration, so the value could be a combination of these values obtained using bitwise 'OR' operator.\nFor example, if the provided value is 6, it matches replicas with HealthState value of OK (2) and Warning (4).\n\n- Default - Default value. Matches any HealthState. The value is zero.\n- None - Filter that doesn't match any HealthState value. Used in order to return no results on a given collection of states. The value is 1.\n- Ok - Filter that matches input with HealthState value Ok. The value is 2.\n- Warning - Filter that matches input with HealthState value Warning. The value is 4.\n- Error - Filter that matches input with HealthState value Error. The value is 8.\n- All - Filter that matches input with any HealthState value. The value is 65535."
+        }
+      }
+    },
+    "ReplicaId": {
+      "type": "string",
+      "description": "Id of a stateful service replica. ReplicaId is used by Service Fabric to uniquely identify a replica of a partition. It is unique within a partition and does not change for the lifetime of the replica. If a replica gets dropped and another replica gets created on the same node for the same partition, it will get a different value for the id. Sometimes the id of a stateless service instance is also referred as a replica id."
+    },
+    "ReplicaId_Integer": {
+      "type": "integer",
+      "format": "int64",
+      "description": "Id of a stateful service replica. ReplicaId is used by Service Fabric to uniquely identify a replica of a partition. It is unique within a partition and does not change for the lifetime of the replica. If a replica gets dropped and another replica gets created on the same node for the same partition, it will get a different value for the id. Sometimes the id of a stateless service instance is also referred as a replica id."
+    },
+    "ReplicaOrInstanceId": {
+      "type": "string",
+      "description": "Id of a stateful service replica or a stateless service instance. This ID is used in the queries that apply to both stateful and stateless services. It is used by Service Fabric to uniquely identify a replica of a partition of a stateful service or an instance of a stateless service partition. It is unique within a partition and does not change for the lifetime of the replica or the instance. If a stateful replica gets dropped and another replica gets created on the same node for the same partition, it will get a different value for the ID. If a stateless instance is failed over on the same or different node it will get a different value for the ID."
+    },
+    "ReplicaInfo": {
+      "discriminator": "ServiceKind",
+      "description": "Information about the identity, status, health, node name, uptime, and other details about the replica.",
+      "required": [
+        "ServiceKind"
+      ],
+      "properties": {
+        "ServiceKind": {
+          "$ref": "#/definitions/ServiceKind",
+          "description": "The kind of service (Stateless or Stateful)."
+        },
+        "ReplicaStatus": {
+          "$ref": "#/definitions/ReplicaStatus",
+          "description": "The status of a replica of a service."
+        },
+        "HealthState": {
+          "$ref": "#/definitions/HealthState",
+          "description": "The health state of a Service Fabric entity such as Cluster, Node, Application, Service, Partition, Replica etc."
+        },
+        "NodeName": {
+          "$ref": "#/definitions/NodeName",
+          "description": "The name of a Service Fabric node."
+        },
+        "Address": {
+          "type": "string",
+          "description": "The address the replica is listening on."
+        },
+        "LastInBuildDurationInSeconds": {
+          "type": "string",
+          "description": "The last in build duration of the replica in seconds."
+        }
+      }
+    },
+    "ReplicaRole": {
+      "type": "string",
+      "description": "The role of a replica of a stateful service.",
+      "enum": [
+        "Unknown",
+        "None",
+        "Primary",
+        "IdleSecondary",
+        "ActiveSecondary"
+      ],
+      "x-ms-enum": {
+        "name": "ReplicaRole",
+        "modelAsString": true,
+        "values": [
+          {
+            "value": "Unknown",
+            "description": "Indicates the initial role that a replica is created in. The value is zero."
+          },
+          {
+            "value": "None",
+            "description": "Specifies that the replica has no responsibility in regard to the replica set. The value is 1"
+          },
+          {
+            "value": "Primary",
+            "description": "Refers to the replica in the set on which all read and write operations are complete in order to enforce strong consistency semantics. Read operations are handled directly by the Primary replica, while write operations must be acknowledged by a quorum of the replicas in the replica set. There can only be one Primary replica in a replica set at a time. The value is 2."
+          },
+          {
+            "value": "IdleSecondary",
+            "description": "Refers to a replica in the set that receives a state transfer from the Primary replica to prepare for becoming an active Secondary replica. There can be multiple Idle Secondary replicas in a replica set at a time. Idle Secondary replicas do not count as a part of a write quorum. The value is 3."
+          },
+          {
+            "value": "ActiveSecondary",
+            "description": "Refers to a replica in the set that receives state updates from the Primary replica, applies them, and sends acknowledgements back. Secondary replicas must participate in the write quorum for a replica set. There can be multiple active Secondary replicas in a replica set at a time. The number of active Secondary replicas is configurable that the reliability subsystem should maintain. The value is 4."
+          }
+        ]
+      }
+    },
+    "ReplicasHealthEvaluation": {
+      "x-ms-discriminator-value": "Replicas",
+      "description": "Represents health evaluation for replicas, containing health evaluations for each unhealthy replica that impacted current aggregated health state. Can be returned when evaluating partition health and the aggregated health state is either Error or Warning.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/HealthEvaluation"
+        }
+      ],
+      "properties": {
+        "MaxPercentUnhealthyReplicasPerPartition": {
+          "type": "integer",
+          "description": "Maximum allowed percentage of unhealthy replicas per partition from the ApplicationHealthPolicy."
+        },
+        "TotalCount": {
+          "type": "integer",
+          "format": "int64",
+          "description": "Total number of replicas in the partition from the health store."
+        },
+        "UnhealthyEvaluations": {
+          "$ref": "#/definitions/UnhealthyEvaluations",
+          "description": "List of unhealthy evaluations that led to the aggregated health state. Includes all the unhealthy ReplicaHealthEvaluation that impacted the aggregated health."
+        }
+      }
+    },
+    "ReplicaStatus": {
+      "type": "string",
+      "description": "The status of a replica of a service.",
+      "enum": [
+        "Invalid",
+        "InBuild",
+        "Standby",
+        "Ready",
+        "Down",
+        "Dropped"
+      ],
+      "x-ms-enum": {
+        "name": "ReplicaStatus",
+        "modelAsString": true,
+        "values": [
+          {
+            "value": "Invalid",
+            "description": "Indicates the replica status is invalid. All Service Fabric enumerations have the invalid type. The value is zero."
+          },
+          {
+            "value": "InBuild",
+            "description": "The replica is being built. This means that a primary replica is seeding this replica. The value is 1."
+          },
+          {
+            "value": "Standby",
+            "description": "The replica is in standby. The value is 2."
+          },
+          {
+            "value": "Ready",
+            "description": "The replica is ready. The value is 3."
+          },
+          {
+            "value": "Down",
+            "description": "The replica is down. The value is 4."
+          },
+          {
+            "value": "Dropped",
+            "description": "Replica is dropped. This means that the replica has been removed from the replica set. If it is persisted, its state has been deleted. The value is 5."
+          }
+        ]
+      }
+    },
+    "RestartNodeDescription": {
+      "description": "Describes the parameters to restart a Service Fabric node.",
+      "properties": {
+        "NodeInstanceId": {
+          "type": "string",
+          "description": "The instance ID of the target node. If instance ID is specified the node is restarted only if it matches with the current instance of the node. A default value of \"0\" would match any instance ID. The instance ID can be obtained using get node query.",
+          "default": "0"
+        },
+        "CreateFabricDump": {
+          "type": "string",
+          "description": "Specify True to create a dump of the fabric node process. This is case-sensitive.",
+          "enum": [
+            "False",
+            "True"
+          ],
+          "default": "False",
+          "x-ms-enum": {
+            "name": "CreateFabricDump",
+            "modelAsString": true,
+            "values": [
+              {
+                "value": "False"
+              },
+              {
+                "value": "True"
+              }
+            ]
+          }
+        }
+      },
+      "required": [
+        "NodeInstanceId"
+      ]
+    },
+    "SafetyCheckInfoList": {
+      "type": "array",
+      "description": "List of pending safety checks",
+      "items": {
+        "$ref": "#/definitions/SafetyCheckWrapper"
+      }
+    },
+    "SafetyCheckWrapper": {
+      "description": "A wrapper for the safety check object. Safety checks are performed by service fabric before continuing with the operations. These checks ensure the availability of the service and the reliability of the state.",
+      "properties": {
+        "SafetyCheck": {
+          "$ref": "#/definitions/SafetyCheck",
+          "description": "Represents a safety check performed by service fabric before continuing with the operations. These checks ensure the availability of the service and the reliability of the state."
+        }
+      }
+    },
+    "ServiceEvent": {
+      "description": "Represents the base for all Service Events.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/FabricEvent"
+        }
+      ],
+      "properties": {
+        "ServiceId": {
+          "$ref": "#/definitions/ServiceId",
+          "description": "The identity of the service. This ID is an encoded representation of the service name. This is used in the REST APIs to identify the service resource.\nStarting in version 6.0, hierarchical names are delimited with the \"\\~\" character. For example, if the service name is \"fabric:/myapp/app1/svc1\",\nthe service identity would be \"myapp~app1\\~svc1\" in 6.0+ and \"myapp/app1/svc1\" in previous versions."
+        }
+      },
+      "required": [
+        "ServiceId"
+      ],
+      "x-ms-discriminator-value": "ServiceEvent"
+    },
+    "ServiceEventList": {
+      "description": "A list of ServiceEvent objects.",
+      "type": "array",
+      "items": {
+        "$ref": "#/definitions/ServiceEvent"
+      }
+    },
+    "ServiceFromTemplateDescription": {
+      "description": "Defines description for creating a Service Fabric service from a template defined in the application manifest.",
+      "required": [
+        "ApplicationName",
+        "ServiceName",
+        "ServiceTypeName"
+      ],
+      "properties": {
+        "ApplicationName": {
+          "$ref": "#/definitions/ApplicationName",
+          "description": "The name of the application, including the 'fabric:' URI scheme."
+        },
+        "ServiceName": {
+          "$ref": "#/definitions/ServiceName",
+          "description": "The full name of the service with 'fabric:' URI scheme."
+        },
+        "ServiceTypeName": {
+          "$ref": "#/definitions/ServiceTypeName",
+          "description": "Name of the service type as specified in the service manifest."
+        },
+        "InitializationData": {
+          "$ref": "#/definitions/ByteArray",
+          "description": "The initialization data for the newly created service instance."
+        },
+        "ServicePackageActivationMode": {
+          "$ref": "#/definitions/ServicePackageActivationMode",
+          "description": "The activation mode of service package to be used for a service."
+        },
+        "ServiceDnsName": {
+          "type": "string",
+          "description": "The DNS name of the service. It requires the DNS system service to be enabled in Service Fabric cluster."
+        }
+      }
+    },
+    "ServiceHealthEvaluation": {
+      "x-ms-discriminator-value": "Service",
+      "description": "Represents health evaluation for a service, containing information about the data and the algorithm used by health store to evaluate health. The evaluation is returned only when the aggregated health state is either Error or Warning.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/HealthEvaluation"
+        }
+      ],
+      "properties": {
+        "ServiceName": {
+          "$ref": "#/definitions/ServiceName",
+          "description": "Name of the service whose health evaluation is described by this object."
+        },
+        "UnhealthyEvaluations": {
+          "$ref": "#/definitions/UnhealthyEvaluations",
+          "description": "List of unhealthy evaluations that led to the current aggregated health state of the service. The types of the unhealthy evaluations can be PartitionsHealthEvaluation or EventHealthEvaluation."
+        }
+      }
+    },
+    "ServiceHealthState": {
+      "description": "Represents the health state of a service, which contains the service identifier and its aggregated health state.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/EntityHealthState"
+        }
+      ],
+      "properties": {
+        "ServiceName": {
+          "$ref": "#/definitions/ServiceName",
+          "description": "Name of the service whose health state is represented by this object."
+        }
+      }
+    },
+    "ServiceHealthStateChunk": {
+      "description": "Represents the health state chunk of a service, which contains the service name, its aggregated health state and any partitions that respect the filters in the cluster health chunk query description.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/EntityHealthStateChunk"
+        }
+      ],
+      "properties": {
+        "ServiceName": {
+          "$ref": "#/definitions/ServiceName",
+          "description": "The name of the service whose health state chunk is provided in this object."
+        },
+        "PartitionHealthStateChunks": {
+          "$ref": "#/definitions/PartitionHealthStateChunkList",
+          "description": "The list of partition health state chunks belonging to the service that respect the filters in the cluster health chunk query description."
+        }
+      }
+    },
+    "ServiceHealthStateChunkList": {
+      "description": "The list of service health state chunks that respect the input filters in the chunk query. Returned by get cluster health state chunks query.",
+      "properties": {
+        "Items": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/ServiceHealthStateChunk"
+          },
+          "description": "The list of service health state chunks that respect the input filters in the chunk query."
+        }
+      }
+    },
+    "ServiceHealthStateFilter": {
+      "description": "Defines matching criteria to determine whether a service should be included as a child of an application in the cluster health chunk.\nThe services are only returned if the parent application matches a filter specified in the cluster health chunk query description.\nOne filter can match zero, one or multiple services, depending on its properties.",
+      "properties": {
+        "ServiceNameFilter": {
+          "type": "string",
+          "description": "The name of the service that matches the filter. The filter is applied only to the specified service, if it exists.\nIf the service doesn't exist, no service is returned in the cluster health chunk based on this filter.\nIf the service exists, it is included as the application's child if the health state matches the other filter properties.\nIf not specified, all services that match the parent filters (if any) are taken into consideration and matched against the other filter members, like health state filter."
+        },
+        "HealthStateFilter": {
+          "type": "integer",
+          "default": 0,
+          "description": "The filter for the health state of the services. It allows selecting services if they match the desired health states.\nThe possible values are integer value of one of the following health states. Only services that match the filter are returned. All services are used to evaluate the cluster aggregated health state.\nIf not specified, default value is None, unless the service name is specified. If the filter has default value and service name is specified, the matching service is returned.\nThe state values are flag-based enumeration, so the value could be a combination of these values obtained using bitwise 'OR' operator.\nFor example, if the provided value is 6, it matches services with HealthState value of OK (2) and Warning (4).\n\n- Default - Default value. Matches any HealthState. The value is zero.\n- None - Filter that doesn't match any HealthState value. Used in order to return no results on a given collection of states. The value is 1.\n- Ok - Filter that matches input with HealthState value Ok. The value is 2.\n- Warning - Filter that matches input with HealthState value Warning. The value is 4.\n- Error - Filter that matches input with HealthState value Error. The value is 8.\n- All - Filter that matches input with any HealthState value. The value is 65535."
+        },
+        "PartitionFilters": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/PartitionHealthStateFilter"
+          },
+          "description": "Defines a list of filters that specify which partitions to be included in the returned cluster health chunk as children of the service. The partitions are returned only if the parent service matches a filter.\nIf the list is empty, no partitions are returned. All the partitions are used to evaluate the parent service aggregated health state, regardless of the input filters.\nThe service filter may specify multiple partition filters.\nFor example, it can specify a filter to return all partitions with health state Error and another filter to always include a partition identified by its partition ID."
+        }
+      }
+    },
+    "ServiceHealth": {
+      "description": "Information about the health of a Service Fabric service.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/EntityHealth"
+        }
+      ],
+      "properties": {
+        "Name": {
+          "$ref": "#/definitions/ServiceName",
+          "description": "The name of the service whose health information is described by this object."
+        },
+        "PartitionHealthStates": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/PartitionHealthState"
+          },
+          "description": "The list of partition health states associated with the service."
+        }
+      }
+    },
+    "ServiceId": {
+      "type": "string",
+      "description": "The identity of the service. This ID is an encoded representation of the service name. This is used in the REST APIs to identify the service resource.\nStarting in version 6.0, hierarchical names are delimited with the \"\\~\" character. For example, if the service name is \"fabric:/myapp/app1/svc1\",\nthe service identity would be \"myapp~app1\\~svc1\" in 6.0+ and \"myapp/app1/svc1\" in previous versions."
+    },
+    "ServiceName": {
+      "type": "string",
+      "description": "The full name of the service with 'fabric:' URI scheme."
+    },
+    "ServiceManifestName": {
+      "type": "string",
+      "description": "The name of the service manifest."
+    },
+    "ServiceTypeName": {
+      "type": "string",
+      "description": "Name of the service type as specified in the service manifest."
+    },
+    "ServiceInfo": {
+      "discriminator": "ServiceKind",
+      "description": "Information about a Service Fabric service.",
+      "properties": {
+        "Id": {
+          "$ref": "#/definitions/ServiceId",
+          "description": "The identity of the service. This ID is an encoded representation of the service name. This is used in the REST APIs to identify the service resource.\nStarting in version 6.0, hierarchical names are delimited with the \"\\~\" character. For example, if the service name is \"fabric:/myapp/app1/svc1\",\nthe service identity would be \"myapp~app1\\~svc1\" in 6.0+ and \"myapp/app1/svc1\" in previous versions."
+        },
+        "ServiceKind": {
+          "$ref": "#/definitions/ServiceKind",
+          "description": "The kind of service (Stateless or Stateful)."
+        },
+        "Name": {
+          "$ref": "#/definitions/ServiceName",
+          "description": "The full name of the service with 'fabric:' URI scheme."
+        },
+        "TypeName": {
+          "$ref": "#/definitions/ServiceTypeName",
+          "description": "Name of the service type as specified in the service manifest."
+        },
+        "ManifestVersion": {
+          "description": "The version of the service manifest.",
+          "type": "string"
+        },
+        "HealthState": {
+          "$ref": "#/definitions/HealthState",
+          "description": "The health state of a Service Fabric entity such as Cluster, Node, Application, Service, Partition, Replica etc."
+        },
+        "ServiceStatus": {
+          "$ref": "#/definitions/ServiceStatus",
+          "description": "The status of the application."
+        },
+        "IsServiceGroup": {
+          "description": "Whether the service is in a service group.",
+          "type": "boolean"
+        }
+      },
+      "required": [
+        "ServiceKind"
+      ]
+    },
+    "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."
+          }
+        ]
+      }
+    },
+    "ServiceNameInfo": {
+      "description": "Information about the service name.",
+      "properties": {
+        "Id": {
+          "$ref": "#/definitions/ServiceId",
+          "description": "The identity of the service. This ID is an encoded representation of the service name. This is used in the REST APIs to identify the service resource.\nStarting in version 6.0, hierarchical names are delimited with the \"\\~\" character. For example, if the service name is \"fabric:/myapp/app1/svc1\",\nthe service identity would be \"myapp~app1\\~svc1\" in 6.0+ and \"myapp/app1/svc1\" in previous versions."
+        },
+        "Name": {
+          "$ref": "#/definitions/ServiceName",
+          "description": "The full name of the service with 'fabric:' URI scheme."
+        }
+      }
+    },
+    "ServicePackageActivationId": {
+      "type": "string",
+      "description": "The ActivationId of a deployed service package. If ServicePackageActivationMode specified at the time of creating the service\nis 'SharedProcess' (or if it is not specified, in which case it defaults to 'SharedProcess'), then value of ServicePackageActivationId\nis always an empty string."
+    },
+    "ServicePartitionInfo": {
+      "discriminator": "ServiceKind",
+      "description": "Information about a partition of a Service Fabric service.",
+      "required": [
+        "ServiceKind"
+      ],
+      "properties": {
+        "ServiceKind": {
+          "$ref": "#/definitions/ServiceKind",
+          "description": "The kind of service (Stateless or Stateful)."
+        },
+        "HealthState": {
+          "$ref": "#/definitions/HealthState",
+          "description": "The health state of a Service Fabric entity such as Cluster, Node, Application, Service, Partition, Replica etc."
+        },
+        "PartitionStatus": {
+          "$ref": "#/definitions/ServicePartitionStatus",
+          "description": "The status of the service fabric service partition."
+        },
+        "PartitionInformation": {
+          "$ref": "#/definitions/PartitionInformation",
+          "description": "Information about the partition identity, partitioning scheme and keys supported by it."
+        }
+      }
+    },
+    "ServicePartitionKind": {
+      "type": "string",
+      "description": "The kind of partitioning scheme used to partition the service.",
+      "enum": [
+        "Invalid",
+        "Singleton",
+        "Int64Range",
+        "Named"
+      ],
+      "x-ms-enum": {
+        "name": "ServicePartitionKind",
+        "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 there is only one partition, and SingletonPartitionSchemeDescription was specified while creating the service. The value is 1."
+          },
+          {
+            "value": "Int64Range",
+            "description": "Indicates that the partition is based on Int64 key ranges, and UniformInt64RangePartitionSchemeDescription was specified while creating the service. The value is 2."
+          },
+          {
+            "value": "Named",
+            "description": "Indicates that the partition is based on string names, and NamedPartitionInformation  was specified while creating the service. The value is 3."
+          }
+        ]
+      }
+    },
+    "ServicePartitionStatus": {
+      "type": "string",
+      "description": "The status of the service fabric service partition.",
+      "enum": [
+        "Invalid",
+        "Ready",
+        "NotReady",
+        "InQuorumLoss",
+        "Reconfiguring",
+        "Deleting"
+      ],
+      "x-ms-enum": {
+        "name": "ServicePartitionStatus",
+        "modelAsString": true,
+        "values": [
+          {
+            "value": "Invalid",
+            "description": "Indicates the partition status is invalid. All Service Fabric enumerations have the invalid type. The value is zero."
+          },
+          {
+            "value": "Ready",
+            "description": "Indicates that the partition is ready. This means that for a stateless service partition there is at least one instance that is up and for a stateful service partition the number of ready replicas is greater than or equal to the MinReplicaSetSize. The value is 1."
+          },
+          {
+            "value": "NotReady",
+            "description": "Indicates that the partition is not ready. This status is returned when none of the other states apply. The value is 2."
+          },
+          {
+            "value": "InQuorumLoss",
+            "description": "Indicates that the partition is in quorum loss. This means that number of replicas that are up and participating in a replica set is less than MinReplicaSetSize for this partition. The value is 3."
+          },
+          {
+            "value": "Reconfiguring",
+            "description": "Indicates that the partition is undergoing reconfiguration of its replica sets. This can happen due to failover, upgrade, load balancing or addition or removal of replicas from the replica set. The value is 4."
+          },
+          {
+            "value": "Deleting",
+            "description": "Indicates that the partition is being deleted. The value is 5."
+          }
+        ]
+      }
+    },
+    "ServicePlacementInvalidDomainPolicyDescription": {
+      "x-ms-discriminator-value": "InvalidDomain",
+      "description": "Describes the policy to be used for placement of a Service Fabric service where a particular fault or upgrade domain should not be used for placement of the instances or replicas of that service.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/ServicePlacementPolicyDescription"
+        }
+      ],
+      "properties": {
+        "DomainName": {
+          "type": "string",
+          "description": "The name of the domain that should not be used for placement."
+        }
+      }
+    },
+    "ServicePlacementNonPartiallyPlaceServicePolicyDescription": {
+      "x-ms-discriminator-value": "NonPartiallyPlaceService",
+      "description": "Describes the policy to be used for placement of a Service Fabric service where all replicas must be able to be placed in order for any replicas to be created.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/ServicePlacementPolicyDescription"
+        }
+      ]
+    },
+    "ServicePlacementPolicyDescription": {
+      "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."
+        }
+      }
+    },
+    "ServicePlacementPolicyDescriptionList": {
+      "type": "array",
+      "items": {
+        "$ref": "#/definitions/ServicePlacementPolicyDescription"
+      },
+      "description": "List of service placement policy descriptions."
+    },
+    "ServicePlacementPolicyType": {
+      "type": "string",
+      "description": "The type of placement policy for a service fabric service. Following are the possible values.",
+      "enum": [
+        "Invalid",
+        "InvalidDomain",
+        "RequireDomain",
+        "PreferPrimaryDomain",
+        "RequireDomainDistribution",
+        "NonPartiallyPlaceService",
+        "AllowMultipleStatelessInstancesOnNode"
+      ],
+      "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": "RequireDomain",
+            "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": "PreferPrimaryDomain",
+            "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": "RequireDomainDistribution",
+            "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."
+          },
+          {
+            "value": "AllowMultipleStatelessInstancesOnNode",
+            "description": "Indicates that the ServicePlacementPolicyDescription is of type ServicePlacementAllowMultipleStatelessInstancesOnNodePolicyDescription, which indicates that multiple stateless instances of a particular partition of the service can be placed on a node. The value is 6."
+          }
+        ]
+      }
+    },
+    "ServicePlacementPreferPrimaryDomainPolicyDescription": {
+      "x-ms-discriminator-value": "PreferPrimaryDomain",
+      "description": "Describes the policy to be used for placement of a Service Fabric service where the service's Primary replicas should optimally be placed in a particular domain.\n\nThis placement policy is usually used with fault domains in scenarios where the Service Fabric cluster is geographically distributed in order to indicate that a service's primary replica should be located in a particular fault domain, which in geo-distributed scenarios usually aligns with regional or datacenter boundaries. Note that since this is an optimization it is possible that the Primary replica may not end up located in this domain due to failures, capacity limits, or other constraints.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/ServicePlacementPolicyDescription"
+        }
+      ],
+      "properties": {
+        "DomainName": {
+          "type": "string",
+          "description": "The name of the domain that should used for placement as per this policy."
+        }
+      }
+    },
+    "ServicePlacementRequiredDomainPolicyDescription": {
+      "x-ms-discriminator-value": "RequireDomain",
+      "description": "Describes the policy to be used for placement of a Service Fabric service where the instances or replicas of that service must be placed in a particular domain",
+      "allOf": [
+        {
+          "$ref": "#/definitions/ServicePlacementPolicyDescription"
+        }
+      ],
+      "properties": {
+        "DomainName": {
+          "type": "string",
+          "description": "The name of the domain that should used for placement as per this policy."
+        }
+      }
+    },
+    "ServicePlacementRequireDomainDistributionPolicyDescription": {
+      "x-ms-discriminator-value": "RequireDomainDistribution",
+      "description": "Describes the policy to be used for placement of a Service Fabric service where two replicas from the same partition should never be placed in the same fault or upgrade domain.\n\nWhile this is not common it can expose the service to an increased risk of concurrent failures due to unplanned outages or other cases of subsequent/concurrent failures. As an example, consider a case where replicas are deployed across different data center, with one replica per location. In the event that one of the datacenters goes offline, normally the replica that was placed in that datacenter will be packed into one of the remaining datacenters. If this is not desirable then this policy should be set.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/ServicePlacementPolicyDescription"
+        }
+      ],
+      "properties": {
+        "DomainName": {
+          "type": "string",
+          "description": "The name of the domain that should used for placement as per this policy."
+        }
+      }
+    },
+    "ServicesHealthEvaluation": {
+      "x-ms-discriminator-value": "Services",
+      "description": "Represents health evaluation for services of a certain service type belonging to an application, containing health evaluations for each unhealthy service that impacted current aggregated health state. Can be returned when evaluating application health and the aggregated health state is either Error or Warning.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/HealthEvaluation"
+        }
+      ],
+      "properties": {
+        "ServiceTypeName": {
+          "type": "string",
+          "description": "Name of the service type of the services."
+        },
+        "MaxPercentUnhealthyServices": {
+          "type": "integer",
+          "description": "Maximum allowed percentage of unhealthy services from the ServiceTypeHealthPolicy."
+        },
+        "TotalCount": {
+          "type": "integer",
+          "format": "int64",
+          "description": "Total number of services of the current service type in the application from the health store."
+        },
+        "UnhealthyEvaluations": {
+          "$ref": "#/definitions/UnhealthyEvaluations",
+          "description": "List of unhealthy evaluations that led to the aggregated health state. Includes all the unhealthy ServiceHealthEvaluation that impacted the aggregated health."
+        }
+      }
+    },
+    "ServiceStatus": {
+      "type": "string",
+      "description": "The status of the application.",
+      "enum": [
+        "Unknown",
+        "Active",
+        "Upgrading",
+        "Deleting",
+        "Creating",
+        "Failed"
+      ],
+      "x-ms-enum": {
+        "name": "ServiceStatus",
+        "modelAsString": true,
+        "values": [
+          {
+            "value": "Unknown",
+            "description": "Indicates the service status is unknown. The value is zero."
+          },
+          {
+            "value": "Active",
+            "description": "Indicates the service status is active. The value is 1."
+          },
+          {
+            "value": "Upgrading",
+            "description": "Indicates the service is upgrading. The value is 2."
+          },
+          {
+            "value": "Deleting",
+            "description": "Indicates the service is being deleted. The value is 3."
+          },
+          {
+            "value": "Creating",
+            "description": "Indicates the service is being created. The value is 4."
+          },
+          {
+            "value": "Failed",
+            "description": "Indicates creation or deletion was terminated due to persistent failures. Another create/delete request can be accepted. The value is 5."
+          }
+        ]
+      }
+    },
+    "ServiceTypeDescription": {
+      "discriminator": "Kind",
+      "description": "Describes a service type defined in the service manifest of a provisioned application type. The properties the ones defined in the service manifest.",
+      "required": [
+        "Kind"
+      ],
+      "properties": {
+        "Kind": {
+          "$ref": "#/definitions/ServiceKind",
+          "description": "The kind of service (Stateless or Stateful)."
+        },
+        "IsStateful": {
+          "type": "boolean",
+          "description": "Indicates whether the service type is a stateful service type or a stateless service type. This property is true if the service type is a stateful service type, false otherwise."
+        },
+        "ServiceTypeName": {
+          "$ref": "#/definitions/ServiceTypeName",
+          "description": "Name of the service type as specified in the service manifest."
+        },
+        "PlacementConstraints": {
+          "type": "string",
+          "description": "The placement constraint to be used when instantiating this service in a Service Fabric cluster."
+        },
+        "LoadMetrics": {
+          "$ref": "#/definitions/ServiceLoadMetricsList",
+          "description": "The service load metrics is given as an array of ServiceLoadMetricDescription objects."
+        },
+        "ServicePlacementPolicies": {
+          "$ref": "#/definitions/ServicePlacementPolicyDescriptionList",
+          "description": "List of service placement policy descriptions."
+        },
+        "Extensions": {
+          "$ref": "#/definitions/ServiceTypeExtensionDescriptionList",
+          "description": "List of service type extensions."
+        }
+      }
+    },
+    "ServiceTypeExtensionDescription": {
+      "description": "Describes extension of a service type defined in the service manifest.",
+      "properties": {
+        "Key": {
+          "type": "string",
+          "description": "The name of the extension."
+        },
+        "Value": {
+          "type": "string",
+          "description": "The extension value."
+        }
+      }
+    },
+    "ServiceTypeExtensionDescriptionList": {
+      "type": "array",
+      "items": {
+        "$ref": "#/definitions/ServiceTypeExtensionDescription"
+      },
+      "description": "List of service type extensions."
+    },
+    "ServiceTypeHealthPolicy": {
+      "description": "Represents the health policy used to evaluate the health of services belonging to a service type.",
+      "properties": {
+        "MaxPercentUnhealthyPartitionsPerService": {
+          "type": "integer",
+          "description": "The maximum allowed percentage of unhealthy partitions per service. Allowed values are Byte values from zero to 100\n\nThe percentage represents the maximum tolerated percentage of partitions that can be unhealthy before the service is considered in error.\nIf the percentage is respected but there is at least one unhealthy partition, the health is evaluated as Warning.\nThe percentage is calculated by dividing the number of unhealthy partitions over the total number of partitions in the service.\nThe computation rounds up to tolerate one failure on small numbers of partitions. Default percentage is zero.",
+          "default": 0
+        },
+        "MaxPercentUnhealthyReplicasPerPartition": {
+          "type": "integer",
+          "description": "The maximum allowed percentage of unhealthy replicas per partition. Allowed values are Byte values from zero to 100.\n\nThe percentage represents the maximum tolerated percentage of replicas that can be unhealthy before the partition is considered in error.\nIf the percentage is respected but there is at least one unhealthy replica, the health is evaluated as Warning.\nThe percentage is calculated by dividing the number of unhealthy replicas over the total number of replicas in the partition.\nThe computation rounds up to tolerate one failure on small numbers of replicas. Default percentage is zero.",
+          "default": 0
+        },
+        "MaxPercentUnhealthyServices": {
+          "type": "integer",
+          "description": "The maximum allowed percentage of unhealthy services. Allowed values are Byte values from zero to 100.\n\nThe percentage represents the maximum tolerated percentage of services that can be unhealthy before the application is considered in error.\nIf the percentage is respected but there is at least one unhealthy service, the health is evaluated as Warning.\nThis is calculated by dividing the number of unhealthy services of the specific service type over the total number of services of the specific service type.\nThe computation rounds up to tolerate one failure on small numbers of services. Default percentage is zero.",
+          "default": 0
+        }
+      }
+    },
+    "ServiceTypeHealthPolicyMap": {
+      "type": "array",
+      "items": {
+        "$ref": "#/definitions/ServiceTypeHealthPolicyMapItem"
+      },
+      "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. For 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. With 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."
+    },
+    "ServiceTypeHealthPolicyMapItem": {
+      "description": "Defines an item in ServiceTypeHealthPolicyMap.",
+      "required": [
+        "Key",
+        "Value"
+      ],
+      "properties": {
+        "Key": {
+          "type": "string",
+          "description": "The key of the service type health policy map item. This is the name of the service type."
+        },
+        "Value": {
+          "$ref": "#/definitions/ServiceTypeHealthPolicy",
+          "description": "The value of the service type health policy map item. This is the ServiceTypeHealthPolicy for this service type."
+        }
+      }
+    },
+    "ServiceTypeInfo": {
+      "description": "Information about a service type that is defined in a service manifest of a provisioned application type.",
+      "properties": {
+        "ServiceTypeDescription": {
+          "$ref": "#/definitions/ServiceTypeDescription",
+          "description": "Describes a service type defined in the service manifest of a provisioned application type. The properties the ones defined in the service manifest."
+        },
+        "ServiceManifestName": {
+          "$ref": "#/definitions/ServiceManifestName",
+          "description": "The name of the service manifest in which this service type is defined."
+        },
+        "ServiceManifestVersion": {
+          "type": "string",
+          "description": "The version of the service manifest in which this service type is defined."
+        },
+        "IsServiceGroup": {
+          "type": "boolean",
+          "description": "Indicates whether the service is a service group. If it is, the property value is true otherwise false."
+        }
+      }
+    },
+    "ServiceTypeInfoList": {
+      "type": "array",
+      "items": {
+        "$ref": "#/definitions/ServiceTypeInfo"
+      },
+      "description": "List of service type information."
+    },
+    "ServiceTypeManifest": {
+      "description": "Contains the manifest describing a service type registered as part of an application in a Service Fabric cluster.",
+      "properties": {
+        "Manifest": {
+          "type": "string",
+          "description": "The XML manifest as a string."
+        }
+      }
+    },
+    "SingletonPartitionInformation": {
+      "description": "Information about a partition that is singleton. The services with singleton partitioning scheme are effectively non-partitioned. They only have one partition.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/PartitionInformation"
+        }
+      ],
+      "x-ms-discriminator-value": "Singleton"
+    },
+    "StatefulServiceInfo": {
+      "description": "Information about a stateful Service Fabric service.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/ServiceInfo"
+        }
+      ],
+      "properties": {
+        "HasPersistedState": {
+          "description": "Whether the service has persisted state.",
+          "type": "boolean"
+        }
+      },
+      "x-ms-discriminator-value": "Stateful"
+    },
+    "StatefulServicePartitionInfo": {
+      "description": "Information about a partition of a stateful Service Fabric service..",
+      "allOf": [
+        {
+          "$ref": "#/definitions/ServicePartitionInfo"
+        }
+      ],
+      "x-ms-discriminator-value": "Stateful",
+      "properties": {
+        "TargetReplicaSetSize": {
+          "type": "integer",
+          "format": "int64",
+          "description": "The target replica set size as a number."
+        },
+        "MinReplicaSetSize": {
+          "type": "integer",
+          "format": "int64",
+          "description": "The minimum replica set size as a number."
+        },
+        "LastQuorumLossDuration": {
+          "type": "string",
+          "format": "duration",
+          "description": "The duration for which this partition was in quorum loss. If the partition is currently in quorum loss, it returns the duration since it has been in that state. This field is using ISO8601 format for specifying the duration."
+        },
+        "PrimaryEpoch": {
+          "$ref": "#/definitions/Epoch",
+          "description": "An Epoch is a configuration number for the partition as a whole. When the configuration of the replica set changes, for example when the Primary replica changes, the operations that are replicated from the new Primary replica are said to be a new Epoch from the ones which were sent by the old Primary replica."
+        }
+      }
+    },
+    "StatefulServiceReplicaHealth": {
+      "description": "Represents the health of the stateful service replica.\nContains the replica aggregated health state, the health events and the unhealthy evaluations.",
+      "x-ms-discriminator-value": "Stateful",
+      "allOf": [
+        {
+          "$ref": "#/definitions/ReplicaHealth"
+        }
+      ],
+      "properties": {
+        "ReplicaId": {
+          "$ref": "#/definitions/ReplicaId",
+          "description": "Id of a stateful service replica. ReplicaId is used by Service Fabric to uniquely identify a replica of a partition. It is unique within a partition and does not change for the lifetime of the replica. If a replica gets dropped and another replica gets created on the same node for the same partition, it will get a different value for the id. Sometimes the id of a stateless service instance is also referred as a replica id."
+        }
+      }
+    },
+    "StatefulServiceReplicaHealthState": {
+      "x-ms-discriminator-value": "Stateful",
+      "description": "Represents the health state of the stateful service replica, which contains the replica ID and the aggregated health state.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/ReplicaHealthState"
+        }
+      ],
+      "properties": {
+        "ReplicaId": {
+          "$ref": "#/definitions/ReplicaId",
+          "description": "Id of a stateful service replica. ReplicaId is used by Service Fabric to uniquely identify a replica of a partition. It is unique within a partition and does not change for the lifetime of the replica. If a replica gets dropped and another replica gets created on the same node for the same partition, it will get a different value for the id. Sometimes the id of a stateless service instance is also referred as a replica id."
+        }
+      }
+    },
+    "StatefulServiceTypeDescription": {
+      "description": "Describes a stateful service type defined in the service manifest of a provisioned application type.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/ServiceTypeDescription"
+        }
+      ],
+      "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."
+        }
+      }
+    },
+    "StatelessServiceInfo": {
+      "description": "Information about a stateless Service Fabric service.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/ServiceInfo"
+        }
+      ],
+      "x-ms-discriminator-value": "Stateless"
+    },
+    "StatelessServiceInstanceHealth": {
+      "description": "Represents the health of the stateless service instance.\nContains the instance aggregated health state, the health events and the unhealthy evaluations.",
+      "x-ms-discriminator-value": "Stateless",
+      "allOf": [
+        {
+          "$ref": "#/definitions/ReplicaHealth"
+        }
+      ],
+      "properties": {
+        "InstanceId": {
+          "$ref": "#/definitions/InstanceId",
+          "description": "Id of a stateless service instance. InstanceId is used by Service Fabric to uniquely identify an instance of a partition of a stateless service. It is unique within a partition and does not change for the lifetime of the instance. If the instance has failed over on the same or different node, it will get a different value for the InstanceId."
+        }
+      }
+    },
+    "StatelessServiceInstanceHealthState": {
+      "x-ms-discriminator-value": "Stateless",
+      "description": "Represents the health state of the stateless service instance, which contains the instance ID and the aggregated health state.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/ReplicaHealthState"
+        }
+      ],
+      "properties": {
+        "ReplicaId": {
+          "$ref": "#/definitions/ReplicaId",
+          "description": "Id of the stateless service instance on the wire this field is called ReplicaId."
+        }
+      }
+    },
+    "StatelessServicePartitionInfo": {
+      "description": "Information about a partition of a stateless Service Fabric service.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/ServicePartitionInfo"
+        }
+      ],
+      "x-ms-discriminator-value": "Stateless",
+      "properties": {
+        "InstanceCount": {
+          "type": "integer",
+          "format": "int64",
+          "description": "Number of instances of this partition."
+        },
+        "MinInstanceCount": {
+          "$ref": "#/definitions/MinInstanceCount",
+          "description": "MinInstanceCount is the minimum number of instances that must be up to meet the EnsureAvailability safety check during operations like upgrade or deactivate node.\nThe actual number that is used is max( MinInstanceCount, ceil( MinInstancePercentage/100.0 * InstanceCount) ).\nNote, if InstanceCount is set to -1, during MinInstanceCount computation -1 is first converted into the number of nodes on which the instances are allowed to be placed according to the placement constraints on the service."
+        },
+        "MinInstancePercentage": {
+          "$ref": "#/definitions/MinInstancePercentage",
+          "description": "MinInstancePercentage is the minimum percentage of InstanceCount that must be up to meet the EnsureAvailability safety check during operations like upgrade or deactivate node.\nThe actual number that is used is max( MinInstanceCount, ceil( MinInstancePercentage/100.0 * InstanceCount) ).\nNote, if InstanceCount is set to -1, during MinInstancePercentage computation, -1 is first converted into the number of nodes on which the instances are allowed to be placed according to the placement constraints on the service."
+        }
+      }
+    },
+    "StatelessServiceTypeDescription": {
+      "description": "Describes a stateless service type defined in the service manifest of a provisioned application type.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/ServiceTypeDescription"
+        }
+      ],
+      "x-ms-discriminator-value": "Stateless",
+      "properties": {
+        "UseImplicitHost": {
+          "type": "boolean",
+          "description": "A flag indicating if this type is not implemented and hosted by a user service process, but is implicitly hosted by a system created process. This value is true for services using the guest executable services, false otherwise."
+        }
+      }
+    },
+    "SystemApplicationHealthEvaluation": {
+      "x-ms-discriminator-value": "SystemApplication",
+      "description": "Represents health evaluation for the fabric:/System application, containing information about the data and the algorithm used by health store to evaluate health. The evaluation is returned only when the aggregated health state of the cluster is either Error or Warning.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/HealthEvaluation"
+        }
+      ],
+      "properties": {
+        "UnhealthyEvaluations": {
+          "$ref": "#/definitions/UnhealthyEvaluations",
+          "description": "List of unhealthy evaluations that led to the current aggregated health state of the system application. The types of the unhealthy evaluations can be DeployedApplicationsHealthEvaluation, ServicesHealthEvaluation or EventHealthEvaluation."
+        }
+      }
+    },
+    "TargetApplicationName": {
+      "type": "string",
+      "description": "The name of the target application, including the 'fabric:' URI scheme."
+    },
+    "TargetApplicationTypeVersion": {
+      "type": "string",
+      "description": "The target application type version (found in the application manifest) for the application upgrade."
+    },
+    "TargetDeploymentName": {
+      "type": "string",
+      "description": "The name of the target deployment."
+    },
+    "UnhealthyEvaluations": {
+      "description": "List of health evaluations that resulted in the current aggregated health state.",
+      "type": "array",
+      "items": {
+        "$ref": "#/definitions/HealthEvaluationWrapper"
+      }
+    },
+    "UpgradeDomainDeltaNodesCheckHealthEvaluation": {
+      "x-ms-discriminator-value": "UpgradeDomainDeltaNodesCheck",
+      "description": "Represents health evaluation for delta unhealthy cluster nodes in an upgrade domain, containing health evaluations for each unhealthy node that impacted current aggregated health state.\nCan be returned during cluster upgrade when cluster aggregated health state is Warning or Error.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/HealthEvaluation"
+        }
+      ],
+      "properties": {
+        "UpgradeDomainName": {
+          "type": "string",
+          "description": "Name of the upgrade domain where nodes health is currently evaluated."
+        },
+        "BaselineErrorCount": {
+          "type": "integer",
+          "format": "int64",
+          "description": "Number of upgrade domain nodes with aggregated heath state Error in the health store at the beginning of the cluster upgrade."
+        },
+        "BaselineTotalCount": {
+          "type": "integer",
+          "format": "int64",
+          "description": "Total number of upgrade domain nodes in the health store at the beginning of the cluster upgrade."
+        },
+        "MaxPercentDeltaUnhealthyNodes": {
+          "type": "integer",
+          "description": "Maximum allowed percentage of upgrade domain delta unhealthy nodes from the ClusterUpgradeHealthPolicy."
+        },
+        "TotalCount": {
+          "type": "integer",
+          "format": "int64",
+          "description": "Total number of upgrade domain nodes in the health store."
+        },
+        "UnhealthyEvaluations": {
+          "$ref": "#/definitions/UnhealthyEvaluations",
+          "description": "List of unhealthy evaluations that led to the aggregated health state. Includes all the unhealthy NodeHealthEvaluation that impacted the aggregated health."
+        }
+      }
+    },
+    "UpgradeDomainInfo": {
+      "description": "Information about an upgrade domain.",
+      "properties": {
+        "Name": {
+          "$ref": "#/definitions/UpgradeDomainName",
+          "description": "The name of the upgrade domain"
+        },
+        "State": {
+          "$ref": "#/definitions/UpgradeDomainState",
+          "description": "The state of the upgrade domain."
+        }
+      }
+    },
+    "UpgradeDomainInfoList": {
+      "type": "array",
+      "description": "List of upgrade domains and their statuses.",
+      "items": {
+        "$ref": "#/definitions/UpgradeDomainInfo"
+      }
+    },
+    "UpgradeDomainName": {
+      "type": "string",
+      "description": "The name of the upgrade domain"
+    },
+    "UpgradeDomainNodesHealthEvaluation": {
+      "x-ms-discriminator-value": "UpgradeDomainNodes",
+      "description": "Represents health evaluation for cluster nodes in an upgrade domain, containing health evaluations for each unhealthy node that impacted current aggregated health state. Can be returned when evaluating cluster health during cluster upgrade and the aggregated health state is either Error or Warning.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/HealthEvaluation"
+        }
+      ],
+      "properties": {
+        "UpgradeDomainName": {
+          "type": "string",
+          "description": "Name of the upgrade domain where nodes health is currently evaluated."
+        },
+        "MaxPercentUnhealthyNodes": {
+          "type": "integer",
+          "description": "Maximum allowed percentage of unhealthy nodes from the ClusterHealthPolicy."
+        },
+        "TotalCount": {
+          "type": "integer",
+          "format": "int64",
+          "description": "Total number of nodes in the current upgrade domain."
+        },
+        "UnhealthyEvaluations": {
+          "$ref": "#/definitions/UnhealthyEvaluations",
+          "description": "List of unhealthy evaluations that led to the aggregated health state. Includes all the unhealthy NodeHealthEvaluation that impacted the aggregated health."
+        }
+      }
+    },
+    "UpgradeDomainState": {
+      "type": "string",
+      "description": "The state of the upgrade domain.",
+      "enum": [
+        "Invalid",
+        "Pending",
+        "InProgress",
+        "Completed"
+      ],
+      "x-ms-enum": {
+        "name": "UpgradeDomainState",
+        "modelAsString": true,
+        "values": [
+          {
+            "value": "Invalid",
+            "description": "Indicates the upgrade domain state is invalid. All Service Fabric enumerations have the invalid type. The value is zero."
+          },
+          {
+            "value": "Pending",
+            "description": "The upgrade domain has not started upgrading yet. The value is 1"
+          },
+          {
+            "value": "InProgress",
+            "description": "The upgrade domain is being upgraded but not complete yet. The value is 2"
+          },
+          {
+            "value": "Completed",
+            "description": "The upgrade domain has completed upgrade. The value is 3"
+          }
+        ]
+      }
+    },
+    "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"
+    },
+    "UpgradeDuration": {
+      "type": "string",
+      "description": "The estimated amount of time that the overall upgrade elapsed. 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"
+    },
+    "UpgradeKind": {
+      "type": "string",
+      "description": "The kind of upgrade out of the following possible values.",
+      "default": "Rolling",
+      "enum": [
+        "Invalid",
+        "Rolling"
+      ],
+      "x-ms-enum": {
+        "name": "UpgradeKind",
+        "modelAsString": true,
+        "values": [
+          {
+            "value": "Invalid",
+            "description": "Indicates the upgrade kind is invalid. All Service Fabric enumerations have the invalid type. The value is zero."
+          },
+          {
+            "value": "Rolling",
+            "description": "The upgrade progresses one upgrade domain at a time. The value is 1"
+          }
+        ]
+      }
+    },
+    "UpgradeMode": {
+      "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": "UnmonitoredAuto",
+      "x-ms-enum": {
+        "name": "UpgradeMode",
+        "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"
+          }
+        ]
+      }
+    },
+    "UpgradeSortOrder": {
+      "type": "string",
+      "description": "Defines the order in which an upgrade proceeds through the cluster.",
+      "enum": [
+        "Invalid",
+        "Default",
+        "Numeric",
+        "Lexicographical",
+        "ReverseNumeric",
+        "ReverseLexicographical"
+      ],
+      "default": "Default",
+      "x-ms-enum": {
+        "name": "UpgradeSortOrder",
+        "modelAsString": true,
+        "values": [
+          {
+            "value": "Invalid",
+            "description": "Indicates that this sort order is not valid. All Service Fabric enumerations have the invalid type. The value is 0."
+          },
+          {
+            "value": "Default",
+            "description": "Indicates that the default sort order (as specified in cluster manifest) will be used. The value is 1."
+          },
+          {
+            "value": "Numeric",
+            "description": "Indicates that forward numeric sort order (UD names sorted as numbers) will be used. The value is 2."
+          },
+          {
+            "value": "Lexicographical",
+            "description": "Indicates that forward lexicographical sort order (UD names sorted as strings) will be used. The value is 3."
+          },
+          {
+            "value": "ReverseNumeric",
+            "description": "Indicates that reverse numeric sort order (UD names sorted as numbers) will be used. The value is 4."
+          },
+          {
+            "value": "ReverseLexicographical",
+            "description": "Indicates that reverse lexicographical sort order (UD names sorted as strings) will be used. The value is 5."
+          }
+        ]
+      }
+    },
+    "UpgradeType": {
+      "type": "string",
+      "description": "The type of upgrade out of the following possible values.",
+      "default": "Rolling",
+      "enum": [
+        "Invalid",
+        "Rolling",
+        "Rolling_ForceRestart"
+      ],
+      "x-ms-enum": {
+        "name": "UpgradeType",
+        "modelAsString": true,
+        "values": [
+          {
+            "value": "Invalid",
+            "description": "Indicates the upgrade kind is invalid. All Service Fabric enumerations have the invalid type. The value is zero."
+          },
+          {
+            "value": "Rolling",
+            "description": "The upgrade progresses one upgrade domain at a time. The value is 1."
+          },
+          {
+            "value": "Rolling_ForceRestart",
+            "description": "The upgrade gets restarted by force. The value is 2."
+          }
+        ]
+      }
+    },
+    "UpgradeReplicaSetCheckTimeout": {
+      "type": "integer",
+      "format": "int64",
+      "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).",
+      "default": 42949672925
+    },
+    "UpgradeState": {
+      "type": "string",
+      "description": "The state of the upgrade domain.",
+      "enum": [
+        "Invalid",
+        "RollingBackInProgress",
+        "RollingBackCompleted",
+        "RollingForwardPending",
+        "RollingForwardInProgress",
+        "RollingForwardCompleted",
+        "Failed"
+      ],
+      "x-ms-enum": {
+        "name": "UpgradeState",
+        "modelAsString": true,
+        "values": [
+          {
+            "value": "Invalid",
+            "description": "Indicates the upgrade state is invalid. All Service Fabric enumerations have the invalid type. The value is zero."
+          },
+          {
+            "value": "RollingBackInProgress",
+            "description": "The upgrade is rolling back to the previous version but is not complete yet. The value is 1"
+          },
+          {
+            "value": "RollingBackCompleted",
+            "description": "The upgrade has finished rolling back. The value is 2"
+          },
+          {
+            "value": "RollingForwardPending",
+            "description": "The current upgrade domain has finished upgrading. The overall upgrade is waiting for an explicit move next request in UnmonitoredManual mode or performing health checks in Monitored mode. The value is 3"
+          },
+          {
+            "value": "RollingForwardInProgress",
+            "description": "The upgrade is rolling forward to the target version but is not complete yet. The value is 4"
+          },
+          {
+            "value": "RollingForwardCompleted",
+            "description": "The upgrade has finished rolling forward. The value is 5"
+          },
+          {
+            "value": "Failed",
+            "description": "The upgrade has failed and is unable to execute FailureAction. The value is 6"
+          }
+        ]
+      }
+    },
+    "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"
+    },
+    "WaitForInbuildReplicaSafetyCheck": {
+      "description": "Safety check that waits for the replica build operation to finish. This indicates that there is a replica that is going through the copy or is providing data for building another replica. Bring the node down will abort this copy operation which are typically expensive involving data movements.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/PartitionSafetyCheck"
+        }
+      ],
+      "x-ms-discriminator-value": "WaitForInbuildReplica"
+    },
+    "WaitForPrimaryPlacementSafetyCheck": {
+      "description": "Safety check that waits for the primary replica that was moved out of the node due to upgrade to be placed back again on that node.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/PartitionSafetyCheck"
+        }
+      ],
+      "x-ms-discriminator-value": "WaitForPrimaryPlacement"
+    },
+    "WaitForPrimarySwapSafetyCheck": {
+      "description": "Safety check that waits for the primary replica to be moved out of the node before starting an upgrade to ensure the availability of the primary replica for the partition.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/PartitionSafetyCheck"
+        }
+      ],
+      "x-ms-discriminator-value": "WaitForPrimarySwap"
+    },
+    "WaitForReconfigurationSafetyCheck": {
+      "description": "Safety check that waits for the current reconfiguration of the partition to be completed before starting an upgrade.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/PartitionSafetyCheck"
+        }
+      ],
+      "x-ms-discriminator-value": "WaitForReconfiguration"
+    },
+    "LoadMetricReport": {
+      "description": "Represents the load metric report which contains the time metric was reported, its name and value.",
+      "properties": {
+        "LastReportedUtc": {
+          "type": "string",
+          "format": "date-time",
+          "description": "Gets the UTC time when the load was reported."
+        },
+        "Name": {
+          "type": "string",
+          "description": "The name of the load metric."
+        },
+        "Value": {
+          "type": "string",
+          "format": "int32",
+          "description": "The value of the load metric. In future releases of Service Fabric this parameter will be deprecated in favor of CurrentValue."
+        },
+        "CurrentValue": {
+          "type": "string",
+          "format": "double",
+          "description": "The value of the load metric."
+        }
+      }
+    },
+    "PartitionLoadInformation": {
+      "description": "Represents load information for a partition, which contains the primary and secondary reported load metrics.\nIn case there is no load reported, PartitionLoadInformation will contain the default load for the service of the partition.\nFor default loads, LoadMetricReport's LastReportedUtc is set to 0.",
+      "properties": {
+        "PartitionId": {
+          "$ref": "#/definitions/PartitionId",
+          "description": "Id of the partition."
+        },
+        "PrimaryLoadMetricReports": {
+          "type": "array",
+          "description": "Array of load reports from the primary replica for this partition.",
+          "items": {
+            "$ref": "#/definitions/LoadMetricReport"
+          }
+        },
+        "SecondaryLoadMetricReports": {
+          "type": "array",
+          "description": "Array of aggregated load reports from all secondary replicas for this partition.\nArray only contains the latest reported load for each metric.",
+          "items": {
+            "$ref": "#/definitions/LoadMetricReport"
+          }
+        }
+      }
+    },
+    "StatefulServiceReplicaInfo": {
+      "x-ms-discriminator-value": "Stateful",
+      "description": "Represents a stateful service replica. This includes information about the identity, role, status, health, node name, uptime, and other details about the replica.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/ReplicaInfo"
+        }
+      ],
+      "properties": {
+        "ReplicaRole": {
+          "$ref": "#/definitions/ReplicaRole",
+          "description": "The role of a replica of a stateful service."
+        },
+        "ReplicaId": {
+          "$ref": "#/definitions/ReplicaId",
+          "description": "Id of a stateful service replica. ReplicaId is used by Service Fabric to uniquely identify a replica of a partition. It is unique within a partition and does not change for the lifetime of the replica. If a replica gets dropped and another replica gets created on the same node for the same partition, it will get a different value for the id. Sometimes the id of a stateless service instance is also referred as a replica id."
+        }
+      }
+    },
+    "StatelessServiceInstanceInfo": {
+      "x-ms-discriminator-value": "Stateless",
+      "description": "Represents a stateless service instance. This includes information about the identity, status, health, node name, uptime, and other details about the instance.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/ReplicaInfo"
+        }
+      ],
+      "properties": {
+        "InstanceId": {
+          "$ref": "#/definitions/InstanceId",
+          "description": "Id of a stateless service instance. InstanceId is used by Service Fabric to uniquely identify an instance of a partition of a stateless service. It is unique within a partition and does not change for the lifetime of the instance. If the instance has failed over on the same or different node, it will get a different value for the InstanceId."
+        }
+      }
+    },
+    "ClusterFabricCodeVersionString": {
+      "type": "string",
+      "description": "The ServiceFabric code version of the cluster."
+    },
+    "ClusterFabricConfigVersionString": {
+      "type": "string",
+      "description": "The cluster configuration version (specified in the cluster manifest)."
+    },
+    "ClusterUpgradeDescriptionObject": {
+      "description": "Represents a ServiceFabric cluster upgrade",
+      "properties": {
+        "ConfigVersion": {
+          "$ref": "#/definitions/ClusterFabricConfigVersionString",
+          "description": "The cluster configuration version (specified in the cluster manifest)."
+        },
+        "CodeVersion": {
+          "$ref": "#/definitions/ClusterFabricCodeVersionString",
+          "description": "The ServiceFabric code version of the cluster."
+        },
+        "UpgradeKind": {
+          "$ref": "#/definitions/UpgradeKind",
+          "description": "The kind of upgrade out of the following possible values."
+        },
+        "RollingUpgradeMode": {
+          "$ref": "#/definitions/UpgradeMode",
+          "description": "The mode used to monitor health during a rolling upgrade. The values are UnmonitoredAuto, UnmonitoredManual, and Monitored."
+        },
+        "UpgradeReplicaSetCheckTimeoutInSeconds": {
+          "$ref": "#/definitions/UpgradeReplicaSetCheckTimeout",
+          "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)."
+        },
+        "SortOrder": {
+          "$ref": "#/definitions/UpgradeSortOrder",
+          "description": "Defines the order in which an upgrade proceeds through the cluster."
+        },
+        "EnableDeltaHealthEvaluation": {
+          "$ref": "#/definitions/DeltaHealthEvaluationBool",
+          "description": "When true, enables delta health evaluation rather than absolute health evaluation after completion of each upgrade domain."
+        },
+        "MonitoringPolicy": {
+          "$ref": "#/definitions/MonitoringPolicyDescription",
+          "description": "Describes the parameters for monitoring an upgrade in Monitored mode."
+        },
+        "ClusterHealthPolicy": {
+          "$ref": "#/definitions/ClusterHealthPolicy",
+          "description": "Defines a health policy used to evaluate the health of the cluster or of a cluster node."
+        },
+        "ClusterUpgradeHealthPolicy": {
+          "$ref": "#/definitions/ClusterUpgradeHealthPolicyObject",
+          "description": "Defines a health policy used to evaluate the health of the cluster during a cluster upgrade."
+        },
+        "ApplicationHealthPolicyMap": {
+          "$ref": "#/definitions/ApplicationHealthPolicyMapObject",
+          "description": "Represents the map of application health policies for a ServiceFabric cluster upgrade"
+        }
+      }
+    },
+    "ClusterUpgradeHealthPolicyObject": {
+      "description": "Defines a health policy used to evaluate the health of the cluster during a cluster upgrade.",
+      "properties": {
+        "MaxPercentDeltaUnhealthyNodes": {
+          "type": "integer",
+          "description": "The maximum allowed percentage of nodes health degradation allowed during cluster upgrades. The 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. The check is performed after every upgrade domain upgrade completion to make sure the global state of the cluster is within tolerated limits. The default value is 10%.",
+          "maximum": 100,
+          "minimum": 0
+        },
+        "MaxPercentUpgradeDomainDeltaUnhealthyNodes": {
+          "type": "integer",
+          "description": "The maximum allowed percentage of upgrade domain nodes health degradation allowed during cluster upgrades. The 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. The 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. The default value is 15%.",
+          "maximum": 100,
+          "minimum": 0
+        }
+      }
+    },
+    "ClusterUpgradeProgressObject": {
+      "description": "Information about a cluster upgrade.",
+      "properties": {
+        "CodeVersion": {
+          "$ref": "#/definitions/ClusterFabricCodeVersionString",
+          "description": "The ServiceFabric code version of the cluster."
+        },
+        "ConfigVersion": {
+          "$ref": "#/definitions/ClusterFabricConfigVersionString",
+          "description": "The cluster configuration version (specified in the cluster manifest)."
+        },
+        "UpgradeDomains": {
+          "$ref": "#/definitions/UpgradeDomainInfoList",
+          "description": "List of upgrade domains and their statuses."
+        },
+        "UpgradeState": {
+          "$ref": "#/definitions/UpgradeState",
+          "description": "The state of the upgrade domain."
+        },
+        "NextUpgradeDomain": {
+          "$ref": "#/definitions/NextUpgradeDomain",
+          "description": "The name of the next upgrade domain to be processed."
+        },
+        "RollingUpgradeMode": {
+          "$ref": "#/definitions/UpgradeMode",
+          "description": "The mode used to monitor health during a rolling upgrade. The values are UnmonitoredAuto, UnmonitoredManual, and Monitored."
+        },
+        "UpgradeDescription": {
+          "$ref": "#/definitions/ClusterUpgradeDescriptionObject",
+          "description": "Represents a ServiceFabric cluster upgrade"
+        },
+        "UpgradeDurationInMilliseconds": {
+          "$ref": "#/definitions/UpgradeDurationString",
+          "description": "The estimated elapsed time spent processing the current overall upgrade."
+        },
+        "UpgradeDomainDurationInMilliseconds": {
+          "$ref": "#/definitions/UpgradeDomainDurationString",
+          "description": "The estimated elapsed time spent processing the current upgrade domain."
+        },
+        "UnhealthyEvaluations": {
+          "$ref": "#/definitions/UnhealthyEvaluations",
+          "description": "List of health evaluations that resulted in the current aggregated health state."
+        },
+        "CurrentUpgradeDomainProgress": {
+          "$ref": "#/definitions/CurrentUpgradeDomainProgressInfo",
+          "description": "Information about the current in-progress upgrade domain."
+        },
+        "StartTimestampUtc": {
+          "$ref": "#/definitions/UpgradeStartTimeUTCString",
+          "description": "The start time of the upgrade in UTC."
+        },
+        "FailureTimestampUtc": {
+          "$ref": "#/definitions/UpgradeFailureTimeUTCString",
+          "description": "The failure time of the upgrade in UTC."
+        },
+        "FailureReason": {
+          "$ref": "#/definitions/FailureReason",
+          "description": "The cause of an upgrade failure that resulted in FailureAction being executed."
+        },
+        "UpgradeDomainProgressAtFailure": {
+          "$ref": "#/definitions/FailedUpgradeDomainProgressObject",
+          "description": "The detailed upgrade progress for nodes in the current upgrade domain at the point of failure."
+        }
+      }
+    },
+    "ClusterConfigurationUpgradeDescription": {
+      "description": "Describes the parameters for a standalone cluster configuration upgrade.",
+      "properties": {
+        "ClusterConfig": {
+          "type": "string",
+          "description": "The cluster configuration as a JSON string. For example, [this file](https://github.com/Azure-Samples/service-fabric-dotnet-standalone-cluster-configuration/blob/master/Samples/ClusterConfig.Unsecure.DevCluster.json) contains JSON describing the [nodes and other properties of the cluster](https://docs.microsoft.com/azure/service-fabric/service-fabric-cluster-manifest)."
+        },
+        "HealthCheckRetryTimeout": {
+          "type": "string",
+          "format": "duration",
+          "description": "The length of time between attempts to perform health checks if the application or cluster is not healthy.",
+          "default": "PT0H0M0S"
+        },
+        "HealthCheckWaitDurationInSeconds": {
+          "type": "string",
+          "format": "duration",
+          "description": "The length of time to wait after completing an upgrade domain before starting the health checks process.",
+          "default": "PT0H0M0S"
+        },
+        "HealthCheckStableDurationInSeconds": {
+          "type": "string",
+          "format": "duration",
+          "description": "The length of time that the application or cluster must remain healthy before the upgrade proceeds to the next upgrade domain.",
+          "default": "PT0H0M0S"
+        },
+        "UpgradeDomainTimeoutInSeconds": {
+          "type": "string",
+          "format": "duration",
+          "description": "The timeout for the upgrade domain.",
+          "default": "PT0H0M0S"
+        },
+        "UpgradeTimeoutInSeconds": {
+          "type": "string",
+          "format": "duration",
+          "description": "The upgrade timeout.",
+          "default": "PT0H0M0S"
+        },
+        "MaxPercentUnhealthyApplications": {
+          "type": "integer",
+          "description": "The maximum allowed percentage of unhealthy applications during the upgrade. Allowed values are integer values from zero to 100.",
+          "default": 0
+        },
+        "MaxPercentUnhealthyNodes": {
+          "type": "integer",
+          "description": "The maximum allowed percentage of unhealthy nodes during the upgrade. Allowed values are integer values from zero to 100.",
+          "default": 0
+        },
+        "MaxPercentDeltaUnhealthyNodes": {
+          "type": "integer",
+          "description": "The maximum allowed percentage of delta health degradation during the upgrade. Allowed values are integer values from zero to 100.",
+          "default": 0
+        },
+        "MaxPercentUpgradeDomainDeltaUnhealthyNodes": {
+          "type": "integer",
+          "description": "The maximum allowed percentage of upgrade domain delta health degradation during the upgrade. Allowed values are integer values from zero to 100.",
+          "default": 0
+        },
+        "ApplicationHealthPolicies": {
+          "$ref": "#/definitions/ApplicationHealthPolicies",
+          "description": "Defines the application health policy map used to evaluate the health of an application or one of its children entities."
+        }
+      },
+      "required": [
+        "ClusterConfig"
+      ]
+    },
+    "DeltaHealthEvaluationBool": {
+      "type": "boolean",
+      "description": "When true, enables delta health evaluation rather than absolute health evaluation after completion of each upgrade domain."
+    },
+    "FailedUpgradeDomainProgressObject": {
+      "description": "The detailed upgrade progress for nodes in the current upgrade domain at the point of failure.",
+      "properties": {
+        "DomainName": {
+          "$ref": "#/definitions/UpgradeDomainName",
+          "description": "The name of the upgrade domain"
+        },
+        "NodeUpgradeProgressList": {
+          "$ref": "#/definitions/NodeUpgradeProgressInfoList",
+          "description": "List of upgrading nodes and their statuses"
+        }
+      }
+    },
+    "UpgradeDomainDurationString": {
+      "type": "string",
+      "description": "The estimated elapsed time spent processing the current upgrade domain."
+    },
+    "UpgradeDurationString": {
+      "type": "string",
+      "description": "The estimated elapsed time spent processing the current overall upgrade."
+    },
+    "UpgradeFailureTimeUTCString": {
+      "type": "string",
+      "description": "The failure time of the upgrade in UTC."
+    },
+    "UpgradeStartTimeUTCString": {
+      "type": "string",
+      "description": "The start time of the upgrade in UTC."
+    },
+    "UpgradeOrchestrationServiceState": {
+      "description": "Service state of Service Fabric Upgrade Orchestration Service.",
+      "properties": {
+        "ServiceState": {
+          "type": "string",
+          "description": "The state of Service Fabric Upgrade Orchestration Service."
+        }
+      }
+    },
+    "UpgradeOrchestrationServiceStateSummary": {
+      "description": "Service state summary of Service Fabric Upgrade Orchestration Service.",
+      "properties": {
+        "CurrentCodeVersion": {
+          "type": "string",
+          "description": "The current code version of the cluster."
+        },
+        "CurrentManifestVersion": {
+          "type": "string",
+          "description": "The current manifest version of the cluster."
+        },
+        "TargetCodeVersion": {
+          "type": "string",
+          "description": "The target code version of  the cluster."
+        },
+        "TargetManifestVersion": {
+          "type": "string",
+          "description": "The target manifest version of the cluster."
+        },
+        "PendingUpgradeType": {
+          "type": "string",
+          "description": "The type of the pending upgrade of the cluster."
+        }
+      }
+    },
+    "ApplicationTypeImageStorePath": {
+      "description": "Path description for the application package in the image store specified during the prior copy operation.",
+      "required": [
+        "ApplicationTypeBuildPath"
+      ],
+      "properties": {
+        "ApplicationTypeBuildPath": {
+          "type": "string",
+          "description": "The relative image store path to the application package."
+        }
+      }
+    },
+    "UnprovisionApplicationTypeDescriptionInfo": {
+      "description": "Describes the operation to unregister or unprovision an application type and its version that was registered with the Service Fabric.",
+      "required": [
+        "ApplicationTypeVersion"
+      ],
+      "properties": {
+        "ApplicationTypeVersion": {
+          "$ref": "#/definitions/ApplicationTypeVersion",
+          "description": "The version of the application type as defined in the application manifest."
+        },
+        "Async": {
+          "type": "boolean",
+          "description": "The flag indicating whether or not unprovision should occur asynchronously. When set to true, the unprovision operation returns when the request is accepted by the system, and the unprovision operation continues without any timeout limit. The default value is false. However, we recommend setting it to true for large application packages that were provisioned."
+        }
+      }
+    },
+    "CodePackageName": {
+      "type": "string",
+      "description": "The name of the code package defined in the service manifest."
+    },
+    "CodePackageEntryPointStatistics": {
+      "description": "Statistics about setup or main entry point  of a code package deployed on a Service Fabric node.",
+      "properties": {
+        "LastExitCode": {
+          "type": "string",
+          "description": "The last exit code of the entry point."
+        },
+        "LastActivationTime": {
+          "type": "string",
+          "format": "date-time",
+          "description": "The last time (in UTC) when Service Fabric attempted to run the entry point."
+        },
+        "LastExitTime": {
+          "type": "string",
+          "format": "date-time",
+          "description": "The last time (in UTC) when the entry point finished running."
+        },
+        "LastSuccessfulActivationTime": {
+          "type": "string",
+          "format": "date-time",
+          "description": "The last time (in UTC) when the entry point ran successfully."
+        },
+        "LastSuccessfulExitTime": {
+          "type": "string",
+          "format": "date-time",
+          "description": "The last time (in UTC) when the entry point finished running gracefully."
+        },
+        "ActivationCount": {
+          "type": "string",
+          "description": "Number of times the entry point has run."
+        },
+        "ActivationFailureCount": {
+          "type": "string",
+          "description": "Number of times the entry point failed to run."
+        },
+        "ContinuousActivationFailureCount": {
+          "type": "string",
+          "description": "Number of times the entry point continuously failed to run."
+        },
+        "ExitCount": {
+          "type": "string",
+          "description": "Number of times the entry point finished running."
+        },
+        "ExitFailureCount": {
+          "type": "string",
+          "description": "Number of times the entry point failed to exit gracefully."
+        },
+        "ContinuousExitFailureCount": {
+          "type": "string",
+          "description": "Number of times the entry point continuously failed to exit gracefully."
+        }
+      }
+    },
+    "DeployedCodePackageInfoList": {
+      "type": "array",
+      "items": {
+        "$ref": "#/definitions/DeployedCodePackageInfo"
+      },
+      "description": "List of deployed code package information."
+    },
+    "DeployedCodePackageInfo": {
+      "description": "Information about code package deployed on a Service Fabric node.",
+      "properties": {
+        "Name": {
+          "$ref": "#/definitions/CodePackageName",
+          "description": "The name of the code package."
+        },
+        "Version": {
+          "type": "string",
+          "description": "The version of the code package specified in service manifest."
+        },
+        "ServiceManifestName": {
+          "$ref": "#/definitions/ServiceManifestName",
+          "description": "The name of service manifest that specified this code package."
+        },
+        "ServicePackageActivationId": {
+          "$ref": "#/definitions/ServicePackageActivationId",
+          "description": "The ActivationId of a deployed service package. If ServicePackageActivationMode specified at the time of creating the service\nis 'SharedProcess' (or if it is not specified, in which case it defaults to 'SharedProcess'), then value of ServicePackageActivationId\nis always an empty string."
+        },
+        "HostType": {
+          "$ref": "#/definitions/HostType",
+          "description": "Specifies the type of host for main entry point of a code package as specified in service manifest."
+        },
+        "HostIsolationMode": {
+          "$ref": "#/definitions/HostIsolationMode",
+          "description": "Specifies the isolation mode of main entry point of a code package when it's host type is ContainerHost. This is specified as part of container host policies in application manifest while importing service manifest."
+        },
+        "Status": {
+          "$ref": "#/definitions/DeploymentStatus",
+          "description": "Specifies the status of a deployed application or service package on a Service Fabric node."
+        },
+        "RunFrequencyInterval": {
+          "type": "string",
+          "description": "The interval at which code package is run. This is used for periodic code package."
+        },
+        "SetupEntryPoint": {
+          "$ref": "#/definitions/CodePackageEntryPoint",
+          "description": "Information about setup or main entry point of a code package deployed on a Service Fabric node."
+        },
+        "MainEntryPoint": {
+          "$ref": "#/definitions/CodePackageEntryPoint",
+          "description": "Information about setup or main entry point of a code package deployed on a Service Fabric node."
+        }
+      }
+    },
+    "DeploymentStatus": {
+      "type": "string",
+      "description": "Specifies the status of a deployed application or service package on a Service Fabric node.",
+      "enum": [
+        "Invalid",
+        "Downloading",
+        "Activating",
+        "Active",
+        "Upgrading",
+        "Deactivating",
+        "RanToCompletion",
+        "Failed"
+      ],
+      "x-ms-enum": {
+        "name": "DeploymentStatus",
+        "modelAsString": true,
+        "values": [
+          {
+            "value": "Invalid",
+            "description": "Indicates status of the application or service package is not known or invalid. The value is 0."
+          },
+          {
+            "value": "Downloading",
+            "description": "Indicates the application or service package is being downloaded to the node from the ImageStore. The value is 1."
+          },
+          {
+            "value": "Activating",
+            "description": "Indicates the application or service package is being activated. The value is 2."
+          },
+          {
+            "value": "Active",
+            "description": "Indicates the application or service package is active the node. The value is 3."
+          },
+          {
+            "value": "Upgrading",
+            "description": "Indicates the application or service package is being upgraded. The value is 4."
+          },
+          {
+            "value": "Deactivating",
+            "description": "Indicates the application or service package is being deactivated. The value is 5."
+          },
+          {
+            "value": "RanToCompletion",
+            "description": "Indicates the application or service package has ran to completion successfully. The value is 6."
+          },
+          {
+            "value": "Failed",
+            "description": "Indicates the application or service package has failed to run to completion. The value is 7."
+          }
+        ]
+      }
+    },
+    "EntryPointStatus": {
+      "type": "string",
+      "description": "Specifies the status of the code package entry point deployed on a Service Fabric node.",
+      "enum": [
+        "Invalid",
+        "Pending",
+        "Starting",
+        "Started",
+        "Stopping",
+        "Stopped"
+      ],
+      "x-ms-enum": {
+        "name": "EntryPointStatus",
+        "modelAsString": true,
+        "values": [
+          {
+            "value": "Invalid",
+            "description": "Indicates status of entry point is not known or invalid. The value is 0."
+          },
+          {
+            "value": "Pending",
+            "description": "Indicates the entry point is scheduled to be started. The value is 1."
+          },
+          {
+            "value": "Starting",
+            "description": "Indicates the entry point is being started. The value is 2."
+          },
+          {
+            "value": "Started",
+            "description": "Indicates the entry point was started successfully and is running. The value is 3."
+          },
+          {
+            "value": "Stopping",
+            "description": "Indicates the entry point is being stopped. The value is 4."
+          },
+          {
+            "value": "Stopped",
+            "description": "Indicates the entry point is not running. The value is 5."
+          }
+        ]
+      }
+    },
+    "CodePackageEntryPoint": {
+      "description": "Information about setup or main entry point of a code package deployed on a Service Fabric node.",
+      "properties": {
+        "EntryPointLocation": {
+          "type": "string",
+          "description": "The location of entry point executable on the node."
+        },
+        "ProcessId": {
+          "type": "string",
+          "description": "The process ID of the entry point."
+        },
+        "RunAsUserName": {
+          "type": "string",
+          "description": "The user name under which entry point executable is run on the node."
+        },
+        "CodePackageEntryPointStatistics": {
+          "$ref": "#/definitions/CodePackageEntryPointStatistics",
+          "description": "Statistics about setup or main entry point  of a code package deployed on a Service Fabric node."
+        },
+        "Status": {
+          "$ref": "#/definitions/EntryPointStatus",
+          "description": "Specifies the status of the code package entry point deployed on a Service Fabric node."
+        },
+        "NextActivationTime": {
+          "type": "string",
+          "format": "date-time",
+          "description": "The time (in UTC) when the entry point executable will be run next."
+        },
+        "InstanceId": {
+          "$ref": "#/definitions/CodePackageInstanceId",
+          "description": "The instance ID for current running entry point. For a code package setup entry point (if specified) runs first and after it finishes main entry point is started. Each time entry point executable is run, its instance id will change."
+        }
+      }
+    },
+    "Chaos": {
+      "description": "Contains a description of Chaos.",
+      "properties": {
+        "ChaosParameters": {
+          "$ref": "#/definitions/ChaosParameters",
+          "description": "If Chaos is running, these are the parameters Chaos is running with."
+        },
+        "Status": {
+          "$ref": "#/definitions/ChaosStatus",
+          "description": "Current status of the Chaos run."
+        },
+        "ScheduleStatus": {
+          "$ref": "#/definitions/ChaosScheduleStatus",
+          "description": "Current status of the schedule."
+        }
+      }
+    },
+    "ChaosStatus": {
+      "type": "string",
+      "description": "Current status of the Chaos run.",
+      "enum": [
+        "Invalid",
+        "Running",
+        "Stopped"
+      ],
+      "x-ms-enum": {
+        "name": "ChaosStatus",
+        "modelAsString": true,
+        "values": [
+          {
+            "value": "Invalid",
+            "description": "Indicates an invalid Chaos status. All Service Fabric enumerations have the invalid type. The value is zero."
+          },
+          {
+            "value": "Running",
+            "description": "Indicates that Chaos is not stopped. The value is one."
+          },
+          {
+            "value": "Stopped",
+            "description": "Indicates that Chaos is not scheduling further faults. The value is two."
+          }
+        ]
+      }
+    },
+    "ChaosScheduleStatus": {
+      "type": "string",
+      "description": "Current status of the schedule.",
+      "enum": [
+        "Invalid",
+        "Stopped",
+        "Active",
+        "Expired",
+        "Pending"
+      ],
+      "x-ms-enum": {
+        "name": "ChaosScheduleStatus",
+        "modelAsString": true,
+        "values": [
+          {
+            "value": "Invalid",
+            "description": "Indicates an invalid Chaos Schedule status. All Service Fabric enumerations have the invalid type. The value is zero."
+          },
+          {
+            "value": "Stopped",
+            "description": "Indicates that the schedule is stopped and not being used to schedule runs of chaos. The value is one."
+          },
+          {
+            "value": "Active",
+            "description": "Indicates that the schedule is active and is being used to schedule runs of Chaos. The value is two."
+          },
+          {
+            "value": "Expired",
+            "description": "Indicates that the schedule is expired and will no longer be used to schedule runs of Chaos. The value is three."
+          },
+          {
+            "value": "Pending",
+            "description": "Indicates that the schedule is pending and is not yet being used to schedule runs of Chaos but will be used when the start time is passed. The value is four."
+          }
+        ]
+      }
+    },
+    "ChaosContextMap": {
+      "additionalProperties": {
+        "type": "string"
+      },
+      "description": "Describes a map that contains a collection of ChaosContextMapItem's."
+    },
+    "ChaosContext": {
+      "description": "Describes a map, which is a collection of (string, string) type key-value pairs. The map can be used to record information about\nthe Chaos run. There cannot be more than 100 such pairs and each string (key or value) can be at most 4095 characters long.\nThis map is set by the starter of the Chaos run to optionally store the context about the specific run.",
+      "properties": {
+        "Map": {
+          "$ref": "#/definitions/ChaosContextMap",
+          "description": "Describes a map that contains a collection of ChaosContextMapItem's."
+        }
+      }
+    },
+    "ChaosParameters": {
+      "description": "Defines all the parameters to configure a Chaos run.",
+      "properties": {
+        "TimeToRunInSeconds": {
+          "type": "string",
+          "description": "Total time (in seconds) for which Chaos will run before automatically stopping. The maximum allowed value is 4,294,967,295 (System.UInt32.MaxValue).",
+          "default": "4294967295"
+        },
+        "MaxClusterStabilizationTimeoutInSeconds": {
+          "type": "integer",
+          "format": "int64",
+          "description": "The maximum amount of time to wait for all cluster entities to become stable and healthy. Chaos executes in iterations and at the start of each iteration it validates the health of cluster entities.\nDuring validation if a cluster entity is not stable and healthy within MaxClusterStabilizationTimeoutInSeconds, Chaos generates a validation failed event.",
+          "default": 60,
+          "minimum": 0,
+          "maximum": 4294967295
+        },
+        "MaxConcurrentFaults": {
+          "type": "integer",
+          "format": "int64",
+          "description": "MaxConcurrentFaults is the maximum number of concurrent faults induced per iteration.\nChaos executes in iterations and two consecutive iterations are separated by a validation phase.\nThe higher the concurrency, the more aggressive the injection of faults, leading to inducing more complex series of states to uncover bugs.\nThe recommendation is to start with a value of 2 or 3 and to exercise caution while moving up.",
+          "default": 1,
+          "minimum": 0,
+          "maximum": 4294967295
+        },
+        "EnableMoveReplicaFaults": {
+          "type": "boolean",
+          "description": "Enables or disables the move primary and move secondary faults.",
+          "default": true
+        },
+        "WaitTimeBetweenFaultsInSeconds": {
+          "type": "integer",
+          "format": "int64",
+          "description": "Wait time (in seconds) between consecutive faults within a single iteration.\nThe larger the value, the lower the overlapping between faults and the simpler the sequence of state transitions that the cluster goes through.\nThe recommendation is to start with a value between 1 and 5 and exercise caution while moving up.",
+          "default": 20,
+          "minimum": 0,
+          "maximum": 4294967295
+        },
+        "WaitTimeBetweenIterationsInSeconds": {
+          "type": "integer",
+          "format": "int64",
+          "description": "Time-separation (in seconds) between two consecutive iterations of Chaos.\nThe larger the value, the lower the fault injection rate.",
+          "default": 30,
+          "minimum": 0,
+          "maximum": 4294967295
+        },
+        "ClusterHealthPolicy": {
+          "$ref": "#/definitions/ClusterHealthPolicy",
+          "description": "Passed-in cluster health policy is used to validate health of the cluster in between Chaos iterations. If the cluster health is in error or if an unexpected exception happens during fault execution--to provide the cluster with some time to recuperate--Chaos will wait for 30 minutes before the next health-check."
+        },
+        "Context": {
+          "$ref": "#/definitions/ChaosContext",
+          "description": "Describes a map, which is a collection of (string, string) type key-value pairs. The map can be used to record information about\nthe Chaos run. There cannot be more than 100 such pairs and each string (key or value) can be at most 4095 characters long.\nThis map is set by the starter of the Chaos run to optionally store the context about the specific run."
+        },
+        "ChaosTargetFilter": {
+          "$ref": "#/definitions/ChaosTargetFilter",
+          "description": "List of cluster entities to target for Chaos faults.\nThis filter can be used to target Chaos faults only to certain node types or only to certain application instances. If ChaosTargetFilter is not used, Chaos faults all cluster entities.\nIf ChaosTargetFilter is used, Chaos faults only the entities that meet the ChaosTargetFilter specification."
+        }
+      }
+    },
+    "ChaosParametersDictionaryItem": {
+      "description": "Defines an item in ChaosParametersDictionary of the Chaos Schedule.",
+      "required": [
+        "Key",
+        "Value"
+      ],
+      "properties": {
+        "Key": {
+          "type": "string",
+          "description": "The key identifying the Chaos Parameter in the dictionary. This key is referenced by Chaos Schedule Jobs."
+        },
+        "Value": {
+          "$ref": "#/definitions/ChaosParameters",
+          "description": "Defines all the parameters to configure a Chaos run."
+        }
+      }
+    },
+    "ChaosEvent": {
+      "discriminator": "Kind",
+      "description": "Represents an event generated during a Chaos run.",
+      "properties": {
+        "Kind": {
+          "$ref": "#/definitions/ChaosEventKind",
+          "description": "The kind of Chaos event."
+        },
+        "TimeStampUtc": {
+          "type": "string",
+          "description": "The UTC timestamp when this Chaos event was generated.",
+          "format": "date-time"
+        }
+      },
+      "required": [
+        "Kind",
+        "TimeStampUtc"
+      ]
+    },
+    "ChaosEventWrapper": {
+      "description": "Wrapper object for Chaos event.",
+      "properties": {
+        "ChaosEvent": {
+          "$ref": "#/definitions/ChaosEvent",
+          "description": "Represents an event generated during a Chaos run."
+        }
+      }
+    },
+    "ChaosEventKind": {
+      "type": "string",
+      "description": "The kind of Chaos event.",
+      "enum": [
+        "Invalid",
+        "Started",
+        "ExecutingFaults",
+        "Waiting",
+        "ValidationFailed",
+        "TestError",
+        "Stopped"
+      ],
+      "x-ms-enum": {
+        "name": "ChaosEventKind",
+        "modelAsString": true,
+        "values": [
+          {
+            "value": "Invalid",
+            "description": "Indicates an invalid Chaos event kind. All Service Fabric enumerations have the invalid type."
+          },
+          {
+            "value": "Started",
+            "description": "Indicates a Chaos event that gets generated when Chaos is started."
+          },
+          {
+            "value": "ExecutingFaults",
+            "description": "Indicates a Chaos event that gets generated when Chaos has decided on the faults for an iteration. This Chaos event contains the details of the faults as a list of strings."
+          },
+          {
+            "value": "Waiting",
+            "description": "Indicates a Chaos event that gets generated when Chaos is waiting for the cluster to become ready for faulting, for example, Chaos may be waiting for the on-going upgrade to finish."
+          },
+          {
+            "value": "ValidationFailed",
+            "description": "Indicates a Chaos event that gets generated when the cluster entities do not become stable and healthy within ChaosParameters.MaxClusterStabilizationTimeoutInSeconds."
+          },
+          {
+            "value": "TestError",
+            "description": "Indicates a Chaos event that gets generated when an unexpected event has occurred in the Chaos engine, for example, due to the cluster snapshot being inconsistent, while faulting a faultable entity Chaos found that the entity was already faulted."
+          },
+          {
+            "value": "Stopped",
+            "description": "Indicates a Chaos event that gets generated when Chaos stops because either the user issued a stop or the time to run was up."
+          }
+        ]
+      }
+    },
+    "ChaosEventsSegment": {
+      "description": "Contains the list of Chaos events and the continuation token to get the next segment.",
+      "properties": {
+        "ContinuationToken": {
+          "$ref": "#/definitions/ContinuationToken",
+          "description": "The continuation token parameter is used to obtain next set of results. The continuation token is included in the response of the API when the results from the system do not fit in a single response. When this value is passed to the next API call, the API returns next set of results. If there are no further results, then the continuation token is not included in the response."
+        },
+        "History": {
+          "$ref": "#/definitions/ChaosEventHistory",
+          "description": "List of Chaos events that meet the user-supplied criteria."
+        }
+      }
+    },
+    "ChaosScheduleDescription": {
+      "description": "Defines the Chaos Schedule used by Chaos and the version of the Chaos Schedule. The version value wraps back to 0 after surpassing 2,147,483,647.",
+      "properties": {
+        "Version": {
+          "description": "The version number of the Schedule.",
+          "type": "integer",
+          "format": "int32",
+          "minimum": 0
+        },
+        "Schedule": {
+          "$ref": "#/definitions/ChaosSchedule",
+          "description": "Defines the schedule used by Chaos."
+        }
+      }
+    },
+    "ChaosSchedule": {
+      "description": "Defines the schedule used by Chaos.",
+      "properties": {
+        "StartDate": {
+          "type": "string",
+          "format": "date-time",
+          "description": "The date and time Chaos will start using this schedule.",
+          "default": "1601-01-01T00:00:00Z"
+        },
+        "ExpiryDate": {
+          "type": "string",
+          "format": "date-time",
+          "description": "The date and time Chaos will continue to use this schedule until.",
+          "default": "9999-12-31T23:59:59.999Z"
+        },
+        "ChaosParametersDictionary": {
+          "type": "array",
+          "description": "A mapping of string names to Chaos Parameters to be referenced by Chaos Schedule Jobs.",
+          "items": {
+            "$ref": "#/definitions/ChaosParametersDictionaryItem"
+          }
+        },
+        "Jobs": {
+          "description": "A list of all Chaos Schedule Jobs that will be automated by the schedule.",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/ChaosScheduleJob"
+          }
+        }
+      }
+    },
+    "ChaosScheduleJob": {
+      "description": "Defines a repetition rule and parameters of Chaos to be used with the Chaos Schedule.",
+      "properties": {
+        "ChaosParameters": {
+          "type": "string",
+          "description": "A reference to which Chaos Parameters of the Chaos Schedule to use."
+        },
+        "Days": {
+          "$ref": "#/definitions/ChaosScheduleJobActiveDaysOfWeek",
+          "description": "Defines the days of the week that a Chaos Schedule Job will run for."
+        },
+        "Times": {
+          "description": "A list of Time Ranges that specify when during active days that this job will run. The times are interpreted as UTC.",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/TimeRange"
+          }
+        }
+      }
+    },
+    "ChaosScheduleJobActiveDaysOfWeek": {
+      "description": "Defines the days of the week that a Chaos Schedule Job will run for.",
+      "properties": {
+        "Sunday": {
+          "type": "boolean",
+          "description": "Indicates if the Chaos Schedule Job will run on Sunday",
+          "default": false
+        },
+        "Monday": {
+          "type": "boolean",
+          "description": "Indicates if the Chaos Schedule Job will run on Monday",
+          "default": false
+        },
+        "Tuesday": {
+          "type": "boolean",
+          "description": "Indicates if the Chaos Schedule Job will run on Tuesday",
+          "default": false
+        },
+        "Wednesday": {
+          "type": "boolean",
+          "description": "Indicates if the Chaos Schedule Job will run on Wednesday",
+          "default": false
+        },
+        "Thursday": {
+          "type": "boolean",
+          "description": "Indicates if the Chaos Schedule Job will run on Thursday",
+          "default": false
+        },
+        "Friday": {
+          "type": "boolean",
+          "description": "Indicates if the Chaos Schedule Job will run on Friday",
+          "default": false
+        },
+        "Saturday": {
+          "type": "boolean",
+          "description": "Indicates if the Chaos Schedule Job will run on Saturday",
+          "default": false
+        }
+      }
+    },
+    "TimeRange": {
+      "description": "Defines a time range in a 24 hour day specified by a start and end time.",
+      "properties": {
+        "StartTime": {
+          "$ref": "#/definitions/TimeOfDay",
+          "description": "Defines an hour and minute of the day specified in 24 hour time."
+        },
+        "EndTime": {
+          "$ref": "#/definitions/TimeOfDay",
+          "description": "Defines an hour and minute of the day specified in 24 hour time."
+        }
+      }
+    },
+    "TimeOfDay": {
+      "description": "Defines an hour and minute of the day specified in 24 hour time.",
+      "properties": {
+        "Hour": {
+          "type": "integer",
+          "format": "int32",
+          "description": "Represents the hour of the day. Value must be between 0 and 23 inclusive.",
+          "minimum": 0,
+          "maximum": 23
+        },
+        "Minute": {
+          "type": "integer",
+          "format": "int32",
+          "description": "Represents the minute of the hour. Value must be between 0 to 59 inclusive.",
+          "minimum": 0,
+          "maximum": 59
+        }
+      }
+    },
+    "ExecutingFaultsChaosEvent": {
+      "description": "Describes a Chaos event that gets generated when Chaos has decided on the faults for an iteration. This Chaos event contains the details of the faults as a list of strings.",
+      "x-ms-discriminator-value": "ExecutingFaults",
+      "allOf": [
+        {
+          "$ref": "#/definitions/ChaosEvent"
+        }
+      ],
+      "properties": {
+        "Faults": {
+          "type": "array",
+          "description": "List of string description of the faults that Chaos decided to execute in an iteration.",
+          "items": {
+            "type": "string"
+          }
+        }
+      }
+    },
+    "StartedChaosEvent": {
+      "description": "Describes a Chaos event that gets generated when Chaos is started.",
+      "x-ms-discriminator-value": "Started",
+      "allOf": [
+        {
+          "$ref": "#/definitions/ChaosEvent"
+        }
+      ],
+      "properties": {
+        "ChaosParameters": {
+          "$ref": "#/definitions/ChaosParameters",
+          "description": "Defines all the parameters to configure a Chaos run."
+        }
+      }
+    },
+    "StoppedChaosEvent": {
+      "description": "Describes a Chaos event that gets generated when Chaos stops because either the user issued a stop or the time to run was up.",
+      "x-ms-discriminator-value": "Stopped",
+      "allOf": [
+        {
+          "$ref": "#/definitions/ChaosEvent"
+        }
+      ],
+      "properties": {
+        "Reason": {
+          "type": "string",
+          "description": "Describes why Chaos stopped. Chaos can stop because of StopChaos API call or the timeToRun provided in ChaosParameters is over."
+        }
+      }
+    },
+    "TestErrorChaosEvent": {
+      "description": "Describes a Chaos event that gets generated when an unexpected event occurs in the Chaos engine.\nFor example, due to the cluster snapshot being inconsistent, while faulting an entity, Chaos found that the entity was already faulted -- which would be an unexpected event.",
+      "x-ms-discriminator-value": "TestError",
+      "allOf": [
+        {
+          "$ref": "#/definitions/ChaosEvent"
+        }
+      ],
+      "properties": {
+        "Reason": {
+          "type": "string",
+          "description": "Describes why TestErrorChaosEvent was generated. For example, Chaos tries to fault a partition but finds that the partition is no longer fault tolerant, then a TestErrorEvent gets generated with the reason stating that the partition is not fault tolerant."
+        }
+      }
+    },
+    "ValidationFailedChaosEvent": {
+      "description": "Chaos event corresponding to a failure during validation.",
+      "x-ms-discriminator-value": "ValidationFailed",
+      "allOf": [
+        {
+          "$ref": "#/definitions/ChaosEvent"
+        }
+      ],
+      "properties": {
+        "Reason": {
+          "type": "string",
+          "description": "Describes why the ValidationFailedChaosEvent was generated. This may happen because more than MaxPercentUnhealthyNodes are unhealthy for more than MaxClusterStabilizationTimeout. This reason will be in the Reason property of the ValidationFailedChaosEvent as a string."
+        }
+      }
+    },
+    "WaitingChaosEvent": {
+      "description": "Describes a Chaos event that gets generated when Chaos is waiting for the cluster to become ready for faulting, for example, Chaos may be waiting for the on-going upgrade to finish.",
+      "x-ms-discriminator-value": "Waiting",
+      "allOf": [
+        {
+          "$ref": "#/definitions/ChaosEvent"
+        }
+      ],
+      "properties": {
+        "Reason": {
+          "type": "string",
+          "description": "Describes why the WaitingChaosEvent was generated, for example, due to a cluster upgrade."
+        }
+      }
+    },
+    "ChaosEventHistory": {
+      "type": "array",
+      "description": "An list of Chaos events that were generated during the time range passed into the GetChaosReport API call.",
+      "items": {
+        "$ref": "#/definitions/ChaosEventWrapper"
+      }
+    },
+    "ChaosTargetFilter": {
+      "description": "Defines all filters for targeted Chaos faults, for example, faulting only certain node types or faulting only certain applications.\nIf ChaosTargetFilter is not used, Chaos faults all cluster entities. If ChaosTargetFilter is used, Chaos faults only the entities that meet the ChaosTargetFilter\nspecification. NodeTypeInclusionList and ApplicationInclusionList allow a union semantics only. It is not possible to specify an intersection\nof NodeTypeInclusionList and ApplicationInclusionList. For example, it is not possible to specify \"fault this application only when it is on that node type.\"\nOnce an entity is included in either NodeTypeInclusionList or ApplicationInclusionList, that entity cannot be excluded using ChaosTargetFilter. Even if\napplicationX does not appear in ApplicationInclusionList, in some Chaos iteration applicationX can be faulted because it happens to be on a node of nodeTypeY that is included\nin NodeTypeInclusionList. If both NodeTypeInclusionList and ApplicationInclusionList are null or empty, an ArgumentException is thrown.",
+      "properties": {
+        "NodeTypeInclusionList": {
+          "type": "array",
+          "description": "A list of node types to include in Chaos faults.\nAll types of faults (restart node, restart code package, remove replica, restart replica, move primary, and move secondary) are enabled for the nodes of these node types.\nIf a node type (say NodeTypeX) does not appear in the NodeTypeInclusionList, then node level faults (like NodeRestart) will never be enabled for the nodes of\nNodeTypeX, but code package and replica faults can still be enabled for NodeTypeX if an application in the ApplicationInclusionList.\nhappens to reside on a node of NodeTypeX.\nAt most 100 node type names can be included in this list, to increase this number, a config upgrade is required for MaxNumberOfNodeTypesInChaosEntityFilter configuration.",
+          "items": {
+            "$ref": "#/definitions/NodeType"
+          }
+        },
+        "ApplicationInclusionList": {
+          "type": "array",
+          "description": "A list of application URIs to include in Chaos faults.\nAll replicas belonging to services of these applications are amenable to replica faults (restart replica, remove replica, move primary, and move secondary) by Chaos.\nChaos may restart a code package only if the code package hosts replicas of these applications only.\nIf an application does not appear in this list, it can still be faulted in some Chaos iteration if the application ends up on a node of a node type that is included in NodeTypeInclusionList.\nHowever, if applicationX is tied to nodeTypeY through placement constraints and applicationX is absent from ApplicationInclusionList and nodeTypeY is absent from NodeTypeInclusionList, then applicationX will never be faulted.\nAt most 1000 application names can be included in this list, to increase this number, a config upgrade is required for MaxNumberOfApplicationsInChaosEntityFilter configuration.",
+          "items": {
+            "$ref": "#/definitions/ApplicationName"
+          }
+        }
+      }
+    },
+    "ApplicationTypeVersion": {
+      "type": "string",
+      "description": "The version of the application type as defined in the application manifest."
+    },
+    "ApplicationCapacityDescription": {
+      "description": "Describes capacity information for services of this application. This description can be used for describing the following.\n- Reserving the capacity for the services on the nodes\n- Limiting the total number of nodes that services of this application can run on\n- Limiting the custom capacity metrics to limit the total consumption of this metric by the services of this application",
+      "properties": {
+        "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
+        },
+        "ApplicationMetrics": {
+          "$ref": "#/definitions/ApplicationMetricDescriptionList",
+          "description": "List of application capacity metric description."
+        }
+      }
+    },
+    "ApplicationDescription": {
+      "description": "Describes a Service Fabric application.",
+      "properties": {
+        "Name": {
+          "$ref": "#/definitions/ApplicationName",
+          "description": "The name of the application, including the 'fabric:' URI scheme."
+        },
+        "TypeName": {
+          "$ref": "#/definitions/ApplicationTypeName",
+          "description": "The application type name as defined in the application manifest."
+        },
+        "TypeVersion": {
+          "$ref": "#/definitions/ApplicationTypeVersion",
+          "description": "The version of the application type as defined in the application manifest."
+        },
+        "ParameterList": {
+          "$ref": "#/definitions/ApplicationParameterList",
+          "description": "List of application parameters with overridden values from their default values specified in the application manifest."
+        },
+        "ApplicationCapacity": {
+          "$ref": "#/definitions/ApplicationCapacityDescription",
+          "description": "Describes capacity information for services of this application. This description can be used for describing the following.\n- Reserving the capacity for the services on the nodes\n- Limiting the total number of nodes that services of this application can run on\n- Limiting the custom capacity metrics to limit the total consumption of this metric by the services of this application"
+        },
+        "ManagedApplicationIdentity": {
+          "$ref": "#/definitions/ManagedApplicationIdentityDescription",
+          "description": "Managed application identity description."
+        }
+      },
+      "required": [
+        "Name",
+        "TypeName",
+        "TypeVersion"
+      ]
+    },
+    "ApplicationMetricDescription": {
+      "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.",
+      "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."
+        },
+        "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."
+        },
+        "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.",
+          "type": "integer",
+          "format": "int64"
+        }
+      }
+    },
+    "ApplicationMetricDescriptionList": {
+      "type": "array",
+      "items": {
+        "$ref": "#/definitions/ApplicationMetricDescription"
+      },
+      "description": "List of application capacity metric description."
+    },
+    "ApplicationLoadMetricInformation": {
+      "description": "Describes load 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.",
+      "properties": {
+        "Name": {
+          "type": "string",
+          "description": "The name of the metric."
+        },
+        "ReservationCapacity": {
+          "type": "integer",
+          "format": "int64",
+          "description": "This is the capacity reserved in the cluster for the application.\nIt's the product of NodeReservationCapacity and MinimumNodes.\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."
+        },
+        "ApplicationCapacity": {
+          "type": "integer",
+          "format": "int64",
+          "description": "Total capacity for this metric in this application instance."
+        },
+        "ApplicationLoad": {
+          "type": "integer",
+          "format": "int64",
+          "description": "Current load for this metric in this application instance."
+        }
+      }
+    },
+    "ApplicationLoadMetricInformationList": {
+      "type": "array",
+      "items": {
+        "$ref": "#/definitions/ApplicationLoadMetricInformation"
+      },
+      "description": "List of application load metric information."
+    },
+    "ComposeDeploymentStatus": {
+      "type": "string",
+      "description": "The status of the compose deployment.",
+      "enum": [
+        "Invalid",
+        "Provisioning",
+        "Creating",
+        "Ready",
+        "Unprovisioning",
+        "Deleting",
+        "Failed",
+        "Upgrading"
+      ],
+      "x-ms-enum": {
+        "name": "ComposeDeploymentStatus",
+        "modelAsString": true,
+        "values": [
+          {
+            "value": "Invalid",
+            "description": "Indicates that the compose deployment status is invalid. The value is zero."
+          },
+          {
+            "value": "Provisioning",
+            "description": "Indicates that the compose deployment is being provisioned in background. The value is 1."
+          },
+          {
+            "value": "Creating",
+            "description": "Indicates that the compose deployment is being created in background. The value is 2."
+          },
+          {
+            "value": "Ready",
+            "description": "Indicates that the compose deployment has been successfully created or upgraded. The value is 3."
+          },
+          {
+            "value": "Unprovisioning",
+            "description": "Indicates that the compose deployment is being unprovisioned in background. The value is 4."
+          },
+          {
+            "value": "Deleting",
+            "description": "Indicates that the compose deployment is being deleted in background. The value is 5."
+          },
+          {
+            "value": "Failed",
+            "description": "Indicates that the compose deployment was terminated due to persistent failures. The value is 6."
+          },
+          {
+            "value": "Upgrading",
+            "description": "Indicates that the compose deployment is being upgraded in the background. The value is 7."
+          }
+        ]
+      }
+    },
+    "ComposeDeploymentStatusInfo": {
+      "description": "Information about a Service Fabric compose deployment.",
+      "properties": {
+        "Name": {
+          "$ref": "#/definitions/DeploymentName",
+          "description": "The name of the deployment."
+        },
+        "ApplicationName": {
+          "$ref": "#/definitions/ApplicationName",
+          "description": "The name of the application, including the 'fabric:' URI scheme."
+        },
+        "Status": {
+          "$ref": "#/definitions/ComposeDeploymentStatus",
+          "description": "The status of the compose deployment."
+        },
+        "StatusDetails": {
+          "description": "The status details of compose deployment including failure message.",
+          "type": "string"
+        }
+      }
+    },
+    "ComposeDeploymentUpgradeDescription": {
+      "description": "Describes the parameters for a compose deployment upgrade.",
+      "properties": {
+        "DeploymentName": {
+          "$ref": "#/definitions/DeploymentName",
+          "description": "The name of the deployment."
+        },
+        "ComposeFileContent": {
+          "type": "string",
+          "description": "The content of the compose file that describes the deployment to create."
+        },
+        "RegistryCredential": {
+          "$ref": "#/definitions/RegistryCredential",
+          "description": "Credential information to connect to container registry."
+        },
+        "UpgradeKind": {
+          "$ref": "#/definitions/UpgradeKind",
+          "description": "The kind of upgrade out of the following possible values."
+        },
+        "RollingUpgradeMode": {
+          "$ref": "#/definitions/UpgradeMode",
+          "description": "The mode used to monitor health during a rolling upgrade. The values are UnmonitoredAuto, UnmonitoredManual, and Monitored."
+        },
+        "UpgradeReplicaSetCheckTimeoutInSeconds": {
+          "$ref": "#/definitions/UpgradeReplicaSetCheckTimeout",
+          "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)."
+        },
+        "MonitoringPolicy": {
+          "$ref": "#/definitions/MonitoringPolicyDescription",
+          "description": "Describes the parameters for monitoring an upgrade in Monitored mode."
+        },
+        "ApplicationHealthPolicy": {
+          "$ref": "#/definitions/ApplicationHealthPolicy",
+          "description": "Defines a health policy used to evaluate the health of an application or one of its children entities."
+        }
+      },
+      "required": [
+        "DeploymentName",
+        "ComposeFileContent",
+        "UpgradeKind"
+      ]
+    },
+    "ComposeDeploymentUpgradeProgressInfo": {
+      "description": "Describes the parameters for a compose deployment upgrade.",
+      "properties": {
+        "DeploymentName": {
+          "$ref": "#/definitions/TargetDeploymentName",
+          "description": "The name of the target deployment."
+        },
+        "ApplicationName": {
+          "$ref": "#/definitions/TargetApplicationName",
+          "description": "The name of the target application, including the 'fabric:' URI scheme."
+        },
+        "UpgradeState": {
+          "$ref": "#/definitions/ComposeDeploymentUpgradeState",
+          "description": "The state of the compose deployment upgrade."
+        },
+        "UpgradeStatusDetails": {
+          "type": "string",
+          "description": "Additional detailed information about the status of the pending upgrade."
+        },
+        "UpgradeKind": {
+          "$ref": "#/definitions/UpgradeKind",
+          "description": "The kind of upgrade out of the following possible values."
+        },
+        "RollingUpgradeMode": {
+          "$ref": "#/definitions/UpgradeMode",
+          "description": "The mode used to monitor health during a rolling upgrade. The values are UnmonitoredAuto, UnmonitoredManual, and Monitored."
+        },
+        "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)."
+        },
+        "UpgradeReplicaSetCheckTimeoutInSeconds": {
+          "$ref": "#/definitions/UpgradeReplicaSetCheckTimeout",
+          "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)."
+        },
+        "MonitoringPolicy": {
+          "$ref": "#/definitions/MonitoringPolicyDescription",
+          "description": "Describes the parameters for monitoring an upgrade in Monitored mode."
+        },
+        "ApplicationHealthPolicy": {
+          "$ref": "#/definitions/ApplicationHealthPolicy",
+          "description": "Defines a health policy used to evaluate the health of an application or one of its children entities."
+        },
+        "TargetApplicationTypeVersion": {
+          "$ref": "#/definitions/TargetApplicationTypeVersion",
+          "description": "The target application type version (found in the application manifest) for the application upgrade."
+        },
+        "UpgradeDuration": {
+          "$ref": "#/definitions/UpgradeDuration",
+          "description": "The estimated amount of time that the overall upgrade elapsed. 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."
+        },
+        "CurrentUpgradeDomainDuration": {
+          "$ref": "#/definitions/CurrentUpgradeDomainDuration",
+          "description": "The estimated amount of time spent processing current 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."
+        },
+        "ApplicationUnhealthyEvaluations": {
+          "$ref": "#/definitions/ApplicationUnhealthyEvaluations",
+          "description": "List of health evaluations that resulted in the current aggregated health state."
+        },
+        "CurrentUpgradeDomainProgress": {
+          "$ref": "#/definitions/CurrentUpgradeDomainProgressInfo",
+          "description": "Information about the current in-progress upgrade domain."
+        },
+        "StartTimestampUtc": {
+          "type": "string",
+          "description": "The estimated UTC datetime when the upgrade started."
+        },
+        "FailureTimestampUtc": {
+          "type": "string",
+          "description": "The estimated UTC datetime when the upgrade failed and FailureAction was executed."
+        },
+        "FailureReason": {
+          "$ref": "#/definitions/FailureReason",
+          "description": "The cause of an upgrade failure that resulted in FailureAction being executed."
+        },
+        "UpgradeDomainProgressAtFailure": {
+          "$ref": "#/definitions/FailureUpgradeDomainProgressInfo",
+          "description": "Information about the upgrade domain progress at the time of upgrade failure."
+        },
+        "ApplicationUpgradeStatusDetails": {
+          "type": "string",
+          "description": "Additional details of application upgrade including failure message."
+        }
+      }
+    },
+    "ComposeDeploymentUpgradeState": {
+      "type": "string",
+      "description": "The state of the compose deployment upgrade.",
+      "enum": [
+        "Invalid",
+        "ProvisioningTarget",
+        "RollingForwardInProgress",
+        "RollingForwardPending",
+        "UnprovisioningCurrent",
+        "RollingForwardCompleted",
+        "RollingBackInProgress",
+        "UnprovisioningTarget",
+        "RollingBackCompleted",
+        "Failed"
+      ],
+      "x-ms-enum": {
+        "name": "ComposeDeploymentUpgradeState",
+        "modelAsString": true,
+        "values": [
+          {
+            "value": "Invalid",
+            "description": "Indicates the upgrade state is invalid. All Service Fabric enumerations have the invalid type. The value is zero."
+          },
+          {
+            "value": "ProvisioningTarget",
+            "description": "The upgrade is in the progress of provisioning target application type version. The value is 1."
+          },
+          {
+            "value": "RollingForwardInProgress",
+            "description": "The upgrade is rolling forward to the target version but is not complete yet. The value is 2."
+          },
+          {
+            "value": "RollingForwardPending",
+            "description": "The current upgrade domain has finished upgrading. The overall upgrade is waiting for an explicit move next request in UnmonitoredManual mode or performing health checks in Monitored mode. The value is 3"
+          },
+          {
+            "value": "UnprovisioningCurrent",
+            "description": "The upgrade is in the progress of unprovisioning current application type version and rolling forward to the target version is completed. The value is 4."
+          },
+          {
+            "value": "RollingForwardCompleted",
+            "description": "The upgrade has finished rolling forward. The value is 5."
+          },
+          {
+            "value": "RollingBackInProgress",
+            "description": "The upgrade is rolling back to the previous version but is not complete yet. The value is 6."
+          },
+          {
+            "value": "UnprovisioningTarget",
+            "description": "The upgrade is in the progress of unprovisioning target application type version and rolling back to the current version is completed. The value is 7."
+          },
+          {
+            "value": "RollingBackCompleted",
+            "description": "The upgrade has finished rolling back. The value is 8."
+          },
+          {
+            "value": "Failed",
+            "description": "The upgrade has failed and is unable to execute FailureAction. The value is 9."
+          }
+        ]
+      }
+    },
+    "PagedComposeDeploymentStatusInfoList": {
+      "description": "The list of compose deployments in the cluster. The list is paged when all of the results cannot fit in a single message. The next set of results can be obtained by executing the same query with the continuation token provided in this list.",
+      "properties": {
+        "ContinuationToken": {
+          "$ref": "#/definitions/ContinuationToken",
+          "description": "The continuation token parameter is used to obtain next set of results. The continuation token is included in the response of the API when the results from the system do not fit in a single response. When this value is passed to the next API call, the API returns next set of results. If there are no further results, then the continuation token is not included in the response."
+        },
+        "Items": {
+          "type": "array",
+          "description": "List of compose deployment status information.",
+          "items": {
+            "$ref": "#/definitions/ComposeDeploymentStatusInfo"
+          }
+        }
+      }
+    },
+    "CreateComposeDeploymentDescription": {
+      "description": "Defines description for creating a Service Fabric compose deployment.",
+      "properties": {
+        "DeploymentName": {
+          "$ref": "#/definitions/DeploymentName",
+          "description": "The name of the deployment."
+        },
+        "ComposeFileContent": {
+          "type": "string",
+          "description": "The content of the compose file that describes the deployment to create."
+        },
+        "RegistryCredential": {
+          "$ref": "#/definitions/RegistryCredential",
+          "description": "Credential information to connect to container registry."
+        }
+      },
+      "required": [
+        "DeploymentName",
+        "ComposeFileContent"
+      ]
+    },
+    "RegistryCredential": {
+      "description": "Credential information to connect to container registry.",
+      "properties": {
+        "RegistryUserName": {
+          "type": "string",
+          "description": "The user name to connect to container registry."
+        },
+        "RegistryPassword": {
+          "type": "string",
+          "description": "The password for supplied username to connect to container registry."
+        },
+        "PasswordEncrypted": {
+          "type": "boolean",
+          "description": "Indicates that supplied container registry password is encrypted."
+        }
+      }
+    },
+    "DeployedServicePackageInfoList": {
+      "type": "array",
+      "items": {
+        "$ref": "#/definitions/DeployedServicePackageInfo"
+      },
+      "description": "List of deployed service package information."
+    },
+    "DeployedServicePackageInfo": {
+      "description": "Information about service package deployed on a Service Fabric node.",
+      "properties": {
+        "Name": {
+          "$ref": "#/definitions/ServiceManifestName",
+          "description": "The name of the service package as specified in the service manifest."
+        },
+        "Version": {
+          "type": "string",
+          "description": "The version of the service package specified in service manifest."
+        },
+        "Status": {
+          "$ref": "#/definitions/DeploymentStatus",
+          "description": "Specifies the status of a deployed application or service package on a Service Fabric node."
+        },
+        "ServicePackageActivationId": {
+          "$ref": "#/definitions/ServicePackageActivationId",
+          "description": "The ActivationId of a deployed service package. If ServicePackageActivationMode specified at the time of creating the service\nis 'SharedProcess' (or if it is not specified, in which case it defaults to 'SharedProcess'), then value of ServicePackageActivationId\nis always an empty string."
+        }
+      }
+    },
+    "DeploymentName": {
+      "type": "string",
+      "description": "The name of the deployment."
+    },
+    "CorrelationSchemeList": {
+      "type": "array",
+      "items": {
+        "$ref": "#/definitions/ServiceCorrelationDescription"
+      },
+      "description": "A list that describes the correlation of the service with other services."
+    },
+    "MoveCost": {
+      "type": "string",
+      "description": "Specifies the move cost for the service.",
+      "enum": [
+        "Zero",
+        "Low",
+        "Medium",
+        "High",
+        "VeryHigh"
+      ],
+      "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."
+          },
+          {
+            "value": "VeryHigh",
+            "description": "Specifies the move cost of the service as VeryHigh. The value is 4."
+          }
+        ]
+      }
+    },
+    "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"
+          }
+        ]
+      }
+    },
+    "ServiceCorrelationDescription": {
+      "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."
+          }
+        ]
+      }
+    },
+    "ServiceLoadMetricsList": {
+      "type": "array",
+      "items": {
+        "$ref": "#/definitions/ServiceLoadMetricDescription"
+      },
+      "description": "The service load metrics is given as an array of ServiceLoadMetricDescription objects."
+    },
+    "ServiceLoadMetricDescription": {
+      "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."
+        }
+      }
+    },
+    "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."
+          }
+        ]
+      }
+    },
+    "ServicePackageActivationMode": {
+      "type": "string",
+      "description": "The activation mode of service package to be used for a Service Fabric service. This is specified at the time of creating the Service.",
+      "enum": [
+        "SharedProcess",
+        "ExclusiveProcess"
+      ],
+      "x-ms-enum": {
+        "name": "ServicePackageActivationMode",
+        "modelAsString": true,
+        "values": [
+          {
+            "value": "SharedProcess",
+            "description": "This is the default activation mode. With this activation mode, replicas or instances from different partition(s) of service, on a given node, will share same activation of service package on a node. The value is zero."
+          },
+          {
+            "value": "ExclusiveProcess",
+            "description": "With this activation mode, each replica or instance of service, on a given node, will have its own dedicated activation of service package on a node. The value is 1."
+          }
+        ]
+      }
+    },
+    "ServicePlacementPoliciesList": {
+      "type": "array",
+      "items": {
+        "$ref": "#/definitions/ServicePlacementPolicyDescription"
+      },
+      "description": "A list that describes the correlation of the service with other services."
+    },
+    "PartitionSchemeDescription": {
+      "discriminator": "PartitionScheme",
+      "description": "Describes how the service is partitioned.",
+      "required": [
+        "PartitionScheme"
+      ],
+      "properties": {
+        "PartitionScheme": {
+          "$ref": "#/definitions/PartitionScheme",
+          "description": "Specifies how the service is partitioned."
+        }
+      }
+    },
+    "NamedPartitionSchemeDescription": {
+      "description": "Describes the named partition scheme of the service.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/PartitionSchemeDescription"
+        }
+      ],
+      "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."
+        }
+      }
+    },
+    "SingletonPartitionSchemeDescription": {
+      "description": "Describes the partition scheme of a singleton-partitioned, or non-partitioned service.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/PartitionSchemeDescription"
+        }
+      ],
+      "x-ms-discriminator-value": "Singleton"
+    },
+    "UniformInt64RangePartitionSchemeDescription": {
+      "description": "Describes a partitioning scheme where an integer range is allocated evenly across a number of partitions.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/PartitionSchemeDescription"
+        }
+      ],
+      "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 partitions."
+        },
+        "HighKey": {
+          "type": "string",
+          "description": "String indicating the upper bound of the partition key range that\nshould be split between the partitions."
+        }
+      }
+    },
+    "ServiceDescription": {
+      "discriminator": "ServiceKind",
+      "description": "A ServiceDescription contains all of the information necessary to create a service.",
+      "required": [
+        "ServiceKind",
+        "ServiceName",
+        "ServiceTypeName",
+        "PartitionDescription"
+      ],
+      "properties": {
+        "ServiceKind": {
+          "$ref": "#/definitions/ServiceKind",
+          "description": "The service kind."
+        },
+        "ApplicationName": {
+          "$ref": "#/definitions/ApplicationName",
+          "description": "The name of the application, including the 'fabric:' URI scheme."
+        },
+        "ServiceName": {
+          "$ref": "#/definitions/ServiceName",
+          "description": "The full name of the service with 'fabric:' URI scheme."
+        },
+        "ServiceTypeName": {
+          "$ref": "#/definitions/ServiceTypeName",
+          "description": "Name of the service type as specified in the service manifest."
+        },
+        "InitializationData": {
+          "$ref": "#/definitions/ByteArray",
+          "description": "The initialization data as an array of bytes. Initialization data is passed to service instances or replicas when they are created."
+        },
+        "PartitionDescription": {
+          "$ref": "#/definitions/PartitionSchemeDescription",
+          "description": "The partition description as an object."
+        },
+        "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": "The correlation scheme."
+        },
+        "ServiceLoadMetrics": {
+          "$ref": "#/definitions/ServiceLoadMetricsList",
+          "description": "The service load metrics."
+        },
+        "ServicePlacementPolicies": {
+          "$ref": "#/definitions/ServicePlacementPoliciesList",
+          "description": "The service placement policies."
+        },
+        "DefaultMoveCost": {
+          "$ref": "#/definitions/MoveCost",
+          "description": "The move cost for the service."
+        },
+        "IsDefaultMoveCostSpecified": {
+          "type": "boolean",
+          "description": "Indicates if the DefaultMoveCost property is specified."
+        },
+        "ServicePackageActivationMode": {
+          "$ref": "#/definitions/ServicePackageActivationMode",
+          "description": "The activation mode of service package to be used for a service."
+        },
+        "ServiceDnsName": {
+          "type": "string",
+          "description": "The DNS name of the service. It requires the DNS system service to be enabled in Service Fabric cluster."
+        },
+        "ScalingPolicies": {
+          "$ref": "#/definitions/ScalingPolicyDescriptionList",
+          "description": "Scaling policies for this service."
+        }
+      }
+    },
+    "StatefulServiceDescription": {
+      "description": "Describes a stateful service.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/ServiceDescription"
+        }
+      ],
+      "x-ms-discriminator-value": "Stateful",
+      "required": [
+        "TargetReplicaSetSize",
+        "MinReplicaSetSize",
+        "HasPersistedState"
+      ],
+      "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."
+        },
+        "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."
+        },
+        "Flags": {
+          "type": "integer",
+          "description": "Flags indicating whether other properties are set. Each of the associated properties corresponds to a flag, specified below, which, if set, indicate that the property is specified.\nThis property can be a combination of those flags obtained using bitwise 'OR' operator.\nFor example, if the provided value is 6 then the flags for QuorumLossWaitDuration (2) and StandByReplicaKeepDuration(4) are set.\n\n- None - Does not indicate any other properties are set. The value is zero.\n- ReplicaRestartWaitDuration - Indicates the ReplicaRestartWaitDuration property is set. The value is 1.\n- QuorumLossWaitDuration - Indicates the QuorumLossWaitDuration property is set. The value is 2.\n- StandByReplicaKeepDuration - Indicates the StandByReplicaKeepDuration property is set. The value is 4.\n- ServicePlacementTimeLimit - Indicates the ServicePlacementTimeLimit property is set. The value is 8.\n- DropSourceReplicaOnMove - Indicates the DropSourceReplicaOnMove property is set. The value is 16."
+        },
+        "ReplicaRestartWaitDurationSeconds": {
+          "type": "integer",
+          "format": "int64",
+          "minimum": 0,
+          "maximum": 4294967295,
+          "description": "The duration, in seconds, between when a replica goes down and when a new replica is created."
+        },
+        "QuorumLossWaitDurationSeconds": {
+          "type": "integer",
+          "format": "int64",
+          "minimum": 0,
+          "maximum": 4294967295,
+          "description": "The maximum duration, in seconds, for which a partition is allowed to be in a state of quorum loss."
+        },
+        "StandByReplicaKeepDurationSeconds": {
+          "type": "integer",
+          "format": "int64",
+          "minimum": 0,
+          "maximum": 4294967295,
+          "description": "The definition on how long StandBy replicas should be maintained before being removed."
+        },
+        "ServicePlacementTimeLimitSeconds": {
+          "type": "integer",
+          "format": "int64",
+          "minimum": 0,
+          "maximum": 4294967295,
+          "description": "The duration for which replicas can stay InBuild before reporting that build is stuck."
+        },
+        "DropSourceReplicaOnMove": {
+          "type": "boolean",
+          "description": "Indicates whether to drop source Secondary replica even if the target replica has not finished build. If desired behavior is to drop it as soon as possible the value of this property is true, if not it is false."
+        }
+      }
+    },
+    "StatelessServiceDescription": {
+      "description": "Describes a stateless service.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/ServiceDescription"
+        }
+      ],
+      "x-ms-discriminator-value": "Stateless",
+      "required": [
+        "InstanceCount"
+      ],
+      "properties": {
+        "InstanceCount": {
+          "type": "integer",
+          "minimum": -1,
+          "description": "The instance count."
+        },
+        "MinInstanceCount": {
+          "$ref": "#/definitions/MinInstanceCount",
+          "description": "MinInstanceCount is the minimum number of instances that must be up to meet the EnsureAvailability safety check during operations like upgrade or deactivate node.\nThe actual number that is used is max( MinInstanceCount, ceil( MinInstancePercentage/100.0 * InstanceCount) ).\nNote, if InstanceCount is set to -1, during MinInstanceCount computation -1 is first converted into the number of nodes on which the instances are allowed to be placed according to the placement constraints on the service."
+        },
+        "MinInstancePercentage": {
+          "$ref": "#/definitions/MinInstancePercentage",
+          "description": "MinInstancePercentage is the minimum percentage of InstanceCount that must be up to meet the EnsureAvailability safety check during operations like upgrade or deactivate node.\nThe actual number that is used is max( MinInstanceCount, ceil( MinInstancePercentage/100.0 * InstanceCount) ).\nNote, if InstanceCount is set to -1, during MinInstancePercentage computation, -1 is first converted into the number of nodes on which the instances are allowed to be placed according to the placement constraints on the service."
+        },
+        "Flags": {
+          "type": "integer",
+          "description": "Flags indicating whether other properties are set. Each of the associated properties corresponds to a flag, specified below, which, if set, indicate that the property is specified.\nThis property can be a combination of those flags obtained using bitwise 'OR' operator.\nFor example, if the provided value is 1 then the flags for InstanceCloseDelayDuration is set.\n\n- None - Does not indicate any other properties are set. The value is zero.\n- InstanceCloseDelayDuration - Indicates the InstanceCloseDelayDuration property is set. The value is 1."
+        },
+        "InstanceCloseDelayDurationSeconds": {
+          "type": "integer",
+          "format": "int64",
+          "minimum": 0,
+          "maximum": 4294967295,
+          "description": "Duration in seconds, to wait before a stateless instance is closed, to allow the active requests to drain gracefully. This would be effective when the instance is closing during the application/cluster upgrade and disabling node.\nThe endpoint exposed on this instance is removed prior to starting the delay, which prevents new connections to this instance.\nIn addition, clients that have subscribed to service endpoint change events(https://docs.microsoft.com/dotnet/api/system.fabric.fabricclient.servicemanagementclient.registerservicenotificationfilterasync), can do\nthe following upon receiving the endpoint removal notification:\n    - Stop sending new requests to this instance.\n    - Close existing connections after in-flight requests have completed.\n    - Connect to a different instance of the service partition for future requests.\nNote, the default value of InstanceCloseDelayDuration is 0, which indicates that there won't be any delay or removal of the endpoint prior to closing the instance."
+        }
+      }
+    },
+    "ReplicatorQueueStatus": {
+      "description": "Provides various statistics of the queue used in the service fabric replicator.\nContains information about the service fabric replicator like the replication/copy queue utilization, last acknowledgement received timestamp, etc.\nDepending on the role of the replicator, the properties in this type imply different meanings.",
+      "properties": {
+        "QueueUtilizationPercentage": {
+          "type": "integer",
+          "format": "int32",
+          "description": "Represents the utilization of the queue. A value of 0 indicates that the queue is empty and a value of 100 indicates the queue is full."
+        },
+        "QueueMemorySize": {
+          "type": "string",
+          "description": "Represents the virtual memory consumed by the queue in bytes."
+        },
+        "FirstSequenceNumber": {
+          "type": "string",
+          "description": "On a primary replicator, this is semantically the sequence number of the operation for which all the secondary replicas have sent an acknowledgement.\nOn a secondary replicator, this is the smallest sequence number of the operation that is present in the queue."
+        },
+        "CompletedSequenceNumber": {
+          "type": "string",
+          "description": "On a primary replicator, this is semantically the highest sequence number of the operation for which all the secondary replicas have sent an acknowledgement.\nOn a secondary replicator, this is semantically the highest sequence number that has been applied to the persistent state."
+        },
+        "CommittedSequenceNumber": {
+          "type": "string",
+          "description": "On a primary replicator, this is semantically the highest sequence number of the operation for which a write quorum of the secondary replicas have sent an acknowledgement.\nOn a secondary replicator, this is semantically the highest sequence number of the in-order operation received from the primary."
+        },
+        "LastSequenceNumber": {
+          "type": "string",
+          "description": "Represents the latest sequence number of the operation that is available in the queue."
+        }
+      }
+    },
+    "ReplicatorStatus": {
+      "discriminator": "Kind",
+      "description": "Represents a base class for primary or secondary replicator status.\nContains information about the service fabric replicator like the replication/copy queue utilization, last acknowledgement received timestamp, etc.",
+      "required": [
+        "Kind"
+      ],
+      "properties": {
+        "Kind": {
+          "$ref": "#/definitions/ReplicaRole",
+          "description": "The role of a replica of a stateful service."
+        }
+      }
+    },
+    "PrimaryReplicatorStatus": {
+      "x-ms-discriminator-value": "Primary",
+      "description": "Provides statistics about the Service Fabric Replicator, when it is functioning in a Primary role.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/ReplicatorStatus"
+        }
+      ],
+      "properties": {
+        "ReplicationQueueStatus": {
+          "$ref": "#/definitions/ReplicatorQueueStatus",
+          "description": "Details about the replication queue on the primary replicator."
+        },
+        "RemoteReplicators": {
+          "$ref": "#/definitions/RemoteReplicatorStatusList",
+          "description": "The status of all the active and idle secondary replicators that the primary is aware of."
+        }
+      }
+    },
+    "SecondaryReplicatorStatus": {
+      "description": "Provides statistics about the Service Fabric Replicator, when it is functioning in a ActiveSecondary role.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/ReplicatorStatus"
+        }
+      ],
+      "properties": {
+        "ReplicationQueueStatus": {
+          "$ref": "#/definitions/ReplicatorQueueStatus",
+          "description": "Details about the replication queue on the secondary replicator."
+        },
+        "LastReplicationOperationReceivedTimeUtc": {
+          "type": "string",
+          "format": "date-time",
+          "description": "The last time-stamp (UTC) at which a replication operation was received from the primary.\nUTC 0 represents an invalid value, indicating that a replication operation message was never received."
+        },
+        "IsInBuild": {
+          "type": "boolean",
+          "description": "Value that indicates whether the replica is currently being built."
+        },
+        "CopyQueueStatus": {
+          "$ref": "#/definitions/ReplicatorQueueStatus",
+          "description": "Details about the copy queue on the secondary replicator."
+        },
+        "LastCopyOperationReceivedTimeUtc": {
+          "type": "string",
+          "format": "date-time",
+          "description": "The last time-stamp (UTC) at which a copy operation was received from the primary.\nUTC 0 represents an invalid value, indicating that a copy operation message was never received."
+        },
+        "LastAcknowledgementSentTimeUtc": {
+          "type": "string",
+          "format": "date-time",
+          "description": "The last time-stamp (UTC) at which an acknowledgment was sent to the primary replicator.\nUTC 0 represents an invalid value, indicating that an acknowledgment message was never sent."
+        }
+      }
+    },
+    "SecondaryActiveReplicatorStatus": {
+      "x-ms-discriminator-value": "ActiveSecondary",
+      "description": "Status of the secondary replicator when it is in active mode and is part of the replica set.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/SecondaryReplicatorStatus"
+        }
+      ]
+    },
+    "SecondaryIdleReplicatorStatus": {
+      "x-ms-discriminator-value": "IdleSecondary",
+      "description": "Status of the secondary replicator when it is in idle mode and is being built by the primary.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/SecondaryReplicatorStatus"
+        }
+      ]
+    },
+    "RemoteReplicatorStatus": {
+      "description": "Represents the state of the secondary replicator from the primary replicator’s point of view.",
+      "properties": {
+        "ReplicaId": {
+          "$ref": "#/definitions/ReplicaId",
+          "description": "Represents the replica ID of the remote secondary replicator."
+        },
+        "LastAcknowledgementProcessedTimeUtc": {
+          "type": "string",
+          "format": "date-time",
+          "description": "The last timestamp (in UTC) when an acknowledgement from the secondary replicator was processed on the primary.\nUTC 0 represents an invalid value, indicating that no acknowledgement messages were ever processed."
+        },
+        "LastReceivedReplicationSequenceNumber": {
+          "type": "string",
+          "description": "The highest replication operation sequence number that the secondary has received from the primary."
+        },
+        "LastAppliedReplicationSequenceNumber": {
+          "type": "string",
+          "description": "The highest replication operation sequence number that the secondary has applied to its state."
+        },
+        "IsInBuild": {
+          "type": "boolean",
+          "description": "A value that indicates whether the secondary replica is in the process of being built."
+        },
+        "LastReceivedCopySequenceNumber": {
+          "type": "string",
+          "description": "The highest copy operation sequence number that the secondary has received from the primary.\nA value of -1 implies that the secondary has received all copy operations."
+        },
+        "LastAppliedCopySequenceNumber": {
+          "type": "string",
+          "description": "The highest copy operation sequence number that the secondary has applied to its state.\nA value of -1 implies that the secondary has applied all copy operations and the copy process is complete."
+        },
+        "RemoteReplicatorAcknowledgementStatus": {
+          "$ref": "#/definitions/RemoteReplicatorAcknowledgementStatus",
+          "description": "Represents the acknowledgment status for the remote secondary replicator."
+        }
+      }
+    },
+    "RemoteReplicatorStatusList": {
+      "type": "array",
+      "items": {
+        "$ref": "#/definitions/RemoteReplicatorStatus"
+      },
+      "description": "List of remote replicator status"
+    },
+    "RemoteReplicatorAcknowledgementStatus": {
+      "description": "Provides details about the remote replicators from the primary replicator's point of view.",
+      "properties": {
+        "ReplicationStreamAcknowledgementDetail": {
+          "$ref": "#/definitions/RemoteReplicatorAcknowledgementDetail",
+          "description": "Details about the acknowledgements for operations that are part of the replication stream data."
+        },
+        "CopyStreamAcknowledgementDetail": {
+          "$ref": "#/definitions/RemoteReplicatorAcknowledgementDetail",
+          "description": "Details about the acknowledgements for operations that are part of the copy stream data."
+        }
+      }
+    },
+    "RemoteReplicatorAcknowledgementDetail": {
+      "description": "Provides various statistics of the acknowledgements that are being received from the remote replicator.",
+      "properties": {
+        "AverageReceiveDuration": {
+          "type": "string",
+          "description": "Represents the average duration it takes for the remote replicator to receive an operation."
+        },
+        "AverageApplyDuration": {
+          "type": "string",
+          "description": "Represents the average duration it takes for the remote replicator to apply an operation. This usually entails writing the operation to disk."
+        },
+        "NotReceivedCount": {
+          "type": "string",
+          "description": "Represents the number of operations not yet received by a remote replicator."
+        },
+        "ReceivedAndNotAppliedCount": {
+          "type": "string",
+          "description": "Represents the number of operations received and not yet applied by a remote replicator."
+        }
+      }
+    },
+    "DeployedServiceReplicaDetailInfo": {
+      "discriminator": "ServiceKind",
+      "description": "Information about a Service Fabric service replica deployed on a node.",
+      "required": [
+        "ServiceKind"
+      ],
+      "properties": {
+        "ServiceKind": {
+          "$ref": "#/definitions/ServiceKind",
+          "description": "The kind of service (Stateless or Stateful)."
+        },
+        "ServiceName": {
+          "$ref": "#/definitions/ServiceName",
+          "description": "Full hierarchical name of the service in URI format starting with `fabric:`."
+        },
+        "PartitionId": {
+          "$ref": "#/definitions/PartitionId",
+          "description": "An internal ID used by Service Fabric to uniquely identify a partition. This is a randomly generated GUID when the service was created. The partition ID is unique and does not change for the lifetime of the service. If the same service was deleted and recreated the IDs of its partitions would be different."
+        },
+        "CurrentServiceOperation": {
+          "$ref": "#/definitions/ServiceOperationName",
+          "description": "Specifies the current active life-cycle operation on a stateful service replica or stateless service instance."
+        },
+        "CurrentServiceOperationStartTimeUtc": {
+          "type": "string",
+          "format": "date-time",
+          "description": "The start time of the current service operation in UTC format."
+        },
+        "ReportedLoad": {
+          "$ref": "#/definitions/LoadMetricReportInfoList",
+          "description": "List of load reported by replica."
+        }
+      }
+    },
+    "DeployedStatefulServiceReplicaDetailInfo": {
+      "description": "Information about a stateful replica running in a code package. Note DeployedServiceReplicaQueryResult will contain duplicate data like ServiceKind, ServiceName, PartitionId and replicaId.",
+      "x-ms-discriminator-value": "Stateful",
+      "allOf": [
+        {
+          "$ref": "#/definitions/DeployedServiceReplicaDetailInfo"
+        }
+      ],
+      "properties": {
+        "ReplicaId": {
+          "$ref": "#/definitions/ReplicaId",
+          "description": "Id of a stateful service replica. ReplicaId is used by Service Fabric to uniquely identify a replica of a partition. It is unique within a partition and does not change for the lifetime of the replica. If a replica gets dropped and another replica gets created on the same node for the same partition, it will get a different value for the id. Sometimes the id of a stateless service instance is also referred as a replica id."
+        },
+        "CurrentReplicatorOperation": {
+          "$ref": "#/definitions/ReplicatorOperationName",
+          "description": "Specifies the operation currently being executed by the Replicator."
+        },
+        "ReadStatus": {
+          "$ref": "#/definitions/PartitionAccessStatus",
+          "description": "Specifies the access status of the partition."
+        },
+        "WriteStatus": {
+          "$ref": "#/definitions/PartitionAccessStatus",
+          "description": "Specifies the access status of the partition."
+        },
+        "ReplicatorStatus": {
+          "$ref": "#/definitions/ReplicatorStatus",
+          "description": "Represents a base class for primary or secondary replicator status.\nContains information about the service fabric replicator like the replication/copy queue utilization, last acknowledgement received timestamp, etc."
+        },
+        "ReplicaStatus": {
+          "$ref": "#/definitions/KeyValueStoreReplicaStatus",
+          "description": "Key value store related information for the replica."
+        },
+        "DeployedServiceReplicaQueryResult": {
+          "$ref": "#/definitions/DeployedStatefulServiceReplicaInfo",
+          "description": "Information about a stateful service replica deployed on a node."
+        }
+      }
+    },
+    "DeployedStatelessServiceInstanceDetailInfo": {
+      "description": "Information about a stateless instance running in a code package. Note that DeployedServiceReplicaQueryResult will contain duplicate data like ServiceKind, ServiceName, PartitionId and InstanceId.",
+      "x-ms-discriminator-value": "Stateless",
+      "allOf": [
+        {
+          "$ref": "#/definitions/DeployedServiceReplicaDetailInfo"
+        }
+      ],
+      "properties": {
+        "InstanceId": {
+          "$ref": "#/definitions/InstanceId",
+          "description": "Id of a stateless service instance. InstanceId is used by Service Fabric to uniquely identify an instance of a partition of a stateless service. It is unique within a partition and does not change for the lifetime of the instance. If the instance has failed over on the same or different node, it will get a different value for the InstanceId."
+        },
+        "DeployedServiceReplicaQueryResult": {
+          "$ref": "#/definitions/DeployedStatelessServiceInstanceInfo",
+          "description": "Information about a stateless service instance deployed on a node."
+        }
+      }
+    },
+    "FabricReplicaStatus": {
+      "type": "string",
+      "description": "Specifies the status of the replica.",
+      "enum": [
+        "Invalid",
+        "Down",
+        "Up"
+      ],
+      "x-ms-enum": {
+        "name": "FabricReplicaStatus",
+        "modelAsString": true,
+        "values": [
+          {
+            "value": "Invalid",
+            "description": "Indicates that the read or write operation access status is not valid. This value is not returned to the caller."
+          },
+          {
+            "value": "Down",
+            "description": "Indicates that the replica is down."
+          },
+          {
+            "value": "Up",
+            "description": "Indicates that the replica is up."
+          }
+        ]
+      }
+    },
+    "LoadMetricReportInfoList": {
+      "type": "array",
+      "items": {
+        "$ref": "#/definitions/LoadMetricReportInfo"
+      },
+      "description": "List of load reported by replica."
+    },
+    "LoadMetricReportInfo": {
+      "description": "Information about load reported by replica.",
+      "properties": {
+        "Name": {
+          "type": "string",
+          "description": "The name of the metric."
+        },
+        "Value": {
+          "type": "integer",
+          "format": "int32",
+          "description": "The value of the load for the metric. In future releases of Service Fabric this parameter will be deprecated in favor of CurrentValue."
+        },
+        "CurrentValue": {
+          "type": "string",
+          "format": "double",
+          "description": "The double value of the load for the metric."
+        },
+        "LastReportedUtc": {
+          "type": "string",
+          "format": "date-time",
+          "description": "The UTC time when the load is reported."
+        }
+      }
+    },
+    "PartitionAccessStatus": {
+      "type": "string",
+      "description": "Specifies the access status of the partition.",
+      "enum": [
+        "Invalid",
+        "Granted",
+        "ReconfigurationPending",
+        "NotPrimary",
+        "NoWriteQuorum"
+      ],
+      "x-ms-enum": {
+        "name": "PartitionAccessStatus",
+        "modelAsString": true,
+        "values": [
+          {
+            "value": "Invalid",
+            "description": "Indicates that the read or write operation access status is not valid. This value is not returned to the caller."
+          },
+          {
+            "value": "Granted",
+            "description": "Indicates that the read or write operation access is granted and the operation is allowed."
+          },
+          {
+            "value": "ReconfigurationPending",
+            "description": "Indicates that the client should try again later, because a reconfiguration is in progress."
+          },
+          {
+            "value": "NotPrimary",
+            "description": "Indicates that this client request was received by a replica that is not a Primary replica."
+          },
+          {
+            "value": "NoWriteQuorum",
+            "description": "Indicates that no write quorum is available and, therefore, no write operation can be accepted."
+          }
+        ]
+      }
+    },
+    "ReplicatorOperationName": {
+      "type": "string",
+      "description": "Specifies the operation currently being executed by the Replicator.",
+      "enum": [
+        "Invalid",
+        "None",
+        "Open",
+        "ChangeRole",
+        "UpdateEpoch",
+        "Close",
+        "Abort",
+        "OnDataLoss",
+        "WaitForCatchup",
+        "Build"
+      ],
+      "x-ms-enum": {
+        "name": "ReplicatorOperationName",
+        "modelAsString": true,
+        "values": [
+          {
+            "value": "Invalid",
+            "description": "Default value if the replicator is not yet ready."
+          },
+          {
+            "value": "None",
+            "description": "Replicator is not running any operation from Service Fabric perspective."
+          },
+          {
+            "value": "Open",
+            "description": "Replicator is opening."
+          },
+          {
+            "value": "ChangeRole",
+            "description": "Replicator is in the process of changing its role."
+          },
+          {
+            "value": "UpdateEpoch",
+            "description": "Due to a change in the replica set, replicator is being updated with its Epoch."
+          },
+          {
+            "value": "Close",
+            "description": "Replicator is closing."
+          },
+          {
+            "value": "Abort",
+            "description": "Replicator is being aborted."
+          },
+          {
+            "value": "OnDataLoss",
+            "description": "Replicator is handling the data loss condition, where the user service may potentially be recovering state from an external source."
+          },
+          {
+            "value": "WaitForCatchup",
+            "description": "Replicator is waiting for a quorum of replicas to be caught up to the latest state."
+          },
+          {
+            "value": "Build",
+            "description": "Replicator is in the process of building one or more replicas."
+          }
+        ]
+      }
+    },
+    "ServiceOperationName": {
+      "type": "string",
+      "description": "Specifies the current active life-cycle operation on a stateful service replica or stateless service instance.",
+      "enum": [
+        "Unknown",
+        "None",
+        "Open",
+        "ChangeRole",
+        "Close",
+        "Abort"
+      ],
+      "x-ms-enum": {
+        "name": "ServiceOperationName",
+        "modelAsString": true,
+        "values": [
+          {
+            "value": "Unknown",
+            "description": "Reserved for future use."
+          },
+          {
+            "value": "None",
+            "description": "The service replica or instance is not going through any life-cycle changes."
+          },
+          {
+            "value": "Open",
+            "description": "The service replica or instance is being opened."
+          },
+          {
+            "value": "ChangeRole",
+            "description": "The service replica is changing roles."
+          },
+          {
+            "value": "Close",
+            "description": "The service replica or instance is being closed."
+          },
+          {
+            "value": "Abort",
+            "description": "The service replica or instance is being aborted."
+          }
+        ]
+      }
+    },
+    "ReplicaKind": {
+      "type": "string",
+      "description": "The role of a replica of a stateful service.",
+      "enum": [
+        "Invalid",
+        "KeyValueStore"
+      ],
+      "x-ms-enum": {
+        "name": "ReplicaKind",
+        "modelAsString": true,
+        "values": [
+          {
+            "value": "Invalid",
+            "description": "Represents an invalid replica kind. The value is zero."
+          },
+          {
+            "value": "KeyValueStore",
+            "description": "Represents a key value store replica. The value is 1"
+          }
+        ]
+      }
+    },
+    "ReplicaStatusBase": {
+      "discriminator": "Kind",
+      "description": "Information about the replica.",
+      "required": [
+        "Kind"
+      ],
+      "properties": {
+        "Kind": {
+          "$ref": "#/definitions/ReplicaKind",
+          "description": "The role of a replica of a stateful service."
+        }
+      }
+    },
+    "KeyValueStoreReplicaStatus": {
+      "description": "Key value store related information for the replica.",
+      "x-ms-discriminator-value": "KeyValueStore",
+      "allOf": [
+        {
+          "$ref": "#/definitions/ReplicaStatusBase"
+        }
+      ],
+      "properties": {
+        "DatabaseRowCountEstimate": {
+          "type": "string",
+          "description": "Value indicating the estimated number of rows in the underlying database."
+        },
+        "DatabaseLogicalSizeEstimate": {
+          "type": "string",
+          "description": "Value indicating the estimated size of the underlying database."
+        },
+        "CopyNotificationCurrentKeyFilter": {
+          "type": "string",
+          "description": "Value indicating the latest key-prefix filter applied to enumeration during the callback. Null if there is no pending callback."
+        },
+        "CopyNotificationCurrentProgress": {
+          "type": "string",
+          "description": "Value indicating the latest number of keys enumerated during the callback. 0 if there is no pending callback."
+        },
+        "StatusDetails": {
+          "type": "string",
+          "description": "Value indicating the current status details of the replica."
+        }
+      }
+    },
+    "ServiceUpdateDescription": {
+      "discriminator": "ServiceKind",
+      "description": "A ServiceUpdateDescription contains all of the information necessary to update a service.",
+      "required": [
+        "ServiceKind"
+      ],
+      "properties": {
+        "ServiceKind": {
+          "$ref": "#/definitions/ServiceKind",
+          "description": "The service kind."
+        },
+        "Flags": {
+          "type": "string",
+          "description": "Flags indicating whether other properties are set. Each of the associated properties corresponds to a flag, specified below, which, if set, indicate that the property is specified.\nThis property can be a combination of those flags obtained using bitwise 'OR' operator.\nFor example, if the provided value is 6 then the flags for ReplicaRestartWaitDuration (2) and QuorumLossWaitDuration (4) are set.\n\n- None - Does not indicate any other properties are set. The value is zero.\n- TargetReplicaSetSize/InstanceCount - Indicates whether the TargetReplicaSetSize property (for Stateful services) or the InstanceCount property (for Stateless services) is set. The value is 1.\n- ReplicaRestartWaitDuration - Indicates the ReplicaRestartWaitDuration property is set. The value is  2.\n- QuorumLossWaitDuration - Indicates the QuorumLossWaitDuration property is set. The value is 4.\n- StandByReplicaKeepDuration - Indicates the StandByReplicaKeepDuration property is set. The value is 8.\n- MinReplicaSetSize - Indicates the MinReplicaSetSize property is set. The value is 16.\n- PlacementConstraints - Indicates the PlacementConstraints property is set. The value is 32.\n- PlacementPolicyList - Indicates the ServicePlacementPolicies property is set. The value is 64.\n- Correlation - Indicates the CorrelationScheme property is set. The value is 128.\n- Metrics - Indicates the ServiceLoadMetrics property is set. The value is 256.\n- DefaultMoveCost - Indicates the DefaultMoveCost property is set. The value is 512.\n- ScalingPolicy - Indicates the ScalingPolicies property is set. The value is 1024.\n- ServicePlacementTimeLimit - Indicates the ServicePlacementTimeLimit property is set. The value is 2048.\n- MinInstanceCount - Indicates the MinInstanceCount property is set. The value is 4096.\n- MinInstancePercentage - Indicates the MinInstancePercentage property is set. The value is 8192.\n- InstanceCloseDelayDuration - Indicates the InstanceCloseDelayDuration property is set. The value is 16384.\n- DropSourceReplicaOnMove - Indicates the DropSourceReplicaOnMove property is set. The value is 32768."
+        },
+        "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": "The correlation scheme."
+        },
+        "LoadMetrics": {
+          "$ref": "#/definitions/ServiceLoadMetricsList",
+          "description": "The service load metrics."
+        },
+        "ServicePlacementPolicies": {
+          "$ref": "#/definitions/ServicePlacementPoliciesList",
+          "description": "The service placement policies."
+        },
+        "DefaultMoveCost": {
+          "$ref": "#/definitions/MoveCost",
+          "description": "The move cost for the service."
+        },
+        "ScalingPolicies": {
+          "$ref": "#/definitions/ScalingPolicyDescriptionList",
+          "description": "Scaling policies for this service."
+        }
+      }
+    },
+    "StatefulServiceUpdateDescription": {
+      "description": "Describes an update for a stateful service.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/ServiceUpdateDescription"
+        }
+      ],
+      "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."
+        },
+        "ReplicaRestartWaitDurationSeconds": {
+          "type": "string",
+          "description": "The duration, in seconds, between when a replica goes down and when a new replica is created."
+        },
+        "QuorumLossWaitDurationSeconds": {
+          "type": "string",
+          "description": "The maximum duration, in seconds, for which a partition is allowed to be in a state of quorum loss."
+        },
+        "StandByReplicaKeepDurationSeconds": {
+          "type": "string",
+          "description": "The definition on how long StandBy replicas should be maintained before being removed."
+        },
+        "ServicePlacementTimeLimitSeconds": {
+          "type": "string",
+          "description": "The duration for which replicas can stay InBuild before reporting that build is stuck."
+        },
+        "DropSourceReplicaOnMove": {
+          "type": "boolean",
+          "description": "Indicates whether to drop source Secondary replica even if the target replica has not finished build. If desired behavior is to drop it as soon as possible the value of this property is true, if not it is false."
+        }
+      }
+    },
+    "StatelessServiceUpdateDescription": {
+      "description": "Describes an update for a stateless service.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/ServiceUpdateDescription"
+        }
+      ],
+      "x-ms-discriminator-value": "Stateless",
+      "properties": {
+        "InstanceCount": {
+          "type": "integer",
+          "minimum": -1,
+          "description": "The instance count."
+        },
+        "MinInstanceCount": {
+          "$ref": "#/definitions/MinInstanceCount",
+          "description": "MinInstanceCount is the minimum number of instances that must be up to meet the EnsureAvailability safety check during operations like upgrade or deactivate node.\nThe actual number that is used is max( MinInstanceCount, ceil( MinInstancePercentage/100.0 * InstanceCount) ).\nNote, if InstanceCount is set to -1, during MinInstanceCount computation -1 is first converted into the number of nodes on which the instances are allowed to be placed according to the placement constraints on the service."
+        },
+        "MinInstancePercentage": {
+          "$ref": "#/definitions/MinInstancePercentage",
+          "description": "MinInstancePercentage is the minimum percentage of InstanceCount that must be up to meet the EnsureAvailability safety check during operations like upgrade or deactivate node.\nThe actual number that is used is max( MinInstanceCount, ceil( MinInstancePercentage/100.0 * InstanceCount) ).\nNote, if InstanceCount is set to -1, during MinInstancePercentage computation, -1 is first converted into the number of nodes on which the instances are allowed to be placed according to the placement constraints on the service."
+        },
+        "InstanceCloseDelayDurationSeconds": {
+          "type": "string",
+          "description": "Duration in seconds, to wait before a stateless instance is closed, to allow the active requests to drain gracefully. This would be effective when the instance is closing during the application/cluster upgrade and disabling node.\nThe endpoint exposed on this instance is removed prior to starting the delay, which prevents new connections to this instance.\nIn addition, clients that have subscribed to service endpoint change events(https://docs.microsoft.com/dotnet/api/system.fabric.fabricclient.servicemanagementclient.registerservicenotificationfilterasync), can do\nthe following upon receiving the endpoint removal notification:\n    - Stop sending new requests to this instance.\n    - Close existing connections after in-flight requests have completed.\n    - Connect to a different instance of the service partition for future requests."
+        }
+      }
+    },
+    "ImageStoreRelativePath": {
+      "type": "string",
+      "description": "The remote location within image store. This path is relative to the image store root."
+    },
+    "FileVersion": {
+      "description": "Information about the version of image store file.",
+      "properties": {
+        "VersionNumber": {
+          "type": "string",
+          "description": "The current image store version number for the file is used in image store for checking whether it need to be updated."
+        },
+        "EpochDataLossNumber": {
+          "type": "string",
+          "description": "The epoch data loss number of image store replica when this file entry was updated or created."
+        },
+        "EpochConfigurationNumber": {
+          "type": "string",
+          "description": "The epoch configuration version number of the image store replica when this file entry was created or updated."
+        }
+      }
+    },
+    "DiskInfo": {
+      "description": "Information about the disk",
+      "properties": {
+        "Capacity": {
+          "type": "string",
+          "description": "the disk size in bytes"
+        },
+        "AvailableSpace": {
+          "type": "string",
+          "description": "the available disk space in bytes"
+        }
+      }
+    },
+    "FileInfo": {
+      "description": "Information about a image store file.",
+      "properties": {
+        "FileSize": {
+          "type": "string",
+          "description": "The size of file in bytes."
+        },
+        "FileVersion": {
+          "$ref": "#/definitions/FileVersion",
+          "description": "Information about the version of image store file."
+        },
+        "ModifiedDate": {
+          "type": "string",
+          "format": "date-time",
+          "description": "The date and time when the image store file was last modified."
+        },
+        "StoreRelativePath": {
+          "type": "string",
+          "description": "The file path relative to the image store root path."
+        }
+      }
+    },
+    "FolderInfo": {
+      "description": "Information about a image store folder. It includes how many files this folder contains and its image store relative path.",
+      "properties": {
+        "StoreRelativePath": {
+          "$ref": "#/definitions/ImageStoreRelativePath",
+          "description": "The remote location within image store. This path is relative to the image store root."
+        },
+        "FileCount": {
+          "type": "string",
+          "description": "The number of files from within the image store folder."
+        }
+      }
+    },
+    "FolderSizeInfo": {
+      "description": "Information of a image store folder size",
+      "properties": {
+        "StoreRelativePath": {
+          "$ref": "#/definitions/ImageStoreRelativePath",
+          "description": "The remote location within image store. This path is relative to the image store root."
+        },
+        "FolderSize": {
+          "type": "string",
+          "description": "The size of folder in bytes."
+        }
+      }
+    },
+    "UsageInfo": {
+      "description": "Information about how much space and how many files in the file system the ImageStore is using in this category",
+      "properties": {
+        "UsedSpace": {
+          "type": "string",
+          "description": "the size of all files in this category"
+        },
+        "FileCount": {
+          "type": "string",
+          "description": "the number of all files in this category"
+        }
+      }
+    },
+    "ImageStoreContent": {
+      "description": "Information about the image store content.",
+      "properties": {
+        "StoreFiles": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/FileInfo"
+          },
+          "description": "The list of image store file info objects represents files found under the given image store relative path."
+        },
+        "StoreFolders": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/FolderInfo"
+          },
+          "description": "The list of image store folder info objects represents subfolders found under the given image store relative path."
+        }
+      }
+    },
+    "ImageStoreCopyDescription": {
+      "description": "Information about how to copy image store content from one image store relative path to another image store relative path.",
+      "required": [
+        "RemoteSource",
+        "RemoteDestination"
+      ],
+      "properties": {
+        "RemoteSource": {
+          "type": "string",
+          "description": "The relative path of source image store content to be copied from."
+        },
+        "RemoteDestination": {
+          "type": "string",
+          "description": "The relative path of destination image store content to be copied to."
+        },
+        "SkipFiles": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "The list of the file names to be skipped for copying."
+        },
+        "CheckMarkFile": {
+          "type": "boolean",
+          "description": "Indicates whether to check mark file during copying. The property is true if checking mark file is required, false otherwise. The mark file is used to check whether the folder is well constructed. If the property is true and mark file does not exist, the copy is skipped."
+        }
+      }
+    },
+    "ImageStoreInfo": {
+      "description": "Information about the ImageStore's resource usage",
+      "properties": {
+        "DiskInfo": {
+          "$ref": "#/definitions/DiskInfo",
+          "description": "disk capacity and available disk space on the node where the ImageStore primary is placed."
+        },
+        "UsedByMetadata": {
+          "$ref": "#/definitions/UsageInfo",
+          "description": "the ImageStore's file system usage for metadata."
+        },
+        "UsedByStaging": {
+          "$ref": "#/definitions/UsageInfo",
+          "description": "The ImageStore's file system usage for staging files that are being uploaded."
+        },
+        "UsedByCopy": {
+          "$ref": "#/definitions/UsageInfo",
+          "description": "the ImageStore's file system usage for copied application and cluster packages. [Removing application and cluster packages](https://docs.microsoft.com/rest/api/servicefabric/sfclient-api-deleteimagestorecontent) will free up this space."
+        },
+        "UsedByRegister": {
+          "$ref": "#/definitions/UsageInfo",
+          "description": "the ImageStore's file system usage for registered and cluster packages. [Unregistering application](https://docs.microsoft.com/rest/api/servicefabric/sfclient-api-unprovisionapplicationtype) and [cluster packages](https://docs.microsoft.com/rest/api/servicefabric/sfclient-api-unprovisionapplicationtype) will free up this space."
+        }
+      }
+    },
+    "InstanceId": {
+      "type": "string",
+      "description": "Id of a stateless service instance. InstanceId is used by Service Fabric to uniquely identify an instance of a partition of a stateless service. It is unique within a partition and does not change for the lifetime of the instance. If the instance has failed over on the same or different node, it will get a different value for the InstanceId."
+    },
+    "CodePackageInstanceId": {
+      "type": "string",
+      "description": "The instance ID for current running entry point. For a code package setup entry point (if specified) runs first and after it finishes main entry point is started. Each time entry point executable is run, its instance id will change."
+    },
+    "HostIsolationMode": {
+      "type": "string",
+      "description": "Specifies the isolation mode of main entry point of a code package when it's host type is ContainerHost. This is specified as part of container host policies in application manifest while importing service manifest.",
+      "enum": [
+        "None",
+        "Process",
+        "HyperV"
+      ],
+      "x-ms-enum": {
+        "name": "HostIsolationMode",
+        "modelAsString": true,
+        "values": [
+          {
+            "value": "None",
+            "description": "Indicates the isolation mode is not applicable for given HostType. The value is 0."
+          },
+          {
+            "value": "Process",
+            "description": "This is the default isolation mode for a ContainerHost. The value is 1."
+          },
+          {
+            "value": "HyperV",
+            "description": "Indicates the ContainerHost is a Hyper-V container. This applies to only Windows containers. The value is 2."
+          }
+        ]
+      }
+    },
+    "HostType": {
+      "type": "string",
+      "description": "Specifies the type of host for main entry point of a code package as specified in service manifest.",
+      "enum": [
+        "Invalid",
+        "ExeHost",
+        "ContainerHost"
+      ],
+      "x-ms-enum": {
+        "name": "HostType",
+        "modelAsString": true,
+        "values": [
+          {
+            "value": "Invalid",
+            "description": "Indicates the type of host is not known or invalid. The value is 0."
+          },
+          {
+            "value": "ExeHost",
+            "description": "Indicates the host is an executable. The value is 1."
+          },
+          {
+            "value": "ContainerHost",
+            "description": "Indicates the host is a container. The value is 2."
+          }
+        ]
+      }
+    },
+    "RestartDeployedCodePackageDescription": {
+      "description": "Defines description for restarting a deployed code package on Service Fabric node.",
+      "required": [
+        "ServiceManifestName",
+        "CodePackageName",
+        "CodePackageInstanceId"
+      ],
+      "properties": {
+        "ServiceManifestName": {
+          "$ref": "#/definitions/ServiceManifestName",
+          "description": "The name of service manifest that specified this code package."
+        },
+        "ServicePackageActivationId": {
+          "$ref": "#/definitions/ServicePackageActivationId",
+          "description": "The ActivationId of a deployed service package. If ServicePackageActivationMode specified at the time of creating the service\nis 'SharedProcess' (or if it is not specified, in which case it defaults to 'SharedProcess'), then value of ServicePackageActivationId\nis always an empty string."
+        },
+        "CodePackageName": {
+          "$ref": "#/definitions/CodePackageName",
+          "description": "The name of the code package defined in the service manifest."
+        },
+        "CodePackageInstanceId": {
+          "$ref": "#/definitions/CodePackageInstanceId",
+          "description": "The instance ID for currently running entry point. For a code package setup entry point (if specified) runs first and after it finishes main entry point is started.\nEach time entry point executable is run, its instance ID will change. If 0 is passed in as the code package instance ID, the API will restart the code package with whatever instance ID it is currently running.\nIf an instance ID other than 0 is passed in, the API will restart the code package only if the current Instance ID matches the passed in instance ID.\nNote, passing in the exact instance ID (not 0) in the API is safer, because if ensures at most one restart of the code package."
+        }
+      }
+    },
+    "DeployedServiceTypeInfo": {
+      "description": "Information about service type deployed on a node, information such as the status of the service type registration on a node.",
+      "properties": {
+        "ServiceTypeName": {
+          "$ref": "#/definitions/ServiceTypeName",
+          "description": "Name of the service type as specified in the service manifest."
+        },
+        "ServiceManifestName": {
+          "$ref": "#/definitions/ServiceManifestName",
+          "description": "The name of the service manifest in which this service type is defined."
+        },
+        "CodePackageName": {
+          "$ref": "#/definitions/CodePackageName",
+          "description": "The name of the code package that registered the service type."
+        },
+        "Status": {
+          "$ref": "#/definitions/ServiceTypeRegistrationStatus",
+          "description": "The status of the service type registration on the node."
+        },
+        "ServicePackageActivationId": {
+          "$ref": "#/definitions/ServicePackageActivationId",
+          "description": "The ActivationId of a deployed service package. If ServicePackageActivationMode specified at the time of creating the service\nis 'SharedProcess' (or if it is not specified, in which case it defaults to 'SharedProcess'), then value of ServicePackageActivationId\nis always an empty string."
+        }
+      }
+    },
+    "DeployedServiceTypeInfoList": {
+      "type": "array",
+      "items": {
+        "$ref": "#/definitions/DeployedServiceTypeInfo"
+      },
+      "description": "List of information about service type deployed on a node."
+    },
+    "ServiceTypeRegistrationStatus": {
+      "type": "string",
+      "description": "The status of the service type registration on the node.",
+      "enum": [
+        "Invalid",
+        "Disabled",
+        "Enabled",
+        "Registered"
+      ],
+      "x-ms-enum": {
+        "name": "ServiceTypeRegistrationStatus",
+        "modelAsString": true,
+        "values": [
+          {
+            "value": "Invalid",
+            "description": "Indicates the registration status is invalid. All Service Fabric enumerations have the invalid type. The value is zero."
+          },
+          {
+            "value": "Disabled",
+            "description": "Indicates that the service type is disabled on this node. A type gets disabled when there are too many failures of the code package hosting the service type. If the service type is disabled, new replicas of that service type will not be placed on the node until it is enabled again. The service type is enabled again after the process hosting it comes up and re-registers the type or a preconfigured time interval has passed. The value is 1."
+          },
+          {
+            "value": "Enabled",
+            "description": "Indicates that the service type is enabled on this node. Replicas of this service type can be placed on this node when the code package registers the service type. The value is 2."
+          },
+          {
+            "value": "Registered",
+            "description": "Indicates that the service type is enabled and registered on the node by a code package. Replicas of this service type can now be placed on this node. The value is 3."
+          }
+        ]
+      }
+    },
+    "ServiceEndpointRole": {
+      "type": "string",
+      "description": "The role of the replica where the endpoint is reported.",
+      "enum": [
+        "Invalid",
+        "Stateless",
+        "StatefulPrimary",
+        "StatefulSecondary"
+      ],
+      "x-ms-enum": {
+        "name": "ServiceEndpointRole",
+        "modelAsString": true,
+        "values": [
+          {
+            "value": "Invalid",
+            "description": "Indicates the service endpoint role is invalid. All Service Fabric enumerations have the invalid type. The value is zero."
+          },
+          {
+            "value": "Stateless",
+            "description": "Indicates that the service endpoint is of a stateless service. The value is 1."
+          },
+          {
+            "value": "StatefulPrimary",
+            "description": "Indicates that the service endpoint is of a primary replica of a stateful service. The value is 2."
+          },
+          {
+            "value": "StatefulSecondary",
+            "description": "Indicates that the service endpoint is of a secondary replica of a stateful service. The value is 3."
+          }
+        ]
+      }
+    },
+    "ResolvedServiceEndpoint": {
+      "description": "Endpoint of a resolved service partition.",
+      "properties": {
+        "Kind": {
+          "$ref": "#/definitions/ServiceEndpointRole",
+          "description": "The role of the replica where the endpoint is reported."
+        },
+        "Address": {
+          "type": "string",
+          "description": "The address of the endpoint. If the endpoint has multiple listeners the address is a JSON object with one property per listener with the value as the address of that listener."
+        }
+      }
+    },
+    "ResolvedServicePartition": {
+      "description": "Information about a service partition and its associated endpoints.",
+      "required": [
+        "Name",
+        "PartitionInformation",
+        "Endpoints",
+        "Version"
+      ],
+      "properties": {
+        "Name": {
+          "$ref": "#/definitions/ServiceName",
+          "description": "The full name of the service with 'fabric:' URI scheme."
+        },
+        "PartitionInformation": {
+          "$ref": "#/definitions/PartitionInformation",
+          "description": "A representation of the resolved partition."
+        },
+        "Endpoints": {
+          "$ref": "#/definitions/ResolvedServiceEndpointList",
+          "description": "List of resolved service endpoints of a service partition."
+        },
+        "Version": {
+          "type": "string",
+          "description": "The version of this resolved service partition result. This version should be passed in the next time the ResolveService call is made via the PreviousRspVersion query parameter."
+        }
+      }
+    },
+    "ResolvedServiceEndpointList": {
+      "type": "array",
+      "items": {
+        "$ref": "#/definitions/ResolvedServiceEndpoint"
+      },
+      "description": "List of resolved service endpoints of a service partition."
+    },
+    "InvokeDataLossResult": {
+      "description": "Represents information about an operation in a terminal state (Completed or Faulted).",
+      "properties": {
+        "ErrorCode": {
+          "type": "integer",
+          "format": "int32",
+          "description": "If OperationState is Completed, this is 0.  If OperationState is Faulted, this is an error code indicating the reason."
+        },
+        "SelectedPartition": {
+          "$ref": "#/definitions/SelectedPartition",
+          "description": "This class returns information about the partition that the user-induced operation acted upon."
+        }
+      }
+    },
+    "InvokeQuorumLossResult": {
+      "description": "Represents information about an operation in a terminal state (Completed or Faulted).",
+      "properties": {
+        "ErrorCode": {
+          "type": "integer",
+          "format": "int32",
+          "description": "If OperationState is Completed, this is 0.  If OperationState is Faulted, this is an error code indicating the reason."
+        },
+        "SelectedPartition": {
+          "$ref": "#/definitions/SelectedPartition",
+          "description": "This class returns information about the partition that the user-induced operation acted upon."
+        }
+      }
+    },
+    "NodeResult": {
+      "description": "Contains information about a node that was targeted by a user-induced operation.",
+      "properties": {
+        "NodeName": {
+          "$ref": "#/definitions/NodeName",
+          "description": "The name of a Service Fabric node."
+        },
+        "NodeInstanceId": {
+          "type": "string",
+          "description": "The node instance id."
+        }
+      }
+    },
+    "NodeTransitionProgress": {
+      "description": "Information about an NodeTransition operation.  This class contains an OperationState and a NodeTransitionResult.  The NodeTransitionResult is not valid until OperationState\nis Completed or Faulted.",
+      "properties": {
+        "State": {
+          "$ref": "#/definitions/OperationState",
+          "description": "The state of the operation."
+        },
+        "NodeTransitionResult": {
+          "$ref": "#/definitions/NodeTransitionResult",
+          "description": "Represents information about an operation in a terminal state (Completed or Faulted)."
+        }
+      }
+    },
+    "NodeTransitionResult": {
+      "description": "Represents information about an operation in a terminal state (Completed or Faulted).",
+      "properties": {
+        "ErrorCode": {
+          "type": "integer",
+          "format": "int32",
+          "description": "If OperationState is Completed, this is 0.  If OperationState is Faulted, this is an error code indicating the reason."
+        },
+        "NodeResult": {
+          "$ref": "#/definitions/NodeResult",
+          "description": "Contains information about a node that was targeted by a user-induced operation."
+        }
+      }
+    },
+    "OperationId": {
+      "type": "string",
+      "format": "uuid",
+      "description": "A GUID that identifies a call to this API.  This is also passed into the corresponding GetProgress API."
+    },
+    "OperationState": {
+      "type": "string",
+      "description": "The state of the operation.",
+      "enum": [
+        "Invalid",
+        "Running",
+        "RollingBack",
+        "Completed",
+        "Faulted",
+        "Cancelled",
+        "ForceCancelled"
+      ],
+      "x-ms-enum": {
+        "name": "OperationState",
+        "modelAsString": true,
+        "values": [
+          {
+            "value": "Invalid",
+            "description": "The operation state is invalid."
+          },
+          {
+            "value": "Running",
+            "description": "The operation is in progress."
+          },
+          {
+            "value": "RollingBack",
+            "description": "The operation is rolling back internal system state because it encountered a fatal error or was cancelled by the user.  \"RollingBack\"     does not refer to user state.  For example, if CancelOperation is called on a command of type PartitionDataLoss, state of \"RollingBack\" does not mean service data is being restored (assuming the command has progressed far enough to cause data loss). It means the system is rolling back/cleaning up internal system state associated with the command."
+          },
+          {
+            "value": "Completed",
+            "description": "The operation has completed successfully and is no longer running."
+          },
+          {
+            "value": "Faulted",
+            "description": "The operation has failed and is no longer running."
+          },
+          {
+            "value": "Cancelled",
+            "description": "The operation was cancelled by the user using CancelOperation, and is no longer running."
+          },
+          {
+            "value": "ForceCancelled",
+            "description": "The operation was cancelled by the user using CancelOperation, with the force parameter set to true.  It is no longer running.  Refer to CancelOperation for more details."
+          }
+        ]
+      }
+    },
+    "OperationStatus": {
+      "description": "Contains the OperationId, OperationState, and OperationType for user-induced operations.",
+      "properties": {
+        "OperationId": {
+          "$ref": "#/definitions/OperationId",
+          "description": "A GUID that identifies a call to this API.  This is also passed into the corresponding GetProgress API."
+        },
+        "State": {
+          "$ref": "#/definitions/OperationState",
+          "description": "The state of the operation."
+        },
+        "Type": {
+          "$ref": "#/definitions/OperationType",
+          "description": "The type of the operation."
+        }
+      }
+    },
+    "OperationStatusList": {
+      "type": "array",
+      "description": "A list of OperationStatus objects.",
+      "items": {
+        "$ref": "#/definitions/OperationStatus"
+      }
+    },
+    "OperationType": {
+      "type": "string",
+      "description": "The type of the operation.",
+      "enum": [
+        "Invalid",
+        "PartitionDataLoss",
+        "PartitionQuorumLoss",
+        "PartitionRestart",
+        "NodeTransition"
+      ],
+      "x-ms-enum": {
+        "name": "OperationType",
+        "modelAsString": true,
+        "values": [
+          {
+            "value": "Invalid",
+            "description": "The operation state is invalid."
+          },
+          {
+            "value": "PartitionDataLoss",
+            "description": "An operation started using the StartDataLoss API."
+          },
+          {
+            "value": "PartitionQuorumLoss",
+            "description": "An operation started using the StartQuorumLoss API."
+          },
+          {
+            "value": "PartitionRestart",
+            "description": "An operation started using the StartPartitionRestart API."
+          },
+          {
+            "value": "NodeTransition",
+            "description": "An operation started using the StartNodeTransition API."
+          }
+        ]
+      }
+    },
+    "PartitionDataLossProgress": {
+      "description": "Information about a partition data loss user-induced operation.",
+      "properties": {
+        "State": {
+          "$ref": "#/definitions/OperationState",
+          "description": "The state of the operation."
+        },
+        "InvokeDataLossResult": {
+          "$ref": "#/definitions/InvokeDataLossResult",
+          "description": "Represents information about an operation in a terminal state (Completed or Faulted)."
+        }
+      }
+    },
+    "PartitionQuorumLossProgress": {
+      "description": "Information about a partition quorum loss user-induced operation.",
+      "properties": {
+        "State": {
+          "$ref": "#/definitions/OperationState",
+          "description": "The state of the operation."
+        },
+        "InvokeQuorumLossResult": {
+          "$ref": "#/definitions/InvokeQuorumLossResult",
+          "description": "Represents information about an operation in a terminal state (Completed or Faulted)."
+        }
+      }
+    },
+    "PartitionRestartProgress": {
+      "description": "Information about a partition restart user-induced operation.",
+      "properties": {
+        "State": {
+          "$ref": "#/definitions/OperationState",
+          "description": "The state of the operation."
+        },
+        "RestartPartitionResult": {
+          "$ref": "#/definitions/RestartPartitionResult",
+          "description": "Represents information about an operation in a terminal state (Completed or Faulted)."
+        }
+      }
+    },
+    "RestartPartitionResult": {
+      "description": "Represents information about an operation in a terminal state (Completed or Faulted).",
+      "properties": {
+        "ErrorCode": {
+          "type": "integer",
+          "format": "int32",
+          "description": "If OperationState is Completed, this is 0.  If OperationState is Faulted, this is an error code indicating the reason."
+        },
+        "SelectedPartition": {
+          "$ref": "#/definitions/SelectedPartition",
+          "description": "This class returns information about the partition that the user-induced operation acted upon."
+        }
+      }
+    },
+    "SelectedPartition": {
+      "description": "This class returns information about the partition that the user-induced operation acted upon.",
+      "properties": {
+        "ServiceName": {
+          "$ref": "#/definitions/ServiceName",
+          "description": "The name of the service the partition belongs to."
+        },
+        "PartitionId": {
+          "$ref": "#/definitions/PartitionId",
+          "description": "An internal ID used by Service Fabric to uniquely identify a partition. This is a randomly generated GUID when the service was created. The partition ID is unique and does not change for the lifetime of the service. If the same service was deleted and recreated the IDs of its partitions would be different."
+        }
+      }
+    },
+    "DeployServicePackageToNodeDescription": {
+      "description": "Defines description for downloading packages associated with a service manifest to image cache on a Service Fabric node.",
+      "properties": {
+        "ServiceManifestName": {
+          "$ref": "#/definitions/ServiceManifestName",
+          "description": "The name of service manifest whose packages need to be downloaded."
+        },
+        "ApplicationTypeName": {
+          "$ref": "#/definitions/ApplicationTypeName",
+          "description": "The application type name as defined in the application manifest."
+        },
+        "ApplicationTypeVersion": {
+          "$ref": "#/definitions/ApplicationTypeVersion",
+          "description": "The version of the application type as defined in the application manifest."
+        },
+        "NodeName": {
+          "$ref": "#/definitions/NodeName",
+          "description": "The name of a Service Fabric node."
+        },
+        "PackageSharingPolicy": {
+          "$ref": "#/definitions/PackageSharingPolicyInfoList",
+          "description": "List of package sharing policy information."
+        }
+      },
+      "required": [
+        "ServiceManifestName",
+        "ApplicationTypeName",
+        "ApplicationTypeVersion",
+        "NodeName"
+      ]
+    },
+    "PackageSharingPolicyInfo": {
+      "description": "Represents a policy for the package sharing.",
+      "properties": {
+        "SharedPackageName": {
+          "type": "string",
+          "description": "The name of code, configuration or data package that should be shared."
+        },
+        "PackageSharingScope": {
+          "$ref": "#/definitions/PackageSharingPolicyScope",
+          "description": "Represents the scope for PackageSharingPolicy. This is specified during DeployServicePackageToNode operation."
+        }
+      }
+    },
+    "PackageSharingPolicyInfoList": {
+      "type": "array",
+      "items": {
+        "$ref": "#/definitions/PackageSharingPolicyInfo"
+      },
+      "description": "List of package sharing policy information."
+    },
+    "PackageSharingPolicyScope": {
+      "type": "string",
+      "description": "Represents the scope for PackageSharingPolicy. This is specified during DeployServicePackageToNode operation.",
+      "enum": [
+        "None",
+        "All",
+        "Code",
+        "Config",
+        "Data"
+      ],
+      "x-ms-enum": {
+        "name": "PackageSharingPolicyScope",
+        "modelAsString": true,
+        "values": [
+          {
+            "value": "None",
+            "description": "No package sharing policy scope. The value is 0."
+          },
+          {
+            "value": "All",
+            "description": "Share all code, config and data packages from corresponding service manifest. The value is 1."
+          },
+          {
+            "value": "Code",
+            "description": "Share all code packages from corresponding service manifest. The value is 2."
+          },
+          {
+            "value": "Config",
+            "description": "Share all config packages from corresponding service manifest. The value is 3."
+          },
+          {
+            "value": "Data",
+            "description": "Share all data packages from corresponding service manifest. The value is 4."
+          }
+        ]
+      }
+    },
+    "ResumeApplicationUpgradeDescription": {
+      "description": "Describes the parameters for resuming an unmonitored manual Service Fabric application upgrade",
+      "properties": {
+        "UpgradeDomainName": {
+          "type": "string",
+          "description": "The name of the upgrade domain in which to resume the upgrade."
+        }
+      },
+      "required": [
+        "UpgradeDomainName"
+      ]
+    },
+    "ApplicationUpgradeUpdateDescription": {
+      "description": "Describes the parameters for updating an ongoing application upgrade.",
+      "properties": {
+        "Name": {
+          "$ref": "#/definitions/ApplicationName",
+          "description": "The name of the application, including the 'fabric:' URI scheme."
+        },
+        "UpgradeKind": {
+          "$ref": "#/definitions/UpgradeKind",
+          "description": "The kind of upgrade out of the following possible values."
+        },
+        "ApplicationHealthPolicy": {
+          "$ref": "#/definitions/ApplicationHealthPolicy",
+          "description": "Defines a health policy used to evaluate the health of an application or one of its children entities."
+        },
+        "UpdateDescription": {
+          "$ref": "#/definitions/RollingUpgradeUpdateDescription",
+          "description": "Describes the parameters for updating a rolling upgrade of application or cluster."
+        }
+      },
+      "required": [
+        "Name",
+        "UpgradeKind"
+      ]
+    },
+    "RollingUpgradeUpdateDescription": {
+      "description": "Describes the parameters for updating a rolling upgrade of application or cluster.",
+      "properties": {
+        "RollingUpgradeMode": {
+          "$ref": "#/definitions/UpgradeMode",
+          "description": "The mode used to monitor health during a rolling upgrade. The values are UnmonitoredAuto, UnmonitoredManual, and Monitored."
+        },
+        "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)."
+        },
+        "ReplicaSetCheckTimeoutInMilliseconds": {
+          "$ref": "#/definitions/UpgradeReplicaSetCheckTimeout",
+          "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)."
+        },
+        "FailureAction": {
+          "$ref": "#/definitions/FailureAction",
+          "description": "The compensating action to perform when a Monitored upgrade encounters monitoring policy or health policy violations.\nInvalid indicates the failure action is invalid. Rollback specifies that the upgrade will start rolling back automatically.\nManual indicates that the upgrade will switch to UnmonitoredManual upgrade mode."
+        },
+        "HealthCheckWaitDurationInMilliseconds": {
+          "$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."
+        },
+        "HealthCheckStableDurationInMilliseconds": {
+          "$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."
+        },
+        "HealthCheckRetryTimeoutInMilliseconds": {
+          "$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."
+        },
+        "UpgradeTimeoutInMilliseconds": {
+          "$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."
+        },
+        "UpgradeDomainTimeoutInMilliseconds": {
+          "$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."
+        },
+        "InstanceCloseDelayDurationInSeconds": {
+          "$ref": "#/definitions/InstanceCloseDelayDurationInSeconds",
+          "description": "Duration in seconds, to wait before a stateless instance is closed, to allow the active requests to drain gracefully. This would be effective when the instance is closing during the application/cluster\nupgrade, only for those instances which have a non-zero delay duration configured in the service description. See InstanceCloseDelayDurationSeconds property in $ref: \"#/definitions/StatelessServiceDescription.yaml\" for details.\nNote, the default value of InstanceCloseDelayDurationInSeconds is 4294967295, which indicates that the behavior will entirely depend on the delay configured in the stateless service description."
+        }
+      },
+      "required": [
+        "RollingUpgradeMode"
+      ]
+    },
+    "NameDescription": {
+      "description": "Describes a Service Fabric name.",
+      "properties": {
+        "Name": {
+          "$ref": "#/definitions/FabricName",
+          "description": "The Service Fabric name, including the 'fabric:' URI scheme."
+        }
+      },
+      "required": [
+        "Name"
+      ]
+    },
+    "FabricName": {
+      "type": "string",
+      "description": "The Service Fabric name, including the 'fabric:' URI scheme."
+    },
+    "PagedSubNameInfoList": {
+      "description": "A paged list of Service Fabric names. The list is paged when all of the results cannot fit in a single message. The next set of results can be obtained by executing the same query with the continuation token provided in this list.",
+      "properties": {
+        "ContinuationToken": {
+          "$ref": "#/definitions/ContinuationToken",
+          "description": "The continuation token parameter is used to obtain next set of results. The continuation token is included in the response of the API when the results from the system do not fit in a single response. When this value is passed to the next API call, the API returns next set of results. If there are no further results, then the continuation token is not included in the response."
+        },
+        "IsConsistent": {
+          "type": "boolean",
+          "description": "Indicates whether any name under the given name has been modified during the enumeration. If there was a modification, this property value is false."
+        },
+        "SubNames": {
+          "type": "array",
+          "description": "List of the child names.",
+          "items": {
+            "$ref": "#/definitions/FabricName"
+          }
+        }
+      }
+    },
+    "PropertyValueKind": {
+      "type": "string",
+      "description": "The kind of property, determined by the type of data. Following are the possible values.",
+      "enum": [
+        "Invalid",
+        "Binary",
+        "Int64",
+        "Double",
+        "String",
+        "Guid"
+      ],
+      "x-ms-enum": {
+        "name": "PropertyValueKind",
+        "modelAsString": true,
+        "values": [
+          {
+            "value": "Invalid",
+            "description": "Indicates the property is invalid. All Service Fabric enumerations have the invalid type. The value is zero."
+          },
+          {
+            "value": "Binary",
+            "description": "The data inside the property is a binary blob. The value is 1."
+          },
+          {
+            "value": "Int64",
+            "description": "The data inside the property is an int64. The value is 2."
+          },
+          {
+            "value": "Double",
+            "description": "The data inside the property is a double. The value is 3."
+          },
+          {
+            "value": "String",
+            "description": "The data inside the property is a string. The value is 4."
+          },
+          {
+            "value": "Guid",
+            "description": "The data inside the property is a guid. The value is 5."
+          }
+        ]
+      }
+    },
+    "PropertyValue": {
+      "discriminator": "Kind",
+      "description": "Describes a Service Fabric property value.",
+      "properties": {
+        "Kind": {
+          "$ref": "#/definitions/PropertyValueKind",
+          "description": "The kind of property, determined by the type of data. Following are the possible values."
+        }
+      },
+      "required": [
+        "Kind"
+      ]
+    },
+    "BinaryPropertyValue": {
+      "description": "Describes a Service Fabric property value of type Binary.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/PropertyValue"
+        }
+      ],
+      "x-ms-discriminator-value": "Binary",
+      "required": [
+        "Data"
+      ],
+      "properties": {
+        "Data": {
+          "$ref": "#/definitions/ByteArray",
+          "description": "Array of bytes to be sent as an integer array. Each element of array is a number between 0 and 255."
+        }
+      }
+    },
+    "Int64PropertyValue": {
+      "description": "Describes a Service Fabric property value of type Int64.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/PropertyValue"
+        }
+      ],
+      "x-ms-discriminator-value": "Int64",
+      "required": [
+        "Data"
+      ],
+      "properties": {
+        "Data": {
+          "type": "string",
+          "description": "The data of the property value."
+        }
+      }
+    },
+    "DoublePropertyValue": {
+      "description": "Describes a Service Fabric property value of type Double.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/PropertyValue"
+        }
+      ],
+      "x-ms-discriminator-value": "Double",
+      "required": [
+        "Data"
+      ],
+      "properties": {
+        "Data": {
+          "type": "number",
+          "format": "double",
+          "description": "The data of the property value."
+        }
+      }
+    },
+    "StringPropertyValue": {
+      "description": "Describes a Service Fabric property value of type String.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/PropertyValue"
+        }
+      ],
+      "x-ms-discriminator-value": "String",
+      "required": [
+        "Data"
+      ],
+      "properties": {
+        "Data": {
+          "type": "string",
+          "description": "The data of the property value."
+        }
+      }
+    },
+    "GuidPropertyValue": {
+      "description": "Describes a Service Fabric property value of type Guid.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/PropertyValue"
+        }
+      ],
+      "x-ms-discriminator-value": "Guid",
+      "required": [
+        "Data"
+      ],
+      "properties": {
+        "Data": {
+          "type": "string",
+          "format": "uuid",
+          "description": "The data of the property value."
+        }
+      }
+    },
+    "PropertyInfo": {
+      "description": "Information about a Service Fabric property.",
+      "properties": {
+        "Name": {
+          "$ref": "#/definitions/PropertyName",
+          "description": "The name of the Service Fabric property."
+        },
+        "Value": {
+          "$ref": "#/definitions/PropertyValue",
+          "description": "Describes a Service Fabric property value."
+        },
+        "Metadata": {
+          "$ref": "#/definitions/PropertyMetadata",
+          "description": "The metadata associated with a property, including the property's name."
+        }
+      },
+      "required": [
+        "Name",
+        "Metadata"
+      ]
+    },
+    "PagedPropertyInfoList": {
+      "description": "The paged list of Service Fabric properties under a given name. The list is paged when all of the results cannot fit in a single message. The next set of results can be obtained by executing the same query with the continuation token provided in this list.",
+      "properties": {
+        "ContinuationToken": {
+          "$ref": "#/definitions/ContinuationToken",
+          "description": "The continuation token parameter is used to obtain next set of results. The continuation token is included in the response of the API when the results from the system do not fit in a single response. When this value is passed to the next API call, the API returns next set of results. If there are no further results, then the continuation token is not included in the response."
+        },
+        "IsConsistent": {
+          "type": "boolean",
+          "description": "Indicates whether any property under the given name has been modified during the enumeration. If there was a modification, this property value is false."
+        },
+        "Properties": {
+          "type": "array",
+          "description": "List of property information.",
+          "items": {
+            "$ref": "#/definitions/PropertyInfo"
+          }
+        }
+      }
+    },
+    "PropertyDescription": {
+      "description": "Description of a Service Fabric property.",
+      "properties": {
+        "PropertyName": {
+          "$ref": "#/definitions/PropertyName",
+          "description": "The name of the Service Fabric property."
+        },
+        "CustomTypeId": {
+          "$ref": "#/definitions/PropertyCustomTypeId",
+          "description": "The property's custom type ID. Using this property, the user is able to tag the type of the value of the property."
+        },
+        "Value": {
+          "$ref": "#/definitions/PropertyValue",
+          "description": "Describes a Service Fabric property value."
+        }
+      },
+      "required": [
+        "PropertyName",
+        "Value"
+      ]
+    },
+    "PropertyName": {
+      "type": "string",
+      "description": "The name of the Service Fabric property."
+    },
+    "PropertyMetadata": {
+      "description": "The metadata associated with a property, including the property's name.",
+      "properties": {
+        "TypeId": {
+          "$ref": "#/definitions/PropertyValueKind",
+          "description": "The kind of property, determined by the type of data. Following are the possible values."
+        },
+        "CustomTypeId": {
+          "$ref": "#/definitions/PropertyCustomTypeId",
+          "description": "The property's custom type ID."
+        },
+        "Parent": {
+          "$ref": "#/definitions/FabricName",
+          "description": "The name of the parent Service Fabric Name for the property. It could be thought of as the name-space/table under which the property exists."
+        },
+        "SizeInBytes": {
+          "type": "integer",
+          "description": "The length of the serialized property value."
+        },
+        "LastModifiedUtcTimestamp": {
+          "type": "string",
+          "format": "date-time",
+          "description": "Represents when the Property was last modified. Only write operations will cause this field to be updated."
+        },
+        "SequenceNumber": {
+          "type": "string",
+          "description": "The version of the property. Every time a property is modified, its sequence number is increased."
+        }
+      }
+    },
+    "PropertyCustomTypeId": {
+      "type": "string",
+      "description": "The property's custom type ID. Using this property, the user is able to tag the type of the value of the property."
+    },
+    "PropertyBatchDescriptionList": {
+      "description": "Describes a list of property batch operations to be executed. Either all or none of the operations will be committed.",
+      "properties": {
+        "Operations": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/PropertyBatchOperation"
+          },
+          "description": "A list of the property batch operations to be executed."
+        }
+      }
+    },
+    "PropertyBatchOperationKind": {
+      "type": "string",
+      "description": "The kind of property batch operation, determined by the operation to be performed. The following are the possible values.",
+      "enum": [
+        "Invalid",
+        "Put",
+        "Get",
+        "CheckExists",
+        "CheckSequence",
+        "Delete",
+        "CheckValue"
+      ],
+      "x-ms-enum": {
+        "name": "PropertyBatchOperationKind",
+        "modelAsString": true,
+        "values": [
+          {
+            "value": "Invalid",
+            "description": "Indicates the property operation is invalid. All Service Fabric enumerations have the invalid type. The value is zero."
+          },
+          {
+            "value": "Put",
+            "description": "The operation will create or edit a property. The value is 1."
+          },
+          {
+            "value": "Get",
+            "description": "The operation will get a property. The value is 2."
+          },
+          {
+            "value": "CheckExists",
+            "description": "The operation will check that a property exists or doesn't exists, depending on the provided value. The value is 3."
+          },
+          {
+            "value": "CheckSequence",
+            "description": "The operation will ensure that the sequence number is equal to the provided value. The value is 4."
+          },
+          {
+            "value": "Delete",
+            "description": "The operation will delete a property. The value is 5."
+          },
+          {
+            "value": "CheckValue",
+            "description": "The operation will ensure that the value of a property is equal to the provided value. The value is 7."
+          }
+        ]
+      }
+    },
+    "PropertyBatchOperation": {
+      "discriminator": "Kind",
+      "description": "Represents the base type for property operations that can be put into a batch and submitted.",
+      "properties": {
+        "Kind": {
+          "$ref": "#/definitions/PropertyBatchOperationKind",
+          "description": "The kind of property batch operation, determined by the operation to be performed. The following are the possible values."
+        },
+        "PropertyName": {
+          "$ref": "#/definitions/PropertyName",
+          "description": "The name of the Service Fabric property."
+        }
+      },
+      "required": [
+        "Kind",
+        "PropertyName"
+      ]
+    },
+    "CheckExistsPropertyBatchOperation": {
+      "description": "Represents a PropertyBatchOperation that compares the Boolean existence of a property with the Exists argument.\nThe PropertyBatchOperation operation fails if the property's existence is not equal to the Exists argument.\nThe CheckExistsPropertyBatchOperation is generally used as a precondition for the write operations in the batch.\nNote that if one PropertyBatchOperation in a PropertyBatch fails,\nthe entire batch fails and cannot be committed in a transactional manner.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/PropertyBatchOperation"
+        }
+      ],
+      "x-ms-discriminator-value": "CheckExists",
+      "properties": {
+        "Exists": {
+          "type": "boolean",
+          "description": "Whether or not the property should exist for the operation to pass."
+        }
+      },
+      "required": [
+        "Exists"
+      ]
+    },
+    "CheckSequencePropertyBatchOperation": {
+      "description": "Compares the Sequence Number of a property with the SequenceNumber argument.\nA property's sequence number can be thought of as that property's version.\nEvery time the property is modified, its sequence number is increased.\nThe sequence number can be found in a property's metadata.\nThe comparison fails if the sequence numbers are not equal.\nCheckSequencePropertyBatchOperation is generally used as a precondition for the write operations in the batch.\nNote that if one PropertyBatchOperation in a PropertyBatch fails,\nthe entire batch fails and cannot be committed in a transactional manner.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/PropertyBatchOperation"
+        }
+      ],
+      "x-ms-discriminator-value": "CheckSequence",
+      "properties": {
+        "SequenceNumber": {
+          "type": "string",
+          "description": "The expected sequence number."
+        }
+      },
+      "required": [
+        "SequenceNumber"
+      ]
+    },
+    "CheckValuePropertyBatchOperation": {
+      "description": "Represents a PropertyBatchOperation that compares the value of the property with the expected value.\nThe CheckValuePropertyBatchOperation is generally used as a precondition for the write operations in the batch.\nNote that if one PropertyBatchOperation in a PropertyBatch fails,\nthe entire batch fails and cannot be committed in a transactional manner.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/PropertyBatchOperation"
+        }
+      ],
+      "x-ms-discriminator-value": "CheckValue",
+      "properties": {
+        "Value": {
+          "$ref": "#/definitions/PropertyValue",
+          "description": "The expected property value."
+        }
+      },
+      "required": [
+        "Value"
+      ]
+    },
+    "DeletePropertyBatchOperation": {
+      "description": "Represents a PropertyBatchOperation that deletes a specified property if it exists.\nNote that if one PropertyBatchOperation in a PropertyBatch fails,\nthe entire batch fails and cannot be committed in a transactional manner.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/PropertyBatchOperation"
+        }
+      ],
+      "x-ms-discriminator-value": "Delete"
+    },
+    "GetPropertyBatchOperation": {
+      "description": "Represents a PropertyBatchOperation that gets the specified property if it exists.\nNote that if one PropertyBatchOperation in a PropertyBatch fails,\nthe entire batch fails and cannot be committed in a transactional manner.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/PropertyBatchOperation"
+        }
+      ],
+      "x-ms-discriminator-value": "Get",
+      "properties": {
+        "IncludeValue": {
+          "type": "boolean",
+          "default": false,
+          "description": "Whether or not to return the property value with the metadata.\nTrue if values should be returned with the metadata; False to return only property metadata."
+        }
+      }
+    },
+    "PutPropertyBatchOperation": {
+      "description": "Puts the specified property under the specified name.\nNote that if one PropertyBatchOperation in a PropertyBatch fails,\nthe entire batch fails and cannot be committed in a transactional manner.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/PropertyBatchOperation"
+        }
+      ],
+      "x-ms-discriminator-value": "Put",
+      "properties": {
+        "Value": {
+          "$ref": "#/definitions/PropertyValue",
+          "description": "Describes a Service Fabric property value."
+        },
+        "CustomTypeId": {
+          "$ref": "#/definitions/PropertyCustomTypeId",
+          "description": "The property's custom type ID. Using this property, the user is able to tag the type of the value of the property."
+        }
+      },
+      "required": [
+        "Value"
+      ]
+    },
+    "PropertyBatchInfoKind": {
+      "type": "string",
+      "description": "The kind of property batch info, determined by the results of a property batch. The following are the possible values.",
+      "enum": [
+        "Invalid",
+        "Successful",
+        "Failed"
+      ],
+      "x-ms-enum": {
+        "name": "PropertyBatchInfoKind",
+        "modelAsString": true,
+        "values": [
+          {
+            "value": "Invalid",
+            "description": "Indicates the property batch info is invalid. All Service Fabric enumerations have the invalid type."
+          },
+          {
+            "value": "Successful",
+            "description": "The property batch succeeded."
+          },
+          {
+            "value": "Failed",
+            "description": "The property batch failed."
+          }
+        ]
+      }
+    },
+    "PropertyBatchInfo": {
+      "discriminator": "Kind",
+      "description": "Information about the results of a property batch.",
+      "properties": {
+        "Kind": {
+          "$ref": "#/definitions/PropertyBatchInfoKind",
+          "description": "The kind of property batch info, determined by the results of a property batch. The following are the possible values."
+        }
+      },
+      "required": [
+        "Kind"
+      ]
+    },
+    "SuccessfulPropertyBatchInfo": {
+      "description": "Derived from PropertyBatchInfo. Represents the property batch succeeding. Contains the results of any \"Get\" operations in the batch.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/PropertyBatchInfo"
+        }
+      ],
+      "x-ms-discriminator-value": "Successful",
+      "properties": {
+        "Properties": {
+          "additionalProperties": {
+            "$ref": "#/definitions/PropertyInfo"
+          },
+          "description": "A map containing the properties that were requested through any \"Get\" property batch operations. The key represents the index of the \"Get\" operation in the original request, in string form. The value is the property. If a property is not found, it will not be in the map."
+        }
+      }
+    },
+    "FailedPropertyBatchInfo": {
+      "description": "Derived from PropertyBatchInfo. Represents the property batch failing. Contains information about the specific batch failure.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/PropertyBatchInfo"
+        }
+      ],
+      "x-ms-discriminator-value": "Failed",
+      "properties": {
+        "ErrorMessage": {
+          "type": "string",
+          "description": "The error message of the failed operation. Describes the exception thrown due to the first unsuccessful operation in the property batch."
+        },
+        "OperationIndex": {
+          "type": "integer",
+          "description": "The index of the unsuccessful operation in the property batch."
+        }
+      }
+    },
+    "EntityKind": {
+      "type": "string",
+      "description": "The entity type of a Service Fabric entity such as Cluster, Node, Application, Service, Partition, Replica etc.",
+      "enum": [
+        "Invalid",
+        "Node",
+        "Partition",
+        "Service",
+        "Application",
+        "Replica",
+        "DeployedApplication",
+        "DeployedServicePackage",
+        "Cluster"
+      ],
+      "x-ms-enum": {
+        "name": "EntityKind",
+        "modelAsString": true,
+        "values": [
+          {
+            "value": "Invalid",
+            "description": "Indicates an invalid entity kind. All Service Fabric enumerations have the invalid type. The value is zero."
+          },
+          {
+            "value": "Node",
+            "description": "Indicates the entity is a Service Fabric node. The value is 1."
+          },
+          {
+            "value": "Partition",
+            "description": "Indicates the entity is a Service Fabric partition. The value is 2."
+          },
+          {
+            "value": "Service",
+            "description": "Indicates the entity is a Service Fabric service. The value is 3."
+          },
+          {
+            "value": "Application",
+            "description": "Indicates the entity is a Service Fabric application. The value is 4."
+          },
+          {
+            "value": "Replica",
+            "description": "Indicates the entity is a Service Fabric replica. The value is 5."
+          },
+          {
+            "value": "DeployedApplication",
+            "description": "Indicates the entity is a Service Fabric deployed application. The value is 6."
+          },
+          {
+            "value": "DeployedServicePackage",
+            "description": "Indicates the entity is a Service Fabric deployed service package. The value is 7."
+          },
+          {
+            "value": "Cluster",
+            "description": "Indicates the entity is a Service Fabric cluster. The value is 8."
+          }
+        ]
+      }
+    },
+    "HealthStateCount": {
+      "description": "Represents information about how many health entities are in Ok, Warning and Error health state.",
+      "properties": {
+        "OkCount": {
+          "type": "integer",
+          "format": "int64",
+          "description": "The number of health entities with aggregated health state Ok.",
+          "minimum": 0
+        },
+        "WarningCount": {
+          "type": "integer",
+          "format": "int64",
+          "description": "The number of health entities with aggregated health state Warning.",
+          "minimum": 0
+        },
+        "ErrorCount": {
+          "type": "integer",
+          "format": "int64",
+          "description": "The number of health entities with aggregated health state Error.",
+          "minimum": 0
+        }
+      }
+    },
+    "EntityKindHealthStateCount": {
+      "description": "Represents health state count for entities of the specified entity kind.",
+      "properties": {
+        "EntityKind": {
+          "$ref": "#/definitions/EntityKind",
+          "description": "The entity kind for which health states are evaluated."
+        },
+        "HealthStateCount": {
+          "$ref": "#/definitions/HealthStateCount",
+          "description": "The health state count for the entities of the specified kind."
+        }
+      }
+    },
+    "HealthStatistics": {
+      "description": "The health statistics of an entity, returned as part of the health query result when the query description is configured to include statistics.\nThe statistics include health state counts for all children types of the current entity.\nFor example, for cluster, the health statistics include health state counts for nodes, applications, services, partitions, replicas, deployed applications and deployed service packages.\nFor partition, the health statistics include health counts for replicas.",
+      "properties": {
+        "HealthStateCountList": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/EntityKindHealthStateCount"
+          },
+          "description": "List of health state counts per entity kind, which keeps track of how many children of the queried entity are in Ok, Warning and Error state."
+        }
+      }
+    },
+    "BackupPolicyDescription": {
+      "description": "Describes a backup policy for configuring periodic backup.",
+      "required": [
+        "Name",
+        "AutoRestoreOnDataLoss",
+        "Schedule",
+        "MaxIncrementalBackups",
+        "Storage"
+      ],
+      "properties": {
+        "Name": {
+          "type": "string",
+          "description": "The unique name identifying this backup policy."
+        },
+        "AutoRestoreOnDataLoss": {
+          "type": "boolean",
+          "description": "Specifies whether to trigger restore automatically using the latest available backup in case the partition experiences a data loss event."
+        },
+        "MaxIncrementalBackups": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 255,
+          "description": "Defines the maximum number of incremental backups to be taken between two full backups. This is just the upper limit. A full backup may be taken before specified number of incremental backups are completed in one of the following conditions\n- The replica has never taken a full backup since it has become primary,\n- Some of the log records since the last backup has been truncated, or\n- Replica passed the MaxAccumulatedBackupLogSizeInMB limit."
+        },
+        "Schedule": {
+          "$ref": "#/definitions/BackupScheduleDescription",
+          "description": "Describes the backup schedule parameters."
+        },
+        "Storage": {
+          "$ref": "#/definitions/BackupStorageDescription",
+          "description": "Describes the details of backup storage where to store the periodic backups."
+        },
+        "RetentionPolicy": {
+          "$ref": "#/definitions/RetentionPolicyDescription",
+          "description": "Describes the policy to retain backups in storage."
+        }
+      }
+    },
+    "PagedBackupPolicyDescriptionList": {
+      "description": "The list of backup policies configured in the cluster. The list is paged when all of the results cannot fit in a single message. The next set of results can be obtained by executing the same query with the continuation token provided in this list.",
+      "properties": {
+        "ContinuationToken": {
+          "$ref": "#/definitions/ContinuationToken",
+          "description": "The continuation token parameter is used to obtain next set of results. The continuation token is included in the response of the API when the results from the system do not fit in a single response. When this value is passed to the next API call, the API returns next set of results. If there are no further results, then the continuation token is not included in the response."
+        },
+        "Items": {
+          "type": "array",
+          "description": "The list of backup policies information.",
+          "items": {
+            "$ref": "#/definitions/BackupPolicyDescription"
+          }
+        }
+      }
+    },
+    "BasicRetentionPolicyDescription": {
+      "description": "Describes basic retention policy.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/RetentionPolicyDescription"
+        }
+      ],
+      "x-ms-discriminator-value": "Basic",
+      "required": [
+        "RetentionDuration"
+      ],
+      "properties": {
+        "RetentionDuration": {
+          "type": "string",
+          "format": "duration",
+          "description": "It is the minimum duration for which a backup created, will remain stored in the storage and might get deleted after that span of time. It should be specified in ISO8601 format."
+        },
+        "MinimumNumberOfBackups": {
+          "type": "integer",
+          "minimum": 0,
+          "description": "It is the minimum number of backups to be retained at any point of time. If specified with a non zero value, backups will not be deleted even if the backups have gone past retention duration and have number of backups less than or equal to it."
+        }
+      }
+    },
+    "RetentionPolicyType": {
+      "type": "string",
+      "description": "The type of retention policy. Currently only \"Basic\" retention policy is supported.",
+      "enum": [
+        "Basic",
+        "Invalid"
+      ],
+      "x-ms-enum": {
+        "name": "RetentionPolicyType",
+        "modelAsString": true,
+        "values": [
+          {
+            "value": "Basic",
+            "description": "Indicates a basic retention policy type."
+          },
+          {
+            "value": "Invalid",
+            "description": "Indicates an invalid retention policy type."
+          }
+        ]
+      }
+    },
+    "DisableBackupDescription": {
+      "description": "It describes the body parameters while disabling backup of a backup entity(Application/Service/Partition).",
+      "required": [
+        "CleanBackup"
+      ],
+      "properties": {
+        "CleanBackup": {
+          "type": "boolean",
+          "description": "Boolean flag to delete backups. It can be set to true for deleting all the backups which were created for the backup entity that is getting disabled for backup."
+        }
+      }
+    },
+    "RetentionPolicyDescription": {
+      "description": "Describes the retention policy configured.",
+      "required": [
+        "RetentionPolicyType"
+      ],
+      "discriminator": "RetentionPolicyType",
+      "properties": {
+        "RetentionPolicyType": {
+          "$ref": "#/definitions/RetentionPolicyType",
+          "description": "The type of retention policy. Currently only \"Basic\" retention policy is supported."
+        }
+      }
+    },
+    "BackupStorageDescription": {
+      "required": [
+        "StorageKind"
+      ],
+      "discriminator": "StorageKind",
+      "properties": {
+        "StorageKind": {
+          "$ref": "#/definitions/BackupStorageKind",
+          "description": "The kind of backup storage, where backups are saved."
+        },
+        "FriendlyName": {
+          "type": "string",
+          "description": "Friendly name for this backup storage."
+        }
+      },
+      "description": "Describes the parameters for the backup storage."
+    },
+    "BackupStorageKind": {
+      "type": "string",
+      "description": "The kind of backup storage, where backups are saved.",
+      "enum": [
+        "Invalid",
+        "FileShare",
+        "AzureBlobStore",
+        "DsmsAzureBlobStore"
+      ],
+      "x-ms-enum": {
+        "name": "BackupStorageKind",
+        "modelAsString": true,
+        "values": [
+          {
+            "value": "Invalid",
+            "description": "Indicates an invalid backup storage kind. All Service Fabric enumerations have the invalid type."
+          },
+          {
+            "value": "FileShare",
+            "description": "Indicates file/ SMB share to be used as backup storage."
+          },
+          {
+            "value": "AzureBlobStore",
+            "description": "Indicates Azure blob store to be used as backup storage."
+          },
+          {
+            "value": "DsmsAzureBlobStore",
+            "description": "Indicates Dsms Azure blob store to be used as backup storage."
+          }
+        ]
+      }
+    },
+    "BackupScheduleDescription": {
+      "description": "Describes the backup schedule parameters.",
+      "required": [
+        "ScheduleKind"
+      ],
+      "discriminator": "ScheduleKind",
+      "properties": {
+        "ScheduleKind": {
+          "$ref": "#/definitions/BackupScheduleKind",
+          "description": "The kind of backup schedule, time based or frequency based."
+        }
+      }
+    },
+    "BackupScheduleKind": {
+      "type": "string",
+      "description": "The kind of backup schedule, time based or frequency based.",
+      "enum": [
+        "Invalid",
+        "TimeBased",
+        "FrequencyBased"
+      ],
+      "x-ms-enum": {
+        "name": "BackupScheduleKind",
+        "modelAsString": true,
+        "values": [
+          {
+            "value": "Invalid",
+            "description": "Indicates an invalid backup schedule kind. All Service Fabric enumerations have the invalid type."
+          },
+          {
+            "value": "TimeBased",
+            "description": "Indicates a time-based backup schedule."
+          },
+          {
+            "value": "FrequencyBased",
+            "description": "Indicates a frequency-based backup schedule."
+          }
+        ]
+      }
+    },
+    "ApplicationBackupConfigurationInfo": {
+      "description": "Backup configuration information for a specific Service Fabric application specifying what backup policy is being applied and suspend description, if any.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/BackupConfigurationInfo"
+        }
+      ],
+      "properties": {
+        "ApplicationName": {
+          "$ref": "#/definitions/ApplicationName",
+          "description": "The name of the application, including the 'fabric:' URI scheme."
+        }
+      },
+      "x-ms-discriminator-value": "Application"
+    },
+    "ServiceBackupConfigurationInfo": {
+      "description": "Backup configuration information for a specific Service Fabric service specifying what backup policy is being applied and suspend description, if any.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/BackupConfigurationInfo"
+        }
+      ],
+      "properties": {
+        "ServiceName": {
+          "$ref": "#/definitions/ServiceName",
+          "description": "The full name of the service with 'fabric:' URI scheme."
+        }
+      },
+      "x-ms-discriminator-value": "Service"
+    },
+    "PagedBackupConfigurationInfoList": {
+      "description": "The list of backup configuration information. The list is paged when all of the results cannot fit in a single message. The next set of results can be obtained by executing the same query with the continuation token provided in this list.",
+      "properties": {
+        "ContinuationToken": {
+          "$ref": "#/definitions/ContinuationToken",
+          "description": "The continuation token parameter is used to obtain next set of results. The continuation token is included in the response of the API when the results from the system do not fit in a single response. When this value is passed to the next API call, the API returns next set of results. If there are no further results, then the continuation token is not included in the response."
+        },
+        "Items": {
+          "type": "array",
+          "description": "List of backup configuration information.",
+          "items": {
+            "$ref": "#/definitions/BackupConfigurationInfo"
+          }
+        }
+      }
+    },
+    "BackupPolicyScope": {
+      "type": "string",
+      "description": "Specifies the scope at which the backup policy is applied.",
+      "enum": [
+        "Invalid",
+        "Partition",
+        "Service",
+        "Application"
+      ],
+      "x-ms-enum": {
+        "name": "BackupPolicyScope",
+        "modelAsString": true,
+        "values": [
+          {
+            "value": "Invalid",
+            "description": "Indicates an invalid backup policy scope type. All Service Fabric enumerations have the invalid type."
+          },
+          {
+            "value": "Partition",
+            "description": "Indicates the backup policy is applied at partition level. Hence overriding any policy which may have applied at partition's service or application level."
+          },
+          {
+            "value": "Service",
+            "description": "Indicates the backup policy is applied at service level. All partitions of the service inherit this policy unless explicitly overridden at partition level."
+          },
+          {
+            "value": "Application",
+            "description": "Indicates the backup policy is applied at application level. All services and partitions of the application inherit this policy unless explicitly overridden at service or partition level."
+          }
+        ]
+      }
+    },
+    "BackupSuspensionScope": {
+      "type": "string",
+      "description": "Specifies the scope at which the backup suspension was applied.",
+      "enum": [
+        "Invalid",
+        "Partition",
+        "Service",
+        "Application"
+      ],
+      "x-ms-enum": {
+        "name": "BackupSuspensionScope",
+        "modelAsString": true,
+        "values": [
+          {
+            "value": "Invalid",
+            "description": "Indicates an invalid backup suspension scope type also indicating entity is not suspended. All Service Fabric enumerations have the invalid type."
+          },
+          {
+            "value": "Partition",
+            "description": "Indicates the backup suspension is applied at partition level."
+          },
+          {
+            "value": "Service",
+            "description": "Indicates the backup suspension is applied at service level. All partitions of the service are hence suspended for backup."
+          },
+          {
+            "value": "Application",
+            "description": "Indicates the backup suspension is applied at application level. All services and partitions of the application are hence suspended for backup."
+          }
+        ]
+      }
+    },
+    "RestorePartitionDescription": {
+      "description": "Specifies the parameters needed to trigger a restore of a specific partition.",
+      "required": [
+        "BackupId",
+        "BackupLocation"
+      ],
+      "properties": {
+        "BackupId": {
+          "type": "string",
+          "format": "uuid",
+          "description": "Unique backup ID."
+        },
+        "BackupLocation": {
+          "type": "string",
+          "description": "Location of the backup relative to the backup storage specified/ configured."
+        },
+        "BackupStorage": {
+          "$ref": "#/definitions/BackupStorageDescription",
+          "description": "Location of the backup from where the partition will be restored."
+        }
+      }
+    },
+    "RestoreProgressInfo": {
+      "description": "Describes the progress of a restore operation on a partition.",
+      "properties": {
+        "RestoreState": {
+          "$ref": "#/definitions/RestoreState",
+          "description": "Represents the current state of the partition restore operation."
+        },
+        "TimeStampUtc": {
+          "type": "string",
+          "format": "date-time",
+          "description": "Timestamp when operation succeeded or failed."
+        },
+        "RestoredEpoch": {
+          "$ref": "#/definitions/Epoch",
+          "description": "Describes the epoch at which the partition is restored."
+        },
+        "RestoredLsn": {
+          "type": "string",
+          "description": "Restored LSN."
+        },
+        "FailureError": {
+          "$ref": "#/definitions/FabricErrorError",
+          "description": "Denotes the failure encountered in performing restore operation."
+        }
+      }
+    },
+    "RestoreState": {
+      "type": "string",
+      "description": "Represents the current state of the partition restore operation.",
+      "enum": [
+        "Invalid",
+        "Accepted",
+        "RestoreInProgress",
+        "Success",
+        "Failure",
+        "Timeout"
+      ],
+      "x-ms-enum": {
+        "name": "RestoreState",
+        "modelAsString": true,
+        "values": [
+          {
+            "value": "Invalid",
+            "description": "Indicates an invalid restore state. All Service Fabric enumerations have the invalid type."
+          },
+          {
+            "value": "Accepted",
+            "description": "Operation has been validated and accepted. Restore is yet to be triggered."
+          },
+          {
+            "value": "RestoreInProgress",
+            "description": "Restore operation has been triggered and is under process."
+          },
+          {
+            "value": "Success",
+            "description": "Operation completed with success."
+          },
+          {
+            "value": "Failure",
+            "description": "Operation completed with failure."
+          },
+          {
+            "value": "Timeout",
+            "description": "Operation timed out."
+          }
+        ]
+      }
+    },
+    "BackupPartitionDescription": {
+      "description": "Describes the parameters for triggering partition's backup.",
+      "properties": {
+        "BackupStorage": {
+          "$ref": "#/definitions/BackupStorageDescription",
+          "description": "Specifies the details of the backup storage where to save the backup."
+        }
+      }
+    },
+    "BackupInfo": {
+      "description": "Represents a backup point which can be used to trigger a restore.",
+      "properties": {
+        "BackupId": {
+          "type": "string",
+          "format": "uuid",
+          "description": "Unique backup ID ."
+        },
+        "BackupChainId": {
+          "type": "string",
+          "format": "uuid",
+          "description": "Unique backup chain ID. All backups part of the same chain has the same backup chain id. A backup chain is comprised of 1 full backup and multiple incremental backups."
+        },
+        "ApplicationName": {
+          "type": "string",
+          "description": "Name of the Service Fabric application this partition backup belongs to."
+        },
+        "ServiceName": {
+          "type": "string",
+          "description": "Name of the Service Fabric service this partition backup belongs to."
+        },
+        "PartitionInformation": {
+          "$ref": "#/definitions/PartitionInformation",
+          "description": "Information about the partition to which this backup belongs to"
+        },
+        "BackupLocation": {
+          "type": "string",
+          "description": "Location of the backup, relative to the backup store."
+        },
+        "BackupType": {
+          "$ref": "#/definitions/BackupType",
+          "description": "Describes the type of backup, whether its full or incremental."
+        },
+        "EpochOfLastBackupRecord": {
+          "$ref": "#/definitions/Epoch",
+          "description": "Epoch of the last record in this backup."
+        },
+        "LsnOfLastBackupRecord": {
+          "type": "string",
+          "description": "LSN of the last record in this backup."
+        },
+        "CreationTimeUtc": {
+          "type": "string",
+          "format": "date-time",
+          "description": "The date time when this backup was taken."
+        },
+        "ServiceManifestVersion": {
+          "type": "string",
+          "description": "Manifest Version of the service this partition backup belongs to."
+        },
+        "FailureError": {
+          "$ref": "#/definitions/FabricErrorError",
+          "description": "Denotes the failure encountered in getting backup point information."
+        }
+      }
+    },
+    "PagedBackupInfoList": {
+      "description": "The list of backups. The list is paged when all of the results cannot fit in a single message. The next set of results can be obtained by executing the same query with the continuation token provided in this list.",
+      "properties": {
+        "ContinuationToken": {
+          "$ref": "#/definitions/ContinuationToken",
+          "description": "The continuation token parameter is used to obtain next set of results. The continuation token is included in the response of the API when the results from the system do not fit in a single response. When this value is passed to the next API call, the API returns next set of results. If there are no further results, then the continuation token is not included in the response."
+        },
+        "Items": {
+          "type": "array",
+          "description": "List of backup information.",
+          "items": {
+            "$ref": "#/definitions/BackupInfo"
+          }
+        }
+      }
+    },
+    "BackupType": {
+      "type": "string",
+      "description": "Describes the type of backup, whether its full or incremental.",
+      "enum": [
+        "Invalid",
+        "Full",
+        "Incremental"
+      ],
+      "x-ms-enum": {
+        "name": "BackupType",
+        "modelAsString": true,
+        "values": [
+          {
+            "value": "Invalid",
+            "description": "Indicates an invalid backup type. All Service Fabric enumerations have the invalid type."
+          },
+          {
+            "value": "Full",
+            "description": "Indicates a full backup."
+          },
+          {
+            "value": "Incremental",
+            "description": "Indicates an incremental backup. A backup chain is comprised of a full backup followed by 0 or more incremental backups."
+          }
+        ]
+      }
+    },
+    "AzureBlobBackupStorageDescription": {
+      "allOf": [
+        {
+          "$ref": "#/definitions/BackupStorageDescription"
+        }
+      ],
+      "x-ms-discriminator-value": "AzureBlobStore",
+      "required": [
+        "ConnectionString",
+        "ContainerName"
+      ],
+      "properties": {
+        "ConnectionString": {
+          "type": "string",
+          "description": "The connection string to connect to the Azure blob store."
+        },
+        "ContainerName": {
+          "type": "string",
+          "description": "The name of the container in the blob store to store and enumerate backups from."
+        }
+      },
+      "description": "Describes the parameters for Azure blob store used for storing and enumerating backups."
+    },
+    "FileShareBackupStorageDescription": {
+      "allOf": [
+        {
+          "$ref": "#/definitions/BackupStorageDescription"
+        }
+      ],
+      "x-ms-discriminator-value": "FileShare",
+      "required": [
+        "Path"
+      ],
+      "description": "Describes the parameters for file share storage used for storing or enumerating backups.",
+      "properties": {
+        "Path": {
+          "type": "string",
+          "description": "UNC path of the file share where to store or enumerate backups from."
+        },
+        "PrimaryUserName": {
+          "type": "string",
+          "description": "Primary user name to access the file share."
+        },
+        "PrimaryPassword": {
+          "type": "string",
+          "description": "Primary password to access the share location."
+        },
+        "SecondaryUserName": {
+          "type": "string",
+          "description": "Secondary user name to access the file share."
+        },
+        "SecondaryPassword": {
+          "type": "string",
+          "description": "Secondary password to access the share location"
+        }
+      }
+    },
+    "DsmsAzureBlobBackupStorageDescription": {
+      "allOf": [
+        {
+          "$ref": "#/definitions/BackupStorageDescription"
+        }
+      ],
+      "x-ms-discriminator-value": "DsmsAzureBlobStore",
+      "required": [
+        "StorageCredentialsSourceLocation",
+        "ContainerName"
+      ],
+      "properties": {
+        "StorageCredentialsSourceLocation": {
+          "type": "string",
+          "description": "The source location of the storage credentials to connect to the Dsms Azure blob store."
+        },
+        "ContainerName": {
+          "type": "string",
+          "description": "The name of the container in the blob store to store and enumerate backups from."
+        }
+      },
+      "description": "Describes the parameters for Dsms Azure blob store used for storing and enumerating backups."
+    },
+    "FrequencyBasedBackupScheduleDescription": {
+      "description": "Describes the frequency based backup schedule.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/BackupScheduleDescription"
+        }
+      ],
+      "x-ms-discriminator-value": "FrequencyBased",
+      "required": [
+        "Interval"
+      ],
+      "properties": {
+        "Interval": {
+          "type": "string",
+          "format": "duration",
+          "description": "Defines the interval with which backups are periodically taken. It should be specified in ISO8601 format. Timespan in seconds is not supported and will be ignored while creating the policy."
+        }
+      }
+    },
+    "TimeBasedBackupScheduleDescription": {
+      "description": "Describes the time based backup schedule.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/BackupScheduleDescription"
+        }
+      ],
+      "x-ms-discriminator-value": "TimeBased",
+      "required": [
+        "ScheduleFrequencyType",
+        "RunTimes"
+      ],
+      "properties": {
+        "ScheduleFrequencyType": {
+          "$ref": "#/definitions/BackupScheduleFrequencyType",
+          "description": "Describes the frequency with which to run the time based backup schedule."
+        },
+        "RunDays": {
+          "$ref": "#/definitions/DayOfWeekList",
+          "description": "List of days of a week when to trigger the periodic backup. This is valid only when the backup schedule frequency type is weekly."
+        },
+        "RunTimes": {
+          "$ref": "#/definitions/TimeList",
+          "description": "Represents the list of exact time during the day in ISO8601 format. Like '19:00:00' will represent '7PM' during the day. Date specified along with time will be ignored."
+        }
+      }
+    },
+    "BackupScheduleFrequencyType": {
+      "type": "string",
+      "description": "Describes the frequency with which to run the time based backup schedule.",
+      "enum": [
+        "Invalid",
+        "Daily",
+        "Weekly"
+      ],
+      "x-ms-enum": {
+        "name": "BackupScheduleFrequencyType",
+        "modelAsString": true,
+        "values": [
+          {
+            "value": "Invalid",
+            "description": "Indicates an invalid backup schedule frequency type. All Service Fabric enumerations have the invalid type."
+          },
+          {
+            "value": "Daily",
+            "description": "Indicates that the time based backup schedule is repeated at a daily frequency."
+          },
+          {
+            "value": "Weekly",
+            "description": "Indicates that the time based backup schedule is repeated at a weekly frequency."
+          }
+        ]
+      }
+    },
+    "TimeList": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "format": "date-time"
+      },
+      "description": "Represents the list of exact time during the day in ISO8601 format. Like '19:00:00' will represent '7PM' during the day. Date specified along with time will be ignored."
+    },
+    "DayOfWeekList": {
+      "type": "array",
+      "items": {
+        "$ref": "#/definitions/DayOfWeek"
+      },
+      "description": "List of days of a week when to trigger the periodic backup. This is valid only when the backup schedule frequency type is weekly."
+    },
+    "DayOfWeek": {
+      "type": "string",
+      "description": "Describes the days in a week.",
+      "enum": [
+        "Sunday",
+        "Monday",
+        "Tuesday",
+        "Wednesday",
+        "Thursday",
+        "Friday",
+        "Saturday"
+      ],
+      "x-ms-enum": {
+        "name": "DayOfWeek",
+        "modelAsString": true,
+        "values": [
+          {
+            "value": "Sunday",
+            "description": "Indicates the Day referred is Sunday."
+          },
+          {
+            "value": "Monday",
+            "description": "Indicates the Day referred is Monday."
+          },
+          {
+            "value": "Tuesday",
+            "description": "Indicates the Day referred is Tuesday."
+          },
+          {
+            "value": "Wednesday",
+            "description": "Indicates the Day referred is Wednesday."
+          },
+          {
+            "value": "Thursday",
+            "description": "Indicates the Day referred is Thursday."
+          },
+          {
+            "value": "Friday",
+            "description": "Indicates the Day referred is Friday."
+          },
+          {
+            "value": "Saturday",
+            "description": "Indicates the Day referred is Saturday."
+          }
+        ]
+      }
+    },
+    "BackupProgressInfo": {
+      "description": "Describes the progress of a partition's backup.",
+      "properties": {
+        "BackupState": {
+          "$ref": "#/definitions/BackupState",
+          "description": "Represents the current state of the partition backup operation."
+        },
+        "TimeStampUtc": {
+          "type": "string",
+          "format": "date-time",
+          "description": "TimeStamp in UTC when operation succeeded or failed."
+        },
+        "BackupId": {
+          "type": "string",
+          "format": "uuid",
+          "description": "Unique ID of the newly created backup."
+        },
+        "BackupLocation": {
+          "type": "string",
+          "description": "Location, relative to the backup store, of the newly created backup."
+        },
+        "EpochOfLastBackupRecord": {
+          "$ref": "#/definitions/Epoch",
+          "description": "Specifies the epoch of the last record included in backup."
+        },
+        "LsnOfLastBackupRecord": {
+          "type": "string",
+          "description": "The LSN of last record included in backup."
+        },
+        "FailureError": {
+          "$ref": "#/definitions/FabricErrorError",
+          "description": "Denotes the failure encountered in performing backup operation."
+        }
+      }
+    },
+    "BackupConfigurationInfo": {
+      "discriminator": "Kind",
+      "description": "Describes the backup configuration information.",
+      "properties": {
+        "Kind": {
+          "$ref": "#/definitions/BackupEntityKind",
+          "description": "The entity type of a Service Fabric entity such as Application, Service or a Partition where periodic backups can be enabled."
+        },
+        "PolicyName": {
+          "description": "The name of the backup policy which is applicable to this Service Fabric application or service or partition.",
+          "type": "string"
+        },
+        "PolicyInheritedFrom": {
+          "$ref": "#/definitions/BackupPolicyScope",
+          "description": "Specifies the scope at which the backup policy is applied."
+        },
+        "SuspensionInfo": {
+          "$ref": "#/definitions/BackupSuspensionInfo",
+          "description": "Describes the backup suspension details."
+        }
+      },
+      "required": [
+        "Kind"
+      ]
+    },
+    "PartitionBackupConfigurationInfo": {
+      "description": "Backup configuration information, for a specific partition, specifying what backup policy is being applied and suspend description, if any.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/BackupConfigurationInfo"
+        }
+      ],
+      "properties": {
+        "ServiceName": {
+          "$ref": "#/definitions/ServiceName",
+          "description": "The full name of the service with 'fabric:' URI scheme."
+        },
+        "PartitionId": {
+          "$ref": "#/definitions/PartitionId",
+          "description": "The partition ID identifying the partition."
+        }
+      },
+      "x-ms-discriminator-value": "Partition"
+    },
+    "BackupState": {
+      "type": "string",
+      "description": "Represents the current state of the partition backup operation.",
+      "enum": [
+        "Invalid",
+        "Accepted",
+        "BackupInProgress",
+        "Success",
+        "Failure",
+        "Timeout"
+      ],
+      "x-ms-enum": {
+        "name": "BackupState",
+        "modelAsString": true,
+        "values": [
+          {
+            "value": "Invalid",
+            "description": "Indicates an invalid backup state. All Service Fabric enumerations have the invalid type."
+          },
+          {
+            "value": "Accepted",
+            "description": "Operation has been validated and accepted. Backup is yet to be triggered."
+          },
+          {
+            "value": "BackupInProgress",
+            "description": "Backup operation has been triggered and is under process."
+          },
+          {
+            "value": "Success",
+            "description": "Operation completed with success."
+          },
+          {
+            "value": "Failure",
+            "description": "Operation completed with failure."
+          },
+          {
+            "value": "Timeout",
+            "description": "Operation timed out."
+          }
+        ]
+      }
+    },
+    "BackupEntity": {
+      "discriminator": "EntityKind",
+      "description": "Describes the Service Fabric entity that is configured for backup.",
+      "properties": {
+        "EntityKind": {
+          "$ref": "#/definitions/BackupEntityKind",
+          "description": "The entity type of a Service Fabric entity such as Application, Service or a Partition where periodic backups can be enabled."
+        }
+      },
+      "required": [
+        "EntityKind"
+      ]
+    },
+    "ApplicationBackupEntity": {
+      "description": "Identifies the Service Fabric application which is being backed up.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/BackupEntity"
+        }
+      ],
+      "properties": {
+        "ApplicationName": {
+          "$ref": "#/definitions/ApplicationName",
+          "description": "The name of the application, including the 'fabric:' URI scheme."
+        }
+      },
+      "x-ms-discriminator-value": "Application"
+    },
+    "ServiceBackupEntity": {
+      "description": "Identifies the Service Fabric stateful service which is being backed up.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/BackupEntity"
+        }
+      ],
+      "properties": {
+        "ServiceName": {
+          "$ref": "#/definitions/ServiceName",
+          "description": "The full name of the service with 'fabric:' URI scheme."
+        }
+      },
+      "x-ms-discriminator-value": "Service"
+    },
+    "PartitionBackupEntity": {
+      "description": "Identifies the Service Fabric stateful partition which is being backed up.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/BackupEntity"
+        }
+      ],
+      "properties": {
+        "ServiceName": {
+          "$ref": "#/definitions/ServiceName",
+          "description": "The full name of the service with 'fabric:' URI scheme."
+        },
+        "PartitionId": {
+          "$ref": "#/definitions/PartitionId",
+          "description": "The partition ID identifying the partition."
+        }
+      },
+      "x-ms-discriminator-value": "Partition"
+    },
+    "EnableBackupDescription": {
+      "description": "Specifies the parameters needed to enable periodic backup.",
+      "required": [
+        "BackupPolicyName"
+      ],
+      "properties": {
+        "BackupPolicyName": {
+          "type": "string",
+          "description": "Name of the backup policy to be used for enabling periodic backups."
+        }
+      }
+    },
+    "PagedBackupEntityList": {
+      "description": "The list of backup entities that are being periodically backed. The list is paged when all of the results cannot fit in a single message. The next set of results can be obtained by executing the same query with the continuation token provided in this list.",
+      "properties": {
+        "ContinuationToken": {
+          "$ref": "#/definitions/ContinuationToken",
+          "description": "The continuation token parameter is used to obtain next set of results. The continuation token is included in the response of the API when the results from the system do not fit in a single response. When this value is passed to the next API call, the API returns next set of results. If there are no further results, then the continuation token is not included in the response."
+        },
+        "Items": {
+          "type": "array",
+          "description": "List of backup entity information.",
+          "items": {
+            "$ref": "#/definitions/BackupEntity"
+          }
+        }
+      }
+    },
+    "BackupSuspensionInfo": {
+      "description": "Describes the backup suspension details.",
+      "properties": {
+        "IsSuspended": {
+          "type": "boolean",
+          "description": "Indicates whether periodic backup is suspended at this level or not."
+        },
+        "SuspensionInheritedFrom": {
+          "$ref": "#/definitions/BackupSuspensionScope",
+          "description": "Specifies the scope at which the backup suspension was applied."
+        }
+      }
+    },
+    "BackupEntityKind": {
+      "type": "string",
+      "description": "The entity type of a Service Fabric entity such as Application, Service or a Partition where periodic backups can be enabled.",
+      "enum": [
+        "Invalid",
+        "Partition",
+        "Service",
+        "Application"
+      ],
+      "x-ms-enum": {
+        "name": "BackupEntityKind",
+        "modelAsString": true,
+        "values": [
+          {
+            "value": "Invalid",
+            "description": "Indicates an invalid entity kind. All Service Fabric enumerations have the invalid type."
+          },
+          {
+            "value": "Partition",
+            "description": "Indicates the entity is a Service Fabric partition."
+          },
+          {
+            "value": "Service",
+            "description": "Indicates the entity is a Service Fabric service."
+          },
+          {
+            "value": "Application",
+            "description": "Indicates the entity is a Service Fabric application."
+          }
+        ]
+      }
+    },
+    "GetBackupByStorageQueryDescription": {
+      "description": "Describes additional filters to be applied, while listing backups, and backup storage details from where to fetch the backups.",
+      "required": [
+        "Storage",
+        "BackupEntity"
+      ],
+      "properties": {
+        "StartDateTimeFilter": {
+          "type": "string",
+          "format": "date-time",
+          "description": "Specifies the start date time in ISO8601 from which to enumerate backups. If not specified, backups are enumerated from the beginning."
+        },
+        "EndDateTimeFilter": {
+          "type": "string",
+          "format": "date-time",
+          "description": "Specifies the end date time in ISO8601 till which to enumerate backups. If not specified, backups are enumerated till the end."
+        },
+        "Latest": {
+          "type": "boolean",
+          "default": false,
+          "description": "If specified as true, gets the most recent backup (within the specified time range) for every partition under the specified backup entity."
+        },
+        "Storage": {
+          "$ref": "#/definitions/BackupStorageDescription",
+          "description": "Describes the parameters for the backup storage from where to enumerate backups. This is optional and by default backups are enumerated from the backup storage where this backup entity is currently being backed up (as specified in backup policy). This parameter is useful to be able to enumerate backups from another cluster where you may intend to restore."
+        },
+        "BackupEntity": {
+          "$ref": "#/definitions/BackupEntity",
+          "description": "Indicates the entity for which to enumerate backups."
+        }
+      }
+    },
+    "NodeImpact": {
+      "description": "Describes the expected impact of a repair to a particular node.\n\nThis type supports the Service Fabric platform; it is not meant to be used directly from your code.",
+      "properties": {
+        "NodeName": {
+          "type": "string",
+          "description": "The name of the impacted node."
+        },
+        "ImpactLevel": {
+          "type": "string",
+          "enum": [
+            "Invalid",
+            "None",
+            "Restart",
+            "RemoveData",
+            "RemoveNode"
+          ],
+          "description": "The level of impact expected.",
+          "x-ms-enum": {
+            "name": "ImpactLevel",
+            "modelAsString": true,
+            "values": [
+              {
+                "value": "Invalid"
+              },
+              {
+                "value": "None"
+              },
+              {
+                "value": "Restart"
+              },
+              {
+                "value": "RemoveData"
+              },
+              {
+                "value": "RemoveNode"
+              }
+            ]
+          }
+        }
+      },
+      "required": [
+        "NodeName"
+      ]
+    },
+    "NodeRepairImpactDescription": {
+      "description": "Describes the expected impact of a repair on a set of nodes.\n\nThis type supports the Service Fabric platform; it is not meant to be used directly from your code.",
+      "x-ms-discriminator-value": "Node",
+      "allOf": [
+        {
+          "$ref": "#/definitions/RepairImpactDescriptionBase"
+        }
+      ],
+      "properties": {
+        "NodeImpactList": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/NodeImpact"
+          },
+          "description": "The list of nodes impacted by a repair action and their respective expected impact."
+        }
+      }
+    },
+    "NodeRepairTargetDescription": {
+      "description": "Describes the list of nodes targeted by a repair action.\n\nThis type supports the Service Fabric platform; it is not meant to be used directly from your code.",
+      "x-ms-discriminator-value": "Node",
+      "allOf": [
+        {
+          "$ref": "#/definitions/RepairTargetDescriptionBase"
+        }
+      ],
+      "properties": {
+        "NodeNames": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "The list of nodes targeted by a repair action."
+        }
+      }
+    },
+    "RepairImpactDescriptionBase": {
+      "discriminator": "Kind",
+      "description": "Describes the expected impact of executing a repair task.\n\nThis type supports the Service Fabric platform; it is not meant to be used directly from your code.",
+      "properties": {
+        "Kind": {
+          "$ref": "#/definitions/RepairImpactKind",
+          "description": "The kind of repair impact represented by the current object."
+        }
+      },
+      "required": [
+        "Kind"
+      ]
+    },
+    "RepairImpactKind": {
+      "description": "Specifies the kind of the impact. This type supports the Service Fabric platform; it is not meant to be used directly from your code.'",
+      "type": "string",
+      "enum": [
+        "Invalid",
+        "Node"
+      ],
+      "x-ms-enum": {
+        "name": "RepairImpactKind",
+        "modelAsString": true,
+        "values": [
+          {
+            "value": "Invalid",
+            "description": "The repair impact is not valid or is of an unknown type."
+          },
+          {
+            "value": "Node",
+            "description": "The repair impact affects a set of Service Fabric nodes."
+          }
+        ]
+      }
+    },
+    "RepairTargetDescriptionBase": {
+      "discriminator": "Kind",
+      "description": "Describes the entities targeted by a repair action.\n\nThis type supports the Service Fabric platform; it is not meant to be used directly from your code.",
+      "properties": {
+        "Kind": {
+          "$ref": "#/definitions/RepairTargetKind",
+          "description": "The kind of repair target described by the current object."
+        }
+      },
+      "required": [
+        "Kind"
+      ]
+    },
+    "RepairTargetKind": {
+      "description": "Specifies the kind of the repair target. This type supports the Service Fabric platform; it is not meant to be used directly from your code.'",
+      "type": "string",
+      "enum": [
+        "Invalid",
+        "Node"
+      ],
+      "x-ms-enum": {
+        "name": "RepairTargetKind",
+        "modelAsString": true,
+        "values": [
+          {
+            "value": "Invalid",
+            "description": "The repair target is not valid or is of an unknown type."
+          },
+          {
+            "value": "Node",
+            "description": "The repair target is a set of Service Fabric nodes."
+          }
+        ]
+      }
+    },
+    "RepairTask": {
+      "description": "Represents a repair task, which includes information about what kind of repair was requested, what its progress is, and what its final result was.\n\nThis type supports the Service Fabric platform; it is not meant to be used directly from your code.",
+      "properties": {
+        "TaskId": {
+          "type": "string",
+          "description": "The ID of the repair task."
+        },
+        "Version": {
+          "type": "string",
+          "description": "The version of the repair task.\nWhen creating a new repair task, the version must be set to zero.  When updating a repair task,\nthe version is used for optimistic concurrency checks.  If the version is\nset to zero, the update will not check for write conflicts.  If the version is set to a non-zero value, then the\nupdate will only succeed if the actual current version of the repair task matches this value."
+        },
+        "Description": {
+          "type": "string",
+          "description": "A description of the purpose of the repair task, or other informational details.\nMay be set when the repair task is created, and is immutable once set."
+        },
+        "State": {
+          "type": "string",
+          "enum": [
+            "Invalid",
+            "Created",
+            "Claimed",
+            "Preparing",
+            "Approved",
+            "Executing",
+            "Restoring",
+            "Completed"
+          ],
+          "description": "The workflow state of the repair task. Valid initial states are Created, Claimed, and Preparing.",
+          "x-ms-enum": {
+            "name": "State",
+            "modelAsString": true,
+            "values": [
+              {
+                "value": "Invalid",
+                "description": "Indicates that the repair task state is invalid. All Service Fabric enumerations have the invalid value."
+              },
+              {
+                "value": "Created",
+                "description": "Indicates that the repair task has been created."
+              },
+              {
+                "value": "Claimed",
+                "description": "Indicates that the repair task has been claimed by a repair executor."
+              },
+              {
+                "value": "Preparing",
+                "description": "Indicates that the Repair Manager is preparing the system to handle the impact of the repair task, usually by taking resources offline gracefully."
+              },
+              {
+                "value": "Approved",
+                "description": "Indicates that the repair task has been approved by the Repair Manager and is safe to execute."
+              },
+              {
+                "value": "Executing",
+                "description": "Indicates that execution of the repair task is in progress."
+              },
+              {
+                "value": "Restoring",
+                "description": "Indicates that the Repair Manager is restoring the system to its pre-repair state, usually by bringing resources back online."
+              },
+              {
+                "value": "Completed",
+                "description": "Indicates that the repair task has completed, and no further state changes will occur."
+              }
+            ]
+          }
+        },
+        "Flags": {
+          "type": "integer",
+          "description": "A bitwise-OR of the following values, which gives additional details about the status of the repair task.\n- 1 - Cancellation of the repair has been requested\n- 2 - Abort of the repair has been requested\n- 4 - Approval of the repair was forced via client request"
+        },
+        "Action": {
+          "type": "string",
+          "description": "The requested repair action. Must be specified when the repair task is created, and is immutable once set."
+        },
+        "Target": {
+          "$ref": "#/definitions/RepairTargetDescriptionBase",
+          "description": "The target object determines what actions the system will take to prepare for the impact of the repair, prior to approving execution of the repair.\nMay be set when the repair task is created, and is immutable once set."
+        },
+        "Executor": {
+          "type": "string",
+          "description": "The name of the repair executor. Must be specified in Claimed and later states, and is immutable once set."
+        },
+        "ExecutorData": {
+          "type": "string",
+          "description": "A data string that the repair executor can use to store its internal state."
+        },
+        "Impact": {
+          "$ref": "#/definitions/RepairImpactDescriptionBase",
+          "description": "The impact object determines what actions the system will take to prepare for the impact of the repair, prior to approving execution of the repair.\nImpact must be specified by the repair executor when transitioning to the Preparing state, and is immutable once set."
+        },
+        "ResultStatus": {
+          "type": "string",
+          "enum": [
+            "Invalid",
+            "Succeeded",
+            "Cancelled",
+            "Interrupted",
+            "Failed",
+            "Pending"
+          ],
+          "description": "A value describing the overall result of the repair task execution. Must be specified in the Restoring and later states, and is immutable once set.",
+          "x-ms-enum": {
+            "name": "ResultStatus",
+            "modelAsString": true,
+            "values": [
+              {
+                "value": "Invalid",
+                "description": "Indicates that the repair task result is invalid. All Service Fabric enumerations have the invalid value."
+              },
+              {
+                "value": "Succeeded",
+                "description": "Indicates that the repair task completed execution successfully."
+              },
+              {
+                "value": "Cancelled",
+                "description": "Indicates that the repair task was cancelled prior to execution."
+              },
+              {
+                "value": "Interrupted",
+                "description": "Indicates that execution of the repair task was interrupted by a cancellation request after some work had already been performed."
+              },
+              {
+                "value": "Failed",
+                "description": "Indicates that there was a failure during execution of the repair task. Some work may have been performed."
+              },
+              {
+                "value": "Pending",
+                "description": "Indicates that the repair task result is not yet available, because the repair task has not finished executing."
+              }
+            ]
+          }
+        },
+        "ResultCode": {
+          "type": "integer",
+          "description": "A numeric value providing additional details about the result of the repair task execution.\nMay be specified in the Restoring and later states, and is immutable once set."
+        },
+        "ResultDetails": {
+          "type": "string",
+          "description": "A string providing additional details about the result of the repair task execution.\nMay be specified in the Restoring and later states, and is immutable once set."
+        },
+        "History": {
+          "$ref": "#/definitions/RepairTaskHistory",
+          "description": "An object that contains timestamps of the repair task's state transitions.\nThese timestamps are updated by the system, and cannot be directly modified."
+        },
+        "PreparingHealthCheckState": {
+          "$ref": "#/definitions/RepairTaskHealthCheckState",
+          "description": "The workflow state of the health check when the repair task is in the Preparing state."
+        },
+        "RestoringHealthCheckState": {
+          "$ref": "#/definitions/RepairTaskHealthCheckState",
+          "description": "The workflow state of the health check when the repair task is in the Restoring state."
+        },
+        "PerformPreparingHealthCheck": {
+          "type": "boolean",
+          "description": "A value to determine if health checks will be performed when the repair task enters the Preparing state."
+        },
+        "PerformRestoringHealthCheck": {
+          "type": "boolean",
+          "description": "A value to determine if health checks will be performed when the repair task enters the Restoring state."
+        }
+      },
+      "required": [
+        "TaskId",
+        "Action",
+        "State"
+      ]
+    },
+    "RepairTaskApproveDescription": {
+      "description": "Describes a request for forced approval of a repair task.\n\nThis type supports the Service Fabric platform; it is not meant to be used directly from your code.",
+      "properties": {
+        "TaskId": {
+          "type": "string",
+          "description": "The ID of the repair task."
+        },
+        "Version": {
+          "type": "string",
+          "description": "The current version number of the repair task. If non-zero, then the request will only succeed if this value matches the actual current version of the repair task. If zero, then no version check is performed."
+        }
+      },
+      "required": [
+        "TaskId"
+      ]
+    },
+    "RepairTaskCancelDescription": {
+      "description": "Describes a request to cancel a repair task.\n\nThis type supports the Service Fabric platform; it is not meant to be used directly from your code.",
+      "properties": {
+        "TaskId": {
+          "type": "string",
+          "description": "The ID of the repair task."
+        },
+        "Version": {
+          "type": "string",
+          "description": "The current version number of the repair task. If non-zero, then the request will only succeed if this value matches the actual current version of the repair task. If zero, then no version check is performed."
+        },
+        "RequestAbort": {
+          "type": "boolean",
+          "description": "_True_ if the repair should be stopped as soon as possible even if it has already started executing. _False_ if the repair should be cancelled only if execution has not yet started."
+        }
+      },
+      "required": [
+        "TaskId"
+      ]
+    },
+    "RepairTaskDeleteDescription": {
+      "description": "Describes a request to delete a completed repair task.\n\nThis type supports the Service Fabric platform; it is not meant to be used directly from your code.",
+      "properties": {
+        "TaskId": {
+          "type": "string",
+          "description": "The ID of the completed repair task to be deleted."
+        },
+        "Version": {
+          "type": "string",
+          "description": "The current version number of the repair task. If non-zero, then the request will only succeed if this value matches the actual current version of the repair task. If zero, then no version check is performed."
+        }
+      },
+      "required": [
+        "TaskId"
+      ]
+    },
+    "RepairTaskHealthCheckState": {
+      "description": "Specifies the workflow state of a repair task's health check. This type supports the Service Fabric platform; it is not meant to be used directly from your code.",
+      "type": "string",
+      "enum": [
+        "NotStarted",
+        "InProgress",
+        "Succeeded",
+        "Skipped",
+        "TimedOut"
+      ],
+      "x-ms-enum": {
+        "name": "RepairTaskHealthCheckState",
+        "modelAsString": true,
+        "values": [
+          {
+            "value": "NotStarted",
+            "description": "Indicates that the health check has not started."
+          },
+          {
+            "value": "InProgress",
+            "description": "Indicates that the health check is in progress."
+          },
+          {
+            "value": "Succeeded",
+            "description": "Indicates that the health check succeeded."
+          },
+          {
+            "value": "Skipped",
+            "description": "Indicates that the health check was skipped."
+          },
+          {
+            "value": "TimedOut",
+            "description": "Indicates that the health check timed out."
+          }
+        ]
+      }
+    },
+    "RepairTaskHistory": {
+      "description": "A record of the times when the repair task entered each state.\n\nThis type supports the Service Fabric platform; it is not meant to be used directly from your code.",
+      "properties": {
+        "CreatedUtcTimestamp": {
+          "type": "string",
+          "format": "date-time",
+          "description": "The time when the repair task entered the Created state."
+        },
+        "ClaimedUtcTimestamp": {
+          "type": "string",
+          "format": "date-time",
+          "description": "The time when the repair task entered the Claimed state."
+        },
+        "PreparingUtcTimestamp": {
+          "type": "string",
+          "format": "date-time",
+          "description": "The time when the repair task entered the Preparing state."
+        },
+        "ApprovedUtcTimestamp": {
+          "type": "string",
+          "format": "date-time",
+          "description": "The time when the repair task entered the Approved state"
+        },
+        "ExecutingUtcTimestamp": {
+          "type": "string",
+          "format": "date-time",
+          "description": "The time when the repair task entered the Executing state"
+        },
+        "RestoringUtcTimestamp": {
+          "type": "string",
+          "format": "date-time",
+          "description": "The time when the repair task entered the Restoring state"
+        },
+        "CompletedUtcTimestamp": {
+          "type": "string",
+          "format": "date-time",
+          "description": "The time when the repair task entered the Completed state"
+        },
+        "PreparingHealthCheckStartUtcTimestamp": {
+          "type": "string",
+          "format": "date-time",
+          "description": "The time when the repair task started the health check in the Preparing state."
+        },
+        "PreparingHealthCheckEndUtcTimestamp": {
+          "type": "string",
+          "format": "date-time",
+          "description": "The time when the repair task completed the health check in the Preparing state."
+        },
+        "RestoringHealthCheckStartUtcTimestamp": {
+          "type": "string",
+          "format": "date-time",
+          "description": "The time when the repair task started the health check in the Restoring state."
+        },
+        "RestoringHealthCheckEndUtcTimestamp": {
+          "type": "string",
+          "format": "date-time",
+          "description": "The time when the repair task completed the health check in the Restoring state."
+        }
+      }
+    },
+    "RepairTaskList": {
+      "type": "array",
+      "description": "A list of repair tasks.",
+      "items": {
+        "$ref": "#/definitions/RepairTask"
+      }
+    },
+    "RepairTaskUpdateHealthPolicyDescription": {
+      "description": "Describes a request to update the health policy of a repair task.\n\nThis type supports the Service Fabric platform; it is not meant to be used directly from your code.",
+      "properties": {
+        "TaskId": {
+          "type": "string",
+          "description": "The ID of the repair task to be updated."
+        },
+        "Version": {
+          "type": "string",
+          "description": "The current version number of the repair task. If non-zero, then the request will only succeed if this value matches the actual current value of the repair task. If zero, then no version check is performed."
+        },
+        "PerformPreparingHealthCheck": {
+          "type": "boolean",
+          "description": "A boolean indicating if health check is to be performed in the Preparing stage of the repair task. If not specified the existing value should not be altered. Otherwise, specify the desired new value."
+        },
+        "PerformRestoringHealthCheck": {
+          "type": "boolean",
+          "description": "A boolean indicating if health check is to be performed in the Restoring stage of the repair task. If not specified the existing value should not be altered. Otherwise, specify the desired new value."
+        }
+      },
+      "required": [
+        "TaskId"
+      ]
+    },
+    "RepairTaskUpdateInfo": {
+      "description": "Describes the result of an operation that created or updated a repair task.\n\nThis type supports the Service Fabric platform; it is not meant to be used directly from your code.",
+      "properties": {
+        "Version": {
+          "type": "string",
+          "description": "The new version of the repair task."
+        }
+      },
+      "required": [
+        "Version"
+      ]
+    },
+    "ReconfigurationInformation": {
+      "description": "Information about current reconfiguration like phase, type, previous configuration role of replica and reconfiguration start date time.",
+      "properties": {
+        "PreviousConfigurationRole": {
+          "$ref": "#/definitions/ReplicaRole",
+          "description": "Replica role before reconfiguration started."
+        },
+        "ReconfigurationPhase": {
+          "$ref": "#/definitions/ReconfigurationPhase",
+          "description": "Current phase of ongoing reconfiguration. If no reconfiguration is taking place then this value will be \"None\"."
+        },
+        "ReconfigurationType": {
+          "$ref": "#/definitions/ReconfigurationType",
+          "description": "Type of current ongoing reconfiguration. If no reconfiguration is taking place then this value will be \"None\"."
+        },
+        "ReconfigurationStartTimeUtc": {
+          "type": "string",
+          "format": "date-time",
+          "description": "Start time (in UTC) of the ongoing reconfiguration. If no reconfiguration is taking place then this value will be zero date-time."
+        }
+      }
+    },
+    "ReconfigurationPhase": {
+      "type": "string",
+      "description": "The reconfiguration phase of a replica of a stateful service.",
+      "enum": [
+        "Unknown",
+        "None",
+        "Phase0",
+        "Phase1",
+        "Phase2",
+        "Phase3",
+        "Phase4",
+        "AbortPhaseZero"
+      ],
+      "x-ms-enum": {
+        "name": "ReconfigurationPhase",
+        "modelAsString": true,
+        "values": [
+          {
+            "value": "Unknown",
+            "description": "Indicates the invalid reconfiguration phase."
+          },
+          {
+            "value": "None",
+            "description": "Specifies that there is no reconfiguration in progress."
+          },
+          {
+            "value": "Phase0",
+            "description": "Refers to the phase where the reconfiguration is transferring data from the previous primary to the new primary."
+          },
+          {
+            "value": "Phase1",
+            "description": "Refers to the phase where the reconfiguration is querying the replica set for the progress."
+          },
+          {
+            "value": "Phase2",
+            "description": "Refers to the phase where the reconfiguration is ensuring that data from the current primary is present in a majority of the replica set."
+          },
+          {
+            "value": "Phase3",
+            "description": "This phase is for internal use only."
+          },
+          {
+            "value": "Phase4",
+            "description": "This phase is for internal use only."
+          },
+          {
+            "value": "AbortPhaseZero",
+            "description": "This phase is for internal use only."
+          }
+        ]
+      }
+    },
+    "ReconfigurationType": {
+      "type": "string",
+      "description": "The type of reconfiguration for replica of a stateful service.",
+      "enum": [
+        "Unknown",
+        "SwapPrimary",
+        "Failover",
+        "Other"
+      ],
+      "x-ms-enum": {
+        "name": "ReconfigurationType",
+        "modelAsString": true,
+        "values": [
+          {
+            "value": "Unknown",
+            "description": "Indicates the invalid reconfiguration type."
+          },
+          {
+            "value": "SwapPrimary",
+            "description": "Specifies that the primary replica is being swapped with a different replica."
+          },
+          {
+            "value": "Failover",
+            "description": "Reconfiguration triggered in response to a primary going down. This could be due to many reasons such as primary replica crashing etc."
+          },
+          {
+            "value": "Other",
+            "description": "Reconfigurations where the primary replica is not changing."
+          }
+        ]
+      }
+    },
+    "InfrastructureServiceResponse": {
+      "type": "string",
+      "format": "binary",
+      "description": "This is a weakly-typed response stream to the client. It contains the JSON response from the infrastructure service without deserialization.\nThe content of the response depends on which command was issued to the infrastructure service."
+    },
+    "UploadChunkRange": {
+      "description": "Information about which portion of the file to upload.",
+      "properties": {
+        "StartPosition": {
+          "type": "string",
+          "description": "The start position of the portion of the file. It's represented by the number of bytes."
+        },
+        "EndPosition": {
+          "type": "string",
+          "description": "The end position of the portion of the file. It's represented by the number of bytes."
+        }
+      }
+    },
+    "UploadSessionInfo": {
+      "description": "Information about an image store upload session. A session is associated with a relative path in the image store.",
+      "properties": {
+        "StoreRelativePath": {
+          "type": "string",
+          "description": "The remote location within image store. This path is relative to the image store root."
+        },
+        "SessionId": {
+          "type": "string",
+          "format": "uuid",
+          "description": "A unique ID of the upload session. A session ID can be reused only if the session was committed or removed."
+        },
+        "ModifiedDate": {
+          "type": "string",
+          "format": "date-time",
+          "description": "The date and time when the upload session was last modified."
+        },
+        "FileSize": {
+          "type": "string",
+          "description": "The size in bytes of the uploading file."
+        },
+        "ExpectedRanges": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/UploadChunkRange"
+          },
+          "description": "List of chunk ranges that image store has not received yet."
+        }
+      }
+    },
+    "UploadSession": {
+      "description": "Information about a image store upload session",
+      "properties": {
+        "UploadSessions": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/UploadSessionInfo"
+          },
+          "description": "When querying upload session by upload session ID, the result contains only one upload session. When querying upload session by image store relative path, the result might contain multiple upload sessions."
+        }
+      }
+    },
+    "ScalingPolicyDescription": {
+      "description": "Describes how the scaling should be performed",
+      "required": [
+        "ScalingTrigger",
+        "ScalingMechanism"
+      ],
+      "properties": {
+        "ScalingTrigger": {
+          "$ref": "#/definitions/ScalingTriggerDescription",
+          "description": "Specifies the trigger associated with this scaling policy"
+        },
+        "ScalingMechanism": {
+          "$ref": "#/definitions/ScalingMechanismDescription",
+          "description": "Specifies the mechanism associated with this scaling policy"
+        }
+      }
+    },
+    "ScalingPolicyDescriptionList": {
+      "type": "array",
+      "items": {
+        "$ref": "#/definitions/ScalingPolicyDescription"
+      },
+      "description": "A list that describes the scaling policies."
+    },
+    "ScalingTriggerDescription": {
+      "discriminator": "Kind",
+      "description": "Describes the trigger for performing a scaling operation.",
+      "required": [
+        "Kind"
+      ],
+      "properties": {
+        "Kind": {
+          "$ref": "#/definitions/ScalingTriggerKind",
+          "description": "Specifies the kind of scaling trigger"
+        }
+      }
+    },
+    "ScalingMechanismDescription": {
+      "discriminator": "Kind",
+      "description": "Describes the mechanism for performing a scaling operation.",
+      "required": [
+        "Kind"
+      ],
+      "properties": {
+        "Kind": {
+          "$ref": "#/definitions/ScalingMechanismKind",
+          "description": "Specifies the kind of scaling mechanism"
+        }
+      }
+    },
+    "ScalingTriggerKind": {
+      "type": "string",
+      "description": "Enumerates the ways that a service can be scaled.",
+      "enum": [
+        "Invalid",
+        "AveragePartitionLoad",
+        "AverageServiceLoad"
+      ],
+      "x-ms-enum": {
+        "name": "ScalingTriggerKind",
+        "modelAsString": true,
+        "values": [
+          {
+            "value": "Invalid",
+            "description": "Indicates the scaling trigger is invalid. All Service Fabric enumerations have the invalid type. The value is zero."
+          },
+          {
+            "value": "AveragePartitionLoad",
+            "description": "Indicates a trigger where scaling decisions are made based on average load of a partition. The value is 1."
+          },
+          {
+            "value": "AverageServiceLoad",
+            "description": "Indicates a trigger where scaling decisions are made based on average load of a service. The value is 2."
+          }
+        ]
+      }
+    },
+    "ScalingMechanismKind": {
+      "type": "string",
+      "description": "Enumerates the ways that a service can be scaled.",
+      "enum": [
+        "Invalid",
+        "PartitionInstanceCount",
+        "AddRemoveIncrementalNamedPartition"
+      ],
+      "x-ms-enum": {
+        "name": "ScalingMechanismKind",
+        "modelAsString": true,
+        "values": [
+          {
+            "value": "Invalid",
+            "description": "Indicates the scaling mechanism is invalid. All Service Fabric enumerations have the invalid type. The value is zero."
+          },
+          {
+            "value": "PartitionInstanceCount",
+            "description": "Indicates a mechanism for scaling where new instances are added or removed from a partition. The value is 1."
+          },
+          {
+            "value": "AddRemoveIncrementalNamedPartition",
+            "description": "Indicates a mechanism for scaling where new named partitions are added or removed from a service. The value is 2."
+          }
+        ]
+      }
+    },
+    "AveragePartitionLoadScalingTrigger": {
+      "description": "Represents a scaling trigger related to an average load of a metric/resource of a partition.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/ScalingTriggerDescription"
+        }
+      ],
+      "x-ms-discriminator-value": "AveragePartitionLoad",
+      "required": [
+        "MetricName",
+        "LowerLoadThreshold",
+        "UpperLoadThreshold",
+        "ScaleIntervalInSeconds"
+      ],
+      "properties": {
+        "MetricName": {
+          "type": "string",
+          "description": "The name of the metric for which usage should be tracked."
+        },
+        "LowerLoadThreshold": {
+          "type": "string",
+          "format": "double",
+          "description": "The lower limit of the load below which a scale in operation should be performed."
+        },
+        "UpperLoadThreshold": {
+          "type": "string",
+          "format": "double",
+          "description": "The upper limit of the load beyond which a scale out operation should be performed."
+        },
+        "ScaleIntervalInSeconds": {
+          "type": "integer",
+          "format": "int64",
+          "minimum": 0,
+          "maximum": 4294967295,
+          "description": "The period in seconds on which a decision is made whether to scale or not."
+        }
+      }
+    },
+    "AverageServiceLoadScalingTrigger": {
+      "description": "Represents a scaling policy related to an average load of a metric/resource of a service.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/ScalingTriggerDescription"
+        }
+      ],
+      "x-ms-discriminator-value": "AverageServiceLoad",
+      "required": [
+        "MetricName",
+        "LowerLoadThreshold",
+        "UpperLoadThreshold",
+        "ScaleIntervalInSeconds"
+      ],
+      "properties": {
+        "MetricName": {
+          "type": "string",
+          "description": "The name of the metric for which usage should be tracked."
+        },
+        "LowerLoadThreshold": {
+          "type": "string",
+          "format": "double",
+          "description": "The lower limit of the load below which a scale in operation should be performed."
+        },
+        "UpperLoadThreshold": {
+          "type": "string",
+          "format": "double",
+          "description": "The upper limit of the load beyond which a scale out operation should be performed."
+        },
+        "ScaleIntervalInSeconds": {
+          "type": "integer",
+          "format": "int64",
+          "minimum": 0,
+          "maximum": 4294967295,
+          "description": "The period in seconds on which a decision is made whether to scale or not."
+        }
+      }
+    },
+    "PartitionInstanceCountScaleMechanism": {
+      "description": "Represents a scaling mechanism for adding or removing instances of stateless service partition.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/ScalingMechanismDescription"
+        }
+      ],
+      "x-ms-discriminator-value": "PartitionInstanceCount",
+      "required": [
+        "MinInstanceCount",
+        "MaxInstanceCount",
+        "ScaleIncrement"
+      ],
+      "properties": {
+        "MinInstanceCount": {
+          "type": "integer",
+          "description": "Minimum number of instances of the partition."
+        },
+        "MaxInstanceCount": {
+          "type": "integer",
+          "description": "Maximum number of instances of the partition."
+        },
+        "ScaleIncrement": {
+          "type": "integer",
+          "description": "The number of instances to add or remove during a scaling operation."
+        }
+      }
+    },
+    "AddRemoveIncrementalNamedPartitionScalingMechanism": {
+      "description": "Represents a scaling mechanism for adding or removing named partitions of a stateless service. Partition names are in the format '0','1''N-1'",
+      "allOf": [
+        {
+          "$ref": "#/definitions/ScalingMechanismDescription"
+        }
+      ],
+      "x-ms-discriminator-value": "AddRemoveIncrementalNamedPartition",
+      "required": [
+        "MinPartitionCount",
+        "MaxPartitionCount",
+        "ScaleIncrement"
+      ],
+      "properties": {
+        "MinPartitionCount": {
+          "type": "integer",
+          "description": "Minimum number of named partitions of the service."
+        },
+        "MaxPartitionCount": {
+          "type": "integer",
+          "description": "Maximum number of named partitions of the service."
+        },
+        "ScaleIncrement": {
+          "type": "integer",
+          "description": "The number of instances to add or remove during a scaling operation."
+        }
+      }
+    },
+    "UnplacedReplicaInformation": {
+      "description": "Contains information for an unplaced replica.",
+      "properties": {
+        "ServiceName": {
+          "$ref": "#/definitions/ServiceName",
+          "description": "The name of the service."
+        },
+        "PartitionId": {
+          "$ref": "#/definitions/PartitionId",
+          "description": "The ID of the partition."
+        },
+        "UnplacedReplicaDetails": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "List of reasons due to which a replica cannot be placed."
+        }
+      }
+    },
+    "ApplicationCreatedEvent": {
+      "description": "Application Created event.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/ApplicationEvent"
+        }
+      ],
+      "properties": {
+        "ApplicationTypeName": {
+          "type": "string",
+          "description": "Application type name."
+        },
+        "ApplicationTypeVersion": {
+          "type": "string",
+          "description": "Application type version."
+        },
+        "ApplicationDefinitionKind": {
+          "type": "string",
+          "description": "Application definition kind."
+        }
+      },
+      "required": [
+        "ApplicationTypeName",
+        "ApplicationTypeVersion",
+        "ApplicationDefinitionKind"
+      ],
+      "x-ms-discriminator-value": "ApplicationCreated"
+    },
+    "ApplicationDeletedEvent": {
+      "description": "Application Deleted event.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/ApplicationEvent"
+        }
+      ],
+      "properties": {
+        "ApplicationTypeName": {
+          "type": "string",
+          "description": "Application type name."
+        },
+        "ApplicationTypeVersion": {
+          "type": "string",
+          "description": "Application type version."
+        }
+      },
+      "required": [
+        "ApplicationTypeName",
+        "ApplicationTypeVersion"
+      ],
+      "x-ms-discriminator-value": "ApplicationDeleted"
+    },
+    "ApplicationNewHealthReportEvent": {
+      "description": "Application Health Report Created event.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/ApplicationEvent"
+        }
+      ],
+      "properties": {
+        "ApplicationInstanceId": {
+          "type": "integer",
+          "format": "int64",
+          "description": "Id of Application instance."
+        },
+        "SourceId": {
+          "type": "string",
+          "description": "Id of report source."
+        },
+        "Property": {
+          "type": "string",
+          "description": "Describes the property."
+        },
+        "HealthState": {
+          "type": "string",
+          "description": "Describes the property health state."
+        },
+        "TimeToLiveMs": {
+          "type": "integer",
+          "format": "int64",
+          "description": "Time to live in milli-seconds."
+        },
+        "SequenceNumber": {
+          "type": "integer",
+          "format": "int64",
+          "description": "Sequence number of report."
+        },
+        "Description": {
+          "type": "string",
+          "description": "Description of report."
+        },
+        "RemoveWhenExpired": {
+          "type": "boolean",
+          "description": "Indicates the removal when it expires."
+        },
+        "SourceUtcTimestamp": {
+          "type": "string",
+          "format": "date-time",
+          "description": "Source time."
+        }
+      },
+      "required": [
+        "ApplicationInstanceId",
+        "SourceId",
+        "Property",
+        "HealthState",
+        "TimeToLiveMs",
+        "SequenceNumber",
+        "Description",
+        "RemoveWhenExpired",
+        "SourceUtcTimestamp"
+      ],
+      "x-ms-discriminator-value": "ApplicationNewHealthReport"
+    },
+    "ApplicationHealthReportExpiredEvent": {
+      "description": "Application Health Report Expired event.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/ApplicationEvent"
+        }
+      ],
+      "properties": {
+        "ApplicationInstanceId": {
+          "type": "integer",
+          "format": "int64",
+          "description": "Id of Application instance."
+        },
+        "SourceId": {
+          "type": "string",
+          "description": "Id of report source."
+        },
+        "Property": {
+          "type": "string",
+          "description": "Describes the property."
+        },
+        "HealthState": {
+          "type": "string",
+          "description": "Describes the property health state."
+        },
+        "TimeToLiveMs": {
+          "type": "integer",
+          "format": "int64",
+          "description": "Time to live in milli-seconds."
+        },
+        "SequenceNumber": {
+          "type": "integer",
+          "format": "int64",
+          "description": "Sequence number of report."
+        },
+        "Description": {
+          "type": "string",
+          "description": "Description of report."
+        },
+        "RemoveWhenExpired": {
+          "type": "boolean",
+          "description": "Indicates the removal when it expires."
+        },
+        "SourceUtcTimestamp": {
+          "type": "string",
+          "format": "date-time",
+          "description": "Source time."
+        }
+      },
+      "required": [
+        "ApplicationInstanceId",
+        "SourceId",
+        "Property",
+        "HealthState",
+        "TimeToLiveMs",
+        "SequenceNumber",
+        "Description",
+        "RemoveWhenExpired",
+        "SourceUtcTimestamp"
+      ],
+      "x-ms-discriminator-value": "ApplicationHealthReportExpired"
+    },
+    "ApplicationUpgradeCompletedEvent": {
+      "description": "Application Upgrade Completed event.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/ApplicationEvent"
+        }
+      ],
+      "properties": {
+        "ApplicationTypeName": {
+          "type": "string",
+          "description": "Application type name."
+        },
+        "ApplicationTypeVersion": {
+          "type": "string",
+          "description": "Application type version."
+        },
+        "OverallUpgradeElapsedTimeInMs": {
+          "type": "number",
+          "format": "double",
+          "description": "Overall upgrade time in milli-seconds."
+        }
+      },
+      "required": [
+        "ApplicationTypeName",
+        "ApplicationTypeVersion",
+        "OverallUpgradeElapsedTimeInMs"
+      ],
+      "x-ms-discriminator-value": "ApplicationUpgradeCompleted"
+    },
+    "ApplicationUpgradeDomainCompletedEvent": {
+      "description": "Application Upgrade Domain Completed event.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/ApplicationEvent"
+        }
+      ],
+      "properties": {
+        "ApplicationTypeName": {
+          "type": "string",
+          "description": "Application type name."
+        },
+        "CurrentApplicationTypeVersion": {
+          "type": "string",
+          "description": "Current Application type version."
+        },
+        "ApplicationTypeVersion": {
+          "type": "string",
+          "description": "Target Application type version."
+        },
+        "UpgradeState": {
+          "type": "string",
+          "description": "State of upgrade."
+        },
+        "UpgradeDomains": {
+          "type": "string",
+          "description": "Upgrade domains."
+        },
+        "UpgradeDomainElapsedTimeInMs": {
+          "type": "number",
+          "format": "double",
+          "description": "Upgrade time of domain in milli-seconds."
+        }
+      },
+      "required": [
+        "ApplicationTypeName",
+        "CurrentApplicationTypeVersion",
+        "ApplicationTypeVersion",
+        "UpgradeState",
+        "UpgradeDomains",
+        "UpgradeDomainElapsedTimeInMs"
+      ],
+      "x-ms-discriminator-value": "ApplicationUpgradeDomainCompleted"
+    },
+    "ApplicationUpgradeRollbackCompletedEvent": {
+      "description": "Application Upgrade Rollback Completed event.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/ApplicationEvent"
+        }
+      ],
+      "properties": {
+        "ApplicationTypeName": {
+          "type": "string",
+          "description": "Application type name."
+        },
+        "ApplicationTypeVersion": {
+          "type": "string",
+          "description": "Application type version."
+        },
+        "FailureReason": {
+          "type": "string",
+          "description": "Describes reason of failure."
+        },
+        "OverallUpgradeElapsedTimeInMs": {
+          "type": "number",
+          "format": "double",
+          "description": "Overall upgrade time in milli-seconds."
+        }
+      },
+      "required": [
+        "ApplicationTypeName",
+        "ApplicationTypeVersion",
+        "FailureReason",
+        "OverallUpgradeElapsedTimeInMs"
+      ],
+      "x-ms-discriminator-value": "ApplicationUpgradeRollbackCompleted"
+    },
+    "ApplicationUpgradeRollbackStartedEvent": {
+      "description": "Application Upgrade Rollback Started event.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/ApplicationEvent"
+        }
+      ],
+      "properties": {
+        "ApplicationTypeName": {
+          "type": "string",
+          "description": "Application type name."
+        },
+        "CurrentApplicationTypeVersion": {
+          "type": "string",
+          "description": "Current Application type version."
+        },
+        "ApplicationTypeVersion": {
+          "type": "string",
+          "description": "Target Application type version."
+        },
+        "FailureReason": {
+          "type": "string",
+          "description": "Describes reason of failure."
+        },
+        "OverallUpgradeElapsedTimeInMs": {
+          "type": "number",
+          "format": "double",
+          "description": "Overall upgrade time in milli-seconds."
+        }
+      },
+      "required": [
+        "ApplicationTypeName",
+        "CurrentApplicationTypeVersion",
+        "ApplicationTypeVersion",
+        "FailureReason",
+        "OverallUpgradeElapsedTimeInMs"
+      ],
+      "x-ms-discriminator-value": "ApplicationUpgradeRollbackStarted"
+    },
+    "ApplicationUpgradeStartedEvent": {
+      "description": "Application Upgrade Started event.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/ApplicationEvent"
+        }
+      ],
+      "properties": {
+        "ApplicationTypeName": {
+          "type": "string",
+          "description": "Application type name."
+        },
+        "CurrentApplicationTypeVersion": {
+          "type": "string",
+          "description": "Current Application type version."
+        },
+        "ApplicationTypeVersion": {
+          "type": "string",
+          "description": "Target Application type version."
+        },
+        "UpgradeType": {
+          "type": "string",
+          "description": "Type of upgrade."
+        },
+        "RollingUpgradeMode": {
+          "type": "string",
+          "description": "Mode of upgrade."
+        },
+        "FailureAction": {
+          "type": "string",
+          "description": "Action if failed."
+        }
+      },
+      "required": [
+        "ApplicationTypeName",
+        "CurrentApplicationTypeVersion",
+        "ApplicationTypeVersion",
+        "UpgradeType",
+        "RollingUpgradeMode",
+        "FailureAction"
+      ],
+      "x-ms-discriminator-value": "ApplicationUpgradeStarted"
+    },
+    "DeployedApplicationNewHealthReportEvent": {
+      "description": "Deployed Application Health Report Created event.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/ApplicationEvent"
+        }
+      ],
+      "properties": {
+        "ApplicationInstanceId": {
+          "type": "integer",
+          "format": "int64",
+          "description": "Id of Application instance."
+        },
+        "NodeName": {
+          "$ref": "#/definitions/NodeName",
+          "description": "The name of a Service Fabric node."
+        },
+        "SourceId": {
+          "type": "string",
+          "description": "Id of report source."
+        },
+        "Property": {
+          "type": "string",
+          "description": "Describes the property."
+        },
+        "HealthState": {
+          "type": "string",
+          "description": "Describes the property health state."
+        },
+        "TimeToLiveMs": {
+          "type": "integer",
+          "format": "int64",
+          "description": "Time to live in milli-seconds."
+        },
+        "SequenceNumber": {
+          "type": "integer",
+          "format": "int64",
+          "description": "Sequence number of report."
+        },
+        "Description": {
+          "type": "string",
+          "description": "Description of report."
+        },
+        "RemoveWhenExpired": {
+          "type": "boolean",
+          "description": "Indicates the removal when it expires."
+        },
+        "SourceUtcTimestamp": {
+          "type": "string",
+          "format": "date-time",
+          "description": "Source time."
+        }
+      },
+      "required": [
+        "ApplicationInstanceId",
+        "NodeName",
+        "SourceId",
+        "Property",
+        "HealthState",
+        "TimeToLiveMs",
+        "SequenceNumber",
+        "Description",
+        "RemoveWhenExpired",
+        "SourceUtcTimestamp"
+      ],
+      "x-ms-discriminator-value": "DeployedApplicationNewHealthReport"
+    },
+    "DeployedApplicationHealthReportExpiredEvent": {
+      "description": "Deployed Application Health Report Expired event.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/ApplicationEvent"
+        }
+      ],
+      "properties": {
+        "ApplicationInstanceId": {
+          "type": "integer",
+          "format": "int64",
+          "description": "Id of Application instance."
+        },
+        "NodeName": {
+          "$ref": "#/definitions/NodeName",
+          "description": "The name of a Service Fabric node."
+        },
+        "SourceId": {
+          "type": "string",
+          "description": "Id of report source."
+        },
+        "Property": {
+          "type": "string",
+          "description": "Describes the property."
+        },
+        "HealthState": {
+          "type": "string",
+          "description": "Describes the property health state."
+        },
+        "TimeToLiveMs": {
+          "type": "integer",
+          "format": "int64",
+          "description": "Time to live in milli-seconds."
+        },
+        "SequenceNumber": {
+          "type": "integer",
+          "format": "int64",
+          "description": "Sequence number of report."
+        },
+        "Description": {
+          "type": "string",
+          "description": "Description of report."
+        },
+        "RemoveWhenExpired": {
+          "type": "boolean",
+          "description": "Indicates the removal when it expires."
+        },
+        "SourceUtcTimestamp": {
+          "type": "string",
+          "format": "date-time",
+          "description": "Source time."
+        }
+      },
+      "required": [
+        "ApplicationInstanceId",
+        "NodeName",
+        "SourceId",
+        "Property",
+        "HealthState",
+        "TimeToLiveMs",
+        "SequenceNumber",
+        "Description",
+        "RemoveWhenExpired",
+        "SourceUtcTimestamp"
+      ],
+      "x-ms-discriminator-value": "DeployedApplicationHealthReportExpired"
+    },
+    "ApplicationProcessExitedEvent": {
+      "description": "Process Exited event.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/ApplicationEvent"
+        }
+      ],
+      "properties": {
+        "ServiceName": {
+          "type": "string",
+          "description": "Name of Service."
+        },
+        "ServicePackageName": {
+          "type": "string",
+          "description": "Name of Service package."
+        },
+        "ServicePackageActivationId": {
+          "type": "string",
+          "description": "Activation Id of Service package."
+        },
+        "IsExclusive": {
+          "type": "boolean",
+          "description": "Indicates IsExclusive flag."
+        },
+        "CodePackageName": {
+          "type": "string",
+          "description": "Name of Code package."
+        },
+        "EntryPointType": {
+          "type": "string",
+          "description": "Type of EntryPoint."
+        },
+        "ExeName": {
+          "type": "string",
+          "description": "Name of executable."
+        },
+        "ProcessId": {
+          "type": "integer",
+          "format": "int64",
+          "description": "Process Id."
+        },
+        "HostId": {
+          "type": "string",
+          "description": "Host Id."
+        },
+        "ExitCode": {
+          "type": "integer",
+          "format": "int64",
+          "description": "Exit code of process."
+        },
+        "UnexpectedTermination": {
+          "type": "boolean",
+          "description": "Indicates if termination is unexpected."
+        },
+        "StartTime": {
+          "type": "string",
+          "format": "date-time",
+          "description": "Start time of process."
+        }
+      },
+      "required": [
+        "ServiceName",
+        "ServicePackageName",
+        "ServicePackageActivationId",
+        "IsExclusive",
+        "CodePackageName",
+        "EntryPointType",
+        "ExeName",
+        "ProcessId",
+        "HostId",
+        "ExitCode",
+        "UnexpectedTermination",
+        "StartTime"
+      ],
+      "x-ms-discriminator-value": "ApplicationProcessExited"
+    },
+    "ApplicationContainerInstanceExitedEvent": {
+      "description": "Container Exited event.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/ApplicationEvent"
+        }
+      ],
+      "properties": {
+        "ServiceName": {
+          "type": "string",
+          "description": "Name of Service."
+        },
+        "ServicePackageName": {
+          "type": "string",
+          "description": "Name of Service package."
+        },
+        "ServicePackageActivationId": {
+          "type": "string",
+          "description": "Activation Id of Service package."
+        },
+        "IsExclusive": {
+          "type": "boolean",
+          "description": "Indicates IsExclusive flag."
+        },
+        "CodePackageName": {
+          "type": "string",
+          "description": "Name of Code package."
+        },
+        "EntryPointType": {
+          "type": "string",
+          "description": "Type of EntryPoint."
+        },
+        "ImageName": {
+          "type": "string",
+          "description": "Name of Container image."
+        },
+        "ContainerName": {
+          "type": "string",
+          "description": "Name of Container."
+        },
+        "HostId": {
+          "type": "string",
+          "description": "Host Id."
+        },
+        "ExitCode": {
+          "type": "integer",
+          "format": "int64",
+          "description": "Exit code of process."
+        },
+        "UnexpectedTermination": {
+          "type": "boolean",
+          "description": "Indicates if termination is unexpected."
+        },
+        "StartTime": {
+          "type": "string",
+          "format": "date-time",
+          "description": "Start time of process."
+        }
+      },
+      "required": [
+        "ServiceName",
+        "ServicePackageName",
+        "ServicePackageActivationId",
+        "IsExclusive",
+        "CodePackageName",
+        "EntryPointType",
+        "ImageName",
+        "ContainerName",
+        "HostId",
+        "ExitCode",
+        "UnexpectedTermination",
+        "StartTime"
+      ],
+      "x-ms-discriminator-value": "ApplicationContainerInstanceExited"
+    },
+    "NodeAbortedEvent": {
+      "description": "Node Aborted event.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/NodeEvent"
+        }
+      ],
+      "properties": {
+        "NodeInstance": {
+          "type": "integer",
+          "format": "int64",
+          "description": "Id of Node instance."
+        },
+        "NodeId": {
+          "type": "string",
+          "description": "Id of Node."
+        },
+        "UpgradeDomain": {
+          "type": "string",
+          "description": "Upgrade domain of Node."
+        },
+        "FaultDomain": {
+          "type": "string",
+          "description": "Fault domain of Node."
+        },
+        "IpAddressOrFQDN": {
+          "type": "string",
+          "description": "IP address or FQDN."
+        },
+        "Hostname": {
+          "type": "string",
+          "description": "Name of Host."
+        },
+        "IsSeedNode": {
+          "type": "boolean",
+          "description": "Indicates if it is seed node."
+        },
+        "NodeVersion": {
+          "type": "string",
+          "description": "Version of Node."
+        }
+      },
+      "required": [
+        "NodeInstance",
+        "NodeId",
+        "UpgradeDomain",
+        "FaultDomain",
+        "IpAddressOrFQDN",
+        "Hostname",
+        "IsSeedNode",
+        "NodeVersion"
+      ],
+      "x-ms-discriminator-value": "NodeAborted"
+    },
+    "NodeAddedToClusterEvent": {
+      "description": "Node Added event.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/NodeEvent"
+        }
+      ],
+      "properties": {
+        "NodeId": {
+          "type": "string",
+          "description": "Id of Node."
+        },
+        "NodeInstance": {
+          "type": "integer",
+          "format": "int64",
+          "description": "Id of Node instance."
+        },
+        "NodeType": {
+          "type": "string",
+          "description": "Type of Node."
+        },
+        "FabricVersion": {
+          "type": "string",
+          "description": "Fabric version."
+        },
+        "IpAddressOrFQDN": {
+          "type": "string",
+          "description": "IP address or FQDN."
+        },
+        "NodeCapacities": {
+          "type": "string",
+          "description": "Capacities."
+        }
+      },
+      "required": [
+        "NodeId",
+        "NodeInstance",
+        "NodeType",
+        "FabricVersion",
+        "IpAddressOrFQDN",
+        "NodeCapacities"
+      ],
+      "x-ms-discriminator-value": "NodeAddedToCluster"
+    },
+    "NodeClosedEvent": {
+      "description": "Node Closed event.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/NodeEvent"
+        }
+      ],
+      "properties": {
+        "NodeId": {
+          "type": "string",
+          "description": "Id of Node."
+        },
+        "NodeInstance": {
+          "type": "integer",
+          "format": "int64",
+          "description": "Id of Node instance."
+        },
+        "Error": {
+          "type": "string",
+          "description": "Describes error."
+        }
+      },
+      "required": [
+        "NodeId",
+        "NodeInstance",
+        "Error"
+      ],
+      "x-ms-discriminator-value": "NodeClosed"
+    },
+    "NodeDeactivateCompletedEvent": {
+      "description": "Node Deactivate Completed event.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/NodeEvent"
+        }
+      ],
+      "properties": {
+        "NodeInstance": {
+          "type": "integer",
+          "format": "int64",
+          "description": "Id of Node instance."
+        },
+        "EffectiveDeactivateIntent": {
+          "type": "string",
+          "description": "Describes deactivate intent."
+        },
+        "BatchIdsWithDeactivateIntent": {
+          "type": "string",
+          "description": "Batch Ids."
+        },
+        "StartTime": {
+          "type": "string",
+          "format": "date-time",
+          "description": "Start time."
+        }
+      },
+      "required": [
+        "NodeInstance",
+        "EffectiveDeactivateIntent",
+        "BatchIdsWithDeactivateIntent",
+        "StartTime"
+      ],
+      "x-ms-discriminator-value": "NodeDeactivateCompleted"
+    },
+    "NodeDeactivateStartedEvent": {
+      "description": "Node Deactivate Started event.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/NodeEvent"
+        }
+      ],
+      "properties": {
+        "NodeInstance": {
+          "type": "integer",
+          "format": "int64",
+          "description": "Id of Node instance."
+        },
+        "BatchId": {
+          "type": "string",
+          "description": "Batch Id."
+        },
+        "DeactivateIntent": {
+          "type": "string",
+          "description": "Describes deactivate intent."
+        }
+      },
+      "required": [
+        "NodeInstance",
+        "BatchId",
+        "DeactivateIntent"
+      ],
+      "x-ms-discriminator-value": "NodeDeactivateStarted"
+    },
+    "NodeDownEvent": {
+      "description": "Node Down event.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/NodeEvent"
+        }
+      ],
+      "properties": {
+        "NodeInstance": {
+          "type": "integer",
+          "format": "int64",
+          "description": "Id of Node instance."
+        },
+        "LastNodeUpAt": {
+          "type": "string",
+          "format": "date-time",
+          "description": "Time when Node was last up."
+        }
+      },
+      "required": [
+        "NodeInstance",
+        "LastNodeUpAt"
+      ],
+      "x-ms-discriminator-value": "NodeDown"
+    },
+    "NodeNewHealthReportEvent": {
+      "description": "Node Health Report Created event.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/NodeEvent"
+        }
+      ],
+      "properties": {
+        "NodeInstanceId": {
+          "type": "integer",
+          "format": "int64",
+          "description": "Id of Node instance."
+        },
+        "SourceId": {
+          "type": "string",
+          "description": "Id of report source."
+        },
+        "Property": {
+          "type": "string",
+          "description": "Describes the property."
+        },
+        "HealthState": {
+          "type": "string",
+          "description": "Describes the property health state."
+        },
+        "TimeToLiveMs": {
+          "type": "integer",
+          "format": "int64",
+          "description": "Time to live in milli-seconds."
+        },
+        "SequenceNumber": {
+          "type": "integer",
+          "format": "int64",
+          "description": "Sequence number of report."
+        },
+        "Description": {
+          "type": "string",
+          "description": "Description of report."
+        },
+        "RemoveWhenExpired": {
+          "type": "boolean",
+          "description": "Indicates the removal when it expires."
+        },
+        "SourceUtcTimestamp": {
+          "type": "string",
+          "format": "date-time",
+          "description": "Source time."
+        }
+      },
+      "required": [
+        "NodeInstanceId",
+        "SourceId",
+        "Property",
+        "HealthState",
+        "TimeToLiveMs",
+        "SequenceNumber",
+        "Description",
+        "RemoveWhenExpired",
+        "SourceUtcTimestamp"
+      ],
+      "x-ms-discriminator-value": "NodeNewHealthReport"
+    },
+    "NodeHealthReportExpiredEvent": {
+      "description": "Node Health Report Expired event.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/NodeEvent"
+        }
+      ],
+      "properties": {
+        "NodeInstanceId": {
+          "type": "integer",
+          "format": "int64",
+          "description": "Id of Node instance."
+        },
+        "SourceId": {
+          "type": "string",
+          "description": "Id of report source."
+        },
+        "Property": {
+          "type": "string",
+          "description": "Describes the property."
+        },
+        "HealthState": {
+          "type": "string",
+          "description": "Describes the property health state."
+        },
+        "TimeToLiveMs": {
+          "type": "integer",
+          "format": "int64",
+          "description": "Time to live in milli-seconds."
+        },
+        "SequenceNumber": {
+          "type": "integer",
+          "format": "int64",
+          "description": "Sequence number of report."
+        },
+        "Description": {
+          "type": "string",
+          "description": "Description of report."
+        },
+        "RemoveWhenExpired": {
+          "type": "boolean",
+          "description": "Indicates the removal when it expires."
+        },
+        "SourceUtcTimestamp": {
+          "type": "string",
+          "format": "date-time",
+          "description": "Source time."
+        }
+      },
+      "required": [
+        "NodeInstanceId",
+        "SourceId",
+        "Property",
+        "HealthState",
+        "TimeToLiveMs",
+        "SequenceNumber",
+        "Description",
+        "RemoveWhenExpired",
+        "SourceUtcTimestamp"
+      ],
+      "x-ms-discriminator-value": "NodeHealthReportExpired"
+    },
+    "NodeOpenSucceededEvent": {
+      "description": "Node Opened Succeeded event.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/NodeEvent"
+        }
+      ],
+      "properties": {
+        "NodeInstance": {
+          "type": "integer",
+          "format": "int64",
+          "description": "Id of Node instance."
+        },
+        "NodeId": {
+          "type": "string",
+          "description": "Id of Node."
+        },
+        "UpgradeDomain": {
+          "type": "string",
+          "description": "Upgrade domain of Node."
+        },
+        "FaultDomain": {
+          "type": "string",
+          "description": "Fault domain of Node."
+        },
+        "IpAddressOrFQDN": {
+          "type": "string",
+          "description": "IP address or FQDN."
+        },
+        "Hostname": {
+          "type": "string",
+          "description": "Name of Host."
+        },
+        "IsSeedNode": {
+          "type": "boolean",
+          "description": "Indicates if it is seed node."
+        },
+        "NodeVersion": {
+          "type": "string",
+          "description": "Version of Node."
+        }
+      },
+      "required": [
+        "NodeInstance",
+        "NodeId",
+        "UpgradeDomain",
+        "FaultDomain",
+        "IpAddressOrFQDN",
+        "Hostname",
+        "IsSeedNode",
+        "NodeVersion"
+      ],
+      "x-ms-discriminator-value": "NodeOpenSucceeded"
+    },
+    "NodeOpenFailedEvent": {
+      "description": "Node Open Failed event.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/NodeEvent"
+        }
+      ],
+      "properties": {
+        "NodeInstance": {
+          "type": "integer",
+          "format": "int64",
+          "description": "Id of Node instance."
+        },
+        "NodeId": {
+          "type": "string",
+          "description": "Id of Node."
+        },
+        "UpgradeDomain": {
+          "type": "string",
+          "description": "Upgrade domain of Node."
+        },
+        "FaultDomain": {
+          "type": "string",
+          "description": "Fault domain of Node."
+        },
+        "IpAddressOrFQDN": {
+          "type": "string",
+          "description": "IP address or FQDN."
+        },
+        "Hostname": {
+          "type": "string",
+          "description": "Name of Host."
+        },
+        "IsSeedNode": {
+          "type": "boolean",
+          "description": "Indicates if it is seed node."
+        },
+        "NodeVersion": {
+          "type": "string",
+          "description": "Version of Node."
+        },
+        "Error": {
+          "type": "string",
+          "description": "Describes the error."
+        }
+      },
+      "required": [
+        "NodeInstance",
+        "NodeId",
+        "UpgradeDomain",
+        "FaultDomain",
+        "IpAddressOrFQDN",
+        "Hostname",
+        "IsSeedNode",
+        "NodeVersion",
+        "Error"
+      ],
+      "x-ms-discriminator-value": "NodeOpenFailed"
+    },
+    "NodeRemovedFromClusterEvent": {
+      "description": "Node Removed event.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/NodeEvent"
+        }
+      ],
+      "properties": {
+        "NodeId": {
+          "type": "string",
+          "description": "Id of Node."
+        },
+        "NodeInstance": {
+          "type": "integer",
+          "format": "int64",
+          "description": "Id of Node instance."
+        },
+        "NodeType": {
+          "type": "string",
+          "description": "Type of Node."
+        },
+        "FabricVersion": {
+          "type": "string",
+          "description": "Fabric version."
+        },
+        "IpAddressOrFQDN": {
+          "type": "string",
+          "description": "IP address or FQDN."
+        },
+        "NodeCapacities": {
+          "type": "string",
+          "description": "Capacities."
+        }
+      },
+      "required": [
+        "NodeId",
+        "NodeInstance",
+        "NodeType",
+        "FabricVersion",
+        "IpAddressOrFQDN",
+        "NodeCapacities"
+      ],
+      "x-ms-discriminator-value": "NodeRemovedFromCluster"
+    },
+    "NodeUpEvent": {
+      "description": "Node Up event.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/NodeEvent"
+        }
+      ],
+      "properties": {
+        "NodeInstance": {
+          "type": "integer",
+          "format": "int64",
+          "description": "Id of Node instance."
+        },
+        "LastNodeDownAt": {
+          "type": "string",
+          "format": "date-time",
+          "description": "Time when Node was last down."
+        }
+      },
+      "required": [
+        "NodeInstance",
+        "LastNodeDownAt"
+      ],
+      "x-ms-discriminator-value": "NodeUp"
+    },
+    "PartitionNewHealthReportEvent": {
+      "description": "Partition Health Report Created event.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/PartitionEvent"
+        }
+      ],
+      "properties": {
+        "SourceId": {
+          "type": "string",
+          "description": "Id of report source."
+        },
+        "Property": {
+          "type": "string",
+          "description": "Describes the property."
+        },
+        "HealthState": {
+          "type": "string",
+          "description": "Describes the property health state."
+        },
+        "TimeToLiveMs": {
+          "type": "integer",
+          "format": "int64",
+          "description": "Time to live in milli-seconds."
+        },
+        "SequenceNumber": {
+          "type": "integer",
+          "format": "int64",
+          "description": "Sequence number of report."
+        },
+        "Description": {
+          "type": "string",
+          "description": "Description of report."
+        },
+        "RemoveWhenExpired": {
+          "type": "boolean",
+          "description": "Indicates the removal when it expires."
+        },
+        "SourceUtcTimestamp": {
+          "type": "string",
+          "format": "date-time",
+          "description": "Source time."
+        }
+      },
+      "required": [
+        "SourceId",
+        "Property",
+        "HealthState",
+        "TimeToLiveMs",
+        "SequenceNumber",
+        "Description",
+        "RemoveWhenExpired",
+        "SourceUtcTimestamp"
+      ],
+      "x-ms-discriminator-value": "PartitionNewHealthReport"
+    },
+    "PartitionHealthReportExpiredEvent": {
+      "description": "Partition Health Report Expired event.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/PartitionEvent"
+        }
+      ],
+      "properties": {
+        "SourceId": {
+          "type": "string",
+          "description": "Id of report source."
+        },
+        "Property": {
+          "type": "string",
+          "description": "Describes the property."
+        },
+        "HealthState": {
+          "type": "string",
+          "description": "Describes the property health state."
+        },
+        "TimeToLiveMs": {
+          "type": "integer",
+          "format": "int64",
+          "description": "Time to live in milli-seconds."
+        },
+        "SequenceNumber": {
+          "type": "integer",
+          "format": "int64",
+          "description": "Sequence number of report."
+        },
+        "Description": {
+          "type": "string",
+          "description": "Description of report."
+        },
+        "RemoveWhenExpired": {
+          "type": "boolean",
+          "description": "Indicates the removal when it expires."
+        },
+        "SourceUtcTimestamp": {
+          "type": "string",
+          "format": "date-time",
+          "description": "Source time."
+        }
+      },
+      "required": [
+        "SourceId",
+        "Property",
+        "HealthState",
+        "TimeToLiveMs",
+        "SequenceNumber",
+        "Description",
+        "RemoveWhenExpired",
+        "SourceUtcTimestamp"
+      ],
+      "x-ms-discriminator-value": "PartitionHealthReportExpired"
+    },
+    "PartitionReconfiguredEvent": {
+      "description": "Partition Reconfiguration event.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/PartitionEvent"
+        }
+      ],
+      "properties": {
+        "NodeName": {
+          "$ref": "#/definitions/NodeName",
+          "description": "The name of a Service Fabric node."
+        },
+        "NodeInstanceId": {
+          "type": "string",
+          "description": "Id of Node instance."
+        },
+        "ServiceType": {
+          "type": "string",
+          "description": "Type of Service."
+        },
+        "CcEpochDataLossVersion": {
+          "type": "integer",
+          "format": "int64",
+          "description": "CcEpochDataLoss version."
+        },
+        "CcEpochConfigVersion": {
+          "type": "integer",
+          "format": "int64",
+          "description": "CcEpochConfig version."
+        },
+        "ReconfigType": {
+          "type": "string",
+          "description": "Type of reconfiguration."
+        },
+        "Result": {
+          "type": "string",
+          "description": "Describes reconfiguration result."
+        },
+        "Phase0DurationMs": {
+          "type": "number",
+          "format": "double",
+          "description": "Duration of Phase0 in milli-seconds."
+        },
+        "Phase1DurationMs": {
+          "type": "number",
+          "format": "double",
+          "description": "Duration of Phase1 in milli-seconds."
+        },
+        "Phase2DurationMs": {
+          "type": "number",
+          "format": "double",
+          "description": "Duration of Phase2 in milli-seconds."
+        },
+        "Phase3DurationMs": {
+          "type": "number",
+          "format": "double",
+          "description": "Duration of Phase3 in milli-seconds."
+        },
+        "Phase4DurationMs": {
+          "type": "number",
+          "format": "double",
+          "description": "Duration of Phase4 in milli-seconds."
+        },
+        "TotalDurationMs": {
+          "type": "number",
+          "format": "double",
+          "description": "Total duration in milli-seconds."
+        }
+      },
+      "required": [
+        "NodeName",
+        "NodeInstanceId",
+        "ServiceType",
+        "CcEpochDataLossVersion",
+        "CcEpochConfigVersion",
+        "ReconfigType",
+        "Result",
+        "Phase0DurationMs",
+        "Phase1DurationMs",
+        "Phase2DurationMs",
+        "Phase3DurationMs",
+        "Phase4DurationMs",
+        "TotalDurationMs"
+      ],
+      "x-ms-discriminator-value": "PartitionReconfigured"
+    },
+    "PartitionPrimaryMoveAnalysisEvent": {
+      "description": "Partition Primary Move Analysis event.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/PartitionAnalysisEvent"
+        }
+      ],
+      "properties": {
+        "WhenMoveCompleted": {
+          "type": "string",
+          "format": "date-time",
+          "description": "Time when the move was completed."
+        },
+        "PreviousNode": {
+          "$ref": "#/definitions/NodeName",
+          "description": "The name of a Service Fabric node."
+        },
+        "CurrentNode": {
+          "$ref": "#/definitions/NodeName",
+          "description": "The name of a Service Fabric node."
+        },
+        "MoveReason": {
+          "type": "string",
+          "description": "Move reason."
+        },
+        "RelevantTraces": {
+          "type": "string",
+          "description": "Relevant traces."
+        }
+      },
+      "required": [
+        "WhenMoveCompleted",
+        "PreviousNode",
+        "CurrentNode",
+        "MoveReason",
+        "RelevantTraces"
+      ],
+      "x-ms-discriminator-value": "PartitionPrimaryMoveAnalysis"
+    },
+    "ServiceCreatedEvent": {
+      "description": "Service Created event.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/ServiceEvent"
+        }
+      ],
+      "properties": {
+        "ServiceTypeName": {
+          "type": "string",
+          "description": "Service type name."
+        },
+        "ApplicationName": {
+          "type": "string",
+          "description": "Application name."
+        },
+        "ApplicationTypeName": {
+          "type": "string",
+          "description": "Application type name."
+        },
+        "ServiceInstance": {
+          "type": "integer",
+          "format": "int64",
+          "description": "Id of Service instance."
+        },
+        "IsStateful": {
+          "type": "boolean",
+          "description": "Indicates if Service is stateful."
+        },
+        "PartitionCount": {
+          "type": "integer",
+          "format": "int32",
+          "description": "Number of partitions."
+        },
+        "TargetReplicaSetSize": {
+          "type": "integer",
+          "format": "int32",
+          "description": "Size of target replicas set."
+        },
+        "MinReplicaSetSize": {
+          "type": "integer",
+          "format": "int32",
+          "description": "Minimum size of replicas set."
+        },
+        "ServicePackageVersion": {
+          "type": "string",
+          "description": "Version of Service package."
+        },
+        "PartitionId": {
+          "$ref": "#/definitions/PartitionId",
+          "description": "An internal ID used by Service Fabric to uniquely identify a partition. This is a randomly generated GUID when the service was created. The partition ID is unique and does not change for the lifetime of the service. If the same service was deleted and recreated the IDs of its partitions would be different."
+        }
+      },
+      "required": [
+        "ServiceTypeName",
+        "ApplicationName",
+        "ApplicationTypeName",
+        "ServiceInstance",
+        "IsStateful",
+        "PartitionCount",
+        "TargetReplicaSetSize",
+        "MinReplicaSetSize",
+        "ServicePackageVersion",
+        "PartitionId"
+      ],
+      "x-ms-discriminator-value": "ServiceCreated"
+    },
+    "ServiceDeletedEvent": {
+      "description": "Service Deleted event.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/ServiceEvent"
+        }
+      ],
+      "properties": {
+        "ServiceTypeName": {
+          "type": "string",
+          "description": "Service type name."
+        },
+        "ApplicationName": {
+          "type": "string",
+          "description": "Application name."
+        },
+        "ApplicationTypeName": {
+          "type": "string",
+          "description": "Application type name."
+        },
+        "ServiceInstance": {
+          "type": "integer",
+          "format": "int64",
+          "description": "Id of Service instance."
+        },
+        "IsStateful": {
+          "type": "boolean",
+          "description": "Indicates if Service is stateful."
+        },
+        "PartitionCount": {
+          "type": "integer",
+          "format": "int32",
+          "description": "Number of partitions."
+        },
+        "TargetReplicaSetSize": {
+          "type": "integer",
+          "format": "int32",
+          "description": "Size of target replicas set."
+        },
+        "MinReplicaSetSize": {
+          "type": "integer",
+          "format": "int32",
+          "description": "Minimum size of replicas set."
+        },
+        "ServicePackageVersion": {
+          "type": "string",
+          "description": "Version of Service package."
+        }
+      },
+      "required": [
+        "ServiceTypeName",
+        "ApplicationName",
+        "ApplicationTypeName",
+        "ServiceInstance",
+        "IsStateful",
+        "PartitionCount",
+        "TargetReplicaSetSize",
+        "MinReplicaSetSize",
+        "ServicePackageVersion"
+      ],
+      "x-ms-discriminator-value": "ServiceDeleted"
+    },
+    "ServiceNewHealthReportEvent": {
+      "description": "Service Health Report Created event.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/ServiceEvent"
+        }
+      ],
+      "properties": {
+        "InstanceId": {
+          "type": "integer",
+          "format": "int64",
+          "description": "Id of Service instance."
+        },
+        "SourceId": {
+          "type": "string",
+          "description": "Id of report source."
+        },
+        "Property": {
+          "type": "string",
+          "description": "Describes the property."
+        },
+        "HealthState": {
+          "type": "string",
+          "description": "Describes the property health state."
+        },
+        "TimeToLiveMs": {
+          "type": "integer",
+          "format": "int64",
+          "description": "Time to live in milli-seconds."
+        },
+        "SequenceNumber": {
+          "type": "integer",
+          "format": "int64",
+          "description": "Sequence number of report."
+        },
+        "Description": {
+          "type": "string",
+          "description": "Description of report."
+        },
+        "RemoveWhenExpired": {
+          "type": "boolean",
+          "description": "Indicates the removal when it expires."
+        },
+        "SourceUtcTimestamp": {
+          "type": "string",
+          "format": "date-time",
+          "description": "Source time."
+        }
+      },
+      "required": [
+        "InstanceId",
+        "SourceId",
+        "Property",
+        "HealthState",
+        "TimeToLiveMs",
+        "SequenceNumber",
+        "Description",
+        "RemoveWhenExpired",
+        "SourceUtcTimestamp"
+      ],
+      "x-ms-discriminator-value": "ServiceNewHealthReport"
+    },
+    "ServiceHealthReportExpiredEvent": {
+      "description": "Service Health Report Expired event.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/ServiceEvent"
+        }
+      ],
+      "properties": {
+        "InstanceId": {
+          "type": "integer",
+          "format": "int64",
+          "description": "Id of Service instance."
+        },
+        "SourceId": {
+          "type": "string",
+          "description": "Id of report source."
+        },
+        "Property": {
+          "type": "string",
+          "description": "Describes the property."
+        },
+        "HealthState": {
+          "type": "string",
+          "description": "Describes the property health state."
+        },
+        "TimeToLiveMs": {
+          "type": "integer",
+          "format": "int64",
+          "description": "Time to live in milli-seconds."
+        },
+        "SequenceNumber": {
+          "type": "integer",
+          "format": "int64",
+          "description": "Sequence number of report."
+        },
+        "Description": {
+          "type": "string",
+          "description": "Description of report."
+        },
+        "RemoveWhenExpired": {
+          "type": "boolean",
+          "description": "Indicates the removal when it expires."
+        },
+        "SourceUtcTimestamp": {
+          "type": "string",
+          "format": "date-time",
+          "description": "Source time."
+        }
+      },
+      "required": [
+        "InstanceId",
+        "SourceId",
+        "Property",
+        "HealthState",
+        "TimeToLiveMs",
+        "SequenceNumber",
+        "Description",
+        "RemoveWhenExpired",
+        "SourceUtcTimestamp"
+      ],
+      "x-ms-discriminator-value": "ServiceHealthReportExpired"
+    },
+    "DeployedServicePackageNewHealthReportEvent": {
+      "description": "Deployed Service Health Report Created event.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/ApplicationEvent"
+        }
+      ],
+      "properties": {
+        "ServiceManifestName": {
+          "type": "string",
+          "description": "Service manifest name."
+        },
+        "ServicePackageInstanceId": {
+          "type": "integer",
+          "format": "int64",
+          "description": "Id of Service package instance."
+        },
+        "ServicePackageActivationId": {
+          "type": "string",
+          "description": "Id of Service package activation."
+        },
+        "NodeName": {
+          "$ref": "#/definitions/NodeName",
+          "description": "The name of a Service Fabric node."
+        },
+        "SourceId": {
+          "type": "string",
+          "description": "Id of report source."
+        },
+        "Property": {
+          "type": "string",
+          "description": "Describes the property."
+        },
+        "HealthState": {
+          "type": "string",
+          "description": "Describes the property health state."
+        },
+        "TimeToLiveMs": {
+          "type": "integer",
+          "format": "int64",
+          "description": "Time to live in milli-seconds."
+        },
+        "SequenceNumber": {
+          "type": "integer",
+          "format": "int64",
+          "description": "Sequence number of report."
+        },
+        "Description": {
+          "type": "string",
+          "description": "Description of report."
+        },
+        "RemoveWhenExpired": {
+          "type": "boolean",
+          "description": "Indicates the removal when it expires."
+        },
+        "SourceUtcTimestamp": {
+          "type": "string",
+          "format": "date-time",
+          "description": "Source time."
+        }
+      },
+      "required": [
+        "ServiceManifestName",
+        "ServicePackageInstanceId",
+        "ServicePackageActivationId",
+        "NodeName",
+        "SourceId",
+        "Property",
+        "HealthState",
+        "TimeToLiveMs",
+        "SequenceNumber",
+        "Description",
+        "RemoveWhenExpired",
+        "SourceUtcTimestamp"
+      ],
+      "x-ms-discriminator-value": "DeployedServicePackageNewHealthReport"
+    },
+    "DeployedServicePackageHealthReportExpiredEvent": {
+      "description": "Deployed Service Health Report Expired event.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/ApplicationEvent"
+        }
+      ],
+      "properties": {
+        "ServiceManifest": {
+          "type": "string",
+          "description": "Service manifest name."
+        },
+        "ServicePackageInstanceId": {
+          "type": "integer",
+          "format": "int64",
+          "description": "Id of Service package instance."
+        },
+        "ServicePackageActivationId": {
+          "type": "string",
+          "description": "Id of Service package activation."
+        },
+        "NodeName": {
+          "$ref": "#/definitions/NodeName",
+          "description": "The name of a Service Fabric node."
+        },
+        "SourceId": {
+          "type": "string",
+          "description": "Id of report source."
+        },
+        "Property": {
+          "type": "string",
+          "description": "Describes the property."
+        },
+        "HealthState": {
+          "type": "string",
+          "description": "Describes the property health state."
+        },
+        "TimeToLiveMs": {
+          "type": "integer",
+          "format": "int64",
+          "description": "Time to live in milli-seconds."
+        },
+        "SequenceNumber": {
+          "type": "integer",
+          "format": "int64",
+          "description": "Sequence number of report."
+        },
+        "Description": {
+          "type": "string",
+          "description": "Description of report."
+        },
+        "RemoveWhenExpired": {
+          "type": "boolean",
+          "description": "Indicates the removal when it expires."
+        },
+        "SourceUtcTimestamp": {
+          "type": "string",
+          "format": "date-time",
+          "description": "Source time."
+        }
+      },
+      "required": [
+        "ServiceManifest",
+        "ServicePackageInstanceId",
+        "ServicePackageActivationId",
+        "NodeName",
+        "SourceId",
+        "Property",
+        "HealthState",
+        "TimeToLiveMs",
+        "SequenceNumber",
+        "Description",
+        "RemoveWhenExpired",
+        "SourceUtcTimestamp"
+      ],
+      "x-ms-discriminator-value": "DeployedServicePackageHealthReportExpired"
+    },
+    "StatefulReplicaNewHealthReportEvent": {
+      "description": "Stateful Replica Health Report Created event.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/ReplicaEvent"
+        }
+      ],
+      "properties": {
+        "ReplicaInstanceId": {
+          "type": "integer",
+          "format": "int64",
+          "description": "Id of Replica instance."
+        },
+        "SourceId": {
+          "type": "string",
+          "description": "Id of report source."
+        },
+        "Property": {
+          "type": "string",
+          "description": "Describes the property."
+        },
+        "HealthState": {
+          "type": "string",
+          "description": "Describes the property health state."
+        },
+        "TimeToLiveMs": {
+          "type": "integer",
+          "format": "int64",
+          "description": "Time to live in milli-seconds."
+        },
+        "SequenceNumber": {
+          "type": "integer",
+          "format": "int64",
+          "description": "Sequence number of report."
+        },
+        "Description": {
+          "type": "string",
+          "description": "Description of report."
+        },
+        "RemoveWhenExpired": {
+          "type": "boolean",
+          "description": "Indicates the removal when it expires."
+        },
+        "SourceUtcTimestamp": {
+          "type": "string",
+          "format": "date-time",
+          "description": "Source time."
+        }
+      },
+      "required": [
+        "ReplicaInstanceId",
+        "SourceId",
+        "Property",
+        "HealthState",
+        "TimeToLiveMs",
+        "SequenceNumber",
+        "Description",
+        "RemoveWhenExpired",
+        "SourceUtcTimestamp"
+      ],
+      "x-ms-discriminator-value": "StatefulReplicaNewHealthReport"
+    },
+    "StatefulReplicaHealthReportExpiredEvent": {
+      "description": "Stateful Replica Health Report Expired event.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/ReplicaEvent"
+        }
+      ],
+      "properties": {
+        "ReplicaInstanceId": {
+          "type": "integer",
+          "format": "int64",
+          "description": "Id of Replica instance."
+        },
+        "SourceId": {
+          "type": "string",
+          "description": "Id of report source."
+        },
+        "Property": {
+          "type": "string",
+          "description": "Describes the property."
+        },
+        "HealthState": {
+          "type": "string",
+          "description": "Describes the property health state."
+        },
+        "TimeToLiveMs": {
+          "type": "integer",
+          "format": "int64",
+          "description": "Time to live in milli-seconds."
+        },
+        "SequenceNumber": {
+          "type": "integer",
+          "format": "int64",
+          "description": "Sequence number of report."
+        },
+        "Description": {
+          "type": "string",
+          "description": "Description of report."
+        },
+        "RemoveWhenExpired": {
+          "type": "boolean",
+          "description": "Indicates the removal when it expires."
+        },
+        "SourceUtcTimestamp": {
+          "type": "string",
+          "format": "date-time",
+          "description": "Source time."
+        }
+      },
+      "required": [
+        "ReplicaInstanceId",
+        "SourceId",
+        "Property",
+        "HealthState",
+        "TimeToLiveMs",
+        "SequenceNumber",
+        "Description",
+        "RemoveWhenExpired",
+        "SourceUtcTimestamp"
+      ],
+      "x-ms-discriminator-value": "StatefulReplicaHealthReportExpired"
+    },
+    "StatelessReplicaNewHealthReportEvent": {
+      "description": "Stateless Replica Health Report Created event.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/ReplicaEvent"
+        }
+      ],
+      "properties": {
+        "SourceId": {
+          "type": "string",
+          "description": "Id of report source."
+        },
+        "Property": {
+          "type": "string",
+          "description": "Describes the property."
+        },
+        "HealthState": {
+          "type": "string",
+          "description": "Describes the property health state."
+        },
+        "TimeToLiveMs": {
+          "type": "integer",
+          "format": "int64",
+          "description": "Time to live in milli-seconds."
+        },
+        "SequenceNumber": {
+          "type": "integer",
+          "format": "int64",
+          "description": "Sequence number of report."
+        },
+        "Description": {
+          "type": "string",
+          "description": "Description of report."
+        },
+        "RemoveWhenExpired": {
+          "type": "boolean",
+          "description": "Indicates the removal when it expires."
+        },
+        "SourceUtcTimestamp": {
+          "type": "string",
+          "format": "date-time",
+          "description": "Source time."
+        }
+      },
+      "required": [
+        "SourceId",
+        "Property",
+        "HealthState",
+        "TimeToLiveMs",
+        "SequenceNumber",
+        "Description",
+        "RemoveWhenExpired",
+        "SourceUtcTimestamp"
+      ],
+      "x-ms-discriminator-value": "StatelessReplicaNewHealthReport"
+    },
+    "StatelessReplicaHealthReportExpiredEvent": {
+      "description": "Stateless Replica Health Report Expired event.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/ReplicaEvent"
+        }
+      ],
+      "properties": {
+        "SourceId": {
+          "type": "string",
+          "description": "Id of report source."
+        },
+        "Property": {
+          "type": "string",
+          "description": "Describes the property."
+        },
+        "HealthState": {
+          "type": "string",
+          "description": "Describes the property health state."
+        },
+        "TimeToLiveMs": {
+          "type": "integer",
+          "format": "int64",
+          "description": "Time to live in milli-seconds."
+        },
+        "SequenceNumber": {
+          "type": "integer",
+          "format": "int64",
+          "description": "Sequence number of report."
+        },
+        "Description": {
+          "type": "string",
+          "description": "Description of report."
+        },
+        "RemoveWhenExpired": {
+          "type": "boolean",
+          "description": "Indicates the removal when it expires."
+        },
+        "SourceUtcTimestamp": {
+          "type": "string",
+          "format": "date-time",
+          "description": "Source time."
+        }
+      },
+      "required": [
+        "SourceId",
+        "Property",
+        "HealthState",
+        "TimeToLiveMs",
+        "SequenceNumber",
+        "Description",
+        "RemoveWhenExpired",
+        "SourceUtcTimestamp"
+      ],
+      "x-ms-discriminator-value": "StatelessReplicaHealthReportExpired"
+    },
+    "ClusterNewHealthReportEvent": {
+      "description": "Cluster Health Report Created event.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/ClusterEvent"
+        }
+      ],
+      "properties": {
+        "SourceId": {
+          "type": "string",
+          "description": "Id of report source."
+        },
+        "Property": {
+          "type": "string",
+          "description": "Describes the property."
+        },
+        "HealthState": {
+          "type": "string",
+          "description": "Describes the property health state."
+        },
+        "TimeToLiveMs": {
+          "type": "integer",
+          "format": "int64",
+          "description": "Time to live in milli-seconds."
+        },
+        "SequenceNumber": {
+          "type": "integer",
+          "format": "int64",
+          "description": "Sequence number of report."
+        },
+        "Description": {
+          "type": "string",
+          "description": "Description of report."
+        },
+        "RemoveWhenExpired": {
+          "type": "boolean",
+          "description": "Indicates the removal when it expires."
+        },
+        "SourceUtcTimestamp": {
+          "type": "string",
+          "format": "date-time",
+          "description": "Source time."
+        }
+      },
+      "required": [
+        "SourceId",
+        "Property",
+        "HealthState",
+        "TimeToLiveMs",
+        "SequenceNumber",
+        "Description",
+        "RemoveWhenExpired",
+        "SourceUtcTimestamp"
+      ],
+      "x-ms-discriminator-value": "ClusterNewHealthReport"
+    },
+    "ClusterHealthReportExpiredEvent": {
+      "description": "Cluster Health Report Expired event.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/ClusterEvent"
+        }
+      ],
+      "properties": {
+        "SourceId": {
+          "type": "string",
+          "description": "Id of report source."
+        },
+        "Property": {
+          "type": "string",
+          "description": "Describes the property."
+        },
+        "HealthState": {
+          "type": "string",
+          "description": "Describes the property health state."
+        },
+        "TimeToLiveMs": {
+          "type": "integer",
+          "format": "int64",
+          "description": "Time to live in milli-seconds."
+        },
+        "SequenceNumber": {
+          "type": "integer",
+          "format": "int64",
+          "description": "Sequence number of report."
+        },
+        "Description": {
+          "type": "string",
+          "description": "Description of report."
+        },
+        "RemoveWhenExpired": {
+          "type": "boolean",
+          "description": "Indicates the removal when it expires."
+        },
+        "SourceUtcTimestamp": {
+          "type": "string",
+          "format": "date-time",
+          "description": "Source time."
+        }
+      },
+      "required": [
+        "SourceId",
+        "Property",
+        "HealthState",
+        "TimeToLiveMs",
+        "SequenceNumber",
+        "Description",
+        "RemoveWhenExpired",
+        "SourceUtcTimestamp"
+      ],
+      "x-ms-discriminator-value": "ClusterHealthReportExpired"
+    },
+    "ClusterUpgradeCompletedEvent": {
+      "description": "Cluster Upgrade Completed event.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/ClusterEvent"
+        }
+      ],
+      "properties": {
+        "TargetClusterVersion": {
+          "type": "string",
+          "description": "Target Cluster version."
+        },
+        "OverallUpgradeElapsedTimeInMs": {
+          "type": "number",
+          "format": "double",
+          "description": "Overall duration of upgrade in milli-seconds."
+        }
+      },
+      "required": [
+        "TargetClusterVersion",
+        "OverallUpgradeElapsedTimeInMs"
+      ],
+      "x-ms-discriminator-value": "ClusterUpgradeCompleted"
+    },
+    "ClusterUpgradeDomainCompletedEvent": {
+      "description": "Cluster Upgrade Domain Completed event.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/ClusterEvent"
+        }
+      ],
+      "properties": {
+        "TargetClusterVersion": {
+          "type": "string",
+          "description": "Target Cluster version."
+        },
+        "UpgradeState": {
+          "type": "string",
+          "description": "State of upgrade."
+        },
+        "UpgradeDomains": {
+          "type": "string",
+          "description": "Upgrade domains."
+        },
+        "UpgradeDomainElapsedTimeInMs": {
+          "type": "number",
+          "format": "double",
+          "description": "Duration of domain upgrade in milli-seconds."
+        }
+      },
+      "required": [
+        "TargetClusterVersion",
+        "UpgradeState",
+        "UpgradeDomains",
+        "UpgradeDomainElapsedTimeInMs"
+      ],
+      "x-ms-discriminator-value": "ClusterUpgradeDomainCompleted"
+    },
+    "ClusterUpgradeRollbackCompletedEvent": {
+      "description": "Cluster Upgrade Rollback Completed event.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/ClusterEvent"
+        }
+      ],
+      "properties": {
+        "TargetClusterVersion": {
+          "type": "string",
+          "description": "Target Cluster version."
+        },
+        "FailureReason": {
+          "type": "string",
+          "description": "Describes failure."
+        },
+        "OverallUpgradeElapsedTimeInMs": {
+          "type": "number",
+          "format": "double",
+          "description": "Overall duration of upgrade in milli-seconds."
+        }
+      },
+      "required": [
+        "TargetClusterVersion",
+        "FailureReason",
+        "OverallUpgradeElapsedTimeInMs"
+      ],
+      "x-ms-discriminator-value": "ClusterUpgradeRollbackCompleted"
+    },
+    "ClusterUpgradeRollbackStartedEvent": {
+      "description": "Cluster Upgrade Rollback Started event.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/ClusterEvent"
+        }
+      ],
+      "properties": {
+        "TargetClusterVersion": {
+          "type": "string",
+          "description": "Target Cluster version."
+        },
+        "FailureReason": {
+          "type": "string",
+          "description": "Describes failure."
+        },
+        "OverallUpgradeElapsedTimeInMs": {
+          "type": "number",
+          "format": "double",
+          "description": "Overall duration of upgrade in milli-seconds."
+        }
+      },
+      "required": [
+        "TargetClusterVersion",
+        "FailureReason",
+        "OverallUpgradeElapsedTimeInMs"
+      ],
+      "x-ms-discriminator-value": "ClusterUpgradeRollbackStarted"
+    },
+    "ClusterUpgradeStartedEvent": {
+      "description": "Cluster Upgrade Started event.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/ClusterEvent"
+        }
+      ],
+      "properties": {
+        "CurrentClusterVersion": {
+          "type": "string",
+          "description": "Current Cluster version."
+        },
+        "TargetClusterVersion": {
+          "type": "string",
+          "description": "Target Cluster version."
+        },
+        "UpgradeType": {
+          "type": "string",
+          "description": "Type of upgrade."
+        },
+        "RollingUpgradeMode": {
+          "type": "string",
+          "description": "Mode of upgrade."
+        },
+        "FailureAction": {
+          "type": "string",
+          "description": "Action if failed."
+        }
+      },
+      "required": [
+        "CurrentClusterVersion",
+        "TargetClusterVersion",
+        "UpgradeType",
+        "RollingUpgradeMode",
+        "FailureAction"
+      ],
+      "x-ms-discriminator-value": "ClusterUpgradeStarted"
+    },
+    "ChaosStoppedEvent": {
+      "description": "Chaos Stopped event.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/ClusterEvent"
+        }
+      ],
+      "properties": {
+        "Reason": {
+          "type": "string",
+          "description": "Describes reason."
+        }
+      },
+      "required": [
+        "Reason"
+      ],
+      "x-ms-discriminator-value": "ChaosStopped"
+    },
+    "ChaosStartedEvent": {
+      "description": "Chaos Started event.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/ClusterEvent"
+        }
+      ],
+      "properties": {
+        "MaxConcurrentFaults": {
+          "type": "integer",
+          "format": "int64",
+          "description": "Maximum number of concurrent faults."
+        },
+        "TimeToRunInSeconds": {
+          "type": "number",
+          "format": "double",
+          "description": "Time to run in seconds."
+        },
+        "MaxClusterStabilizationTimeoutInSeconds": {
+          "type": "number",
+          "format": "double",
+          "description": "Maximum timeout for cluster stabilization in seconds."
+        },
+        "WaitTimeBetweenIterationsInSeconds": {
+          "type": "number",
+          "format": "double",
+          "description": "Wait time between iterations in seconds."
+        },
+        "WaitTimeBetweenFaultsInSeconds": {
+          "type": "number",
+          "format": "double",
+          "description": "Wait time between faults in seconds."
+        },
+        "MoveReplicaFaultEnabled": {
+          "type": "boolean",
+          "description": "Indicates MoveReplica fault is enabled."
+        },
+        "IncludedNodeTypeList": {
+          "type": "string",
+          "description": "List of included Node types."
+        },
+        "IncludedApplicationList": {
+          "type": "string",
+          "description": "List of included Applications."
+        },
+        "ClusterHealthPolicy": {
+          "type": "string",
+          "description": "Health policy."
+        },
+        "ChaosContext": {
+          "type": "string",
+          "description": "Chaos Context."
+        }
+      },
+      "required": [
+        "MaxConcurrentFaults",
+        "TimeToRunInSeconds",
+        "MaxClusterStabilizationTimeoutInSeconds",
+        "WaitTimeBetweenIterationsInSeconds",
+        "WaitTimeBetweenFaultsInSeconds",
+        "MoveReplicaFaultEnabled",
+        "IncludedNodeTypeList",
+        "IncludedApplicationList",
+        "ClusterHealthPolicy",
+        "ChaosContext"
+      ],
+      "x-ms-discriminator-value": "ChaosStarted"
+    },
+    "ChaosCodePackageRestartScheduledEvent": {
+      "description": "Chaos Restart Code Package Fault Scheduled event.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/ApplicationEvent"
+        }
+      ],
+      "properties": {
+        "FaultGroupId": {
+          "type": "string",
+          "format": "uuid",
+          "description": "Id of fault group."
+        },
+        "FaultId": {
+          "type": "string",
+          "format": "uuid",
+          "description": "Id of fault."
+        },
+        "NodeName": {
+          "$ref": "#/definitions/NodeName",
+          "description": "The name of a Service Fabric node."
+        },
+        "ServiceManifestName": {
+          "type": "string",
+          "description": "Service manifest name."
+        },
+        "CodePackageName": {
+          "type": "string",
+          "description": "Code package name."
+        },
+        "ServicePackageActivationId": {
+          "type": "string",
+          "description": "Id of Service package activation."
+        }
+      },
+      "required": [
+        "FaultGroupId",
+        "FaultId",
+        "NodeName",
+        "ServiceManifestName",
+        "CodePackageName",
+        "ServicePackageActivationId"
+      ],
+      "x-ms-discriminator-value": "ChaosCodePackageRestartScheduled"
+    },
+    "ChaosReplicaRemovalScheduledEvent": {
+      "description": "Chaos Remove Replica Fault Scheduled event.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/ReplicaEvent"
+        }
+      ],
+      "properties": {
+        "FaultGroupId": {
+          "type": "string",
+          "format": "uuid",
+          "description": "Id of fault group."
+        },
+        "FaultId": {
+          "type": "string",
+          "format": "uuid",
+          "description": "Id of fault."
+        },
+        "ServiceUri": {
+          "type": "string",
+          "description": "Service name."
+        }
+      },
+      "required": [
+        "FaultGroupId",
+        "FaultId",
+        "ServiceUri"
+      ],
+      "x-ms-discriminator-value": "ChaosReplicaRemovalScheduled"
+    },
+    "ChaosPartitionSecondaryMoveScheduledEvent": {
+      "description": "Chaos Move Secondary Fault Scheduled event.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/PartitionEvent"
+        }
+      ],
+      "properties": {
+        "FaultGroupId": {
+          "type": "string",
+          "format": "uuid",
+          "description": "Id of fault group."
+        },
+        "FaultId": {
+          "type": "string",
+          "format": "uuid",
+          "description": "Id of fault."
+        },
+        "ServiceName": {
+          "type": "string",
+          "description": "Service name."
+        },
+        "SourceNode": {
+          "$ref": "#/definitions/NodeName",
+          "description": "The name of a Service Fabric node."
+        },
+        "DestinationNode": {
+          "$ref": "#/definitions/NodeName",
+          "description": "The name of a Service Fabric node."
+        },
+        "ForcedMove": {
+          "type": "boolean",
+          "description": "Indicates a forced move."
+        }
+      },
+      "required": [
+        "FaultGroupId",
+        "FaultId",
+        "ServiceName",
+        "SourceNode",
+        "DestinationNode",
+        "ForcedMove"
+      ],
+      "x-ms-discriminator-value": "ChaosPartitionSecondaryMoveScheduled"
+    },
+    "ChaosPartitionPrimaryMoveScheduledEvent": {
+      "description": "Chaos Move Primary Fault Scheduled event.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/PartitionEvent"
+        }
+      ],
+      "properties": {
+        "FaultGroupId": {
+          "type": "string",
+          "format": "uuid",
+          "description": "Id of fault group."
+        },
+        "FaultId": {
+          "type": "string",
+          "format": "uuid",
+          "description": "Id of fault."
+        },
+        "ServiceName": {
+          "type": "string",
+          "description": "Service name."
+        },
+        "NodeTo": {
+          "$ref": "#/definitions/NodeName",
+          "description": "The name of a Service Fabric node."
+        },
+        "ForcedMove": {
+          "type": "boolean",
+          "description": "Indicates a forced move."
+        }
+      },
+      "required": [
+        "FaultGroupId",
+        "FaultId",
+        "ServiceName",
+        "NodeTo",
+        "ForcedMove"
+      ],
+      "x-ms-discriminator-value": "ChaosPartitionPrimaryMoveScheduled"
+    },
+    "ChaosReplicaRestartScheduledEvent": {
+      "description": "Chaos Restart Replica Fault Scheduled event.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/ReplicaEvent"
+        }
+      ],
+      "properties": {
+        "FaultGroupId": {
+          "type": "string",
+          "format": "uuid",
+          "description": "Id of fault group."
+        },
+        "FaultId": {
+          "type": "string",
+          "format": "uuid",
+          "description": "Id of fault."
+        },
+        "ServiceUri": {
+          "type": "string",
+          "description": "Service name."
+        }
+      },
+      "required": [
+        "FaultGroupId",
+        "FaultId",
+        "ServiceUri"
+      ],
+      "x-ms-discriminator-value": "ChaosReplicaRestartScheduled"
+    },
+    "ChaosNodeRestartScheduledEvent": {
+      "description": "Chaos Restart Node Fault Scheduled event.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/NodeEvent"
+        }
+      ],
+      "properties": {
+        "NodeInstanceId": {
+          "type": "integer",
+          "format": "int64",
+          "description": "Id of Node instance."
+        },
+        "FaultGroupId": {
+          "type": "string",
+          "format": "uuid",
+          "description": "Id of fault group."
+        },
+        "FaultId": {
+          "type": "string",
+          "format": "uuid",
+          "description": "Id of fault."
+        }
+      },
+      "required": [
+        "NodeInstanceId",
+        "FaultGroupId",
+        "FaultId"
+      ],
+      "x-ms-discriminator-value": "ChaosNodeRestartScheduled"
+    },
+    "ManagedApplicationIdentityDescription": {
+      "description": "Managed application identity description.",
+      "properties": {
+        "TokenServiceEndpoint": {
+          "type": "string",
+          "description": "Token service endpoint."
+        },
+        "ManagedIdentities": {
+          "$ref": "#/definitions/ManagedApplicationIdentityList",
+          "description": "A list of managed application identity objects."
+        }
+      }
+    },
+    "ManagedApplicationIdentityList": {
+      "description": "A list of managed application identity objects.",
+      "type": "array",
+      "items": {
+        "$ref": "#/definitions/ManagedApplicationIdentity"
+      }
+    },
+    "ManagedApplicationIdentity": {
+      "description": "Describes a managed application identity.",
+      "required": [
+        "Name"
+      ],
+      "properties": {
+        "Name": {
+          "type": "string",
+          "description": "The name of the identity."
+        },
+        "PrincipalId": {
+          "type": "string",
+          "description": "The identity's PrincipalId."
+        }
+      }
+    },
+    "InstanceCloseDelayDurationInSeconds": {
+      "type": "integer",
+      "format": "int64",
+      "description": "Duration in seconds, to wait before a stateless instance is closed, to allow the active requests to drain gracefully. This would be effective when the instance is closing during the application/cluster\nupgrade, only for those instances which have a non-zero delay duration configured in the service description. See InstanceCloseDelayDurationSeconds property in $ref: \"#/definitions/StatelessServiceDescription.yaml\" for details.\nNote, the default value of InstanceCloseDelayDurationInSeconds is 4294967295, which indicates that the behavior will entirely depend on the delay configured in the stateless service description.",
+      "default": 4294967295
+    },
+    "MetricLoadDescription": {
+      "description": "Specifies metric load information.",
+      "properties": {
+        "MetricName": {
+          "type": "string",
+          "description": "The name of the reported metric."
+        },
+        "CurrentLoad": {
+          "type": "integer",
+          "format": "int64",
+          "description": "The current value of the metric load."
+        },
+        "PredictedLoad": {
+          "type": "integer",
+          "format": "int64",
+          "description": "The predicted value of the metric load."
+        }
+      }
+    },
+    "PagedUpdatePartitionLoadResultList": {
+      "description": "The list of results of the call UpdatePartitionLoad. The list is paged when all of the results cannot fit in a single message. The next set of results can be obtained by executing the same query with the continuation token provided in this list.",
+      "properties": {
+        "ContinuationToken": {
+          "$ref": "#/definitions/ContinuationToken",
+          "description": "The continuation token parameter is used to obtain next set of results. The continuation token is included in the response of the API when the results from the system do not fit in a single response. When this value is passed to the next API call, the API returns next set of results. If there are no further results, then the continuation token is not included in the response."
+        },
+        "Items": {
+          "type": "array",
+          "description": "List of partition load update information.",
+          "items": {
+            "$ref": "#/definitions/UpdatePartitionLoadResult"
+          }
+        }
+      }
+    },
+    "PartitionMetricLoadDescription": {
+      "description": "Represents load information for a partition, which contains the metrics load information about primary, all secondary replicas/instances or a specific secondary replica/instance located on a specific node.",
+      "properties": {
+        "PartitionId": {
+          "$ref": "#/definitions/PartitionId",
+          "description": "Id of the partition."
+        },
+        "PrimaryReplicaLoadEntries": {
+          "type": "array",
+          "description": "Partition's load information for primary replica, in case partition is from a stateful service.",
+          "items": {
+            "$ref": "#/definitions/MetricLoadDescription"
+          }
+        },
+        "SecondaryReplicasOrInstancesLoadEntries": {
+          "type": "array",
+          "description": "Partition's load information for all secondary replicas or instances.",
+          "items": {
+            "$ref": "#/definitions/MetricLoadDescription"
+          }
+        },
+        "SecondaryReplicaOrInstanceLoadEntriesPerNode": {
+          "type": "array",
+          "description": "Partition's load information for a specific secondary replica or instance located on a specific node.",
+          "items": {
+            "$ref": "#/definitions/ReplicaMetricLoadDescription"
+          }
+        }
+      }
+    },
+    "PartitionMetricLoadDescriptionList": {
+      "type": "array",
+      "items": {
+        "$ref": "#/definitions/PartitionMetricLoadDescription"
+      },
+      "description": "List that contains load descriptions of each partition."
+    },
+    "ReplicaMetricLoadDescription": {
+      "description": "Specifies metric loads of a partition's specific secondary replica or instance.",
+      "properties": {
+        "NodeName": {
+          "type": "string",
+          "description": "Node name of a specific secondary replica or instance."
+        },
+        "ReplicaOrInstanceLoadEntries": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/MetricLoadDescription"
+          },
+          "description": "Loads of a different metrics for a partition's secondary replica or instance."
+        }
+      }
+    },
+    "UpdatePartitionLoadResult": {
+      "description": "Specifies result of updating load for specified partitions. The output will be ordered based on the partition ID.",
+      "properties": {
+        "PartitionId": {
+          "$ref": "#/definitions/PartitionId",
+          "description": "Id of the partition."
+        },
+        "PartitionErrorCode": {
+          "type": "integer",
+          "description": "If OperationState is Completed - this is 0.  If OperationState is Faulted - this is an error code indicating the reason."
+        }
+      }
+    },
+    "ResourceStatus": {
+      "description": "Status of the resource.",
+      "type": "string",
+      "enum": [
+        "Unknown",
+        "Ready",
+        "Upgrading",
+        "Creating",
+        "Deleting",
+        "Failed"
+      ],
+      "x-ms-enum": {
+        "name": "ResourceStatus",
+        "modelAsString": true,
+        "values": [
+          {
+            "value": "Unknown",
+            "description": "Indicates the resource status is unknown. The value is zero."
+          },
+          {
+            "value": "Ready",
+            "description": "Indicates the resource is ready. The value is 1."
+          },
+          {
+            "value": "Upgrading",
+            "description": "Indicates the resource is upgrading. The value is 2."
+          },
+          {
+            "value": "Creating",
+            "description": "Indicates the resource is being created. The value is 3."
+          },
+          {
+            "value": "Deleting",
+            "description": "Indicates the resource is being deleted. The value is 4."
+          },
+          {
+            "value": "Failed",
+            "description": "Indicates the resource is not functional due to persistent failures. See statusDetails property for more details. The value is 5."
+          }
+        ]
+      }
+    },
+    "SecretKind": {
+      "type": "string",
+      "description": "Describes the kind of secret.",
+      "enum": [
+        "inlinedValue",
+        "keyVaultVersionedReference"
+      ],
+      "x-ms-enum": {
+        "name": "SecretKind",
+        "modelAsString": true,
+        "values": [
+          {
+            "value": "inlinedValue",
+            "description": "A simple secret resource whose plaintext value is provided by the user."
+          },
+          {
+            "value": "keyVaultVersionedReference",
+            "description": "A secret resource that references a specific version of a secret stored in Azure Key Vault; the expected value is a versioned KeyVault URI corresponding to the version of the secret being referenced."
+          }
+        ]
+      }
+    },
+    "SecretResourceProperties": {
+      "description": "Describes the properties of a secret resource.",
+      "type": "object",
+      "allOf": [
+        {
+          "$ref": "#/definitions/SecretResourcePropertiesBase"
+        }
+      ],
+      "properties": {
+        "description": {
+          "description": "User readable description of the secret.",
+          "type": "string"
+        },
+        "status": {
+          "readOnly": true,
+          "$ref": "#/definitions/ResourceStatus",
+          "description": "Status of the resource."
+        },
+        "statusDetails": {
+          "readOnly": true,
+          "type": "string",
+          "description": "Gives additional information about the current status of the secret."
+        },
+        "contentType": {
+          "type": "string",
+          "description": "The type of the content stored in the secret value. The value of this property is opaque to Service Fabric. Once set, the value of this property cannot be changed."
+        }
+      }
+    },
+    "InlinedValueSecretResourceProperties": {
+      "description": "Describes the properties of a secret resource whose value is provided explicitly as plaintext. The secret resource may have multiple values, each being uniquely versioned. The secret value of each version is stored encrypted, and delivered as plaintext into the context of applications referencing it.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/SecretResourceProperties"
+        }
+      ],
+      "x-ms-discriminator-value": "inlinedValue"
+    },
+    "SecretResourceName": {
+      "type": "string",
+      "description": "Name of the Secret resource."
+    },
+    "SecretResourceDescription": {
+      "description": "This type describes a secret resource.",
+      "properties": {
+        "properties": {
+          "$ref": "#/definitions/SecretResourceProperties",
+          "description": "Describes the properties of a secret resource."
+        },
+        "name": {
+          "$ref": "#/definitions/SecretResourceName",
+          "description": "Name of the Secret resource."
+        }
+      },
+      "required": [
+        "name",
+        "properties"
+      ]
+    },
+    "PagedSecretResourceDescriptionList": {
+      "type": "object",
+      "description": "The list of secret resources. The list is paged when all of the results cannot fit in a single message. The next set of results can be obtained by executing the same query with the continuation token provided in this list.",
+      "properties": {
+        "ContinuationToken": {
+          "$ref": "#/definitions/ContinuationToken",
+          "description": "The continuation token parameter is used to obtain next set of results. The continuation token is included in the response of the API when the results from the system do not fit in a single response. When this value is passed to the next API call, the API returns next set of results. If there are no further results, then the continuation token is not included in the response."
+        },
+        "Items": {
+          "type": "array",
+          "description": "One page of the list.",
+          "items": {
+            "$ref": "#/definitions/SecretResourceDescription"
+          }
+        }
+      }
+    },
+    "SecretResourcePropertiesBase": {
+      "discriminator": "kind",
+      "description": "This type describes the properties of a secret resource, including its kind.",
+      "type": "object",
+      "properties": {
+        "kind": {
+          "$ref": "#/definitions/SecretKind",
+          "description": "Describes the kind of secret."
+        }
+      },
+      "required": [
+        "kind"
+      ]
+    },
+    "SecretValue": {
+      "type": "object",
+      "description": "This type represents the unencrypted value of the secret.",
+      "properties": {
+        "value": {
+          "type": "string",
+          "description": "The actual value of the secret."
+        }
+      }
+    },
+    "SecretValueProperties": {
+      "type": "object",
+      "description": "This type describes properties of secret value resource.",
+      "properties": {
+        "value": {
+          "type": "string",
+          "description": "The actual value of the secret."
+        }
+      }
+    },
+    "SecretValueResourceDescription": {
+      "description": "This type describes a value of a secret resource. The name of this resource is the version identifier corresponding to this secret value.",
+      "properties": {
+        "name": {
+          "type": "string",
+          "description": "Version identifier of the secret value."
+        },
+        "properties": {
+          "x-ms-client-flatten": true,
+          "$ref": "#/definitions/SecretValueResourceProperties",
+          "description": "This type describes properties of a secret value resource."
+        }
+      },
+      "required": [
+        "name",
+        "properties"
+      ]
+    },
+    "PagedSecretValueResourceDescriptionList": {
+      "type": "object",
+      "description": "The list of values of a secret resource, paged if the number of results exceeds the limits of a single message. The next set of results can be obtained by executing the same query with the continuation token provided in the previous page.",
+      "properties": {
+        "ContinuationToken": {
+          "$ref": "#/definitions/ContinuationToken",
+          "description": "The continuation token parameter is used to obtain next set of results. The continuation token is included in the response of the API when the results from the system do not fit in a single response. When this value is passed to the next API call, the API returns next set of results. If there are no further results, then the continuation token is not included in the response."
+        },
+        "Items": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/SecretValueResourceDescription"
+          },
+          "description": "One page of the list."
+        }
+      }
+    },
+    "SecretValueResourceProperties": {
+      "description": "This type describes properties of a secret value resource.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/SecretValueProperties"
+        }
+      ]
+    },
+    "VolumeProperties": {
+      "description": "Describes properties of a volume resource.",
+      "properties": {
+        "description": {
+          "type": "string",
+          "description": "User readable description of the volume."
+        },
+        "status": {
+          "readOnly": true,
+          "$ref": "#/definitions/ResourceStatus",
+          "description": "Status of the volume."
+        },
+        "statusDetails": {
+          "readOnly": true,
+          "type": "string",
+          "description": "Gives additional information about the current status of the volume."
+        },
+        "provider": {
+          "$ref": "#/definitions/VolumeProvider",
+          "description": "Provider of the volume."
+        },
+        "azureFileParameters": {
+          "$ref": "#/definitions/VolumeProviderParametersAzureFile",
+          "description": "This type describes a volume provided by an Azure Files file share."
+        }
+      },
+      "required": [
+        "provider"
+      ]
+    },
+    "VolumeProvider": {
+      "type": "string",
+      "description": "Describes the provider of the volume resource.",
+      "enum": [
+        "SFAzureFile"
+      ],
+      "x-ms-enum": {
+        "name": "VolumeProvider",
+        "modelAsString": true,
+        "values": [
+          {
+            "value": "SFAzureFile",
+            "description": "Provides volumes that are backed by Azure Files."
+          }
+        ]
+      }
+    },
+    "VolumeProviderParametersAzureFile": {
+      "description": "This type describes a volume provided by an Azure Files file share.",
+      "properties": {
+        "accountName": {
+          "description": "Name of the Azure storage account for the File Share.",
+          "type": "string"
+        },
+        "accountKey": {
+          "description": "Access key of the Azure storage account for the File Share.",
+          "type": "string"
+        },
+        "shareName": {
+          "description": "Name of the Azure Files file share that provides storage for the volume.",
+          "type": "string"
+        }
+      },
+      "required": [
+        "accountName",
+        "shareName"
+      ]
+    },
+    "VolumeReference": {
+      "description": "Describes a reference to a volume resource.",
+      "type": "object",
+      "properties": {
+        "name": {
+          "type": "string",
+          "description": "Name of the volume being referenced."
+        },
+        "readOnly": {
+          "type": "boolean",
+          "description": "The flag indicating whether the volume is read only. Default is 'false'."
+        },
+        "destinationPath": {
+          "type": "string",
+          "description": "The path within the container at which the volume should be mounted. Only valid path characters are allowed."
+        }
+      },
+      "required": [
+        "name",
+        "destinationPath"
+      ]
+    },
+    "ApplicationScopedVolume": {
+      "description": "Describes a volume whose lifetime is scoped to the application's lifetime.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/VolumeReference"
+        }
+      ],
+      "properties": {
+        "creationParameters": {
+          "$ref": "#/definitions/ApplicationScopedVolumeCreationParameters",
+          "description": "Describes parameters for creating application-scoped volumes."
+        }
+      },
+      "required": [
+        "creationParameters"
+      ]
+    },
+    "ApplicationScopedVolumeCreationParameters": {
+      "description": "Describes parameters for creating application-scoped volumes.",
+      "type": "object",
+      "discriminator": "kind",
+      "properties": {
+        "kind": {
+          "$ref": "#/definitions/ApplicationScopedVolumeKind",
+          "description": "Specifies the application-scoped volume kind."
+        },
+        "description": {
+          "description": "User readable description of the volume.",
+          "type": "string"
+        }
+      },
+      "required": [
+        "kind"
+      ]
+    },
+    "ApplicationScopedVolumeCreationParametersServiceFabricVolumeDisk": {
+      "description": "Describes parameters for creating application-scoped volumes provided by Service Fabric Volume Disks",
+      "allOf": [
+        {
+          "$ref": "#/definitions/ApplicationScopedVolumeCreationParameters"
+        }
+      ],
+      "properties": {
+        "sizeDisk": {
+          "description": "Volume size",
+          "type": "string",
+          "enum": [
+            "Small",
+            "Medium",
+            "Large"
+          ],
+          "x-ms-enum": {
+            "name": "SizeTypes",
+            "modelAsString": true
+          }
+        }
+      },
+      "required": [
+        "sizeDisk"
+      ],
+      "x-ms-discriminator-value": "ServiceFabricVolumeDisk"
+    },
+    "ApplicationScopedVolumeKind": {
+      "description": "Specifies the application-scoped volume kind.",
+      "type": "string",
+      "enum": [
+        "ServiceFabricVolumeDisk"
+      ],
+      "x-ms-enum": {
+        "name": "ApplicationScopedVolumeKind",
+        "modelAsString": true,
+        "values": [
+          {
+            "value": "ServiceFabricVolumeDisk",
+            "description": "Provides Service Fabric High Availability Volume Disk"
+          }
+        ]
+      }
+    },
+    "VolumeResourceName": {
+      "type": "string",
+      "description": "Name of the Volume resource."
+    },
+    "VolumeResourceDescription": {
+      "description": "This type describes a volume resource.",
+      "properties": {
+        "name": {
+          "$ref": "#/definitions/VolumeResourceName",
+          "description": "Name of the Volume resource."
+        },
+        "properties": {
+          "x-ms-client-flatten": true,
+          "$ref": "#/definitions/VolumeProperties",
+          "description": "Describes properties of a volume resource."
+        }
+      },
+      "required": [
+        "name",
+        "properties"
+      ]
+    },
+    "PagedVolumeResourceDescriptionList": {
+      "type": "object",
+      "description": "The list of volume resources. The list is paged when all of the results cannot fit in a single message. The next set of results can be obtained by executing the same query with the continuation token provided in this list.",
+      "properties": {
+        "ContinuationToken": {
+          "$ref": "#/definitions/ContinuationToken",
+          "description": "The continuation token parameter is used to obtain next set of results. The continuation token is included in the response of the API when the results from the system do not fit in a single response. When this value is passed to the next API call, the API returns next set of results. If there are no further results, then the continuation token is not included in the response."
+        },
+        "Items": {
+          "type": "array",
+          "description": "One page of the list.",
+          "items": {
+            "$ref": "#/definitions/VolumeResourceDescription"
+          }
+        }
+      }
+    },
+    "NetworkAddressPrefix": {
+      "type": "string",
+      "description": "Address space for a container network. This is expressed in CIDR notation."
+    },
+    "NetworkRef": {
+      "description": "Describes a network reference in a service.",
+      "properties": {
+        "name": {
+          "type": "string",
+          "description": "Name of the network"
+        },
+        "endpointRefs": {
+          "description": "A list of endpoints that are exposed on this network.",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/EndpointRef"
+          }
+        }
+      }
+    },
+    "EndpointRef": {
+      "description": "Describes a reference to a service endpoint.",
+      "properties": {
+        "name": {
+          "type": "string",
+          "description": "Name of the endpoint."
+        }
+      }
+    },
+    "NetworkKind": {
+      "type": "string",
+      "description": "The type of a Service Fabric container network.",
+      "enum": [
+        "Local"
+      ],
+      "x-ms-enum": {
+        "name": "NetworkKind",
+        "modelAsString": true,
+        "values": [
+          {
+            "value": "Local",
+            "description": "Indicates a container network local to a single Service Fabric cluster. The value is 1."
+          }
+        ]
+      }
+    },
+    "NetworkResourceProperties": {
+      "description": "Describes properties of a network resource.",
+      "type": "object",
+      "allOf": [
+        {
+          "$ref": "#/definitions/NetworkResourcePropertiesBase"
+        }
+      ],
+      "properties": {
+        "description": {
+          "type": "string",
+          "description": "User readable description of the network."
+        },
+        "status": {
+          "readOnly": true,
+          "$ref": "#/definitions/ResourceStatus",
+          "description": "Status of the network."
+        },
+        "statusDetails": {
+          "readOnly": true,
+          "type": "string",
+          "description": "Gives additional information about the current status of the network."
+        }
+      }
+    },
+    "LocalNetworkResourceProperties": {
+      "description": "Information about a Service Fabric container network local to a single Service Fabric cluster.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/NetworkResourceProperties"
+        }
+      ],
+      "x-ms-discriminator-value": "Local",
+      "properties": {
+        "networkAddressPrefix": {
+          "$ref": "#/definitions/NetworkAddressPrefix",
+          "description": "Address space for the local container network."
+        }
+      }
+    },
+    "NetworkResourceName": {
+      "type": "string",
+      "description": "Name of the Network resource."
+    },
+    "NetworkResourceDescription": {
+      "description": "This type describes a network resource.",
+      "properties": {
+        "name": {
+          "$ref": "#/definitions/NetworkResourceName",
+          "description": "Name of the Network resource."
+        },
+        "properties": {
+          "$ref": "#/definitions/NetworkResourceProperties",
+          "description": "Describes properties of a network resource."
+        }
+      },
+      "required": [
+        "name",
+        "properties"
+      ]
+    },
+    "NetworkResourcePropertiesBase": {
+      "discriminator": "kind",
+      "description": "This type describes the properties of a network resource, including its kind.",
+      "type": "object",
+      "properties": {
+        "kind": {
+          "$ref": "#/definitions/NetworkKind",
+          "description": "The type of a Service Fabric container network."
+        }
+      },
+      "required": [
+        "kind"
+      ]
+    },
+    "PagedNetworkResourceDescriptionList": {
+      "type": "object",
+      "description": "The list of network resources. The list is paged when all of the results cannot fit in a single message. The next set of results can be obtained by executing the same query with the continuation token provided in this list.",
+      "properties": {
+        "ContinuationToken": {
+          "$ref": "#/definitions/ContinuationToken",
+          "description": "The continuation token parameter is used to obtain next set of results. The continuation token is included in the response of the API when the results from the system do not fit in a single response. When this value is passed to the next API call, the API returns next set of results. If there are no further results, then the continuation token is not included in the response."
+        },
+        "Items": {
+          "type": "array",
+          "description": "One page of the list.",
+          "items": {
+            "$ref": "#/definitions/NetworkResourceDescription"
+          }
+        }
+      }
+    },
+    "GatewayDestination": {
+      "description": "Describes destination endpoint for routing traffic.",
+      "type": "object",
+      "properties": {
+        "applicationName": {
+          "type": "string",
+          "description": "Name of the service fabric Mesh application."
+        },
+        "serviceName": {
+          "type": "string",
+          "description": "service that contains the endpoint."
+        },
+        "endpointName": {
+          "type": "string",
+          "description": "name of the endpoint in the service."
+        }
+      },
+      "required": [
+        "applicationName",
+        "endpointName",
+        "serviceName"
+      ]
+    },
+    "GatewayProperties": {
+      "description": "Describes properties of a gateway resource.",
+      "properties": {
+        "description": {
+          "description": "User readable description of the gateway.",
+          "type": "string"
+        },
+        "sourceNetwork": {
+          "$ref": "#/definitions/NetworkRef",
+          "description": "Network the gateway should listen on for requests."
+        },
+        "destinationNetwork": {
+          "$ref": "#/definitions/NetworkRef",
+          "description": "Network that the Application is using."
+        },
+        "tcp": {
+          "description": "Configuration for tcp connectivity for this gateway.",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/TcpConfig"
+          }
+        },
+        "http": {
+          "description": "Configuration for http connectivity for this gateway.",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/HttpConfig"
+          }
+        },
+        "status": {
+          "readOnly": true,
+          "$ref": "#/definitions/ResourceStatus",
+          "description": "Status of the resource."
+        },
+        "statusDetails": {
+          "readOnly": true,
+          "type": "string",
+          "description": "Gives additional information about the current status of the gateway."
+        },
+        "ipAddress": {
+          "readOnly": true,
+          "type": "string",
+          "description": "IP address of the gateway. This is populated in the response and is ignored for incoming requests."
+        }
+      },
+      "required": [
+        "destinationNetwork",
+        "sourceNetwork"
+      ]
+    },
+    "HttpConfig": {
+      "description": "Describes the http configuration for external connectivity for this network.",
+      "type": "object",
+      "properties": {
+        "name": {
+          "type": "string",
+          "description": "http gateway config name."
+        },
+        "port": {
+          "type": "integer",
+          "description": "Specifies the port at which the service endpoint below needs to be exposed."
+        },
+        "hosts": {
+          "type": "array",
+          "description": "description for routing.",
+          "items": {
+            "$ref": "#/definitions/HttpHostConfig"
+          }
+        }
+      },
+      "required": [
+        "hosts",
+        "name",
+        "port"
+      ]
+    },
+    "HttpHostConfig": {
+      "description": "Describes the hostname properties for http routing.",
+      "type": "object",
+      "properties": {
+        "name": {
+          "type": "string",
+          "description": "http hostname config name."
+        },
+        "routes": {
+          "type": "array",
+          "description": "Route information to use for routing. Routes are processed in the order they are specified. Specify routes that are more specific before routes that can handle general cases.",
+          "items": {
+            "$ref": "#/definitions/HttpRouteConfig"
+          }
+        }
+      },
+      "required": [
+        "name",
+        "routes"
+      ]
+    },
+    "HttpRouteConfig": {
+      "description": "Describes the hostname properties for http routing.",
+      "type": "object",
+      "properties": {
+        "name": {
+          "type": "string",
+          "description": "http route name."
+        },
+        "match": {
+          "$ref": "#/definitions/HttpRouteMatchRule",
+          "description": "Describes a rule for http route matching."
+        },
+        "destination": {
+          "$ref": "#/definitions/GatewayDestination",
+          "description": "Describes destination endpoint for routing traffic."
+        }
+      },
+      "required": [
+        "destination",
+        "match",
+        "name"
+      ]
+    },
+    "HttpRouteMatchHeader": {
+      "description": "Describes header information for http route matching.",
+      "type": "object",
+      "properties": {
+        "name": {
+          "type": "string",
+          "description": "Name of header to match in request."
+        },
+        "value": {
+          "type": "string",
+          "description": "Value of header to match in request."
+        },
+        "type": {
+          "type": "string",
+          "description": "how to match header value",
+          "enum": [
+            "exact"
+          ],
+          "x-ms-enum": {
+            "name": "HeaderMatchType",
+            "modelAsString": true
+          }
+        }
+      },
+      "required": [
+        "name"
+      ]
+    },
+    "HttpRouteMatchPath": {
+      "description": "Path to match for routing.",
+      "type": "object",
+      "properties": {
+        "value": {
+          "type": "string",
+          "description": "Uri path to match for request."
+        },
+        "rewrite": {
+          "type": "string",
+          "description": "replacement string for matched part of the Uri."
+        },
+        "type": {
+          "type": "string",
+          "description": "how to match value in the Uri",
+          "enum": [
+            "prefix"
+          ],
+          "x-ms-enum": {
+            "name": "PathMatchType",
+            "modelAsString": true
+          }
+        }
+      },
+      "required": [
+        "type",
+        "value"
+      ]
+    },
+    "HttpRouteMatchRule": {
+      "description": "Describes a rule for http route matching.",
+      "type": "object",
+      "properties": {
+        "path": {
+          "$ref": "#/definitions/HttpRouteMatchPath",
+          "description": "Path to match for routing."
+        },
+        "headers": {
+          "type": "array",
+          "description": "headers and their values to match in request.",
+          "items": {
+            "$ref": "#/definitions/HttpRouteMatchHeader"
+          }
+        }
+      },
+      "required": [
+        "path"
+      ]
+    },
+    "TcpConfig": {
+      "description": "Describes the tcp configuration for external connectivity for this network.",
+      "type": "object",
+      "properties": {
+        "name": {
+          "type": "string",
+          "description": "tcp gateway config name."
+        },
+        "port": {
+          "type": "integer",
+          "description": "Specifies the port at which the service endpoint below needs to be exposed."
+        },
+        "destination": {
+          "$ref": "#/definitions/GatewayDestination",
+          "description": "Describes destination endpoint for routing traffic."
+        }
+      },
+      "required": [
+        "destination",
+        "name",
+        "port"
+      ]
+    },
+    "GatewayResourceName": {
+      "type": "string",
+      "description": "Name of the Gateway resource."
+    },
+    "GatewayResourceDescription": {
+      "description": "This type describes a gateway resource.",
+      "properties": {
+        "name": {
+          "$ref": "#/definitions/GatewayResourceName",
+          "description": "Name of the Gateway resource."
+        },
+        "properties": {
+          "x-ms-client-flatten": true,
+          "$ref": "#/definitions/GatewayProperties",
+          "description": "Describes properties of a gateway resource."
+        }
+      },
+      "required": [
+        "name",
+        "properties"
+      ]
+    },
+    "PagedGatewayResourceDescriptionList": {
+      "type": "object",
+      "description": "The list of gateway resources. The list is paged when all of the results cannot fit in a single message. The next set of results can be obtained by executing the same query with the continuation token provided in this list.",
+      "properties": {
+        "ContinuationToken": {
+          "$ref": "#/definitions/ContinuationToken",
+          "description": "The continuation token parameter is used to obtain next set of results. The continuation token is included in the response of the API when the results from the system do not fit in a single response. When this value is passed to the next API call, the API returns next set of results. If there are no further results, then the continuation token is not included in the response."
+        },
+        "Items": {
+          "type": "array",
+          "description": "One page of the list.",
+          "items": {
+            "$ref": "#/definitions/GatewayResourceDescription"
+          }
+        }
+      }
+    },
+    "ApplicationProperties": {
+      "description": "Describes properties of a application resource.",
+      "properties": {
+        "description": {
+          "type": "string",
+          "description": "User readable description of the application."
+        },
+        "services": {
+          "type": "array",
+          "description": "Describes the services in the application. This property is used to create or modify services of the application. On get only the name of the service is returned. The service description can be obtained by querying for the service resource.",
+          "items": {
+            "$ref": "#/definitions/ServiceResourceDescription"
+          }
+        },
+        "diagnostics": {
+          "$ref": "#/definitions/DiagnosticsDescription",
+          "description": "Describes the diagnostics definition and usage for an application resource."
+        },
+        "debugParams": {
+          "description": "Internal - used by Visual Studio to setup the debugging session on the local development environment.",
+          "type": "string"
+        },
+        "serviceNames": {
+          "readOnly": true,
+          "description": "Names of the services in the application.",
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "status": {
+          "readOnly": true,
+          "$ref": "#/definitions/ResourceStatus",
+          "description": "Status of the application."
+        },
+        "statusDetails": {
+          "readOnly": true,
+          "type": "string",
+          "description": "Gives additional information about the current status of the application."
+        },
+        "healthState": {
+          "readOnly": true,
+          "$ref": "#/definitions/HealthState",
+          "description": "Describes the health state of an application resource."
+        },
+        "unhealthyEvaluation": {
+          "readOnly": true,
+          "type": "string",
+          "description": "When the application's health state is not 'Ok', this additional details from service fabric Health Manager for the user to know why the application is marked unhealthy."
+        }
+      }
+    },
+    "ApplicationResourceUpgradeProgressInfo": {
+      "description": "This type describes an application resource upgrade.",
+      "properties": {
+        "Name": {
+          "type": "string",
+          "description": "Name of the Application resource."
+        },
+        "TargetApplicationTypeVersion": {
+          "type": "string",
+          "description": "The target application version for the application upgrade."
+        },
+        "StartTimestampUtc": {
+          "type": "string",
+          "description": "The estimated UTC datetime when the upgrade started."
+        },
+        "UpgradeState": {
+          "$ref": "#/definitions/ApplicationResourceUpgradeState",
+          "description": "The state of the application resource upgrade."
+        },
+        "PercentCompleted": {
+          "type": "string",
+          "description": "The estimated percent of replicas are completed in the upgrade."
+        },
+        "ServiceUpgradeProgress": {
+          "$ref": "#/definitions/ServiceUpgradeProgressList",
+          "description": "List of service upgrade progresses."
+        },
+        "RollingUpgradeMode": {
+          "$ref": "#/definitions/RollingUpgradeMode",
+          "description": "The mode used to monitor health during a rolling upgrade. The values are UnmonitoredAuto, UnmonitoredManual, and Monitored."
+        },
+        "UpgradeDuration": {
+          "type": "string",
+          "description": "The estimated amount of time that the overall upgrade elapsed. 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"
+        },
+        "ApplicationUpgradeStatusDetails": {
+          "type": "string",
+          "description": "Additional detailed information about the status of the pending upgrade."
+        },
+        "UpgradeReplicaSetCheckTimeoutInSeconds": {
+          "type": "integer",
+          "format": "int64",
+          "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).",
+          "default": 42949672925
+        },
+        "FailureTimestampUtc": {
+          "type": "string",
+          "description": "The estimated UTC datetime when the upgrade failed and FailureAction was executed."
+        }
+      }
+    },
+    "ApplicationResourceUpgradeState": {
+      "type": "string",
+      "description": "The state of the application resource upgrade.",
+      "enum": [
+        "Invalid",
+        "ProvisioningTarget",
+        "RollingForward",
+        "UnprovisioningCurrent",
+        "CompletedRollforward",
+        "RollingBack",
+        "UnprovisioningTarget",
+        "CompletedRollback",
+        "Failed"
+      ],
+      "x-ms-enum": {
+        "name": "ApplicationResourceUpgradeState",
+        "modelAsString": true,
+        "values": [
+          {
+            "value": "Invalid",
+            "description": "Indicates the upgrade state is invalid. All Service Fabric enumerations have the invalid type. The value is 0."
+          },
+          {
+            "value": "ProvisioningTarget",
+            "description": "The upgrade is in the progress of provisioning target application type version. The value is 1."
+          },
+          {
+            "value": "RollingForward",
+            "description": "The upgrade is rolling forward to the target version but is not complete yet. The value is 2."
+          },
+          {
+            "value": "UnprovisioningCurrent",
+            "description": "The upgrade is in the progress of unprovisioning current application type version and rolling forward to the target version is completed. The value is 3."
+          },
+          {
+            "value": "CompletedRollforward",
+            "description": "The upgrade has finished rolling forward. The value is 4."
+          },
+          {
+            "value": "RollingBack",
+            "description": "The upgrade is rolling back to the previous version but is not complete yet. The value is 5."
+          },
+          {
+            "value": "UnprovisioningTarget",
+            "description": "The upgrade is in the progress of unprovisioning target application type version and rolling back to the current version is completed. The value is 6."
+          },
+          {
+            "value": "CompletedRollback",
+            "description": "The upgrade has finished rolling back. The value is 7."
+          },
+          {
+            "value": "Failed",
+            "description": "The upgrade has failed and is unable to execute FailureAction. The value is 8."
+          }
+        ]
+      }
+    },
+    "AzureInternalMonitoringPipelineSinkDescription": {
+      "allOf": [
+        {
+          "$ref": "#/definitions/DiagnosticsSinkProperties"
+        }
+      ],
+      "x-ms-discriminator-value": "AzureInternalMonitoringPipeline",
+      "description": "Diagnostics settings for Geneva.",
+      "properties": {
+        "accountName": {
+          "description": "Azure Internal monitoring pipeline account.",
+          "type": "string"
+        },
+        "namespace": {
+          "description": "Azure Internal monitoring pipeline account namespace.",
+          "type": "string"
+        },
+        "maConfigUrl": {
+          "description": "Azure Internal monitoring agent configuration.",
+          "type": "string"
+        },
+        "fluentdConfigUrl": {
+          "description": "Azure Internal monitoring agent fluentd configuration.",
+          "type": "string"
+        },
+        "autoKeyConfigUrl": {
+          "description": "Azure Internal monitoring pipeline autokey associated with the certificate.",
+          "type": "string"
+        }
+      }
+    },
+    "DiagnosticsDescription": {
+      "description": "Describes the diagnostics options available",
+      "properties": {
+        "sinks": {
+          "description": "List of supported sinks that can be referenced.",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/DiagnosticsSinkProperties"
+          }
+        },
+        "enabled": {
+          "description": "Status of whether or not sinks are enabled.",
+          "type": "boolean"
+        },
+        "defaultSinkRefs": {
+          "description": "The sinks to be used if diagnostics is enabled. Sink choices can be overridden at the service and code package level.",
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        }
+      }
+    },
+    "DiagnosticsRef": {
+      "description": "Reference to sinks in DiagnosticsDescription.",
+      "properties": {
+        "enabled": {
+          "description": "Status of whether or not sinks are enabled.",
+          "type": "boolean"
+        },
+        "sinkRefs": {
+          "description": "List of sinks to be used if enabled. References the list of sinks in DiagnosticsDescription.",
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        }
+      }
+    },
+    "DiagnosticsSinkKind": {
+      "type": "string",
+      "description": "The kind of DiagnosticsSink.",
+      "enum": [
+        "Invalid",
+        "AzureInternalMonitoringPipeline"
+      ],
+      "x-ms-enum": {
+        "name": "DiagnosticsSinkKind",
+        "modelAsString": true,
+        "values": [
+          {
+            "value": "Invalid",
+            "description": "Indicates an invalid sink kind. All Service Fabric enumerations have the invalid type."
+          },
+          {
+            "value": "AzureInternalMonitoringPipeline",
+            "description": "Diagnostics settings for Geneva."
+          }
+        ]
+      }
+    },
+    "DiagnosticsSinkProperties": {
+      "description": "Properties of a DiagnosticsSink.",
+      "discriminator": "kind",
+      "properties": {
+        "kind": {
+          "$ref": "#/definitions/DiagnosticsSinkKind",
+          "description": "The kind of DiagnosticsSink."
+        },
+        "name": {
+          "description": "Name of the sink. This value is referenced by DiagnosticsReferenceDescription",
+          "type": "string"
+        },
+        "description": {
+          "description": "A description of the sink.",
+          "type": "string"
+        }
+      },
+      "required": [
+        "kind"
+      ]
+    },
+    "IdentityDescription": {
+      "description": "Information describing the identities associated with this application.",
+      "properties": {
+        "tokenServiceEndpoint": {
+          "type": "string",
+          "description": "the endpoint for the token service managing this identity"
+        },
+        "type": {
+          "type": "string",
+          "description": "the types of identities associated with this resource; currently restricted to 'SystemAssigned and UserAssigned'"
+        },
+        "tenantId": {
+          "type": "string",
+          "description": "the identifier of the tenant containing the application's identity."
+        },
+        "principalId": {
+          "type": "string",
+          "description": "the object identifier of the Service Principal of the identity associated with this resource."
+        },
+        "userAssignedIdentities": {
+          "$ref": "#/definitions/UserAssignedIdentityMap",
+          "description": "represents user assigned identities map."
+        }
+      },
+      "required": [
+        "type"
+      ]
+    },
+    "IdentityItemDescription": {
+      "description": "Describes a single user-assigned identity associated with the application.",
+      "type": "object",
+      "properties": {
+        "principalId": {
+          "type": "string",
+          "description": "the object identifier of the Service Principal which this identity represents."
+        },
+        "clientId": {
+          "type": "string",
+          "description": "the client identifier of the Service Principal which this identity represents."
+        }
+      }
+    },
+    "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"
+          }
+        ]
+      }
+    },
+    "ServiceUpgradeProgressList": {
+      "type": "array",
+      "description": "List of service upgrade progresses.",
+      "items": {
+        "$ref": "#/definitions/ServiceUpgradeProgress"
+      }
+    },
+    "ServiceUpgradeProgress": {
+      "description": "Information about how many replicas are completed or pending for a specific service during upgrade.",
+      "properties": {
+        "ServiceName": {
+          "type": "string",
+          "description": "Name of the Service resource."
+        },
+        "CompletedReplicaCount": {
+          "type": "string",
+          "description": "The number of replicas that completes the upgrade in the service."
+        },
+        "PendingReplicaCount": {
+          "type": "string",
+          "description": "The number of replicas that are waiting to be upgraded in the service."
+        }
+      }
+    },
+    "UserAssignedIdentityMap": {
+      "type": "object",
+      "description": "Defines a map that contains user assigned identities.",
+      "additionalProperties": {
+        "$ref": "#/definitions/IdentityItemDescription"
+      }
+    },
+    "AddRemoveReplicaScalingMechanism": {
+      "description": "Describes the horizontal auto scaling mechanism that adds or removes replicas (containers or container groups).",
+      "allOf": [
+        {
+          "$ref": "#/definitions/AutoScalingMechanism"
+        },
+        {
+          "type": "object"
+        }
+      ],
+      "x-ms-discriminator-value": "AddRemoveReplica",
+      "properties": {
+        "minCount": {
+          "type": "integer",
+          "description": "Minimum number of containers (scale down won't be performed below this number)."
+        },
+        "maxCount": {
+          "type": "integer",
+          "description": "Maximum number of containers (scale up won't be performed above this number)."
+        },
+        "scaleIncrement": {
+          "type": "integer",
+          "description": "Each time auto scaling is performed, this number of containers will be added or removed."
+        }
+      },
+      "required": [
+        "minCount",
+        "maxCount",
+        "scaleIncrement"
+      ]
+    },
+    "AutoScalingMechanism": {
+      "type": "object",
+      "discriminator": "kind",
+      "description": "Describes the mechanism for performing auto scaling operation. Derived classes will describe the actual mechanism.",
+      "properties": {
+        "kind": {
+          "$ref": "#/definitions/AutoScalingMechanismKind",
+          "description": "The type of auto scaling mechanism."
+        }
+      },
+      "required": [
+        "kind"
+      ]
+    },
+    "AutoScalingMechanismKind": {
+      "type": "string",
+      "description": "Enumerates the mechanisms for auto scaling.",
+      "enum": [
+        "AddRemoveReplica"
+      ],
+      "x-ms-enum": {
+        "name": "AutoScalingMechanismKind",
+        "modelAsString": true,
+        "values": [
+          {
+            "value": "AddRemoveReplica",
+            "description": "Indicates that scaling should be performed by adding or removing replicas."
+          }
+        ]
+      }
+    },
+    "AutoScalingMetric": {
+      "type": "object",
+      "discriminator": "kind",
+      "description": "Describes the metric that is used for triggering auto scaling operation. Derived classes will describe resources or metrics.",
+      "properties": {
+        "kind": {
+          "$ref": "#/definitions/AutoScalingMetricKind",
+          "description": "The type of auto scaling metric"
+        }
+      },
+      "required": [
+        "kind"
+      ]
+    },
+    "AutoScalingMetricKind": {
+      "type": "string",
+      "description": "Enumerates the metrics that are used for triggering auto scaling.",
+      "enum": [
+        "Resource"
+      ],
+      "x-ms-enum": {
+        "name": "AutoScalingMetricKind",
+        "modelAsString": true,
+        "values": [
+          {
+            "value": "Resource",
+            "description": "Indicates that the metric is one of resources, like cpu or memory."
+          }
+        ]
+      }
+    },
+    "AutoScalingPolicy": {
+      "description": "Describes the auto scaling policy",
+      "type": "object",
+      "properties": {
+        "name": {
+          "description": "The name of the auto scaling policy.",
+          "type": "string"
+        },
+        "trigger": {
+          "$ref": "#/definitions/AutoScalingTrigger",
+          "description": "Determines when auto scaling operation will be invoked."
+        },
+        "mechanism": {
+          "$ref": "#/definitions/AutoScalingMechanism",
+          "description": "The mechanism that is used to scale when auto scaling operation is invoked."
+        }
+      },
+      "required": [
+        "name",
+        "trigger",
+        "mechanism"
+      ]
+    },
+    "AutoScalingResourceMetric": {
+      "description": "Describes the resource that is used for triggering auto scaling.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/AutoScalingMetric"
+        },
+        {
+          "type": "object"
+        }
+      ],
+      "x-ms-discriminator-value": "Resource",
+      "properties": {
+        "name": {
+          "$ref": "#/definitions/AutoScalingResourceMetricName",
+          "description": "Name of the resource."
+        }
+      },
+      "required": [
+        "name"
+      ]
+    },
+    "AutoScalingResourceMetricName": {
+      "type": "string",
+      "description": "Enumerates the resources that are used for triggering auto scaling.",
+      "enum": [
+        "cpu",
+        "memoryInGB"
+      ],
+      "x-ms-enum": {
+        "name": "AutoScalingResourceMetricName",
+        "modelAsString": true,
+        "values": [
+          {
+            "value": "cpu",
+            "description": "Indicates that the resource is CPU cores."
+          },
+          {
+            "value": "memoryInGB",
+            "description": "Indicates that the resource is memory in GB."
+          }
+        ]
+      }
+    },
+    "AutoScalingTrigger": {
+      "type": "object",
+      "discriminator": "kind",
+      "description": "Describes the trigger for performing auto scaling operation.",
+      "properties": {
+        "kind": {
+          "$ref": "#/definitions/AutoScalingTriggerKind",
+          "description": "The type of auto scaling trigger"
+        }
+      },
+      "required": [
+        "kind"
+      ]
+    },
+    "AutoScalingTriggerKind": {
+      "type": "string",
+      "description": "Enumerates the triggers for auto scaling.",
+      "enum": [
+        "AverageLoad"
+      ],
+      "x-ms-enum": {
+        "name": "AutoScalingTriggerKind",
+        "modelAsString": true,
+        "values": [
+          {
+            "value": "AverageLoad",
+            "description": "Indicates that scaling should be performed based on average load of all replicas in the service."
+          }
+        ]
+      }
+    },
+    "ContainerCodePackageProperties": {
+      "description": "Describes a container and its runtime properties.",
+      "properties": {
+        "name": {
+          "description": "The name of the code package.",
+          "type": "string"
+        },
+        "image": {
+          "description": "The Container image to use.",
+          "type": "string"
+        },
+        "imageRegistryCredential": {
+          "$ref": "#/definitions/ImageRegistryCredential",
+          "description": "Image registry credential."
+        },
+        "entryPoint": {
+          "description": "Override for the default entry point in the container.",
+          "type": "string"
+        },
+        "commands": {
+          "description": "Command array to execute within the container in exec form.",
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "environmentVariables": {
+          "description": "The environment variables to set in this container",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/EnvironmentVariable"
+          }
+        },
+        "settings": {
+          "description": "The settings to set in this container. The setting file path can be fetched from environment variable \"Fabric_SettingPath\". The path for Windows container is \"C:\\\\secrets\". The path for Linux container is \"/var/secrets\".",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/Setting"
+          }
+        },
+        "labels": {
+          "description": "The labels to set in this container.",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/ContainerLabel"
+          }
+        },
+        "endpoints": {
+          "description": "The endpoints exposed by this container.",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/EndpointProperties"
+          }
+        },
+        "resources": {
+          "description": "The resources required by this container.",
+          "$ref": "#/definitions/ResourceRequirements"
+        },
+        "volumeRefs": {
+          "description": "Volumes to be attached to the container. The lifetime of these volumes is independent of the application's lifetime.",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/VolumeReference"
+          }
+        },
+        "volumes": {
+          "description": "Volumes to be attached to the container. The lifetime of these volumes is scoped to the application's lifetime.",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/ApplicationScopedVolume"
+          }
+        },
+        "diagnostics": {
+          "$ref": "#/definitions/DiagnosticsRef",
+          "description": "Reference to sinks in DiagnosticsDescription."
+        },
+        "reliableCollectionsRefs": {
+          "description": "A list of ReliableCollection resources used by this particular code package. Please refer to ReliableCollectionsRef for more details.",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/ReliableCollectionsRef"
+          }
+        },
+        "instanceView": {
+          "readOnly": true,
+          "$ref": "#/definitions/ContainerInstanceView",
+          "description": "Runtime information of a container instance."
+        },
+        "livenessProbe": {
+          "description": "An array of liveness probes for a code package. It determines when to restart a code package.",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/Probe"
+          }
+        },
+        "readinessProbe": {
+          "description": "An array of readiness probes for a code package. It determines when to unpublish an endpoint.",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/Probe"
+          }
+        }
+      },
+      "required": [
+        "name",
+        "image",
+        "resources"
+      ]
+    },
+    "ContainerEvent": {
+      "description": "A container event.",
+      "properties": {
+        "name": {
+          "type": "string",
+          "description": "The name of the container event."
+        },
+        "count": {
+          "type": "integer",
+          "description": "The count of the event."
+        },
+        "firstTimestamp": {
+          "type": "string",
+          "description": "Date/time of the first event."
+        },
+        "lastTimestamp": {
+          "type": "string",
+          "description": "Date/time of the last event."
+        },
+        "message": {
+          "type": "string",
+          "description": "The event message"
+        },
+        "type": {
+          "type": "string",
+          "description": "The event type."
+        }
+      }
+    },
+    "ContainerInstanceView": {
+      "description": "Runtime information of a container instance.",
+      "properties": {
+        "restartCount": {
+          "type": "integer",
+          "description": "The number of times the container has been restarted."
+        },
+        "currentState": {
+          "$ref": "#/definitions/ContainerState",
+          "description": "Current container instance state."
+        },
+        "previousState": {
+          "$ref": "#/definitions/ContainerState",
+          "description": "Previous container instance state."
+        },
+        "events": {
+          "description": "The events of this container instance.",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/ContainerEvent"
+          }
+        }
+      }
+    },
+    "ContainerLabel": {
+      "description": "Describes a container label.",
+      "properties": {
+        "name": {
+          "description": "The name of the container label.",
+          "type": "string"
+        },
+        "value": {
+          "description": "The value of the container label.",
+          "type": "string"
+        }
+      },
+      "required": [
+        "name",
+        "value"
+      ]
+    },
+    "ContainerState": {
+      "description": "The container state.",
+      "properties": {
+        "state": {
+          "type": "string",
+          "description": "The state of this container"
+        },
+        "startTime": {
+          "type": "string",
+          "format": "date-time",
+          "description": "Date/time when the container state started."
+        },
+        "exitCode": {
+          "type": "string",
+          "description": "The container exit code."
+        },
+        "finishTime": {
+          "type": "string",
+          "format": "date-time",
+          "description": "Date/time when the container state finished."
+        },
+        "detailStatus": {
+          "description": "Human-readable status of this state.",
+          "type": "string"
+        }
+      }
+    },
+    "DefaultExecutionPolicy": {
+      "description": "The default execution policy. Always restart the service if an exit occurs.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/ExecutionPolicy"
+        },
+        {
+          "type": "object"
+        }
+      ],
+      "x-ms-discriminator-value": "Default"
+    },
+    "EndpointProperties": {
+      "description": "Describes a container endpoint.",
+      "properties": {
+        "name": {
+          "description": "The name of the endpoint.",
+          "type": "string"
+        },
+        "port": {
+          "description": "Port used by the container.",
+          "type": "integer"
+        }
+      },
+      "required": [
+        "name"
+      ]
+    },
+    "EnvironmentVariable": {
+      "description": "Describes an environment variable for the container.",
+      "properties": {
+        "type": {
+          "$ref": "#/definitions/EnvironmentVariableType",
+          "description": "The type of the environment variable being given in value"
+        },
+        "name": {
+          "description": "The name of the environment variable.",
+          "type": "string"
+        },
+        "value": {
+          "description": "The value of the environment variable, will be processed based on the type provided.",
+          "type": "string"
+        }
+      }
+    },
+    "EnvironmentVariableType": {
+      "type": "string",
+      "description": "The type of the environment variable being given in value",
+      "default": "ClearText",
+      "enum": [
+        "ClearText",
+        "KeyVaultReference",
+        "SecretValueReference"
+      ],
+      "x-ms-enum": {
+        "name": "EnvironmentVariableType",
+        "modelAsString": true,
+        "values": [
+          {
+            "value": "ClearText",
+            "description": "The environment variable in clear text, will not be processed in any way and passed in as is"
+          },
+          {
+            "value": "KeyVaultReference",
+            "description": "The URI to a KeyVault secret version, will be resolved using the application's managed identity (this type is only valid if the app was assigned a managed identity) before getting passed in"
+          },
+          {
+            "value": "SecretValueReference",
+            "description": "The reference to a SecretValue resource, will be resolved before getting passed in"
+          }
+        ]
+      }
+    },
+    "ExecutionPolicy": {
+      "type": "object",
+      "discriminator": "type",
+      "description": "The execution policy of the service",
+      "properties": {
+        "type": {
+          "$ref": "#/definitions/ExecutionPolicyType",
+          "description": "Enumerates the execution policy types for services."
+        }
+      },
+      "required": [
+        "type"
+      ]
+    },
+    "ExecutionPolicyType": {
+      "type": "string",
+      "description": "Enumerates the execution policy types for services.",
+      "enum": [
+        "Default",
+        "RunToCompletion"
+      ],
+      "x-ms-enum": {
+        "name": "ExecutionPolicyType",
+        "modelAsString": true,
+        "values": [
+          {
+            "value": "Default",
+            "description": "Indicates the default execution policy, always restart the service if an exit occurs."
+          },
+          {
+            "value": "RunToCompletion",
+            "description": "Indicates that the service will perform its desired operation and complete successfully. If the service encounters failure, it will restarted based on restart policy specified. If the service completes its operation successfully, it will not be restarted again."
+          }
+        ]
+      }
+    },
+    "ImageRegistryCredential": {
+      "description": "Image registry credential.",
+      "properties": {
+        "server": {
+          "type": "string",
+          "description": "Docker image registry server, without protocol such as `http` and `https`."
+        },
+        "username": {
+          "type": "string",
+          "description": "The username for the private registry."
+        },
+        "passwordType": {
+          "$ref": "#/definitions/ImageRegistryPasswordType",
+          "description": "The type of the image registry password being given in password"
+        },
+        "password": {
+          "type": "string",
+          "description": "The password for the private registry. The password is required for create or update operations, however it is not returned in the get or list operations. Will be processed based on the type provided."
+        }
+      },
+      "required": [
+        "server",
+        "username"
+      ]
+    },
+    "ImageRegistryPasswordType": {
+      "type": "string",
+      "description": "The type of the image registry password being given in password",
+      "default": "ClearText",
+      "enum": [
+        "ClearText",
+        "KeyVaultReference",
+        "SecretValueReference"
+      ],
+      "x-ms-enum": {
+        "name": "ImageRegistryPasswordType",
+        "modelAsString": true,
+        "values": [
+          {
+            "value": "ClearText",
+            "description": "The image registry password in clear text, will not be processed in any way and used directly"
+          },
+          {
+            "value": "KeyVaultReference",
+            "description": "The URI to a KeyVault secret version, will be resolved using the application's managed identity (this type is only valid if the app was assigned a managed identity) before getting used"
+          },
+          {
+            "value": "SecretValueReference",
+            "description": "The reference to a SecretValue resource, will be resolved before getting used"
+          }
+        ]
+      }
+    },
+    "OperatingSystemType": {
+      "type": "string",
+      "description": "The operation system required by the code in service.",
+      "enum": [
+        "Linux",
+        "Windows"
+      ],
+      "x-ms-enum": {
+        "name": "OperatingSystemType",
+        "modelAsString": true,
+        "values": [
+          {
+            "value": "Linux",
+            "description": "The required operating system is Linux."
+          },
+          {
+            "value": "Windows",
+            "description": "The required operating system is Windows."
+          }
+        ]
+      }
+    },
+    "Probe": {
+      "description": "Probes have a number of fields that you can use to control their behavior.",
+      "properties": {
+        "initialDelaySeconds": {
+          "type": "integer",
+          "description": "The initial delay in seconds to start executing probe once codepackage has started.",
+          "default": 0
+        },
+        "periodSeconds": {
+          "type": "integer",
+          "description": "Periodic seconds to execute probe.",
+          "default": 10
+        },
+        "timeoutSeconds": {
+          "type": "integer",
+          "description": "Period after which probe is considered as failed if it hasn't completed successfully.",
+          "default": 1
+        },
+        "successThreshold": {
+          "type": "integer",
+          "description": "The count of successful probe executions after which probe is considered success.",
+          "default": 1
+        },
+        "failureThreshold": {
+          "type": "integer",
+          "description": "The count of failures after which probe is considered failed.",
+          "default": 3
+        },
+        "exec": {
+          "$ref": "#/definitions/ProbeExec",
+          "description": "Exec command to run inside the container."
+        },
+        "httpGet": {
+          "$ref": "#/definitions/ProbeHttpGet",
+          "description": "Http probe for the container."
+        },
+        "tcpSocket": {
+          "$ref": "#/definitions/ProbeTcpSocket",
+          "description": "Tcp port to probe inside the container."
+        }
+      }
+    },
+    "ProbeExec": {
+      "description": "Exec command to run inside the container.",
+      "properties": {
+        "command": {
+          "description": "Comma separated command to run inside the container for example \"sh, -c, echo hello world\".",
+          "type": "string"
+        }
+      },
+      "required": [
+        "command"
+      ]
+    },
+    "ProbeHttpGet": {
+      "description": "Http probe for the container.",
+      "properties": {
+        "port": {
+          "description": "Port to access for probe.",
+          "type": "integer"
+        },
+        "path": {
+          "description": "Path to access on the HTTP request.",
+          "type": "string"
+        },
+        "host": {
+          "description": "Host IP to connect to.",
+          "type": "string"
+        },
+        "httpHeaders": {
+          "description": "Headers to set in the request.",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/ProbeHttpGetHeaders"
+          }
+        },
+        "scheme": {
+          "type": "string",
+          "description": "Scheme for the http probe. Can be Http or Https.",
+          "enum": [
+            "http",
+            "https"
+          ],
+          "x-ms-enum": {
+            "name": "scheme",
+            "modelAsString": true,
+            "values": [
+              {
+                "value": "http",
+                "description": "Indicates that the probe is http."
+              },
+              {
+                "value": "https",
+                "description": "Indicates that the probe is https. No cert validation."
+              }
+            ]
+          }
+        }
+      },
+      "required": [
+        "port"
+      ]
+    },
+    "ProbeHttpGetHeaders": {
+      "description": "Http headers.",
+      "properties": {
+        "name": {
+          "description": "The name of the header.",
+          "type": "string"
+        },
+        "value": {
+          "description": "The value of the header.",
+          "type": "string"
+        }
+      },
+      "required": [
+        "name",
+        "value"
+      ]
+    },
+    "ProbeTcpSocket": {
+      "description": "Tcp port to probe inside the container.",
+      "properties": {
+        "port": {
+          "description": "Port to access for probe.",
+          "type": "integer"
+        }
+      },
+      "required": [
+        "port"
+      ]
+    },
+    "ReliableCollectionsRef": {
+      "description": "Specifying this parameter adds support for reliable collections",
+      "properties": {
+        "name": {
+          "description": "Name of ReliableCollection resource. Right now it's not used and you can use any string.",
+          "type": "string"
+        },
+        "doNotPersistState": {
+          "description": "False (the default) if ReliableCollections state is persisted to disk as usual. True if you do not want to persist state, in which case replication is still enabled and you can use ReliableCollections as distributed cache.",
+          "type": "boolean"
+        }
+      },
+      "required": [
+        "name"
+      ]
+    },
+    "ResourceLimits": {
+      "description": "This type describes the resource limits for a given container. It describes the most amount of resources a container is allowed to use before being restarted.",
+      "properties": {
+        "memoryInGB": {
+          "description": "The memory limit in GB.",
+          "type": "number",
+          "format": "double"
+        },
+        "cpu": {
+          "description": "CPU limits in cores. At present, only full cores are supported.",
+          "type": "number",
+          "format": "double"
+        }
+      }
+    },
+    "ResourceRequests": {
+      "description": "This type describes the requested resources for a given container. It describes the least amount of resources required for the container. A container can consume more than requested resources up to the specified limits before being restarted. Currently, the requested resources are treated as limits.",
+      "properties": {
+        "memoryInGB": {
+          "description": "The memory request in GB for this container.",
+          "type": "number",
+          "format": "double"
+        },
+        "cpu": {
+          "description": "Requested number of CPU cores. At present, only full cores are supported.",
+          "type": "number",
+          "format": "double"
+        }
+      },
+      "required": [
+        "memoryInGB",
+        "cpu"
+      ]
+    },
+    "ResourceRequirements": {
+      "description": "This type describes the resource requirements for a container or a service.",
+      "properties": {
+        "requests": {
+          "$ref": "#/definitions/ResourceRequests",
+          "description": "Describes the requested resources for a given container."
+        },
+        "limits": {
+          "$ref": "#/definitions/ResourceLimits",
+          "description": "Describes the maximum limits on the resources for a given container."
+        }
+      },
+      "required": [
+        "requests"
+      ]
+    },
+    "RestartPolicy": {
+      "type": "string",
+      "description": "Enumerates the restart policy for RunToCompletionExecutionPolicy",
+      "enum": [
+        "OnFailure",
+        "Never"
+      ],
+      "x-ms-enum": {
+        "name": "RestartPolicy",
+        "modelAsString": true,
+        "values": [
+          {
+            "value": "OnFailure",
+            "description": "Service will be restarted when it encounters a failure."
+          },
+          {
+            "value": "Never",
+            "description": "Service will never be restarted. If the service encounters a failure, it will move to Failed state."
+          }
+        ]
+      }
+    },
+    "RunToCompletionExecutionPolicy": {
+      "description": "The run to completion execution policy, the service will perform its desired operation and complete successfully. If the service encounters failure, it will restarted based on restart policy specified. If the service completes its operation successfully, it will not be restarted again.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/ExecutionPolicy"
+        },
+        {
+          "type": "object"
+        }
+      ],
+      "x-ms-discriminator-value": "RunToCompletion",
+      "properties": {
+        "restart": {
+          "$ref": "#/definitions/RestartPolicy",
+          "description": "Enumerates the restart policy for RunToCompletionExecutionPolicy"
+        }
+      },
+      "required": [
+        "restart"
+      ]
+    },
+    "ServiceProperties": {
+      "description": "Describes properties of a service resource.",
+      "properties": {
+        "description": {
+          "type": "string",
+          "description": "User readable description of the service."
+        },
+        "replicaCount": {
+          "type": "integer",
+          "description": "The number of replicas of the service to create. Defaults to 1 if not specified."
+        },
+        "executionPolicy": {
+          "$ref": "#/definitions/ExecutionPolicy",
+          "description": "The execution policy of the service"
+        },
+        "autoScalingPolicies": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/AutoScalingPolicy"
+          },
+          "description": "Auto scaling policies"
+        },
+        "status": {
+          "readOnly": true,
+          "$ref": "#/definitions/ResourceStatus",
+          "description": "Status of the service."
+        },
+        "statusDetails": {
+          "readOnly": true,
+          "type": "string",
+          "description": "Gives additional information about the current status of the service."
+        },
+        "healthState": {
+          "readOnly": true,
+          "$ref": "#/definitions/HealthState",
+          "description": "Describes the health state of an application resource."
+        },
+        "unhealthyEvaluation": {
+          "readOnly": true,
+          "type": "string",
+          "description": "When the service's health state is not 'Ok', this additional details from service fabric Health Manager for the user to know why the service is marked unhealthy."
+        },
+        "identityRefs": {
+          "description": "The service identity list.",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/ServiceIdentity"
+          }
+        },
+        "dnsName": {
+          "type": "string",
+          "description": "Dns name of the service."
+        }
+      }
+    },
+    "ServiceReplicaProperties": {
+      "description": "Describes the properties of a service replica.",
+      "properties": {
+        "osType": {
+          "$ref": "#/definitions/OperatingSystemType",
+          "description": "The operation system required by the code in service."
+        },
+        "codePackages": {
+          "description": "Describes the set of code packages that forms the service. A code package describes the container and the properties for running it. All the code packages are started together on the same host and share the same context (network, process etc.).",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/ContainerCodePackageProperties"
+          }
+        },
+        "networkRefs": {
+          "type": "array",
+          "description": "The names of the private networks that this service needs to be part of.",
+          "items": {
+            "$ref": "#/definitions/NetworkRef"
+          }
+        },
+        "diagnostics": {
+          "$ref": "#/definitions/DiagnosticsRef",
+          "description": "Reference to sinks in DiagnosticsDescription."
+        }
+      },
+      "required": [
+        "osType",
+        "codePackages"
+      ]
+    },
+    "Setting": {
+      "description": "Describes a setting for the container. The setting file path can be fetched from environment variable \"Fabric_SettingPath\". The path for Windows container is \"C:\\\\secrets\". The path for Linux container is \"/var/secrets\".",
+      "properties": {
+        "type": {
+          "$ref": "#/definitions/SettingType",
+          "description": "The type of the setting being given in value"
+        },
+        "name": {
+          "description": "The name of the setting.",
+          "type": "string"
+        },
+        "value": {
+          "description": "The value of the setting, will be processed based on the type provided.",
+          "type": "string"
+        }
+      }
+    },
+    "SettingType": {
+      "type": "string",
+      "description": "The type of the setting being given in value",
+      "default": "ClearText",
+      "enum": [
+        "ClearText",
+        "KeyVaultReference",
+        "SecretValueReference"
+      ],
+      "x-ms-enum": {
+        "name": "SettingType",
+        "modelAsString": true,
+        "values": [
+          {
+            "value": "ClearText",
+            "description": "The setting in clear text, will not be processed in any way and passed in as is"
+          },
+          {
+            "value": "KeyVaultReference",
+            "description": "The URI to a KeyVault secret version, will be resolved using the application's managed identity (this type is only valid if the app was assigned a managed identity) before getting passed in"
+          },
+          {
+            "value": "SecretValueReference",
+            "description": "The reference to a SecretValue resource, will be resolved before getting passed in"
+          }
+        ]
+      }
+    },
+    "ServiceReplicaDescription": {
+      "description": "Describes a replica of a service resource.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/ServiceReplicaProperties"
+        }
+      ],
+      "properties": {
+        "replicaName": {
+          "type": "string",
+          "description": "Name of the replica."
+        }
+      },
+      "required": [
+        "replicaName"
+      ]
+    },
+    "AverageLoadScalingTrigger": {
+      "description": "Describes the average load trigger used for auto scaling.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/AutoScalingTrigger"
+        },
+        {
+          "type": "object"
+        }
+      ],
+      "x-ms-discriminator-value": "AverageLoad",
+      "properties": {
+        "metric": {
+          "$ref": "#/definitions/AutoScalingMetric",
+          "description": "Description of the metric that is used for scaling."
+        },
+        "lowerLoadThreshold": {
+          "type": "number",
+          "format": "double",
+          "description": "Lower load threshold (if average load is below this threshold, service will scale down)."
+        },
+        "upperLoadThreshold": {
+          "type": "number",
+          "format": "double",
+          "description": "Upper load threshold (if average load is above this threshold, service will scale up)."
+        },
+        "scaleIntervalInSeconds": {
+          "type": "integer",
+          "description": "Scale interval that indicates how often will this trigger be checked.",
+          "minimum": 60
+        }
+      },
+      "required": [
+        "metric",
+        "lowerLoadThreshold",
+        "upperLoadThreshold",
+        "scaleIntervalInSeconds"
+      ]
+    },
+    "ServiceIdentity": {
+      "description": "Map service identity friendly name to an application identity.",
+      "properties": {
+        "name": {
+          "description": "The identity friendly name.",
+          "type": "string"
+        },
+        "identityRef": {
+          "description": "The application identity name.",
+          "type": "string"
+        }
+      }
+    },
+    "ServiceResourceName": {
+      "type": "string",
+      "description": "Name of the Service resource."
+    },
+    "ServiceResourceDescription": {
+      "description": "This type describes a service resource.",
+      "properties": {
+        "name": {
+          "$ref": "#/definitions/ServiceResourceName",
+          "description": "Name of the Service resource."
+        },
+        "properties": {
+          "x-ms-client-flatten": true,
+          "$ref": "#/definitions/ServiceResourceProperties",
+          "description": "This type describes properties of a service resource."
+        }
+      },
+      "required": [
+        "name",
+        "properties"
+      ]
+    },
+    "ServiceResourceProperties": {
+      "description": "This type describes properties of a service resource.",
+      "allOf": [
+        {
+          "$ref": "#/definitions/ServiceReplicaProperties"
+        },
+        {
+          "$ref": "#/definitions/ServiceProperties"
+        }
+      ]
+    },
+    "PagedServiceResourceDescriptionList": {
+      "type": "object",
+      "description": "The list of service resources. The list is paged when all of the results cannot fit in a single message. The next set of results can be obtained by executing the same query with the continuation token provided in this list.",
+      "properties": {
+        "ContinuationToken": {
+          "$ref": "#/definitions/ContinuationToken",
+          "description": "The continuation token parameter is used to obtain next set of results. The continuation token is included in the response of the API when the results from the system do not fit in a single response. When this value is passed to the next API call, the API returns next set of results. If there are no further results, then the continuation token is not included in the response."
+        },
+        "Items": {
+          "type": "array",
+          "description": "One page of the list.",
+          "items": {
+            "$ref": "#/definitions/ServiceResourceDescription"
+          }
+        }
+      }
+    },
+    "PagedServiceReplicaDescriptionList": {
+      "description": "The list of service resource replicas in the cluster. The list is paged when all of the results cannot fit in a single message. The next set of results can be obtained by executing the same query with the continuation token provided in this list.",
+      "properties": {
+        "ContinuationToken": {
+          "$ref": "#/definitions/ContinuationToken",
+          "description": "The continuation token parameter is used to obtain next set of results. The continuation token is included in the response of the API when the results from the system do not fit in a single response. When this value is passed to the next API call, the API returns next set of results. If there are no further results, then the continuation token is not included in the response."
+        },
+        "Items": {
+          "type": "array",
+          "description": "List of service resource replica description.",
+          "items": {
+            "$ref": "#/definitions/ServiceReplicaDescription"
+          }
+        }
+      }
+    },
+    "ApplicationResourceName": {
+      "type": "string",
+      "description": "Name of the Application resource."
+    },
+    "ApplicationResourceDescription": {
+      "description": "This type describes a application resource.",
+      "properties": {
+        "name": {
+          "$ref": "#/definitions/ApplicationResourceName",
+          "description": "Name of the Application resource."
+        },
+        "properties": {
+          "x-ms-client-flatten": true,
+          "$ref": "#/definitions/ApplicationProperties",
+          "description": "Describes properties of a application resource."
+        },
+        "identity": {
+          "$ref": "#/definitions/IdentityDescription",
+          "description": "Describes the identity of the application."
+        }
+      },
+      "required": [
+        "name",
+        "properties"
+      ]
+    },
+    "PagedApplicationResourceDescriptionList": {
+      "type": "object",
+      "description": "The list of application resources. The list is paged when all of the results cannot fit in a single message. The next set of results can be obtained by executing the same query with the continuation token provided in this list.",
+      "properties": {
+        "ContinuationToken": {
+          "$ref": "#/definitions/ContinuationToken",
+          "description": "The continuation token parameter is used to obtain next set of results. The continuation token is included in the response of the API when the results from the system do not fit in a single response. When this value is passed to the next API call, the API returns next set of results. If there are no further results, then the continuation token is not included in the response."
+        },
+        "Items": {
+          "type": "array",
+          "description": "One page of the list.",
+          "items": {
+            "$ref": "#/definitions/ApplicationResourceDescription"
+          }
+        }
+      }
+    }
+  },
+  "parameters": {
+    "CodePackageNameRequiredPathParam": {
+      "name": "codePackageName",
+      "in": "path",
+      "x-ms-parameter-location": "method",
+      "type": "string",
+      "required": true,
+      "description": "The name of code package of the service."
+    },
+    "ApiVersion_6-4-Preview_RequiredQueryParam": {
+      "name": "api-version",
+      "in": "query",
+      "x-ms-parameter-location": "method",
+      "type": "string",
+      "enum": [
+        "6.4-preview"
+      ],
+      "required": true,
+      "default": "6.4-preview",
+      "description": "The version of the API. This parameter is required and its value must be '6.4-preview'.",
+      "x-ms-enum": {
+        "name": "ApiVersion_6-4-Preview_RequiredQueryParam",
+        "modelAsString": true,
+        "values": [
+          {
+            "value": "6.4-preview",
+            "description": "The version number for the preview functionality of 6.4 runtime"
+          }
+        ]
+      }
+    },
+    "TailOptionalQueryParam": {
+      "name": "Tail",
+      "in": "query",
+      "x-ms-parameter-location": "method",
+      "type": "string",
+      "required": false,
+      "description": "Number of lines to show from the end of the logs. Default is 100. 'all' to show the complete logs."
+    },
+    "ApiVersion_6-0-Preview_RequiredQueryParam": {
+      "name": "api-version",
+      "in": "query",
+      "x-ms-parameter-location": "method",
+      "type": "string",
+      "enum": [
+        "6.0-preview"
+      ],
+      "required": true,
+      "default": "6.0-preview",
+      "description": "The version of the API. This parameter is required and its value must be '\"6.0-preview'.",
+      "x-ms-enum": {
+        "name": "ApiVersion_6-0-Preview_RequiredQueryParam",
+        "modelAsString": true,
+        "values": [
+          {
+            "value": "6.0-preview",
+            "description": "The version number for the preview functionality of 6.0 runtime."
+          }
+        ]
+      }
+    },
+    "ApiVersion_6-0_RequiredQueryParam": {
+      "name": "api-version",
+      "in": "query",
+      "x-ms-parameter-location": "method",
+      "type": "string",
+      "enum": [
+        "6.0"
+      ],
+      "required": true,
+      "default": "6.0",
+      "description": "The version of the API. This parameter is required and its value must be '6.0'.\n\nService Fabric REST API version is based on the runtime version in which the API was introduced or was changed. Service Fabric runtime supports more than one version of the API. This is the latest supported version of the API. If a lower API version is passed, the returned response may be different from the one documented in this specification.\n\nAdditionally the runtime accept any version that is higher than the latest supported version up to the current version of the runtime. So if the latest API version is 6.0, but if the runtime is 6.1, in order to make it easier to write the clients, the runtime will accept version 6.1 for that API. However the behavior of the API will be as per the documented 6.0 version.",
+      "x-ms-enum": {
+        "name": "ApiVersion_6-0_RequiredQueryParam",
+        "modelAsString": true,
+        "values": [
+          {
+            "value": "6.0",
+            "description": "The 6.0 version of the API."
+          }
+        ]
+      }
+    },
+    "ApiVersion_6-1_RequiredQueryParam": {
+      "name": "api-version",
+      "in": "query",
+      "x-ms-parameter-location": "method",
+      "type": "string",
+      "enum": [
+        "6.1"
+      ],
+      "required": true,
+      "default": "6.1",
+      "description": "The version of the API. This parameter is required and its value must be '6.1'.\n\nService Fabric REST API version is based on the runtime version in which the API was introduced or was changed. Service Fabric runtime supports more than one version of the API. This is the latest supported version of the API. If a lower API version is passed, the returned response may be different from the one documented in this specification.\n\nAdditionally the runtime accept any version that is higher than the latest supported version up to the current version of the runtime. So if the latest API version is 6.0, but if the runtime is 6.1, in order to make it easier to write the clients, the runtime will accept version 6.1 for that API. However the behavior of the API will be as per the documented 6.0 version.",
+      "x-ms-enum": {
+        "name": "ApiVersion_6-1_RequiredQueryParam",
+        "modelAsString": true,
+        "values": [
+          {
+            "value": "6.1",
+            "description": "The 6.1 version of the API."
+          }
+        ]
+      }
+    },
+    "ApiVersion_6-2_RequiredQueryParam": {
+      "name": "api-version",
+      "in": "query",
+      "x-ms-parameter-location": "method",
+      "type": "string",
+      "enum": [
+        "6.2"
+      ],
+      "required": true,
+      "default": "6.2",
+      "description": "The version of the API. This parameter is required and its value must be '6.2'.\n\nService Fabric REST API version is based on the runtime version in which the API was introduced or was changed. Service Fabric runtime supports more than one version of the API. This version is the latest supported version of the API. If a lower API version is passed, the returned response may be different from the one documented in this specification.\n\nAdditionally the runtime accepts any version that is higher than the latest supported version up to the current version of the runtime. So if the latest API version is 6.0 and the runtime is 6.1, the runtime will accept version 6.1 for that API. However the behavior of the API will be as per the documented 6.0 version.",
+      "x-ms-enum": {
+        "name": "ApiVersion_6-2_RequiredQueryParam",
+        "modelAsString": true,
+        "values": [
+          {
+            "value": "6.2",
+            "description": "The 6.2 version of the API."
+          }
+        ]
+      }
+    },
+    "ApiVersion_6-2-Preview_RequiredQueryParam": {
+      "name": "api-version",
+      "in": "query",
+      "x-ms-parameter-location": "method",
+      "type": "string",
+      "enum": [
+        "6.2-preview"
+      ],
+      "required": true,
+      "default": "6.2-preview",
+      "description": "The version of the API. This parameter is required and its value must be '6.2-preview'.",
+      "x-ms-enum": {
+        "name": "ApiVersion_6-2-Preview_RequiredQueryParam",
+        "modelAsString": true,
+        "values": [
+          {
+            "value": "6.2-preview",
+            "description": "The version number for the preview functionality of 6.2 runtime"
+          }
+        ]
+      }
+    },
+    "ApiVersion_6-3_RequiredQueryParam": {
+      "name": "api-version",
+      "in": "query",
+      "x-ms-parameter-location": "method",
+      "type": "string",
+      "enum": [
+        "6.3"
+      ],
+      "required": true,
+      "default": "6.3",
+      "description": "The version of the API. This parameter is required and its value must be '6.3'.\n\nService Fabric REST API version is based on the runtime version in which the API was introduced or was changed. Service Fabric runtime supports more than one version of the API. This version is the latest supported version of the API. If a lower API version is passed, the returned response may be different from the one documented in this specification.\n\nAdditionally the runtime accepts any version that is higher than the latest supported version up to the current version of the runtime. So if the latest API version is 6.0 and the runtime is 6.1, the runtime will accept version 6.1 for that API. However the behavior of the API will be as per the documented 6.0 version.",
+      "x-ms-enum": {
+        "name": "ApiVersion_6-3_RequiredQueryParam",
+        "modelAsString": true,
+        "values": [
+          {
+            "value": "6.3",
+            "description": "The 6.3 version of the API."
+          }
+        ]
+      }
+    },
+    "ApiVersion_6-3-Preview_RequiredQueryParam": {
+      "name": "api-version",
+      "in": "query",
+      "x-ms-parameter-location": "method",
+      "type": "string",
+      "enum": [
+        "6.3-preview"
+      ],
+      "required": true,
+      "default": "6.3-preview",
+      "description": "The version of the API. This parameter is required and its value must be '6.3-preview'.",
+      "x-ms-enum": {
+        "name": "ApiVersion_6-3-Preview_RequiredQueryParam",
+        "modelAsString": true,
+        "values": [
+          {
+            "value": "6.3-preview",
+            "description": "The version number for the preview functionality of 6.3 runtime"
+          }
+        ]
+      }
+    },
+    "ApiVersion_6-4_RequiredQueryParam": {
+      "name": "api-version",
+      "in": "query",
+      "x-ms-parameter-location": "method",
+      "type": "string",
+      "enum": [
+        "6.4"
+      ],
+      "required": true,
+      "default": "6.4",
+      "description": "The version of the API. This parameter is required and its value must be '6.4'.\n\nService Fabric REST API version is based on the runtime version in which the API was introduced or was changed. Service Fabric runtime supports more than one version of the API. This version is the latest supported version of the API. If a lower API version is passed, the returned response may be different from the one documented in this specification.\n\nAdditionally the runtime accepts any version that is higher than the latest supported version up to the current version of the runtime. So if the latest API version is 6.0 and the runtime is 6.1, the runtime will accept version 6.1 for that API. However the behavior of the API will be as per the documented 6.0 version.",
+      "x-ms-enum": {
+        "name": "ApiVersion_6-4_RequiredQueryParam",
+        "modelAsString": true,
+        "values": [
+          {
+            "value": "6.4",
+            "description": "The 6.4 version of the API."
+          }
+        ]
+      }
+    },
+    "ApiVersion_6-5_RequiredQueryParam": {
+      "name": "api-version",
+      "in": "query",
+      "x-ms-parameter-location": "method",
+      "type": "string",
+      "enum": [
+        "6.5"
+      ],
+      "required": true,
+      "default": "6.5",
+      "description": "The version of the API. This parameter is required and its value must be '6.5'.\n\nService Fabric REST API version is based on the runtime version in which the API was introduced or was changed. Service Fabric runtime supports more than one version of the API. This version is the latest supported version of the API. If a lower API version is passed, the returned response may be different from the one documented in this specification.\n\nAdditionally the runtime accepts any version that is higher than the latest supported version up to the current version of the runtime. So if the latest API version is 6.0 and the runtime is 6.1, the runtime will accept version 6.1 for that API. However the behavior of the API will be as per the documented 6.0 version.",
+      "x-ms-enum": {
+        "name": "ApiVersion_6-5_RequiredQueryParam",
+        "modelAsString": true,
+        "values": [
+          {
+            "value": "6.5",
+            "description": "The 6.5 version of the API."
+          }
+        ]
+      }
+    },
+    "ApiVersion_7-0_RequiredQueryParam": {
+      "name": "api-version",
+      "in": "query",
+      "x-ms-parameter-location": "method",
+      "type": "string",
+      "enum": [
+        "7.0"
+      ],
+      "required": true,
+      "default": "7.0",
+      "description": "The version of the API. This parameter is required and its value must be '7.0'.\n\nService Fabric REST API version is based on the runtime version in which the API was introduced or was changed. Service Fabric runtime supports more than one version of the API. This version is the latest supported version of the API. If a lower API version is passed, the returned response may be different from the one documented in this specification.\n\nAdditionally the runtime accepts any version that is higher than the latest supported version up to the current version of the runtime. So if the latest API version is 6.0 and the runtime is 6.1, the runtime will accept version 6.1 for that API. However the behavior of the API will be as per the documented 6.0 version.",
+      "x-ms-enum": {
+        "name": "ApiVersion_7-0_RequiredQueryParam",
+        "modelAsString": true,
+        "values": [
+          {
+            "value": "7.0",
+            "description": "The 7.0 version of the API."
+          }
+        ]
+      }
+    },
+    "ApiVersion_7-2_RequiredQueryParam": {
+      "name": "api-version",
+      "in": "query",
+      "x-ms-parameter-location": "method",
+      "type": "string",
+      "enum": [
+        "7.2"
+      ],
+      "required": true,
+      "default": "7.2",
+      "description": "The version of the API. This parameter is required and its value must be '7.2'.\n\nService Fabric REST API version is based on the runtime version in which the API was introduced or was changed. Service Fabric runtime supports more than one version of the API. This version is the latest supported version of the API. If a lower API version is passed, the returned response may be different from the one documented in this specification.\n\nAdditionally the runtime accepts any version that is higher than the latest supported version up to the current version of the runtime. So if the latest API version is 6.0 and the runtime is 6.1, the runtime will accept version 6.1 for that API. However the behavior of the API will be as per the documented 6.0 version.",
+      "x-ms-enum": {
+        "name": "ApiVersion_7-2_RequiredQueryParam",
+        "modelAsString": true,
+        "values": [
+          {
+            "value": "7.2",
+            "description": "The 7.2 version of the API."
+          }
+        ]
+      }
+    },
+    "ApplicationDefinitionKindFilterOptionalQueryParam": {
+      "name": "ApplicationDefinitionKindFilter",
+      "description": "Used to filter on ApplicationDefinitionKind, which is the mechanism used to define a Service Fabric application.\n- Default - Default value, which performs the same function as selecting \"All\". The value is 0.\n- All - Filter that matches input with any ApplicationDefinitionKind value. The value is 65535.\n- ServiceFabricApplicationDescription - Filter that matches input with ApplicationDefinitionKind value ServiceFabricApplicationDescription. The value is 1.\n- Compose - Filter that matches input with ApplicationDefinitionKind value Compose. The value is 2.",
+      "in": "query",
+      "x-ms-parameter-location": "method",
+      "type": "integer",
+      "required": false,
+      "default": 0
+    },
+    "ApplicationHealthPolicyOptionalBodyParam": {
+      "name": "ApplicationHealthPolicy",
+      "in": "body",
+      "description": "Describes the health policies used to evaluate the health of an application or one of its children.\nIf not present, the health evaluation uses the health policy from application manifest or the default health policy.",
+      "required": false,
+      "x-ms-parameter-location": "method",
+      "schema": {
+        "$ref": "#/definitions/ApplicationHealthPolicy"
+      }
+    },
+    "ApplicationIdRequiredPathParam": {
+      "name": "applicationId",
+      "in": "path",
+      "x-ms-parameter-location": "method",
+      "x-ms-skip-url-encoding": true,
+      "type": "string",
+      "required": true,
+      "description": "The identity of the application. This is typically the full name of the application without the 'fabric:' URI scheme.\nStarting from version 6.0, hierarchical names are delimited with the \"~\" character.\nFor example, if the application name is \"fabric:/myapp/app1\", the application identity would be \"myapp~app1\" in 6.0+ and \"myapp/app1\" in previous versions."
+    },
+    "ApplicationsHealthStateFilterOptionalQueryParam": {
+      "name": "ApplicationsHealthStateFilter",
+      "description": "Allows filtering of the application health state objects returned in the result of cluster health\nquery based on their health state.\nThe possible values for this parameter include integer value obtained from members or bitwise operations\non members of HealthStateFilter enumeration. Only applications that match the filter are returned.\nAll applications are used to evaluate the aggregated health state. If not specified, all entries are returned.\nThe state values are flag-based enumeration, so the value could be a combination of these values obtained using bitwise 'OR' operator.\nFor example, if the provided value is 6 then health state of applications with HealthState value of OK (2) and Warning (4) are returned.\n\n- Default - Default value. Matches any HealthState. The value is zero.\n- None - Filter that doesn't match any HealthState value. Used in order to return no results on a given collection of states. The value is 1.\n- Ok - Filter that matches input with HealthState value Ok. The value is 2.\n- Warning - Filter that matches input with HealthState value Warning. The value is 4.\n- Error - Filter that matches input with HealthState value Error. The value is 8.\n- All - Filter that matches input with any HealthState value. The value is 65535.",
+      "in": "query",
+      "x-ms-parameter-location": "method",
+      "type": "integer",
+      "required": false,
+      "default": 0
+    },
+    "ApplicationTypeDefinitionKindFilterOptionalQueryParam": {
+      "name": "ApplicationTypeDefinitionKindFilter",
+      "description": "Used to filter on ApplicationTypeDefinitionKind which is the mechanism used to define a Service Fabric application type.\n- Default - Default value, which performs the same function as selecting \"All\". The value is 0.\n- All - Filter that matches input with any ApplicationTypeDefinitionKind value. The value is 65535.\n- ServiceFabricApplicationPackage - Filter that matches input with ApplicationTypeDefinitionKind value ServiceFabricApplicationPackage. The value is 1.\n- Compose - Filter that matches input with ApplicationTypeDefinitionKind value Compose. The value is 2.",
+      "in": "query",
+      "x-ms-parameter-location": "method",
+      "type": "integer",
+      "required": false,
+      "default": 0
+    },
+    "ApplicationTypeNameOptionalQueryParam": {
+      "name": "ApplicationTypeName",
+      "in": "query",
+      "x-ms-parameter-location": "method",
+      "type": "string",
+      "required": false,
+      "description": "The application type name used to filter the applications to query for. This value should not contain the application type version."
+    },
+    "ApplicationTypeNameRequiredPathParam": {
+      "name": "applicationTypeName",
+      "in": "path",
+      "x-ms-parameter-location": "method",
+      "type": "string",
+      "required": true,
+      "description": "The name of the application type."
+    },
+    "ApplicationTypeVersionOptionalQueryParam": {
+      "name": "ApplicationTypeVersion",
+      "in": "query",
+      "x-ms-parameter-location": "method",
+      "type": "string",
+      "required": false,
+      "description": "The version of the application type."
+    },
+    "ApplicationTypeVersionRequiredQueryParam": {
+      "name": "ApplicationTypeVersion",
+      "in": "query",
+      "x-ms-parameter-location": "method",
+      "type": "string",
+      "required": true,
+      "description": "The version of the application type."
+    },
+    "ProvisionApplicationTypeDescriptionBaseRequiredBodyParam": {
+      "name": "ProvisionApplicationTypeDescriptionBaseRequiredBodyParam",
+      "in": "body",
+      "description": "The base type of provision application type description which supports either image store-based provision or external store-based provision.",
+      "required": true,
+      "x-ms-parameter-location": "method",
+      "schema": {
+        "$ref": "#/definitions/ProvisionApplicationTypeDescriptionBase"
+      }
+    },
+    "ClusterConfigurationUpgradeDescriptionRequiredBodyParam": {
+      "name": "ClusterConfigurationUpgradeDescription",
+      "in": "body",
+      "description": "Parameters for a standalone cluster configuration upgrade.",
+      "required": true,
+      "x-ms-parameter-location": "method",
+      "schema": {
+        "$ref": "#/definitions/ClusterConfigurationUpgradeDescription"
+      }
+    },
+    "ClusterHealthPoliciesOptionalBodyParam": {
+      "name": "ClusterHealthPolicies",
+      "in": "body",
+      "description": "Describes the health policies used to evaluate the cluster health.\nIf not present, the health evaluation uses the cluster health policy defined in the cluster manifest or the default cluster health policy.\nBy default, each application is evaluated using its specific application health policy, defined in the application manifest, or the default health policy, if no policy is defined in manifest.\nIf the application health policy map is specified, and it has an entry for an application, the specified application health policy\nis used to evaluate the application health.",
+      "required": false,
+      "x-ms-parameter-location": "method",
+      "schema": {
+        "$ref": "#/definitions/ClusterHealthPolicies"
+      }
+    },
+    "ClusterHealthPolicyOptionalBodyParam": {
+      "name": "ClusterHealthPolicy",
+      "in": "body",
+      "description": "Describes the health policies used to evaluate the health of a cluster or node. If not present, the health evaluation uses the health policy from cluster manifest or the default health policy.",
+      "required": false,
+      "x-ms-parameter-location": "method",
+      "schema": {
+        "$ref": "#/definitions/ClusterHealthPolicy"
+      }
+    },
+    "ClusterHealthChunkQueryDescriptionOptionalBodyParam": {
+      "name": "ClusterHealthChunkQueryDescription",
+      "in": "body",
+      "description": "Describes the cluster and application health policies used to evaluate the cluster health and the filters to select which cluster entities to be returned.\nIf the cluster health policy is present, it is used to evaluate the cluster events and the cluster nodes. If not present, the health evaluation uses the cluster health policy defined in the cluster manifest or the default cluster health policy.\nBy default, each application is evaluated using its specific application health policy, defined in the application manifest, or the default health policy, if no policy is defined in manifest.\nIf the application health policy map is specified, and it has an entry for an application, the specified application health policy\nis used to evaluate the application health.\nUsers can specify very flexible filters to select which cluster entities to include in response. The selection can be done based on the entities health state and based on the hierarchy.\nThe query can return multi-level children of the entities based on the specified filters. For example, it can return one application with a specified name, and for this application, return\nonly services that are in Error or Warning, and all partitions and replicas for one of these services.",
+      "required": false,
+      "x-ms-parameter-location": "method",
+      "schema": {
+        "$ref": "#/definitions/ClusterHealthChunkQueryDescription"
+      }
+    },
+    "CodePackageInstanceIdRequiredQueryParam": {
+      "name": "CodePackageInstanceId",
+      "description": "ID that uniquely identifies a code package instance deployed on a service fabric node.",
+      "in": "query",
+      "x-ms-parameter-location": "method",
+      "type": "string",
+      "required": true
+    },
+    "CodePackageNameRequiredQueryParam": {
+      "name": "CodePackageName",
+      "in": "query",
+      "x-ms-parameter-location": "method",
+      "type": "string",
+      "required": true,
+      "description": "The name of code package specified in service manifest registered as part of an application type in a Service Fabric cluster."
+    },
+    "CodeVersionOptionalQueryParam": {
+      "name": "CodeVersion",
+      "in": "query",
+      "x-ms-parameter-location": "method",
+      "type": "string",
+      "required": false,
+      "description": "The product version of Service Fabric."
+    },
+    "ConfigVersionOptionalQueryParam": {
+      "name": "ConfigVersion",
+      "in": "query",
+      "x-ms-parameter-location": "method",
+      "type": "string",
+      "required": false,
+      "description": "The config version of Service Fabric."
+    },
+    "ConfigurationApiVersionRequiredQueryParam": {
+      "name": "ConfigurationApiVersion",
+      "in": "query",
+      "x-ms-parameter-location": "method",
+      "type": "string",
+      "required": true,
+      "description": "The API version of the Standalone cluster json configuration."
+    },
+    "ContainerApiRequiredBodyParam": {
+      "name": "ContainerApiRequestBody",
+      "in": "body",
+      "description": "Parameters for making container API call",
+      "required": true,
+      "x-ms-parameter-location": "method",
+      "schema": {
+        "$ref": "#/definitions/ContainerApiRequestBody"
+      }
+    },
+    "ContinuationTokenOptionalQueryParam": {
+      "name": "ContinuationToken",
+      "in": "query",
+      "x-ms-parameter-location": "method",
+      "x-ms-skip-url-encoding": true,
+      "type": "string",
+      "required": false,
+      "description": "The continuation token parameter is used to obtain next set of results. A continuation token with a non-empty value is included in the response of the API when the results from the system do not fit in a single response. When this value is passed to the next API call, the API returns next set of results. If there are no further results, then the continuation token does not contain a value. The value of this parameter should not be URL encoded."
+    },
+    "DeployedApplicationsHealthStateFilterOptionalQueryParam": {
+      "name": "DeployedApplicationsHealthStateFilter",
+      "description": "Allows filtering of the deployed applications health state objects returned in the result of application health query based on their health state.\nThe possible values for this parameter include integer value of one of the following health states. Only deployed applications that match the filter will be returned.\nAll deployed applications are used to evaluate the aggregated health state. If not specified, all entries are returned.\nThe state values are flag-based enumeration, so the value could be a combination of these values, obtained using bitwise 'OR' operator.\nFor example, if the provided value is 6 then health state of deployed applications with HealthState value of OK (2) and Warning (4) are returned.\n\n- Default - Default value. Matches any HealthState. The value is zero.\n- None - Filter that doesn't match any HealthState value. Used in order to return no results on a given collection of states. The value is 1.\n- Ok - Filter that matches input with HealthState value Ok. The value is 2.\n- Warning - Filter that matches input with HealthState value Warning. The value is 4.\n- Error - Filter that matches input with HealthState value Error. The value is 8.\n- All - Filter that matches input with any HealthState value. The value is 65535.",
+      "in": "query",
+      "x-ms-parameter-location": "method",
+      "type": "integer",
+      "required": false,
+      "default": 0
+    },
+    "DeployedServicePackagesHealthStateFilterOptionalQueryParam": {
+      "name": "DeployedServicePackagesHealthStateFilter",
+      "description": "Allows filtering of the deployed service package health state objects returned in the result of deployed application health query based on their health state.\nThe possible values for this parameter include integer value of one of the following health states.\nOnly deployed service packages that match the filter are returned. All deployed service packages are used to evaluate the aggregated health state of the deployed application.\nIf not specified, all entries are returned.\nThe state values are flag-based enumeration, so the value can be a combination of these values, obtained using the bitwise 'OR' operator.\nFor example, if the provided value is 6 then health state of service packages with HealthState value of OK (2) and Warning (4) are returned.\n\n- Default - Default value. Matches any HealthState. The value is zero.\n- None - Filter that doesn't match any HealthState value. Used in order to return no results on a given collection of states. The value is 1.\n- Ok - Filter that matches input with HealthState value Ok. The value is 2.\n- Warning - Filter that matches input with HealthState value Warning. The value is 4.\n- Error - Filter that matches input with HealthState value Error. The value is 8.\n- All - Filter that matches input with any HealthState value. The value is 65535.",
+      "in": "query",
+      "x-ms-parameter-location": "method",
+      "type": "integer",
+      "required": false,
+      "default": 0
+    },
+    "DeploymentNameRequiredPathParam": {
+      "name": "deploymentName",
+      "in": "path",
+      "x-ms-parameter-location": "method",
+      "x-ms-skip-url-encoding": true,
+      "type": "string",
+      "required": true,
+      "description": "The identity of the deployment."
+    },
+    "EventsHealthStateFilterOptionalQueryParam": {
+      "name": "EventsHealthStateFilter",
+      "description": "Allows filtering the collection of HealthEvent objects returned based on health state.\nThe possible values for this parameter include integer value of one of the following health states.\nOnly events that match the filter are returned. All events are used to evaluate the aggregated health state.\nIf not specified, all entries are returned. The state values are flag-based enumeration, so the value could be a combination of these values, obtained using the bitwise 'OR' operator. For example, If the provided value is 6 then all of the events with HealthState value of OK (2) and Warning (4) are returned.\n\n- Default - Default value. Matches any HealthState. The value is zero.\n- None - Filter that doesn't match any HealthState value. Used in order to return no results on a given collection of states. The value is 1.\n- Ok - Filter that matches input with HealthState value Ok. The value is 2.\n- Warning - Filter that matches input with HealthState value Warning. The value is 4.\n- Error - Filter that matches input with HealthState value Error. The value is 8.\n- All - Filter that matches input with any HealthState value. The value is 65535.",
+      "in": "query",
+      "x-ms-parameter-location": "method",
+      "type": "integer",
+      "required": false,
+      "default": 0
+    },
+    "ExcludeApplicationParametersOptionalQueryParam": {
+      "name": "ExcludeApplicationParameters",
+      "in": "query",
+      "x-ms-parameter-location": "method",
+      "type": "boolean",
+      "required": false,
+      "default": false,
+      "description": "The flag that specifies whether application parameters will be excluded from the result."
+    },
+    "HealthInformationRequiredBodyParam": {
+      "name": "HealthInformation",
+      "in": "body",
+      "description": "Describes the health information for the health report. This information needs to be present in all of the health reports sent to the health manager.",
+      "required": true,
+      "x-ms-parameter-location": "method",
+      "schema": {
+        "$ref": "#/definitions/HealthInformation"
+      }
+    },
+    "NodeNameRequiredPathParam": {
+      "name": "nodeName",
+      "in": "path",
+      "x-ms-parameter-location": "method",
+      "type": "string",
+      "required": true,
+      "description": "The name of the node."
+    },
+    "NodesHealthStateFilterOptionalQueryParam": {
+      "name": "NodesHealthStateFilter",
+      "description": "Allows filtering of the node health state objects returned in the result of cluster health query\nbased on their health state. The possible values for this parameter include integer value of one of the\nfollowing health states. Only nodes that match the filter are returned. All nodes are used to evaluate the aggregated health state.\nIf not specified, all entries are returned.\nThe state values are flag-based enumeration, so the value could be a combination of these values obtained using bitwise 'OR' operator.\nFor example, if the provided value is 6 then health state of nodes with HealthState value of OK (2) and Warning (4) are returned.\n\n- Default - Default value. Matches any HealthState. The value is zero.\n- None - Filter that doesn't match any HealthState value. Used in order to return no results on a given collection of states. The value is 1.\n- Ok - Filter that matches input with HealthState value Ok. The value is 2.\n- Warning - Filter that matches input with HealthState value Warning. The value is 4.\n- Error - Filter that matches input with HealthState value Error. The value is 8.\n- All - Filter that matches input with any HealthState value. The value is 65535.",
+      "in": "query",
+      "x-ms-parameter-location": "method",
+      "type": "integer",
+      "required": false,
+      "default": 0
+    },
+    "NodeStatusFilterOptionalQueryParam": {
+      "name": "NodeStatusFilter",
+      "description": "Allows filtering the nodes based on the NodeStatus. Only the nodes that are matching the specified filter value will be returned. The filter value can be one of the following.",
+      "in": "query",
+      "x-ms-parameter-location": "method",
+      "type": "string",
+      "enum": [
+        "default",
+        "all",
+        "up",
+        "down",
+        "enabling",
+        "disabling",
+        "disabled",
+        "unknown",
+        "removed"
+      ],
+      "required": false,
+      "default": "default",
+      "x-ms-enum": {
+        "name": "NodeStatusFilter",
+        "modelAsString": true,
+        "values": [
+          {
+            "value": "default",
+            "description": "This filter value will match all of the nodes excepts the ones with status as Unknown or Removed."
+          },
+          {
+            "value": "all",
+            "description": "This filter value will match all of the nodes."
+          },
+          {
+            "value": "up",
+            "description": "This filter value will match nodes that are Up."
+          },
+          {
+            "value": "down",
+            "description": "This filter value will match nodes that are Down."
+          },
+          {
+            "value": "enabling",
+            "description": "This filter value will match nodes that are in the process of being enabled with status as Enabling."
+          },
+          {
+            "value": "disabling",
+            "description": "This filter value will match nodes that are in the process of being disabled with status as Disabling."
+          },
+          {
+            "value": "disabled",
+            "description": "This filter value will match nodes that are Disabled."
+          },
+          {
+            "value": "unknown",
+            "description": "This filter value will match nodes whose status is Unknown. A node would be in Unknown state if Service Fabric does not have authoritative information about that node. This can happen if the system learns about a node at runtime."
+          },
+          {
+            "value": "removed",
+            "description": "This filter value will match nodes whose status is Removed. These are the nodes that are removed from the cluster using the RemoveNodeState API."
+          }
+        ]
+      }
+    },
+    "PartitionIdOptionalQueryParam": {
+      "name": "PartitionId",
+      "in": "query",
+      "x-ms-parameter-location": "method",
+      "type": "string",
+      "format": "uuid",
+      "required": false,
+      "description": "The identity of the partition."
+    },
+    "PartitionIdRequiredPathParam": {
+      "name": "partitionId",
+      "in": "path",
+      "x-ms-parameter-location": "method",
+      "x-ms-skip-url-encoding": true,
+      "type": "string",
+      "format": "uuid",
+      "required": true,
+      "description": "The identity of the partition."
+    },
+    "ProvisionFabricDescriptionRequiredBodyParam": {
+      "name": "ProvisionFabricDescription",
+      "in": "body",
+      "description": "Describes the parameters for provisioning a cluster.",
+      "required": true,
+      "x-ms-parameter-location": "method",
+      "schema": {
+        "$ref": "#/definitions/ProvisionFabricDescription"
+      }
+    },
+    "UnprovisionFabricDescriptionRequiredBodyParam": {
+      "name": "UnprovisionFabricDescription",
+      "in": "body",
+      "description": "Describes the parameters for unprovisioning a cluster.",
+      "required": true,
+      "x-ms-parameter-location": "method",
+      "schema": {
+        "$ref": "#/definitions/UnprovisionFabricDescription"
+      }
+    },
+    "ResumeClusterUpgradeDescriptionRequiredBodyParam": {
+      "name": "ResumeClusterUpgradeDescription",
+      "in": "body",
+      "description": "Describes the parameters for resuming a cluster upgrade.",
+      "required": true,
+      "x-ms-parameter-location": "method",
+      "schema": {
+        "$ref": "#/definitions/ResumeClusterUpgradeDescription"
+      }
+    },
+    "UpdateClusterUpgradeDescriptionRequiredBodyParam": {
+      "name": "UpdateClusterUpgradeDescription",
+      "in": "body",
+      "description": "Parameters for updating a cluster upgrade.",
+      "required": true,
+      "x-ms-parameter-location": "method",
+      "schema": {
+        "$ref": "#/definitions/UpdateClusterUpgradeDescription"
+      }
+    },
+    "StartClusterUpgradeDescriptionRequiredBodyParam": {
+      "name": "StartClusterUpgradeDescription",
+      "in": "body",
+      "description": "Describes the parameters for starting a cluster upgrade.",
+      "required": true,
+      "x-ms-parameter-location": "method",
+      "schema": {
+        "$ref": "#/definitions/StartClusterUpgradeDescription"
+      }
+    },
+    "ReplicaHealthReportServiceKindRequiredQueryParam": {
+      "name": "ServiceKind",
+      "in": "query",
+      "required": true,
+      "x-ms-parameter-location": "method",
+      "description": "The kind of service replica (Stateless or Stateful) for which the health is being reported. Following are the possible values.",
+      "type": "string",
+      "enum": [
+        "Stateless",
+        "Stateful"
+      ],
+      "default": "Stateful",
+      "x-ms-enum": {
+        "name": "ReplicaHealthReportServiceKind",
+        "modelAsString": true,
+        "values": [
+          {
+            "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."
+          }
+        ]
+      }
+    },
+    "ReplicaIdRequiredPathParam": {
+      "name": "replicaId",
+      "in": "path",
+      "x-ms-parameter-location": "method",
+      "x-ms-skip-url-encoding": true,
+      "type": "string",
+      "required": true,
+      "description": "The identifier of the replica."
+    },
+    "ReplicasHealthStateFilerOptionalQueryParam": {
+      "name": "ReplicasHealthStateFilter",
+      "description": "Allows filtering the collection of ReplicaHealthState objects on the partition. The value can be obtained from members or bitwise operations on members of HealthStateFilter. Only replicas that match the filter will be returned. All replicas will be used to evaluate the aggregated health state. If not specified, all entries will be returned.The state values are flag-based enumeration, so the value could be a combination of these values obtained using bitwise 'OR' operator. For example, If the provided value is 6 then all of the events with HealthState value of OK (2) and Warning (4) will be returned. The possible values for this parameter include integer value of one of the following health states.\n\n- Default - Default value. Matches any HealthState. The value is zero.\n- None - Filter that doesn't match any HealthState value. Used in order to return no results on a given collection of states. The value is 1.\n- Ok - Filter that matches input with HealthState value Ok. The value is 2.\n- Warning - Filter that matches input with HealthState value Warning. The value is 4.\n- Error - Filter that matches input with HealthState value Error. The value is 8.\n- All - Filter that matches input with any HealthState value. The value is 65535.",
+      "in": "query",
+      "x-ms-parameter-location": "method",
+      "type": "integer",
+      "required": false,
+      "default": 0
+    },
+    "ServiceIdRequiredPathParam": {
+      "name": "serviceId",
+      "in": "path",
+      "x-ms-parameter-location": "method",
+      "x-ms-skip-url-encoding": true,
+      "type": "string",
+      "required": true,
+      "description": "The identity of the service. This ID is typically the full name of the service without the 'fabric:' URI scheme.\nStarting from version 6.0, hierarchical names are delimited with the \"~\" character.\nFor example, if the service name is \"fabric:/myapp/app1/svc1\", the service identity would be \"myapp~app1~svc1\" in 6.0+ and \"myapp/app1/svc1\" in previous versions."
+    },
+    "ServiceManifestNameOptionalQueryParam": {
+      "name": "ServiceManifestName",
+      "in": "query",
+      "x-ms-parameter-location": "method",
+      "type": "string",
+      "required": false,
+      "description": "The name of a service manifest registered as part of an application type in a Service Fabric cluster."
+    },
+    "ServiceManifestNameRequiredQueryParam": {
+      "name": "ServiceManifestName",
+      "in": "query",
+      "x-ms-parameter-location": "method",
+      "type": "string",
+      "required": true,
+      "description": "The name of a service manifest registered as part of an application type in a Service Fabric cluster."
+    },
+    "ServicePackageNameRequiredPathParam": {
+      "name": "servicePackageName",
+      "in": "path",
+      "x-ms-parameter-location": "method",
+      "x-ms-skip-url-encoding": true,
+      "type": "string",
+      "required": true,
+      "description": "The name of the service package."
+    },
+    "ServicesHealthStateFilterOptionalQueryParam": {
+      "name": "ServicesHealthStateFilter",
+      "description": "Allows filtering of the services health state objects returned in the result of services health query based on their health state.\nThe possible values for this parameter include integer value of one of the following health states.\nOnly services that match the filter are returned. All services are used to evaluate the aggregated health state.\nIf not specified, all entries are returned. The state values are flag-based enumeration, so the value could be a combination of these values,\nobtained using bitwise 'OR' operator. For example, if the provided value is 6 then health state of services with HealthState value of OK (2) and Warning (4) will be returned.\n\n- Default - Default value. Matches any HealthState. The value is zero.\n- None - Filter that doesn't match any HealthState value. Used in order to return no results on a given collection of states. The value is 1.\n- Ok - Filter that matches input with HealthState value Ok. The value is 2.\n- Warning - Filter that matches input with HealthState value Warning. The value is 4.\n- Error - Filter that matches input with HealthState value Error. The value is 8.\n- All - Filter that matches input with any HealthState value. The value is 65535.",
+      "in": "query",
+      "x-ms-parameter-location": "method",
+      "type": "integer",
+      "required": false,
+      "default": 0
+    },
+    "CreateServiceFromTemplateRequiredBodyParam": {
+      "name": "ServiceFromTemplateDescription",
+      "in": "body",
+      "description": "Describes the service that needs to be created from the template defined in the application manifest.",
+      "required": true,
+      "x-ms-parameter-location": "method",
+      "schema": {
+        "$ref": "#/definitions/ServiceFromTemplateDescription"
+      }
+    },
+    "ServiceTypeNameOptionalQueryParam": {
+      "name": "ServiceTypeName",
+      "in": "query",
+      "x-ms-parameter-location": "method",
+      "type": "string",
+      "required": false,
+      "description": "The service type name used to filter the services to query for."
+    },
+    "InfrastructureCommandRequiredQueryParam": {
+      "name": "Command",
+      "description": "The text of the command to be invoked. The content of the command is infrastructure-specific.",
+      "in": "query",
+      "x-ms-parameter-location": "method",
+      "type": "string",
+      "required": true
+    },
+    "InfrastructureServiceIdOptionalQueryParam": {
+      "name": "ServiceId",
+      "in": "query",
+      "x-ms-parameter-location": "method",
+      "type": "string",
+      "description": "The identity of the infrastructure service. This is the full name of the infrastructure service without the 'fabric:' URI scheme. This parameter required only for the cluster that has more than one instance of infrastructure service running.",
+      "required": false
+    },
+    "ForceRemoveOptionalQueryParam": {
+      "name": "ForceRemove",
+      "in": "query",
+      "x-ms-parameter-location": "method",
+      "type": "boolean",
+      "required": false,
+      "description": "Remove a Service Fabric application or service forcefully without going through the graceful shutdown sequence. This parameter can be used to forcefully delete an application or service for which delete is timing out due to issues in the service code that prevents graceful close of replicas."
+    },
+    "ForceRemoveReplicaOptionalQueryParam": {
+      "name": "ForceRemove",
+      "in": "query",
+      "x-ms-parameter-location": "method",
+      "type": "boolean",
+      "required": false,
+      "description": "Remove a Service Fabric application or service forcefully without going through the graceful shutdown sequence. This parameter can be used to forcefully delete an application or service for which delete is timing out due to issues in the service code that prevents graceful close of replicas."
+    },
+    "DeactivationIntentDescriptionRequiredBodyParam": {
+      "name": "DeactivationIntentDescription",
+      "in": "body",
+      "description": "Describes the intent or reason for deactivating the node.",
+      "required": true,
+      "x-ms-parameter-location": "method",
+      "schema": {
+        "$ref": "#/definitions/DeactivationIntentDescription"
+      }
+    },
+    "RestartNodeDescriptionRequiredBodyParam": {
+      "name": "RestartNodeDescription",
+      "in": "body",
+      "description": "The instance of the node to be restarted and a flag indicating the need to take dump of the fabric process.",
+      "required": true,
+      "x-ms-parameter-location": "method",
+      "schema": {
+        "$ref": "#/definitions/RestartNodeDescription"
+      }
+    },
+    "ApplicationUpgradeDescriptionRequiredBodyParam": {
+      "name": "ApplicationUpgradeDescription",
+      "in": "body",
+      "description": "Parameters for an application upgrade.",
+      "required": true,
+      "x-ms-parameter-location": "method",
+      "schema": {
+        "$ref": "#/definitions/ApplicationUpgradeDescription"
+      }
+    },
+    "ComposeDeploymentUpgradeDescriptionRequiredBodyParam": {
+      "name": "ComposeDeploymentUpgradeDescription",
+      "in": "body",
+      "description": "Parameters for upgrading compose deployment.",
+      "required": true,
+      "x-ms-parameter-location": "method",
+      "schema": {
+        "$ref": "#/definitions/ComposeDeploymentUpgradeDescription"
+      }
+    },
+    "ApplicationTypeImageStorePathRequiredBodyParam": {
+      "name": "ApplicationTypeImageStorePath",
+      "in": "body",
+      "description": "The relative path for the application package in the image store specified during the prior copy operation.",
+      "required": true,
+      "x-ms-parameter-location": "method",
+      "schema": {
+        "$ref": "#/definitions/ApplicationTypeImageStorePath"
+      }
+    },
+    "UnprovisionApplicationTypeRequiredBodyParam": {
+      "name": "UnprovisionApplicationTypeDescriptionInfo",
+      "in": "body",
+      "description": "The relative path for the application package in the image store specified during the prior copy operation.",
+      "required": true,
+      "x-ms-parameter-location": "method",
+      "schema": {
+        "$ref": "#/definitions/UnprovisionApplicationTypeDescriptionInfo"
+      }
+    },
+    "UpgradeOrchestrationServiceStateRequiredBodyParam": {
+      "name": "UpgradeOrchestrationServiceState",
+      "in": "body",
+      "x-ms-parameter-location": "method",
+      "required": true,
+      "description": "Service state of Service Fabric Upgrade Orchestration Service.",
+      "schema": {
+        "$ref": "#/definitions/UpgradeOrchestrationServiceState"
+      }
+    },
+    "ChaosParametersRequiredBodyParam": {
+      "name": "ChaosParameters",
+      "in": "body",
+      "description": "Describes all the parameters to configure a Chaos run.",
+      "required": true,
+      "x-ms-parameter-location": "method",
+      "schema": {
+        "$ref": "#/definitions/ChaosParameters"
+      }
+    },
+    "StartTimeUtcOptionalQueryParam": {
+      "name": "StartTimeUtc",
+      "in": "query",
+      "x-ms-parameter-location": "method",
+      "type": "string",
+      "required": false,
+      "description": "The Windows file time representing the start time of the time range for which a Chaos report is to be generated. Consult [DateTime.ToFileTimeUtc Method](https://msdn.microsoft.com/library/system.datetime.tofiletimeutc(v=vs.110).aspx) for details."
+    },
+    "EndTimeUtcOptionalQueryParam": {
+      "name": "EndTimeUtc",
+      "in": "query",
+      "x-ms-parameter-location": "method",
+      "type": "string",
+      "required": false,
+      "description": "The Windows file time representing the end time of the time range for which a Chaos report is to be generated. Consult [DateTime.ToFileTimeUtc Method](https://msdn.microsoft.com/library/system.datetime.tofiletimeutc(v=vs.110).aspx) for details."
+    },
+    "ApplicationNameRequiredQueryParam": {
+      "name": "ApplicationName",
+      "in": "query",
+      "x-ms-parameter-location": "method",
+      "type": "string",
+      "required": true,
+      "description": "The name of application to create from compose file. This is typically the full name of the application including 'fabric:' URI scheme."
+    },
+    "CreateComposeDeploymentRequiredBodyParam": {
+      "name": "CreateComposeDeploymentDescription",
+      "in": "body",
+      "description": "Describes the compose deployment that needs to be created.",
+      "required": true,
+      "x-ms-parameter-location": "method",
+      "schema": {
+        "$ref": "#/definitions/CreateComposeDeploymentDescription"
+      }
+    },
+    "PasswordEncryptedOptionalQueryParam": {
+      "name": "PasswordEncrypted",
+      "in": "query",
+      "x-ms-parameter-location": "method",
+      "type": "boolean",
+      "required": false,
+      "description": "Indicates that supplied container repository password is encrypted."
+    },
+    "RepositoryPasswordOptionalQueryParam": {
+      "name": "RepositoryPassword",
+      "in": "query",
+      "x-ms-parameter-location": "method",
+      "type": "string",
+      "required": false,
+      "description": "The password for supplied username to connect to container repository."
+    },
+    "RepositoryUserNameOptionalQueryParam": {
+      "name": "RepositoryUserName",
+      "in": "query",
+      "x-ms-parameter-location": "method",
+      "type": "string",
+      "required": false,
+      "description": "The user name to connect to container repository."
+    },
+    "MaxResultsOptionalQueryParam": {
+      "name": "MaxResults",
+      "in": "query",
+      "x-ms-parameter-location": "method",
+      "type": "integer",
+      "format": "int64",
+      "minimum": 0,
+      "default": 0,
+      "required": false,
+      "description": "The maximum number of results to be returned as part of the paged queries. This parameter defines the upper bound on the number of results returned. The results returned can be less than the specified maximum results if they do not fit in the message as per the max message size restrictions defined in the configuration. If this parameter is zero or not specified, the paged query includes as many results as possible that fit in the return message."
+    },
+    "ApplicationDescriptionRequiredBodyParam": {
+      "name": "ApplicationDescription",
+      "in": "body",
+      "description": "Description for creating an application.",
+      "required": true,
+      "x-ms-parameter-location": "method",
+      "schema": {
+        "$ref": "#/definitions/ApplicationDescription"
+      }
+    },
+    "ServiceDescriptionRequiredBodyParam": {
+      "name": "ServiceDescription",
+      "in": "body",
+      "description": "The information necessary to create a service.",
+      "required": true,
+      "x-ms-parameter-location": "method",
+      "schema": {
+        "$ref": "#/definitions/ServiceDescription"
+      }
+    },
+    "ServiceUpdateDescriptionRequiredBodyParam": {
+      "name": "ServiceUpdateDescription",
+      "in": "body",
+      "description": "The information necessary to update a service.",
+      "required": true,
+      "x-ms-parameter-location": "method",
+      "schema": {
+        "$ref": "#/definitions/ServiceUpdateDescription"
+      }
+    },
+    "ImageStoreCopyDescriptionRequiredBodyParam": {
+      "name": "ImageStoreCopyDescription",
+      "in": "body",
+      "description": "Describes the copy description for the image store.",
+      "required": true,
+      "x-ms-parameter-location": "method",
+      "schema": {
+        "$ref": "#/definitions/ImageStoreCopyDescription"
+      }
+    },
+    "CodePackageNameOptionalQueryParam": {
+      "name": "CodePackageName",
+      "in": "query",
+      "x-ms-parameter-location": "method",
+      "type": "string",
+      "required": false,
+      "description": "The name of code package specified in service manifest registered as part of an application type in a Service Fabric cluster."
+    },
+    "RestartDeployedCodePackageRequiredBodyParam": {
+      "name": "RestartDeployedCodePackageDescription",
+      "in": "body",
+      "description": "Describes the deployed code package on Service Fabric node to restart.",
+      "required": true,
+      "x-ms-parameter-location": "method",
+      "schema": {
+        "$ref": "#/definitions/RestartDeployedCodePackageDescription"
+      }
+    },
+    "PartitionsHealthStateFilterOptionalQueryParam": {
+      "name": "PartitionsHealthStateFilter",
+      "description": "Allows filtering of the partitions health state objects returned in the result of service health query based on their health state.\nThe possible values for this parameter include integer value of one of the following health states.\nOnly partitions that match the filter are returned. All partitions are used to evaluate the aggregated health state.\nIf not specified, all entries are returned. The state values are flag-based enumeration, so the value could be a combination of these value\nobtained using bitwise 'OR' operator. For example, if the provided value is 6 then health state of partitions with HealthState value of OK (2) and Warning (4) will be returned.\n\n- Default - Default value. Matches any HealthState. The value is zero.\n- None - Filter that doesn't match any HealthState value. Used in order to return no results on a given collection of states. The value is 1.\n- Ok - Filter that matches input with HealthState value Ok. The value is 2.\n- Warning - Filter that matches input with HealthState value Warning. The value is 4.\n- Error - Filter that matches input with HealthState value Error. The value is 8.\n- All - Filter that matches input with any HealthState value. The value is 65535.",
+      "in": "query",
+      "x-ms-parameter-location": "method",
+      "type": "integer",
+      "required": false,
+      "default": 0
+    },
+    "DeployedServiceType_ServiceManifestNameOptionalQueryParam": {
+      "name": "ServiceManifestName",
+      "in": "query",
+      "x-ms-parameter-location": "method",
+      "type": "string",
+      "required": false,
+      "description": "The name of the service manifest to filter the list of deployed service type information. If specified, the response will only contain the information about service types that are defined in this service manifest."
+    },
+    "ServiceTypeNameRequiredPathParam": {
+      "name": "serviceTypeName",
+      "in": "path",
+      "x-ms-parameter-location": "method",
+      "x-ms-skip-url-encoding": true,
+      "type": "string",
+      "required": true,
+      "description": "Specifies the name of a Service Fabric service type."
+    },
+    "ImageStoreContentPathRequiredPathParam": {
+      "name": "contentPath",
+      "in": "path",
+      "x-ms-parameter-location": "method",
+      "type": "string",
+      "required": true,
+      "description": "Relative path to file or folder in the image store from its root."
+    },
+    "PartitionKeyTypeOptionalQueryParam": {
+      "name": "PartitionKeyType",
+      "description": "Key type for the partition. This parameter is required if the partition scheme for the service is Int64Range or Named. The possible values are following.\n- None (1) - Indicates that the PartitionKeyValue parameter is not specified. This is valid for the partitions with partitioning scheme as Singleton. This is the default value. The value is 1.\n- Int64Range (2) - Indicates that the PartitionKeyValue parameter is an int64 partition key. This is valid for the partitions with partitioning scheme as Int64Range. The value is 2.\n- Named (3) - Indicates that the PartitionKeyValue parameter is a name of the partition. This is valid for the partitions with partitioning scheme as Named. The value is 3.",
+      "in": "query",
+      "x-ms-parameter-location": "method",
+      "type": "integer",
+      "required": false
+    },
+    "PartitionKeyValueOptionalQueryParam": {
+      "name": "PartitionKeyValue",
+      "in": "query",
+      "x-ms-parameter-location": "method",
+      "x-ms-skip-url-encoding": true,
+      "type": "string",
+      "required": false,
+      "description": "Partition key. This is required if the partition scheme for the service is Int64Range or Named. \nThis is not the partition ID, but rather, either the integer key value, or the name of the partition ID.\nFor example, if your service is using ranged partitions from 0 to 10, then they PartitionKeyValue would be an\ninteger in that range. Query service description to see the range or name."
+    },
+    "PreviousRspVersionOptionalQueryParam": {
+      "name": "PreviousRspVersion",
+      "in": "query",
+      "x-ms-parameter-location": "method",
+      "x-ms-skip-url-encoding": true,
+      "type": "string",
+      "required": false,
+      "description": "The value in the Version field of the response that was received previously. This is required if the user knows that the result that was gotten previously is stale."
+    },
+    "DataLossModeRequiredQueryParam": {
+      "name": "DataLossMode",
+      "description": "This enum is passed to the StartDataLoss API to indicate what type of data loss to induce.",
+      "in": "query",
+      "x-ms-parameter-location": "method",
+      "type": "string",
+      "enum": [
+        "Invalid",
+        "PartialDataLoss",
+        "FullDataLoss"
+      ],
+      "required": true,
+      "x-ms-enum": {
+        "name": "DataLossMode",
+        "modelAsString": true,
+        "values": [
+          {
+            "value": "Invalid",
+            "description": "Reserved.  Do not pass into API."
+          },
+          {
+            "value": "PartialDataLoss",
+            "description": "PartialDataLoss option will cause a quorum of replicas to go down, triggering an OnDataLoss event in the system for the given partition."
+          },
+          {
+            "value": "FullDataLoss",
+            "description": "FullDataLoss option will drop all the replicas which means that all the data will be lost."
+          }
+        ]
+      }
+    },
+    "FaultOperationIdRequiredQueryParam": {
+      "name": "OperationId",
+      "description": "A GUID that identifies a call of this API.  This is passed into the corresponding GetProgress API",
+      "in": "query",
+      "x-ms-parameter-location": "method",
+      "type": "string",
+      "format": "uuid",
+      "required": true
+    },
+    "ForceRequiredQueryParam": {
+      "name": "Force",
+      "description": "Indicates whether to gracefully roll back and clean up internal system state modified by executing the user-induced operation.",
+      "in": "query",
+      "x-ms-parameter-location": "method",
+      "type": "boolean",
+      "required": true,
+      "default": false
+    },
+    "NodeInstanceIdRequiredQueryParam": {
+      "name": "NodeInstanceId",
+      "in": "query",
+      "x-ms-parameter-location": "method",
+      "type": "string",
+      "required": true,
+      "description": "The node instance ID of the target node.  This can be determined through GetNodeInfo API."
+    },
+    "NodeTransitionTypeRequiredQueryParam": {
+      "name": "NodeTransitionType",
+      "description": "Indicates the type of transition to perform.  NodeTransitionType.Start will start a stopped node.  NodeTransitionType.Stop will stop a node that is up.",
+      "in": "query",
+      "x-ms-parameter-location": "method",
+      "type": "string",
+      "enum": [
+        "Invalid",
+        "Start",
+        "Stop"
+      ],
+      "required": true,
+      "x-ms-enum": {
+        "name": "NodeTransitionType",
+        "modelAsString": true,
+        "values": [
+          {
+            "value": "Invalid",
+            "description": "Reserved.  Do not pass into API."
+          },
+          {
+            "value": "Start",
+            "description": "Transition a stopped node to up."
+          },
+          {
+            "value": "Stop",
+            "description": "Transition an up node to stopped."
+          }
+        ]
+      }
+    },
+    "QuorumLossDurationRequiredQueryParam": {
+      "name": "QuorumLossDuration",
+      "description": "The amount of time for which the partition will be kept in quorum loss.  This must be specified in seconds.",
+      "in": "query",
+      "x-ms-parameter-location": "method",
+      "type": "integer",
+      "required": true
+    },
+    "QuorumLossModeRequiredQueryParam": {
+      "name": "QuorumLossMode",
+      "description": "This enum is passed to the StartQuorumLoss API to indicate what type of quorum loss to induce.",
+      "in": "query",
+      "x-ms-parameter-location": "method",
+      "type": "string",
+      "enum": [
+        "Invalid",
+        "QuorumReplicas",
+        "AllReplicas"
+      ],
+      "required": true,
+      "x-ms-enum": {
+        "name": "QuorumLossMode",
+        "modelAsString": true,
+        "values": [
+          {
+            "value": "Invalid",
+            "description": "Reserved.  Do not pass into API."
+          },
+          {
+            "value": "QuorumReplicas",
+            "description": "Partial Quorum loss mode : Minimum number of replicas for a partition will be down that will cause a quorum loss."
+          },
+          {
+            "value": "AllReplicas"
+          }
+        ]
+      }
+    },
+    "RestartPartitionModeRequiredQueryParam": {
+      "name": "RestartPartitionMode",
+      "description": "Describe which partitions to restart.",
+      "in": "query",
+      "x-ms-parameter-location": "method",
+      "type": "string",
+      "enum": [
+        "Invalid",
+        "AllReplicasOrInstances",
+        "OnlyActiveSecondaries"
+      ],
+      "required": true,
+      "x-ms-enum": {
+        "name": "RestartPartitionMode",
+        "modelAsString": true,
+        "values": [
+          {
+            "value": "Invalid",
+            "description": "Reserved.  Do not pass into API."
+          },
+          {
+            "value": "AllReplicasOrInstances",
+            "description": "All replicas or instances in the partition are restarted at once."
+          },
+          {
+            "value": "OnlyActiveSecondaries",
+            "description": "Only the secondary replicas are restarted."
+          }
+        ]
+      }
+    },
+    "StateFilterRequiredQueryParam": {
+      "name": "StateFilter",
+      "description": "Used to filter on OperationState's for user-induced operations.\n\n- 65535 - select All\n- 1 - select Running\n- 2 - select RollingBack\n- 8 - select Completed\n- 16 - select Faulted\n- 32 - select Cancelled\n- 64 - select ForceCancelled",
+      "in": "query",
+      "x-ms-parameter-location": "method",
+      "type": "integer",
+      "required": true,
+      "default": 65535
+    },
+    "StopDurationInSecondsRequiredQueryParam": {
+      "name": "StopDurationInSeconds",
+      "in": "query",
+      "x-ms-parameter-location": "method",
+      "type": "integer",
+      "format": "int32",
+      "minimum": 0,
+      "required": true,
+      "description": "The duration, in seconds, to keep the node stopped.  The minimum value is 600, the maximum is 14400.  After this time expires, the node will automatically come back up."
+    },
+    "TypeFilterRequiredQueryParam": {
+      "name": "TypeFilter",
+      "description": "Used to filter on OperationType for user-induced operations.\n\n- 65535 - select all\n- 1 - select PartitionDataLoss.\n- 2 - select PartitionQuorumLoss.\n- 4 - select PartitionRestart.\n- 8 - select NodeTransition.",
+      "in": "query",
+      "x-ms-parameter-location": "method",
+      "type": "integer",
+      "required": true,
+      "default": 65535
+    },
+    "DeployServicePackageToNodeRequiredBodyParam": {
+      "name": "DeployServicePackageToNodeDescription",
+      "in": "body",
+      "description": "Describes information for deploying a service package to a Service Fabric node.",
+      "required": true,
+      "x-ms-parameter-location": "method",
+      "schema": {
+        "$ref": "#/definitions/DeployServicePackageToNodeDescription"
+      }
+    },
+    "ResumeApplicationUpgradeDescriptionRequiredBodyParam": {
+      "name": "ResumeApplicationUpgradeDescription",
+      "in": "body",
+      "description": "Describes the parameters for resuming an application upgrade.",
+      "required": true,
+      "x-ms-parameter-location": "method",
+      "schema": {
+        "$ref": "#/definitions/ResumeApplicationUpgradeDescription"
+      }
+    },
+    "ApplicationUpgradeUpdateDescriptionRequiredBodyParam": {
+      "name": "ApplicationUpgradeUpdateDescription",
+      "in": "body",
+      "description": "Parameters for updating an existing application upgrade.",
+      "required": true,
+      "x-ms-parameter-location": "method",
+      "schema": {
+        "$ref": "#/definitions/ApplicationUpgradeUpdateDescription"
+      }
+    },
+    "TimeoutOptionalQueryParam": {
+      "name": "timeout",
+      "in": "query",
+      "x-ms-parameter-location": "method",
+      "type": "integer",
+      "format": "int64",
+      "required": false,
+      "minimum": 1,
+      "maximum": 4294967295,
+      "default": 60,
+      "description": "The server timeout for performing the operation in seconds. This timeout specifies the time duration that the client is willing to wait for the requested operation to complete. The default value for this parameter is 60 seconds."
+    },
+    "NameDescriptionRequiredBodyParam": {
+      "name": "NameDescription",
+      "in": "body",
+      "description": "Describes the Service Fabric name to be created.",
+      "required": true,
+      "x-ms-parameter-location": "method",
+      "schema": {
+        "$ref": "#/definitions/NameDescription"
+      }
+    },
+    "NameIdRequiredPathParam": {
+      "name": "nameId",
+      "in": "path",
+      "x-ms-parameter-location": "method",
+      "x-ms-skip-url-encoding": true,
+      "type": "string",
+      "required": true,
+      "description": "The Service Fabric name, without the 'fabric:' URI scheme."
+    },
+    "RecursiveOptionalQueryParam": {
+      "name": "Recursive",
+      "description": "Allows specifying that the search performed should be recursive.",
+      "in": "query",
+      "x-ms-parameter-location": "method",
+      "type": "boolean",
+      "required": false,
+      "default": false
+    },
+    "IncludeValuesOptionalQueryParam": {
+      "name": "IncludeValues",
+      "description": "Allows specifying whether to include the values of the properties returned. True if values should be returned with the metadata; False to return only property metadata.",
+      "in": "query",
+      "x-ms-parameter-location": "method",
+      "type": "boolean",
+      "required": false,
+      "default": false
+    },
+    "PropertyDescriptionRequiredBodyParam": {
+      "name": "PropertyDescription",
+      "in": "body",
+      "description": "Describes the Service Fabric property to be created.",
+      "required": true,
+      "x-ms-parameter-location": "method",
+      "schema": {
+        "$ref": "#/definitions/PropertyDescription"
+      }
+    },
+    "PropertyNameRequiredQueryParam": {
+      "name": "PropertyName",
+      "description": "Specifies the name of the property to get.",
+      "in": "query",
+      "x-ms-parameter-location": "method",
+      "type": "string",
+      "required": true
+    },
+    "PropertyBatchDescriptionListRequiredBodyParam": {
+      "name": "PropertyBatchDescriptionList",
+      "in": "body",
+      "description": "Describes the property batch operations to be submitted.",
+      "required": true,
+      "x-ms-parameter-location": "method",
+      "schema": {
+        "$ref": "#/definitions/PropertyBatchDescriptionList"
+      }
+    },
+    "ImmediateOptionalQueryParam": {
+      "name": "Immediate",
+      "in": "query",
+      "x-ms-parameter-location": "method",
+      "type": "boolean",
+      "required": false,
+      "default": false,
+      "description": "A flag that indicates whether the report should be sent immediately.\nA health report is sent to a Service Fabric gateway Application, which forwards to the health store.\nIf Immediate is set to true, the report is sent immediately from HTTP Gateway to the health store, regardless of the fabric client settings that the HTTP Gateway Application is using.\nThis is useful for critical reports that should be sent as soon as possible.\nDepending on timing and other conditions, sending the report may still fail, for example if the HTTP Gateway is closed or the message doesn't reach the Gateway.\nIf Immediate is set to false, the report is sent based on the health client settings from the HTTP Gateway. Therefore, it will be batched according to the HealthReportSendInterval configuration.\nThis is the recommended setting because it allows the health client to optimize health reporting messages to health store as well as health report processing.\nBy default, reports are not sent immediately."
+    },
+    "ExcludeHealthStatisticsOptionalQueryParam": {
+      "name": "ExcludeHealthStatistics",
+      "description": "Indicates whether the health statistics should be returned as part of the query result. False by default.\nThe statistics show the number of children entities in health state Ok, Warning, and Error.",
+      "in": "query",
+      "x-ms-parameter-location": "method",
+      "type": "boolean",
+      "required": false,
+      "default": false
+    },
+    "IncludeSystemApplicationHealthStatisticsOptionalQueryParam": {
+      "name": "IncludeSystemApplicationHealthStatistics",
+      "description": "Indicates whether the health statistics should include the fabric:/System application health statistics. False by default.\nIf IncludeSystemApplicationHealthStatistics is set to true, the health statistics include the entities that belong to the fabric:/System application.\nOtherwise, the query result includes health statistics only for user applications.\nThe health statistics must be included in the query result for this parameter to be applied.",
+      "in": "query",
+      "x-ms-parameter-location": "method",
+      "type": "boolean",
+      "required": false,
+      "default": false
+    },
+    "IncludeHealthStateOptionalQueryParam": {
+      "name": "IncludeHealthState",
+      "in": "query",
+      "x-ms-parameter-location": "method",
+      "type": "boolean",
+      "required": false,
+      "default": false,
+      "description": "Include the health state of an entity.\nIf this parameter is false or not specified, then the health state returned is \"Unknown\".\nWhen set to true, the query goes in parallel to the node and the health system service before the results are merged.\nAs a result, the query is more expensive and may take a longer time."
+    },
+    "BackupPolicyDescriptionRequiredBodyParam": {
+      "name": "BackupPolicyDescription",
+      "in": "body",
+      "required": true,
+      "x-ms-parameter-location": "method",
+      "description": "Describes the backup policy.",
+      "schema": {
+        "$ref": "#/definitions/BackupPolicyDescription"
+      }
+    },
+    "DisableBackupDescriptionOptionalBodyParam": {
+      "name": "DisableBackupDescription",
+      "in": "body",
+      "description": "Specifies the parameters to disable backup for any backup entity.",
+      "required": false,
+      "x-ms-parameter-location": "method",
+      "schema": {
+        "$ref": "#/definitions/DisableBackupDescription"
+      }
+    },
+    "BackupPolicyNameRequiredPathParam": {
+      "name": "backupPolicyName",
+      "in": "path",
+      "description": "The name of the backup policy.",
+      "required": true,
+      "x-ms-parameter-location": "method",
+      "type": "string"
+    },
+    "EnableBackupDescriptionRequiredBodyParam": {
+      "name": "EnableBackupDescription",
+      "in": "body",
+      "description": "Specifies the parameters for enabling backup.",
+      "required": true,
+      "x-ms-parameter-location": "method",
+      "schema": {
+        "$ref": "#/definitions/EnableBackupDescription"
+      }
+    },
+    "RestorePartitionDescriptionRequiredBodyParam": {
+      "name": "RestorePartitionDescription",
+      "in": "body",
+      "description": "Describes the parameters to restore the partition.",
+      "required": true,
+      "x-ms-parameter-location": "method",
+      "schema": {
+        "$ref": "#/definitions/RestorePartitionDescription"
+      }
+    },
+    "RestoreTimeoutOptionalQueryParam": {
+      "name": "RestoreTimeout",
+      "description": "Specifies the maximum amount of time to wait, in minutes, for the restore operation to complete. Post that, the operation returns back with timeout error. However, in certain corner cases it could be that the restore operation goes through even though it completes with timeout. In case of timeout error, its recommended to invoke this operation again with a greater timeout value. the default value for the same is 10 minutes.",
+      "in": "query",
+      "x-ms-parameter-location": "method",
+      "type": "integer",
+      "required": false,
+      "default": 10
+    },
+    "BackupPartitionDescriptionOptionalBodyParam": {
+      "name": "BackupPartitionDescription",
+      "in": "body",
+      "required": false,
+      "x-ms-parameter-location": "method",
+      "description": "Describes the parameters to backup the partition now. If not present, backup operation uses default parameters from the backup policy current associated with this partition.",
+      "schema": {
+        "$ref": "#/definitions/BackupPartitionDescription"
+      }
+    },
+    "BackupTimeoutOptionalQueryParam": {
+      "name": "BackupTimeout",
+      "in": "query",
+      "x-ms-parameter-location": "method",
+      "type": "integer",
+      "required": false,
+      "description": "Specifies the maximum amount of time, in minutes, to wait for the backup operation to complete. Post that, the operation completes with timeout error. However, in certain corner cases it could be that though the operation returns back timeout, the backup actually goes through. In case of timeout error, its recommended to invoke this operation again with a greater timeout value. The default value for the same is 10 minutes.",
+      "default": 10
+    },
+    "LatestOptionalQueryParam": {
+      "name": "Latest",
+      "in": "query",
+      "x-ms-parameter-location": "method",
+      "type": "boolean",
+      "description": "Specifies whether to get only the most recent backup available for a partition for the specified time range.",
+      "required": false,
+      "default": false
+    },
+    "StartDateTimeFilterOptionalQueryParam": {
+      "name": "StartDateTimeFilter",
+      "in": "query",
+      "x-ms-parameter-location": "method",
+      "type": "string",
+      "format": "date-time",
+      "required": false,
+      "description": "Specify the start date time from which to enumerate backups, in datetime format. The date time must be specified in ISO8601 format. This is an optional parameter. If not specified, all backups from the beginning are enumerated."
+    },
+    "EndDateTimeFilterOptionalQueryParam": {
+      "name": "EndDateTimeFilter",
+      "in": "query",
+      "x-ms-parameter-location": "method",
+      "type": "string",
+      "format": "date-time",
+      "required": false,
+      "description": "Specify the end date time till which to enumerate backups, in datetime format. The date time must be specified in ISO8601 format. This is an optional parameter. If not specified, enumeration is done till the most recent backup."
+    },
+    "GetBackupByStorageQueryDescriptionRequiredBodyParam": {
+      "name": "GetBackupByStorageQueryDescription",
+      "in": "body",
+      "required": true,
+      "x-ms-parameter-location": "method",
+      "description": "Describes the filters and backup storage details to be used for enumerating backups.",
+      "schema": {
+        "$ref": "#/definitions/GetBackupByStorageQueryDescription"
+      }
+    },
+    "RepairTaskApproveDescriptionRequiredBodyParam": {
+      "name": "RepairTaskApproveDescription",
+      "in": "body",
+      "description": "Describes the repair task to be approved.",
+      "required": true,
+      "x-ms-parameter-location": "method",
+      "schema": {
+        "$ref": "#/definitions/RepairTaskApproveDescription"
+      }
+    },
+    "RepairTaskCancelDescriptionRequiredBodyParam": {
+      "name": "RepairTaskCancelDescription",
+      "in": "body",
+      "description": "Describes the repair task to be cancelled.",
+      "required": true,
+      "x-ms-parameter-location": "method",
+      "schema": {
+        "$ref": "#/definitions/RepairTaskCancelDescription"
+      }
+    },
+    "RepairTaskDeleteDescriptionRequiredBodyParam": {
+      "name": "RepairTaskDeleteDescription",
+      "in": "body",
+      "description": "Describes the repair task to be deleted.",
+      "required": true,
+      "x-ms-parameter-location": "method",
+      "schema": {
+        "$ref": "#/definitions/RepairTaskDeleteDescription"
+      }
+    },
+    "RepairTaskExecutorFilterOptionalQueryParam": {
+      "name": "ExecutorFilter",
+      "description": "The name of the repair executor whose claimed tasks should be included in the list.",
+      "in": "query",
+      "x-ms-parameter-location": "method",
+      "type": "string",
+      "required": false
+    },
+    "RepairTaskIdFilterOptionalQueryParam": {
+      "name": "TaskIdFilter",
+      "description": "The repair task ID prefix to be matched.",
+      "in": "query",
+      "x-ms-parameter-location": "method",
+      "type": "string",
+      "required": false
+    },
+    "RepairTaskRequiredBodyParam": {
+      "name": "RepairTask",
+      "in": "body",
+      "description": "Describes the repair task to be created or updated.",
+      "required": true,
+      "x-ms-parameter-location": "method",
+      "schema": {
+        "$ref": "#/definitions/RepairTask"
+      }
+    },
+    "RepairTaskStateFilterOptionalQueryParam": {
+      "name": "StateFilter",
+      "description": "A bitwise-OR of the following values, specifying which task states should be included in the result list.\n\n- 1 - Created\n- 2 - Claimed\n- 4 - Preparing\n- 8 - Approved\n- 16 - Executing\n- 32 - Restoring\n- 64 - Completed",
+      "in": "query",
+      "x-ms-parameter-location": "method",
+      "type": "integer",
+      "required": false
+    },
+    "RepairTaskUpdateHealthPolicyDescriptionRequiredBodyParam": {
+      "name": "RepairTaskUpdateHealthPolicyDescription",
+      "in": "body",
+      "description": "Describes the repair task healthy policy to be updated.",
+      "x-ms-parameter-location": "method",
+      "required": true,
+      "schema": {
+        "$ref": "#/definitions/RepairTaskUpdateHealthPolicyDescription"
+      }
+    },
+    "UploadSessionIdRequiredQueryParam": {
+      "name": "session-id",
+      "in": "query",
+      "x-ms-parameter-location": "method",
+      "type": "string",
+      "format": "uuid",
+      "required": true,
+      "description": "A GUID generated by the user for a file uploading. It identifies an image store upload session which keeps track of all file chunks until it is committed."
+    },
+    "UploadFileChunkContentRangeHeaderParam": {
+      "name": "Content-Range",
+      "in": "header",
+      "x-ms-parameter-location": "method",
+      "type": "string",
+      "required": true,
+      "description": "When uploading file chunks to the image store, the Content-Range header field need to be configured and sent with a request. The format should looks like \"bytes {First-Byte-Position}-{Last-Byte-Position}/{File-Length}\". For example, Content-Range:bytes 300-5000/20000 indicates that user is sending bytes 300 through 5,000 and the total file length is 20,000 bytes."
+    },
+    "ChaosScheduleRequiredBodyParam": {
+      "name": "ChaosSchedule",
+      "in": "body",
+      "description": "Describes the schedule used by Chaos.",
+      "required": true,
+      "x-ms-parameter-location": "method",
+      "schema": {
+        "$ref": "#/definitions/ChaosScheduleDescription"
+      }
+    },
+    "StartTimeUtcRequiredQueryParam": {
+      "name": "StartTimeUtc",
+      "in": "query",
+      "x-ms-parameter-location": "method",
+      "type": "string",
+      "required": true,
+      "description": "The start time of a lookup query in ISO UTC yyyy-MM-ddTHH:mm:ssZ."
+    },
+    "EndTimeUtcRequiredQueryParam": {
+      "name": "EndTimeUtc",
+      "in": "query",
+      "x-ms-parameter-location": "method",
+      "type": "string",
+      "required": true,
+      "description": "The end time of a lookup query in ISO UTC yyyy-MM-ddTHH:mm:ssZ."
+    },
+    "EventsTypesFilterOptionalQueryParam": {
+      "name": "EventsTypesFilter",
+      "in": "query",
+      "x-ms-parameter-location": "method",
+      "type": "string",
+      "required": false,
+      "description": "This is a comma separated string specifying the types of FabricEvents that should only be included in the response."
+    },
+    "ExcludeAnalysisEventsOptionalQueryParam": {
+      "name": "ExcludeAnalysisEvents",
+      "in": "query",
+      "x-ms-parameter-location": "method",
+      "type": "boolean",
+      "required": false,
+      "description": "This param disables the retrieval of AnalysisEvents if true is passed."
+    },
+    "SkipCorrelationLookupOptionalQueryParam": {
+      "name": "SkipCorrelationLookup",
+      "in": "query",
+      "x-ms-parameter-location": "method",
+      "type": "boolean",
+      "required": false,
+      "description": "This param disables the search of CorrelatedEvents information if true is passed. otherwise the CorrelationEvents get processed and HasCorrelatedEvents field in every FabricEvent gets populated."
+    },
+    "EventInstanceIdRequiredPathParam": {
+      "name": "eventInstanceId",
+      "in": "path",
+      "x-ms-parameter-location": "method",
+      "type": "string",
+      "required": true,
+      "description": "The EventInstanceId."
+    },
+    "PreviousOptionalQueryParam": {
+      "name": "Previous",
+      "in": "query",
+      "x-ms-parameter-location": "method",
+      "type": "boolean",
+      "description": "Specifies whether to get container logs from exited/dead containers of the code package instance.",
+      "required": false,
+      "default": false
+    },
+    "IgnoreConstraintsOptionalParam": {
+      "name": "IgnoreConstraints",
+      "in": "query",
+      "x-ms-parameter-location": "method",
+      "type": "boolean",
+      "required": false,
+      "default": false,
+      "description": "Ignore constraints when moving a replica. If this parameter is not specified, all constraints are honored."
+    },
+    "NodeNameOptionalParam": {
+      "name": "NodeName",
+      "in": "query",
+      "x-ms-parameter-location": "method",
+      "type": "string",
+      "required": false,
+      "description": "The name of the node."
+    },
+    "VerboseServicePlacementHealthReportingParam": {
+      "name": "Enabled",
+      "in": "query",
+      "x-ms-parameter-location": "method",
+      "type": "boolean",
+      "required": true,
+      "description": "The verbosity of service placement health reporting."
+    },
+    "NewNodeNameOptionalParam": {
+      "name": "NewNodeName",
+      "in": "query",
+      "x-ms-parameter-location": "method",
+      "type": "string",
+      "required": false,
+      "description": "The name of the target node for secondary replica move. If not specified, replica is moved to a random node."
+    },
+    "CurrentNodeNameRequiredParam": {
+      "name": "CurrentNodeName",
+      "in": "query",
+      "x-ms-parameter-location": "method",
+      "type": "string",
+      "required": true,
+      "description": "The name of the source node for secondary replica move."
+    },
+    "OnlyQueryPrimariesOptionalQueryParam": {
+      "name": "OnlyQueryPrimaries",
+      "description": "Indicates that unplaced replica information will be queries only for primary replicas.",
+      "in": "query",
+      "x-ms-parameter-location": "method",
+      "type": "boolean",
+      "required": false,
+      "default": false
+    },
+    "ForceConfigurationOverrideOptionalParam": {
+      "name": "Force",
+      "in": "query",
+      "x-ms-parameter-location": "method",
+      "type": "boolean",
+      "required": false,
+      "description": "Force adding configuration overrides on specified nodes."
+    },
+    "ConfigurationOverrideListRequiredParam": {
+      "name": "ConfigParameterOverrideList",
+      "in": "body",
+      "description": "Description for adding list of configuration overrides.",
+      "required": true,
+      "x-ms-parameter-location": "method",
+      "schema": {
+        "$ref": "#/definitions/ConfigParameterOverrideList"
+      }
+    },
+    "PartitionMetricLoadDescriptionListRequiredParam": {
+      "name": "PartitionMetricLoadDescriptionList",
+      "in": "body",
+      "description": "Description of updating load for list of partitions.",
+      "required": true,
+      "x-ms-parameter-location": "method",
+      "schema": {
+        "$ref": "#/definitions/PartitionMetricLoadDescriptionList"
+      }
+    },
+    "SecretResourceDescriptionRequiredBodyParam": {
+      "name": "secretResourceDescription",
+      "in": "body",
+      "description": "Description for creating a secret resource.",
+      "required": true,
+      "x-ms-parameter-location": "method",
+      "schema": {
+        "$ref": "#/definitions/SecretResourceDescription"
+      }
+    },
+    "SecretResourceNameRequiredPathParam": {
+      "name": "secretResourceName",
+      "in": "path",
+      "x-ms-parameter-location": "method",
+      "x-ms-skip-url-encoding": true,
+      "type": "string",
+      "required": true,
+      "description": "The name of the secret resource."
+    },
+    "SecretValueResourceDescriptionRequiredBodyParam": {
+      "name": "secretValueResourceDescription",
+      "in": "body",
+      "description": "Description for creating a value of a secret resource.",
+      "required": true,
+      "x-ms-parameter-location": "method",
+      "schema": {
+        "$ref": "#/definitions/SecretValueResourceDescription"
+      }
+    },
+    "SecretValueResourceNameRequiredPathParam": {
+      "name": "secretValueResourceName",
+      "in": "path",
+      "x-ms-parameter-location": "method",
+      "x-ms-skip-url-encoding": true,
+      "type": "string",
+      "required": true,
+      "description": "The name of the secret resource value which is typically the version identifier for the value."
+    },
+    "VolumeResourceDescriptionRequiredBodyParam": {
+      "name": "volumeResourceDescription",
+      "in": "body",
+      "description": "Description for creating a Volume resource.",
+      "required": true,
+      "x-ms-parameter-location": "method",
+      "schema": {
+        "$ref": "#/definitions/VolumeResourceDescription"
+      }
+    },
+    "VolumeResourceNameRequiredPathParam": {
+      "name": "volumeResourceName",
+      "in": "path",
+      "x-ms-parameter-location": "method",
+      "x-ms-skip-url-encoding": true,
+      "type": "string",
+      "required": true,
+      "description": "The identity of the volume."
+    },
+    "NetworkResourceDescriptionRequiredBodyParam": {
+      "name": "networkResourceDescription",
+      "in": "body",
+      "description": "Description for creating a Network resource.",
+      "required": true,
+      "x-ms-parameter-location": "method",
+      "schema": {
+        "$ref": "#/definitions/NetworkResourceDescription"
+      }
+    },
+    "NetworkResourceNameRequiredPathParam": {
+      "name": "networkResourceName",
+      "in": "path",
+      "x-ms-parameter-location": "method",
+      "x-ms-skip-url-encoding": true,
+      "type": "string",
+      "required": true,
+      "description": "The identity of the network."
+    },
+    "ApplicationResourceDescriptionRequiredBodyParam": {
+      "name": "applicationResourceDescription",
+      "in": "body",
+      "description": "Description for creating a Application resource.",
+      "required": true,
+      "x-ms-parameter-location": "method",
+      "schema": {
+        "$ref": "#/definitions/ApplicationResourceDescription"
+      }
+    },
+    "ApplicationResourceNameRequiredPathParam": {
+      "name": "applicationResourceName",
+      "in": "path",
+      "x-ms-parameter-location": "method",
+      "x-ms-skip-url-encoding": true,
+      "type": "string",
+      "required": true,
+      "description": "The identity of the application."
+    },
+    "ServiceResourceNameRequiredPathParam": {
+      "name": "serviceResourceName",
+      "in": "path",
+      "x-ms-parameter-location": "method",
+      "x-ms-skip-url-encoding": true,
+      "type": "string",
+      "required": true,
+      "description": "The identity of the service."
+    },
+    "ReplicaNameRequiredPathParam": {
+      "name": "replicaName",
+      "in": "path",
+      "x-ms-parameter-location": "method",
+      "x-ms-skip-url-encoding": true,
+      "type": "string",
+      "required": true,
+      "description": "Service Fabric replica name."
+    },
+    "GatewayResourceDescriptionRequiredBodyParam": {
+      "name": "gatewayResourceDescription",
+      "in": "body",
+      "description": "Description for creating a Gateway resource.",
+      "required": true,
+      "x-ms-parameter-location": "method",
+      "schema": {
+        "$ref": "#/definitions/GatewayResourceDescription"
+      }
+    },
+    "GatewayResourceNameRequiredPathParam": {
+      "name": "gatewayResourceName",
+      "in": "path",
+      "x-ms-parameter-location": "method",
+      "x-ms-skip-url-encoding": true,
+      "type": "string",
+      "required": true,
+      "description": "The identity of the gateway."
+    }
+  }
+}
diff --git a/specification/servicefabric/data-plane/readme.go.md b/specification/servicefabric/data-plane/readme.go.md
index e11163673d21..d59076f5d70e 100644
--- a/specification/servicefabric/data-plane/readme.go.md
+++ b/specification/servicefabric/data-plane/readme.go.md
@@ -18,6 +18,7 @@ batch:
   - tag: "6.4"
   - tag: "6.5"
   - tag: "7.0"
+  - tag: "7.2"
 ```
 
 ### Tag: 6.2 and go
@@ -59,4 +60,12 @@ These settings apply only when `--tag=7.0 --go` is specified on the command line
 
 ``` yaml $(tag) == '7.0' && $(go)
 output-folder: $(go-sdk-folder)/services/$(namespace)/7.0/$(namespace)
+```
+
+### Tag: 7.2 and go
+
+These settings apply only when `--tag=7.2 --go` is specified on the command line.
+
+``` yaml $(tag) == '7.2' && $(go)
+output-folder: $(go-sdk-folder)/services/$(namespace)/7.2/$(namespace)
 ```
\ No newline at end of file
diff --git a/specification/servicefabric/data-plane/readme.md b/specification/servicefabric/data-plane/readme.md
index 719a8b671916..4e8ddd138a3d 100644
--- a/specification/servicefabric/data-plane/readme.md
+++ b/specification/servicefabric/data-plane/readme.md
@@ -25,7 +25,7 @@ These are the global settings for the ServiceFabricClient API.
 
 ``` yaml
 openapi-type: data-plane
-tag: '7.1'
+tag: '7.2'
 ```
 
 ### Suppression
@@ -125,6 +125,16 @@ input-file:
 
 ```
 
+### Tag: 7.2
+
+These settings apply only when `--tag=7.2` is specified on the command line.
+
+``` yaml $(tag) == '7.2'
+input-file:
+- Microsoft.ServiceFabric/stable/7.2/servicefabric.json
+
+```
+
 ---
 # Code Generation
 
@@ -179,7 +189,7 @@ input-file:
   - $(this-folder)/Microsoft.ServiceFabric/stable/6.5/servicefabric.json
   - $(this-folder)/Microsoft.ServiceFabric/stable/7.0/servicefabric.json
   - $(this-folder)/Microsoft.ServiceFabric/stable/7.1/servicefabric.json
-
+  - $(this-folder)/Microsoft.ServiceFabric/stable/7.2/servicefabric.json
 ```
 
 If there are files that should not be in the `all-api-versions` set, 
diff --git a/specification/servicefabric/data-plane/readme.python.md b/specification/servicefabric/data-plane/readme.python.md
index ab41c8694c10..3ada9c5e3aad 100644
--- a/specification/servicefabric/data-plane/readme.python.md
+++ b/specification/servicefabric/data-plane/readme.python.md
@@ -11,7 +11,7 @@ python:
   payload-flattening-threshold: 2
   namespace: azure.servicefabric
   package-name: azure-servicefabric
-  package-version: 7.0.0.0
+  package-version: 7.2.0.0
   add-credentials: true
   clear-output-folder: true
 ```
diff --git a/specification/streamanalytics/resource-manager/readme.az.md b/specification/streamanalytics/resource-manager/readme.az.md
new file mode 100644
index 000000000000..34bd207b4dd1
--- /dev/null
+++ b/specification/streamanalytics/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: streamanalytics
+  package-name: azure-mgmt-streamanalytics
+  namespace: azure.mgmt.streamanalytics
+az-output-folder: $(azure-cli-extension-folder)/src/streamanalytics
+python-sdk-output-folder: "$(az-output-folder)/azext_streamanalytics/vendored_sdks/streamanalytics"
+```
diff --git a/specification/streamanalytics/resource-manager/readme.cli.md b/specification/streamanalytics/resource-manager/readme.cli.md
new file mode 100644
index 000000000000..4b69b6bf3ba9
--- /dev/null
+++ b/specification/streamanalytics/resource-manager/readme.cli.md
@@ -0,0 +1,10 @@
+## CLI
+
+These settings apply only when `--cli` is specified on the command line.
+
+``` yaml $(cli)
+cli:
+  cli-name: streamanalytics
+  package-name: azure-mgmt-streamanalytics
+  namespace: azure.mgmt.streamanalytics
+```
diff --git a/specification/streamanalytics/resource-manager/readme.python.md b/specification/streamanalytics/resource-manager/readme.python.md
index f13ae0206aff..a74b0b5aaff2 100644
--- a/specification/streamanalytics/resource-manager/readme.python.md
+++ b/specification/streamanalytics/resource-manager/readme.python.md
@@ -24,7 +24,6 @@ azure-arm: true
 license-header: MICROSOFT_MIT_NO_VERSION
 package-name: azure-mgmt-streamanalytics
 no-namespace-folders: true
-package-version: 0.1.0
 ```
 
 ``` yaml $(python-mode) == 'update'
@@ -36,8 +35,10 @@ output-folder: $(python-sdks-folder)/streamanalytics/azure-mgmt-streamanalytics/
 ```
 ``` yaml $(python-mode) == 'create'
 python:
+  package-version: 0.1.0
   basic-setup-py: true
   output-folder: $(python-sdks-folder)/streamanalytics/azure-mgmt-streamanalytics
+package-version: 0.1.0
 basic-setup-py: true
 output-folder: $(python-sdks-folder)/streamanalytics/azure-mgmt-streamanalytics
 ```
diff --git a/specification/synapse/data-plane/Microsoft.Synapse/preview/2019-06-01-preview/examples/CreateManagedPrivateEndpoint.json b/specification/synapse/data-plane/Microsoft.Synapse/preview/2019-06-01-preview/examples/CreateManagedPrivateEndpoint.json
index 546fa6e7fe84..168740ecf1c7 100644
--- a/specification/synapse/data-plane/Microsoft.Synapse/preview/2019-06-01-preview/examples/CreateManagedPrivateEndpoint.json
+++ b/specification/synapse/data-plane/Microsoft.Synapse/preview/2019-06-01-preview/examples/CreateManagedPrivateEndpoint.json
@@ -1,11 +1,10 @@
 {
   "parameters": {
-    "workspaceName": "myWorkspace",
-    "SynapseDnsSuffix": "dev.azuresynapse.net",
+    "endpoint": "exampleWorkspace.dev.azuresynapse.net",
     "api-version": "2019-06-01-preview",
     "managedVirtualNetworkName": "default",
     "managedPrivateEndpointName": "myPrivateEndpoint",
-    "parameters": {
+    "managedPrivateEndpoint": {
       "properties": {
         "privateLinkResourceId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/myResourceGroup/providers/Microsoft.Storage/accounts/myStorageAccount",
         "groupId": "blob"
@@ -13,7 +12,7 @@
     }
   },
   "responses": {
-    "202": {
+    "200": {
       "body": {
         "type": "Microsoft.Synapse/workspaces/managedVirtualNetworks/managedPrivateEndpoints",
         "name": "myPrivateEndpoint",
diff --git a/specification/synapse/data-plane/Microsoft.Synapse/preview/2019-06-01-preview/examples/DeleteManagedPrivateEndpoint.json b/specification/synapse/data-plane/Microsoft.Synapse/preview/2019-06-01-preview/examples/DeleteManagedPrivateEndpoint.json
index a82531a7ca46..0dae9a6beee1 100644
--- a/specification/synapse/data-plane/Microsoft.Synapse/preview/2019-06-01-preview/examples/DeleteManagedPrivateEndpoint.json
+++ b/specification/synapse/data-plane/Microsoft.Synapse/preview/2019-06-01-preview/examples/DeleteManagedPrivateEndpoint.json
@@ -1,7 +1,6 @@
 {
   "parameters": {
-    "workspaceName": "myWorkspace",
-    "SynapseDnsSuffix": "dev.azuresynapse.net",
+    "endpoint": "exampleWorkspace.dev.azuresynapse.net",
     "api-version": "2019-06-01-preview",
     "managedVirtualNetworkName": "default",
     "managedPrivateEndpointName": "myPrivateEndpoint"
diff --git a/specification/synapse/data-plane/Microsoft.Synapse/preview/2019-06-01-preview/examples/GetManagedPrivateEndpoint.json b/specification/synapse/data-plane/Microsoft.Synapse/preview/2019-06-01-preview/examples/GetManagedPrivateEndpoint.json
index cb3551457722..14c2f5029b07 100644
--- a/specification/synapse/data-plane/Microsoft.Synapse/preview/2019-06-01-preview/examples/GetManagedPrivateEndpoint.json
+++ b/specification/synapse/data-plane/Microsoft.Synapse/preview/2019-06-01-preview/examples/GetManagedPrivateEndpoint.json
@@ -1,7 +1,6 @@
 {
   "parameters": {
-    "workspaceName": "myWorkspace",
-    "SynapseDnsSuffix": "dev.azuresynapse.net",
+    "endpoint": "exampleWorkspace.dev.azuresynapse.net",
     "api-version": "2019-06-01-preview",
     "managedVirtualNetworkName": "default",
     "managedPrivateEndpointName": "myPrivateEndpoint"
diff --git a/specification/synapse/data-plane/Microsoft.Synapse/preview/2019-06-01-preview/examples/ListManagedPrivateEndpoints.json b/specification/synapse/data-plane/Microsoft.Synapse/preview/2019-06-01-preview/examples/ListManagedPrivateEndpoints.json
index 2dfbbc8c6aef..a91826d848a9 100644
--- a/specification/synapse/data-plane/Microsoft.Synapse/preview/2019-06-01-preview/examples/ListManagedPrivateEndpoints.json
+++ b/specification/synapse/data-plane/Microsoft.Synapse/preview/2019-06-01-preview/examples/ListManagedPrivateEndpoints.json
@@ -1,7 +1,6 @@
 {
   "parameters": {
-    "workspaceName": "myWorkspace",
-    "SynapseDnsSuffix": "dev.azuresynapse.net",
+    "endpoint": "exampleWorkspace.dev.azuresynapse.net",
     "api-version": "2019-06-01-preview",
     "managedVirtualNetworkName": "default"
   },
diff --git a/specification/synapse/data-plane/Microsoft.Synapse/preview/2019-06-01-preview/managedPrivateEndpoints.json b/specification/synapse/data-plane/Microsoft.Synapse/preview/2019-06-01-preview/managedPrivateEndpoints.json
index 8322fd96043d..0db302d9eae4 100644
--- a/specification/synapse/data-plane/Microsoft.Synapse/preview/2019-06-01-preview/managedPrivateEndpoints.json
+++ b/specification/synapse/data-plane/Microsoft.Synapse/preview/2019-06-01-preview/managedPrivateEndpoints.json
@@ -2,21 +2,14 @@
   "swagger": "2.0",
   "info": {
     "version": "2019-06-01-preview",
-    "title": "VnetClient"
+    "title": "ManagedPrivateEndpointsClient"
   },
   "x-ms-parameterized-host": {
-    "hostTemplate": "{workspaceName}.{SynapseDnsSuffix}",
+    "hostTemplate": "{endpoint}",
+    "useSchemePrefix": false,
     "parameters": [
       {
-        "name": "workspaceName",
-        "description": "The name of the workspace to execute operations on.",
-        "required": true,
-        "type": "string",
-        "in": "path",
-        "x-ms-skip-url-encoding": true
-      },
-      {
-        "$ref": "#/parameters/SynapseDnsSuffixInPath"
+        "$ref": "#/parameters/Endpoint"
       }
     ]
   },
@@ -79,10 +72,19 @@
           },
           {
             "$ref": "#/parameters/ManagedPrivateEndpointNameParameter"
+          },
+          {
+            "name": "managedPrivateEndpoint",
+            "in": "body",
+            "required": true,
+            "description": "Managed private endpoint properties.",
+            "schema": {
+              "$ref": "#/definitions/ManagedPrivateEndpoint"
+            }
           }
         ],
         "responses": {
-          "202": {
+          "200": {
             "schema": {
               "$ref": "#/definitions/ManagedPrivateEndpoint"
             },
@@ -262,6 +264,15 @@
     }
   },
   "parameters": {
+    "Endpoint": {
+      "name": "endpoint",
+      "description": "The workspace development endpoint, for example https://myworkspace.dev.azuresynapse.net.",
+      "required": true,
+      "type": "string",
+      "in": "path",
+      "x-ms-skip-url-encoding": true,
+      "x-ms-parameter-location": "client"
+    },
     "ApiVersionParameter": {
       "name": "api-version",
       "in": "query",
@@ -269,16 +280,6 @@
       "type": "string",
       "description": "The Synapse client API Version."
     },
-    "SynapseDnsSuffixInPath": {
-      "name": "SynapseDnsSuffix",
-      "in": "path",
-      "required": true,
-      "type": "string",
-      "default": "dev.azuresynapse.net",
-      "x-ms-skip-url-encoding": true,
-      "description": "Gets the DNS suffix used as the base for all Synapse service requests.",
-      "x-ms-parameter-location": "client"
-    },
     "ManagedVirtualNetworkNameParameter": {
       "name": "managedVirtualNetworkName",
       "in": "path",
diff --git a/specification/synapse/resource-manager/Microsoft.Synapse/preview/2019-06-01-preview/bigDataPool.json b/specification/synapse/resource-manager/Microsoft.Synapse/preview/2019-06-01-preview/bigDataPool.json
index 9a4769f7aae7..fd7f5a282891 100644
--- a/specification/synapse/resource-manager/Microsoft.Synapse/preview/2019-06-01-preview/bigDataPool.json
+++ b/specification/synapse/resource-manager/Microsoft.Synapse/preview/2019-06-01-preview/bigDataPool.json
@@ -410,6 +410,10 @@
           "type": "boolean",
           "description": "Whether compute isolation is required or not."
         },
+        "sessionLevelPackagesEnabled": {
+          "type": "boolean",
+          "description": "Whether session level library/package management is enabled or not."
+        },
         "sparkEventsFolder": {
           "type": "string",
           "description": "The Spark events folder"
@@ -423,6 +427,13 @@
           "$ref": "#/definitions/LibraryRequirements",
           "description": "Library version requirements"
         },
+        "customLibraries": {
+          "description": "List of custom libraries/packages associated with the spark pool.",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/LibraryInfo"
+          }
+        },
         "sparkConfigProperties": {
           "$ref": "#/definitions/LibraryRequirements",
           "description": "Spark configuration file to specify additional properties"
@@ -503,6 +514,34 @@
         }
       }
     },
+    "LibraryInfo": {
+      "type": "object",
+      "description": "Library/package information of a Big Data pool powered by Apache Spark",
+      "title": "Information about a library/package created at the workspace level.",
+      "properties": {
+        "name": {
+          "type": "string",
+          "description": "Name of the library."
+        },
+        "path": {
+          "type": "string",
+          "description": "Storage blob path of library."
+        },
+        "containerName": {
+          "type": "string",
+          "description": "Storage blob container name."
+        },
+        "uploadedTimestamp": {
+          "type": "string",
+          "format": "date-time",
+          "description": "The last update time of the library."
+        },
+        "type": {
+          "type": "string",
+          "description": "Type of the library."
+        }
+      }
+    },
     "LibraryRequirements": {
       "type": "object",
       "description": "Library requirements for a Big Data pool powered by Apache Spark",
diff --git a/specification/synapse/resource-manager/Microsoft.Synapse/preview/2019-06-01-preview/examples/UpdateWorkspace.json b/specification/synapse/resource-manager/Microsoft.Synapse/preview/2019-06-01-preview/examples/UpdateWorkspace.json
index c64c464f96f3..a42bbb2ccb14 100644
--- a/specification/synapse/resource-manager/Microsoft.Synapse/preview/2019-06-01-preview/examples/UpdateWorkspace.json
+++ b/specification/synapse/resource-manager/Microsoft.Synapse/preview/2019-06-01-preview/examples/UpdateWorkspace.json
@@ -11,15 +11,15 @@
       "identity": {
         "type": "SystemAssigned"
       },
-      "managedVirtualNetworkSettings": {
-        "preventDataExfiltration": false,
-        "linkedAccessCheckOnTargetResource": false,
-        "allowedAadTenantIdsForLinking": [
-          "740239CE-A25B-485B-86A0-262F29F6EBDB"
-        ]
-      },
       "properties": {
-        "sqlAdministratorLoginPassword": "password"
+        "sqlAdministratorLoginPassword": "password",
+        "managedVirtualNetworkSettings": {
+          "preventDataExfiltration": false,
+          "linkedAccessCheckOnTargetResource": false,
+          "allowedAadTenantIdsForLinking": [
+            "740239CE-A25B-485B-86A0-262F29F6EBDB"
+          ]
+        }
       }
     }
   },
diff --git a/specification/synapse/resource-manager/Microsoft.Synapse/preview/2019-06-01-preview/workspace.json b/specification/synapse/resource-manager/Microsoft.Synapse/preview/2019-06-01-preview/workspace.json
index 5a4a4feaabb0..23e084e91246 100644
--- a/specification/synapse/resource-manager/Microsoft.Synapse/preview/2019-06-01-preview/workspace.json
+++ b/specification/synapse/resource-manager/Microsoft.Synapse/preview/2019-06-01-preview/workspace.json
@@ -841,28 +841,6 @@
           "description": "The identity of the workspace",
           "$ref": "#/definitions/ManagedIdentity"
         },
-        "managedVirtualNetworkSettings": {
-          "description": "Managed Virtual Network Settings",
-          "type": "object",
-          "properties": {
-            "preventDataExfiltration": {
-              "description": "Prevent Data Exfiltration",
-              "type": "boolean"
-            },
-            "linkedAccessCheckOnTargetResource": {
-              "description": "Linked Access Check On Target Resource",
-              "type": "boolean"
-            },
-            "allowedAadTenantIdsForLinking": {
-              "description": "Allowed Aad Tenant Ids For Linking",
-              "type": "array",
-              "items": {
-                "type": "string",
-                "description": "Tenant Id"
-              }
-            }
-          }
-        },
         "properties": {
           "description": "Workspace patch properties",
           "$ref": "#/definitions/WorkspacePatchProperties",
@@ -878,6 +856,10 @@
           "description": "SQL administrator login password",
           "type": "string"
         },
+        "managedVirtualNetworkSettings": {
+          "description": "Managed Virtual Network Settings",
+          "$ref": "#/definitions/ManagedVirtualNetworkSettings"
+        },
         "provisioningState": {
           "description": "Resource provisioning state",
           "type": "string",
diff --git a/specification/vmware/resource-manager/Microsoft.AVS/stable/2020-03-20/examples/Operations_List.json b/specification/vmware/resource-manager/Microsoft.AVS/stable/2020-03-20/examples/Operations_List.json
index 36fea5ade871..91e66c3b4daf 100644
--- a/specification/vmware/resource-manager/Microsoft.AVS/stable/2020-03-20/examples/Operations_List.json
+++ b/specification/vmware/resource-manager/Microsoft.AVS/stable/2020-03-20/examples/Operations_List.json
@@ -4,19 +4,521 @@
   },
   "responses": {
     "200": {
-      "body": [
-        {
-          "display": {
-            "description": "Creates a private cloud",
-            "operation": "Create Private Cloud",
-            "provider": "Azure VMware Solution",
-            "resource": "Private Cloud"
-          },
-          "name": "Microsoft.AVS/privateClouds/create",
-          "origin": "user,system"
-        }
-      ],
-      "nextLink": "string"
+      "headers": {},
+      "body": {
+        "value": [
+          {
+            "display": {
+              "description": "Lists operations available on Microsoft.AVS resource provider.",
+              "operation": "List available Microsoft.AVS operations",
+              "provider": "Microsoft.AVS",
+              "resource": "operations"
+            },
+            "isDataAction": false,
+            "name": "Microsoft.AVS/operations/read",
+            "origin": "user,system",
+            "properties": {}
+          },
+          {
+            "display": {
+              "description": "Register Subscription for Microsoft.AVS resource provider.",
+              "operation": "Register Subscription for Microsoft.AVS",
+              "provider": "Microsoft.AVS",
+              "resource": ""
+            },
+            "isDataAction": false,
+            "name": "Microsoft.AVS/register/action",
+            "origin": "user,system",
+            "properties": {}
+          },
+          {
+            "display": {
+              "description": "Unregister Subscription for Microsoft.AVS resource provider.",
+              "operation": "Unregister Subscription for Microsoft.AVS",
+              "provider": "Microsoft.AVS",
+              "resource": ""
+            },
+            "isDataAction": false,
+            "name": "Microsoft.AVS/unregister/action",
+            "origin": "user,system",
+            "properties": {}
+          },
+          {
+            "display": {
+              "description": "Checks if the privateCloud Name is available",
+              "operation": "Check Name Availability",
+              "provider": "Microsoft.AVS",
+              "resource": "checkNameAvailability"
+            },
+            "isDataAction": false,
+            "name": "Microsoft.AVS/checkNameAvailability/read",
+            "origin": "user,system",
+            "properties": {}
+          },
+          {
+            "display": {
+              "description": "Checks if the privateCloud Name is available",
+              "operation": "Check Name Availability",
+              "provider": "Microsoft.AVS",
+              "resource": "locations/checkNameAvailability"
+            },
+            "isDataAction": false,
+            "name": "Microsoft.AVS/locations/checkNameAvailability/read",
+            "origin": "user,system",
+            "properties": {}
+          },
+          {
+            "display": {
+              "description": "Checks if quota is available for the subscription",
+              "operation": "Check Quota Availability",
+              "provider": "Microsoft.AVS",
+              "resource": "locations/checkQuotaAvailability"
+            },
+            "isDataAction": false,
+            "name": "Microsoft.AVS/locations/checkQuotaAvailability/read",
+            "origin": "user,system",
+            "properties": {}
+          },
+          {
+            "display": {
+              "description": "Checks if trial is available for the subscription",
+              "operation": "Check Trial Availability",
+              "provider": "Microsoft.AVS",
+              "resource": "locations/checkTrialAvailability"
+            },
+            "isDataAction": false,
+            "name": "Microsoft.AVS/locations/checkTrialAvailability/read",
+            "origin": "user,system",
+            "properties": {}
+          },
+          {
+            "display": {
+              "description": "Registers the Microsoft Microsoft.AVS resource provider and enables creation of Private Clouds.",
+              "operation": "Register Microsoft.AVS resource provider.",
+              "provider": "Microsoft.AVS",
+              "resource": "privateClouds"
+            },
+            "isDataAction": false,
+            "name": "Microsoft.AVS/privateClouds/register/action",
+            "origin": "user,system",
+            "properties": {}
+          },
+          {
+            "display": {
+              "description": "Creates or updates a PrivateCloud resource.",
+              "operation": "Create or update a PrivateCloud.",
+              "provider": "Microsoft.AVS",
+              "resource": "privateClouds"
+            },
+            "isDataAction": false,
+            "name": "Microsoft.AVS/privateClouds/write",
+            "origin": "user,system",
+            "properties": {}
+          },
+          {
+            "display": {
+              "description": "Gets the settings for the specified PrivateCloud.",
+              "operation": "Read PrivateCloud settings",
+              "provider": "Microsoft.AVS",
+              "resource": "privateClouds"
+            },
+            "isDataAction": false,
+            "name": "Microsoft.AVS/privateClouds/read",
+            "origin": "user,system",
+            "properties": {}
+          },
+          {
+            "display": {
+              "description": "Delete a specific PrivateCloud.",
+              "operation": "Delete a PrivateCloud.",
+              "provider": "Microsoft.AVS",
+              "resource": "privateClouds"
+            },
+            "isDataAction": false,
+            "name": "Microsoft.AVS/privateClouds/delete",
+            "origin": "user,system",
+            "properties": {}
+          },
+          {
+            "display": {
+              "description": "Reads privateClouds operationstatuses.",
+              "operation": "Read privateClouds operationstatuses",
+              "provider": "Microsoft.AVS",
+              "resource": "privateClouds/operationstatuses"
+            },
+            "isDataAction": false,
+            "name": "Microsoft.AVS/privateClouds/operationstatuses/read",
+            "origin": "user,system",
+            "properties": {}
+          },
+          {
+            "display": {
+              "description": "Gets the cluster settings for a PrivateCloud cluster.",
+              "operation": "Read Cluster settings.",
+              "provider": "Microsoft.AVS",
+              "resource": "privateClouds/clusters"
+            },
+            "isDataAction": false,
+            "name": "Microsoft.AVS/privateClouds/clusters/read",
+            "origin": "user,system",
+            "properties": {}
+          },
+          {
+            "display": {
+              "description": "Create or update a PrivateCloud cluster resource.",
+              "operation": "Create or update a PrivateCloud cluster.",
+              "provider": "Microsoft.AVS",
+              "resource": "privateClouds/clusters"
+            },
+            "isDataAction": false,
+            "name": "Microsoft.AVS/privateClouds/clusters/write",
+            "origin": "user,system",
+            "properties": {}
+          },
+          {
+            "display": {
+              "description": "Delete a specific PrivateCloud cluster.",
+              "operation": "Delete a PriveCloud cluster.",
+              "provider": "Microsoft.AVS",
+              "resource": "privateClouds/clusters"
+            },
+            "isDataAction": false,
+            "name": "Microsoft.AVS/privateClouds/clusters/delete",
+            "origin": "user,system",
+            "properties": {}
+          },
+          {
+            "display": {
+              "description": "Reads privateClouds/clusters operationstatuses.",
+              "operation": "Read privateClouds/clusters operationstatuses",
+              "provider": "Microsoft.AVS",
+              "resource": "privateClouds/clusters/operationstatuses"
+            },
+            "isDataAction": false,
+            "name": "Microsoft.AVS/privateClouds/clusters/operationstatuses/read",
+            "origin": "user,system",
+            "properties": {}
+          },
+          {
+            "display": {
+              "description": "Reads privateClouds/clusters operationresults.",
+              "operation": "Read privateClouds/clusters operationresults",
+              "provider": "Microsoft.AVS",
+              "resource": "privateclouds/clusters/operationresults"
+            },
+            "isDataAction": false,
+            "name": "Microsoft.AVS/privateclouds/clusters/operationresults/read",
+            "origin": "user,system",
+            "properties": {}
+          },
+          {
+            "display": {
+              "description": "Reads privateClouds operationresults.",
+              "operation": "Read privateClouds operationresults",
+              "provider": "Microsoft.AVS",
+              "resource": "privateClouds/operationresults"
+            },
+            "isDataAction": false,
+            "name": "Microsoft.AVS/privateClouds/operationresults/read",
+            "origin": "user,system",
+            "properties": {}
+          },
+          {
+            "display": {
+              "description": "Gets the authorization settings for a PrivateCloud cluster.",
+              "operation": "Read Authorization settings.",
+              "provider": "Microsoft.AVS",
+              "resource": "privateClouds/authorizations"
+            },
+            "isDataAction": false,
+            "name": "Microsoft.AVS/privateClouds/authorizations/read",
+            "origin": "user,system",
+            "properties": {}
+          },
+          {
+            "display": {
+              "description": "Create or update a PrivateCloud authorization resource.",
+              "operation": "Create or update a PrivateCloud authorization.",
+              "provider": "Microsoft.AVS",
+              "resource": "privateClouds/authorizations"
+            },
+            "isDataAction": false,
+            "name": "Microsoft.AVS/privateClouds/authorizations/write",
+            "origin": "user,system",
+            "properties": {}
+          },
+          {
+            "display": {
+              "description": "Delete a specific PrivateCloud authorization.",
+              "operation": "Delete a PriveCloud authorization.",
+              "provider": "Microsoft.AVS",
+              "resource": "privateClouds/authorizations"
+            },
+            "isDataAction": false,
+            "name": "Microsoft.AVS/privateClouds/authorizations/delete",
+            "origin": "user,system",
+            "properties": {}
+          },
+          {
+            "display": {
+              "description": "Lists the AdminCredentials for privateClouds.",
+              "operation": "List privateClouds AdminCredentials",
+              "provider": "Microsoft.AVS",
+              "resource": "privateClouds"
+            },
+            "isDataAction": true,
+            "name": "Microsoft.AVS/privateClouds/listAdminCredentials/action",
+            "origin": "user,system",
+            "properties": {}
+          },
+          {
+            "display": {
+              "description": "Gets the hcxEnterpriseSites for a PrivateCloud.",
+              "operation": "Read hcxEnterpriseSites",
+              "provider": "Microsoft.AVS",
+              "resource": "privateClouds/hcxEnterpriseSites"
+            },
+            "isDataAction": false,
+            "name": "Microsoft.AVS/privateClouds/hcxEnterpriseSites/read",
+            "origin": "user,system",
+            "properties": {}
+          },
+          {
+            "display": {
+              "description": "Create or update a hcxEnterpriseSites.",
+              "operation": "Create or update a hcxEnterpriseSites",
+              "provider": "Microsoft.AVS",
+              "resource": "privateClouds/hcxEnterpriseSites"
+            },
+            "isDataAction": false,
+            "name": "Microsoft.AVS/privateClouds/hcxEnterpriseSites/write",
+            "origin": "user,system",
+            "properties": {}
+          },
+          {
+            "display": {
+              "description": "Delete a specific hcxEnterpriseSites.",
+              "operation": "Delete a hcxEnterpriseSites",
+              "provider": "Microsoft.AVS",
+              "resource": "privateClouds/hcxEnterpriseSites"
+            },
+            "isDataAction": false,
+            "name": "Microsoft.AVS/privateClouds/hcxEnterpriseSites/delete",
+            "origin": "user,system",
+            "properties": {}
+          },
+          {
+            "display": {
+              "description": "Gets the hostInstances for a PrivateCloud.",
+              "operation": "Read hostInstances",
+              "provider": "Microsoft.AVS",
+              "resource": "privateClouds/hostInstances"
+            },
+            "isDataAction": false,
+            "name": "Microsoft.AVS/privateClouds/hostInstances/read",
+            "origin": "user,system",
+            "properties": {}
+          },
+          {
+            "display": {
+              "description": "Create or update a hostInstances.",
+              "operation": "Create or update a hostInstances",
+              "provider": "Microsoft.AVS",
+              "resource": "privateClouds/hostInstances"
+            },
+            "isDataAction": false,
+            "name": "Microsoft.AVS/privateClouds/hostInstances/write",
+            "origin": "user,system",
+            "properties": {}
+          },
+          {
+            "display": {
+              "description": "Delete a specific hostInstances.",
+              "operation": "Delete a hostInstances",
+              "provider": "Microsoft.AVS",
+              "resource": "privateClouds/hostInstances"
+            },
+            "isDataAction": false,
+            "name": "Microsoft.AVS/privateClouds/hostInstances/delete",
+            "origin": "user,system",
+            "properties": {}
+          },
+          {
+            "display": {
+              "description": "Gets the available metrics for Private Cloud",
+              "operation": "Read Private Cloud metric definitions",
+              "provider": "Microsoft Azure Dedicated",
+              "resource": "privateClouds"
+            },
+            "isDataAction": false,
+            "name": "Microsoft.AVS/privateClouds/providers/Microsoft.Insights/metricDefinitions/read",
+            "origin": "system",
+            "properties": {
+              "serviceSpecification": {
+                "metricSpecifications": [
+                  {
+                    "aggregationType": "Average",
+                    "displayDescription": "The total amount of disk used in SDDC",
+                    "displayName": "Datastore disk used",
+                    "enableRegionalMdmAccount": "true",
+                    "name": "UsedLatest",
+                    "sourceMdmAccount": "AVSShoebox2",
+                    "sourceMdmNamespace": "Vsphere.Datastore.Disk",
+                    "supportedTimeGrainTypes": [
+                      "PT5M",
+                      "PT15M",
+                      "PT30M",
+                      "PT1H",
+                      "PT6H",
+                      "PT12H",
+                      "P1D"
+                    ],
+                    "unit": "Bytes"
+                  },
+                  {
+                    "aggregationType": "Average",
+                    "displayDescription": "The total capacity of disk in SDDC",
+                    "displayName": "Datastore disk total capacity",
+                    "enableRegionalMdmAccount": "true",
+                    "name": "CapacityLatest",
+                    "sourceMdmAccount": "AVSShoebox2",
+                    "sourceMdmNamespace": "Vsphere.Datastore.Disk",
+                    "supportedTimeGrainTypes": [
+                      "PT5M",
+                      "PT15M",
+                      "PT30M",
+                      "PT1H",
+                      "PT6H",
+                      "PT12H",
+                      "P1D"
+                    ],
+                    "unit": "Bytes"
+                  },
+                  {
+                    "aggregationType": "Average",
+                    "displayDescription": "Total amount of machine memory in cluster that is available",
+                    "displayName": "Average Effective Memory",
+                    "enableRegionalMdmAccount": "true",
+                    "name": "EffectiveMemAverage",
+                    "sourceMdmAccount": "AVSShoebox2",
+                    "sourceMdmNamespace": "Vsphere.Cluster.ClusterServices",
+                    "supportedTimeGrainTypes": [
+                      "PT5M",
+                      "PT15M",
+                      "PT30M",
+                      "PT1H",
+                      "PT6H",
+                      "PT12H",
+                      "P1D"
+                    ],
+                    "unit": "Bytes"
+                  },
+                  {
+                    "aggregationType": "Average",
+                    "displayDescription": "Total memory in cluster",
+                    "displayName": "Average Total Memory",
+                    "enableRegionalMdmAccount": "true",
+                    "name": "TotalMbAverage",
+                    "sourceMdmAccount": "AVSShoebox2",
+                    "sourceMdmNamespace": "Vsphere.Cluster.Mem",
+                    "supportedTimeGrainTypes": [
+                      "PT5M",
+                      "PT15M",
+                      "PT30M",
+                      "PT1H",
+                      "PT6H",
+                      "PT12H",
+                      "P1D"
+                    ],
+                    "unit": "Bytes"
+                  },
+                  {
+                    "aggregationType": "Average",
+                    "displayDescription": "Host physical memory consumed by the virtualization infrastructure",
+                    "displayName": "Average Memory Overhead",
+                    "enableRegionalMdmAccount": "true",
+                    "name": "OverheadAverage",
+                    "sourceMdmAccount": "AVSShoebox2",
+                    "sourceMdmNamespace": "Vsphere.Cluster.Mem",
+                    "supportedTimeGrainTypes": [
+                      "PT5M",
+                      "PT15M",
+                      "PT30M",
+                      "PT1H",
+                      "PT6H",
+                      "PT12H",
+                      "P1D"
+                    ],
+                    "unit": "Bytes"
+                  },
+                  {
+                    "aggregationType": "Average",
+                    "displayDescription": "Memory usage as percentage of total configured or available memory",
+                    "displayName": "Average Memory Usage",
+                    "enableRegionalMdmAccount": "true",
+                    "name": "UsageAverage",
+                    "sourceMdmAccount": "AVSShoebox2",
+                    "sourceMdmNamespace": "Vsphere.Cluster.Mem",
+                    "supportedTimeGrainTypes": [
+                      "PT5M",
+                      "PT15M",
+                      "PT30M",
+                      "PT1H",
+                      "PT6H",
+                      "PT12H",
+                      "P1D"
+                    ],
+                    "unit": "Percent"
+                  },
+                  {
+                    "aggregationType": "Average",
+                    "displayDescription": "Total available CPU resources in cluster",
+                    "displayName": "Effective CPU available",
+                    "enableRegionalMdmAccount": "true",
+                    "name": "EffectiveCpuAverage",
+                    "sourceMdmAccount": "AVSShoebox2",
+                    "sourceMdmNamespace": "Vsphere.Cluster.ClusterServices",
+                    "supportedTimeGrainTypes": [
+                      "PT5M",
+                      "PT15M",
+                      "PT30M",
+                      "PT1H",
+                      "PT6H",
+                      "PT12H",
+                      "P1D"
+                    ],
+                    "unit": "Percent"
+                  }
+                ]
+              }
+            }
+          },
+          {
+            "display": {
+              "description": "Gets the diagnostic setting for the resource",
+              "operation": "Read diagnostic setting",
+              "provider": "Microsoft.AVS",
+              "resource": "privateClouds"
+            },
+            "isDataAction": false,
+            "name": "Microsoft.AVS/privateClouds/providers/Microsoft.Insights/diagnosticSettings/read",
+            "origin": "system",
+            "properties": {}
+          },
+          {
+            "display": {
+              "description": "Creates or updates the diagnostic setting for the resource",
+              "operation": "Write diagnostic setting",
+              "provider": "Microsoft.AVS",
+              "resource": "privateClouds"
+            },
+            "isDataAction": false,
+            "name": "Microsoft.AVS/privateClouds/providers/Microsoft.Insights/diagnosticSettings/write",
+            "origin": "system",
+            "properties": {}
+          }
+        ]
+      }
     }
   }
 }
diff --git a/specification/vmware/resource-manager/Microsoft.AVS/stable/2020-03-20/vmware.json b/specification/vmware/resource-manager/Microsoft.AVS/stable/2020-03-20/vmware.json
index 1a8d82df26ce..f968128343d7 100644
--- a/specification/vmware/resource-manager/Microsoft.AVS/stable/2020-03-20/vmware.json
+++ b/specification/vmware/resource-manager/Microsoft.AVS/stable/2020-03-20/vmware.json
@@ -1213,6 +1213,7 @@
         "availableHosts": {
           "description": "Number of trial hosts available",
           "type": "integer",
+          "format": "int32",
           "readOnly": true
         }
       }
@@ -1226,6 +1227,7 @@
           "readOnly": true,
           "additionalProperties": {
             "type": "integer",
+            "format": "int32",
             "readOnly": true
           }
         },
@@ -1353,6 +1355,152 @@
               "readOnly": true
             }
           }
+        },
+        "isDataAction": {
+          "description": "Gets or sets a value indicating whether the operation is a data action or not",
+          "type": "boolean"
+        },
+        "origin": {
+          "description": "Origin of the operation",
+          "type": "string"
+        },
+        "properties": {
+          "$ref": "#/definitions/OperationProperties",
+          "description": "Properties of the operation"
+        }
+      }
+    },
+    "OperationProperties": {
+      "description": "Extra Operation properties",
+      "type": "object",
+      "properties": {
+        "serviceSpecification": {
+          "$ref": "#/definitions/ServiceSpecification",
+          "description": "Service specifications of the operation"
+        }
+      }
+    },
+    "ServiceSpecification": {
+      "description": "Service specification payload",
+      "type": "object",
+      "properties": {
+        "logSpecifications": {
+          "description": "Specifications of the Log for Azure Monitoring",
+          "uniqueItems": false,
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/LogSpecification"
+          }
+        },
+        "metricSpecifications": {
+          "description": "Specifications of the Metrics for Azure Monitoring",
+          "uniqueItems": false,
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/MetricSpecification"
+          }
+        }
+      }
+    },
+    "LogSpecification": {
+      "description": "Specifications of the Log for Azure Monitoring",
+      "type": "object",
+      "properties": {
+        "name": {
+          "description": "Name of the log",
+          "type": "string"
+        },
+        "displayName": {
+          "description": "Localized friendly display name of the log",
+          "type": "string"
+        },
+        "blobDuration": {
+          "description": "Blob duration of the log",
+          "type": "string"
+        }
+      }
+    },
+    "MetricSpecification": {
+      "description": "Specifications of the Metrics for Azure Monitoring",
+      "type": "object",
+      "properties": {
+        "name": {
+          "description": "Name of the metric",
+          "type": "string"
+        },
+        "displayName": {
+          "description": "Localized friendly display name of the metric",
+          "type": "string"
+        },
+        "displayDescription": {
+          "description": "Localized friendly description of the metric",
+          "type": "string"
+        },
+        "unit": {
+          "description": "Unit that makes sense for the metric",
+          "type": "string"
+        },
+        "category": {
+          "description": "Name of the metric category that the metric belongs to. A metric can only belong to a single category.",
+          "type": "string"
+        },
+        "aggregationType": {
+          "description": "Only provide one value for this field. Valid values: Average, Minimum, Maximum, Total, Count.",
+          "type": "string"
+        },
+        "supportedAggregationTypes": {
+          "description": "Supported aggregation types",
+          "uniqueItems": false,
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "supportedTimeGrainTypes": {
+          "description": "Supported time grain types",
+          "uniqueItems": false,
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "fillGapWithZero": {
+          "description": "Optional. If set to true, then zero will be returned for time duration where no metric is emitted/published.",
+          "type": "boolean"
+        },
+        "dimensions": {
+          "description": "Dimensions of the metric",
+          "uniqueItems": false,
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/MetricDimension"
+          }
+        },
+        "enableRegionalMdmAccount": {
+          "description": "Whether or not the service is using regional MDM accounts.",
+          "type": "string"
+        },
+        "sourceMdmAccount": {
+          "description": "The name of the MDM account.",
+          "type": "string"
+        },
+        "sourceMdmNamespace": {
+          "description": "The name of the MDM namespace.",
+          "type": "string"
+        }
+      }
+    },
+    "MetricDimension": {
+      "description": "Specifications of the Dimension of metrics",
+      "type": "object",
+      "properties": {
+        "name": {
+          "description": "Name of the dimension",
+          "type": "string"
+        },
+        "displayName": {
+          "description": "Localized friendly display name of the dimension",
+          "type": "string"
         }
       }
     },
@@ -1704,7 +1852,8 @@
       "properties": {
         "clusterSize": {
           "description": "The cluster size",
-          "type": "integer"
+          "type": "integer",
+          "format": "int32"
         }
       }
     },
@@ -1719,9 +1868,14 @@
         }
       ],
       "properties": {
+        "provisioningState": {
+          "description": "The state of the cluster provisioning",
+          "$ref": "#/definitions/ClusterProvisioningState"
+        },
         "clusterId": {
           "description": "The identity",
           "type": "integer",
+          "format": "int32",
           "readOnly": true
         },
         "hosts": {
@@ -1744,22 +1898,26 @@
       "properties": {
         "provisioningState": {
           "description": "The state of the cluster provisioning",
-          "type": "string",
-          "readOnly": true,
-          "enum": [
-            "Succeeded",
-            "Failed",
-            "Cancelled",
-            "Deleting",
-            "Updating"
-          ],
-          "x-ms-enum": {
-            "name": "ClusterProvisioningState",
-            "modelAsString": true
-          }
+          "$ref": "#/definitions/ClusterProvisioningState"
         }
       }
     },
+    "ClusterProvisioningState": {
+      "description": "The state of the cluster provisioning",
+      "type": "string",
+      "readOnly": true,
+      "enum": [
+        "Succeeded",
+        "Failed",
+        "Cancelled",
+        "Deleting",
+        "Updating"
+      ],
+      "x-ms-enum": {
+        "name": "ClusterProvisioningState",
+        "modelAsString": true
+      }
+    },
     "PrivateCloudList": {
       "description": "A paged list of private clouds",
       "properties": {
diff --git a/specification/vmware/resource-manager/readme.md b/specification/vmware/resource-manager/readme.md
index a381bf23160b..8d0c35ff08f9 100644
--- a/specification/vmware/resource-manager/readme.md
+++ b/specification/vmware/resource-manager/readme.md
@@ -38,6 +38,21 @@ directive:
   - suppress: R3010
     from: vmware.json
     reason: list by immediate parent operations are defined
+  - suppress: R3027
+    from: vmware.json
+    reasons: the PrivateClouds_List operation is by resource group
+  - suppress: R3018
+    from: vmware.json
+    where: $.definitions.Operation.properties.isDataAction
+    reason: standard property for Operation
+  - suppress: R3018
+    from: vmware.json
+    where: $.definitions.MetricSpecification.properties.fillGapWithZero
+    reason: standard property for MetricSpecification
+  - suppress: R2001
+    from: vmware.json
+    where: $.definitions.Operation.properties.properties
+    reason: x-ms-client-flatten not needed for Operation
 ```
 
 ### Tag: package-2019-08-09-preview
@@ -79,6 +94,17 @@ swagger-to-sdk:
       - node sdkauto_afterscript.js vmware/resource-manager
 ```
 
+## Suppression
+```
+directive:
+  - suppress: SECRET_PROPERTY
+    from: vmware.json
+    where:
+      - $.definitions.AdminCredentials.properties.nsxtPassword
+      - $.definitions.AdminCredentials.properties.vcenterPassword
+    reason: Secrets are OK to return in a POST response.
+```
+
 ## TypeScript
 
 See configuration in [readme.typescript.md](./readme.typescript.md)
diff --git a/specification/web/resource-manager/Microsoft.Web/stable/2020-06-01/CommonDefinitions.json b/specification/web/resource-manager/Microsoft.Web/stable/2020-06-01/CommonDefinitions.json
index c8188882a811..948428d153c3 100644
--- a/specification/web/resource-manager/Microsoft.Web/stable/2020-06-01/CommonDefinitions.json
+++ b/specification/web/resource-manager/Microsoft.Web/stable/2020-06-01/CommonDefinitions.json
@@ -2149,6 +2149,15 @@
             "read"
           ]
         },
+        "vnetRouteAllEnabled": {
+          "description": "Virtual Network Route All enabled. This causes all outbound traffic to have Virtual Network Security Groups and User Defined Routes applied.",
+          "type": "boolean"
+        },
+        "vnetPrivatePortsCount": {
+          "format": "int32",
+          "description": "The number of private ports assigned to this app. These will be assigned dynamically on runtime.",
+          "type": "integer"
+        },
         "cors": {
           "$ref": "#/definitions/CorsSettings",
           "description": "Cross-Origin Resource Sharing (CORS) settings."
diff --git a/specification/workloadmonitor/resource-manager/Microsoft.WorkloadMonitor/preview/2020-01-13-preview/Microsoft.WorkloadMonitor.json b/specification/workloadmonitor/resource-manager/Microsoft.WorkloadMonitor/preview/2020-01-13-preview/Microsoft.WorkloadMonitor.json
index 8366d5ef07b6..8161165e45a8 100644
--- a/specification/workloadmonitor/resource-manager/Microsoft.WorkloadMonitor/preview/2020-01-13-preview/Microsoft.WorkloadMonitor.json
+++ b/specification/workloadmonitor/resource-manager/Microsoft.WorkloadMonitor/preview/2020-01-13-preview/Microsoft.WorkloadMonitor.json
@@ -15,7 +15,7 @@
   "paths": {
     "/providers/Microsoft.WorkloadMonitor/operations": {
       "get": {
-        "summary": "Gets a list of possible operations",
+        "summary": "Get a list of all available REST API operations.",
         "operationId": "Operations_List",
         "produces": [
           "application/json"
@@ -30,7 +30,7 @@
         ],
         "responses": {
           "200": {
-            "description": "list of operations",
+            "description": "The list of available REST API operations.",
             "schema": {
               "$ref": "#/definitions/OperationList"
             }
@@ -38,7 +38,7 @@
           "default": {
             "description": "Error response describing why the operation failed.",
             "schema": {
-              "$ref": "#/definitions/DefaultError"
+              "$ref": "#/definitions/ErrorResponse"
             }
           }
         },
@@ -49,10 +49,10 @@
         }
       }
     },
-    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceNamespace}/{resourceType}/{resourceName}/providers/Microsoft.WorkloadMonitor/monitors": {
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{providerName}/{resourceCollectionName}/{resourceName}/providers/Microsoft.WorkloadMonitor/monitors": {
       "get": {
-        "summary": "Get list of a monitors of a resource (with optional filter).",
-        "operationId": "Monitors_List",
+        "summary": "Get the current health status of all monitors of a virtual machine. Optional parameters: $expand (retrieve the monitor's evidence and configuration) and $filter (filter by monitor name).",
+        "operationId": "HealthMonitors_List",
         "produces": [
           "application/json"
         ],
@@ -70,16 +70,16 @@
             "$ref": "#/parameters/resourceGroupName"
           },
           {
-            "$ref": "#/parameters/resourceNamespace"
+            "$ref": "#/parameters/providerName"
           },
           {
-            "$ref": "#/parameters/resourceType"
+            "$ref": "#/parameters/resourceCollectionName"
           },
           {
             "$ref": "#/parameters/resourceName"
           },
           {
-            "$ref": "#/parameters/filter"
+            "$ref": "#/parameters/monitorNameFilter"
           },
           {
             "$ref": "#/parameters/expand"
@@ -87,15 +87,15 @@
         ],
         "responses": {
           "200": {
-            "description": "Search results matching criteria",
+            "description": "The health monitors matching the specified criteria.",
             "schema": {
-              "$ref": "#/definitions/MonitorList"
+              "$ref": "#/definitions/HealthMonitorList"
             }
           },
           "default": {
             "description": "Error response describing why the operation failed.",
             "schema": {
-              "$ref": "#/definitions/DefaultError"
+              "$ref": "#/definitions/ErrorResponse"
             }
           }
         },
@@ -112,10 +112,10 @@
         }
       }
     },
-    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceNamespace}/{resourceType}/{resourceName}/providers/Microsoft.WorkloadMonitor/monitors/{monitorId}": {
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{providerName}/{resourceCollectionName}/{resourceName}/providers/Microsoft.WorkloadMonitor/monitors/{monitorId}": {
       "get": {
-        "summary": "Get the current status of a monitor of a resource.",
-        "operationId": "Monitors_Get",
+        "summary": "Get the current health status of a monitor of a virtual machine. Optional parameter: $expand (retrieve the monitor's evidence and configuration).",
+        "operationId": "HealthMonitors_Get",
         "produces": [
           "application/json"
         ],
@@ -130,10 +130,10 @@
             "$ref": "#/parameters/resourceGroupName"
           },
           {
-            "$ref": "#/parameters/resourceNamespace"
+            "$ref": "#/parameters/providerName"
           },
           {
-            "$ref": "#/parameters/resourceType"
+            "$ref": "#/parameters/resourceCollectionName"
           },
           {
             "$ref": "#/parameters/resourceName"
@@ -147,15 +147,15 @@
         ],
         "responses": {
           "200": {
-            "description": "search results matching criteria",
+            "description": "The health monitor matching the specified criteria.",
             "schema": {
-              "$ref": "#/definitions/Monitor"
+              "$ref": "#/definitions/HealthMonitor"
             }
           },
           "default": {
             "description": "Error response describing why the operation failed.",
             "schema": {
-              "$ref": "#/definitions/DefaultError"
+              "$ref": "#/definitions/ErrorResponse"
             }
           }
         },
@@ -169,10 +169,10 @@
         }
       }
     },
-    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceNamespace}/{resourceType}/{resourceName}/providers/Microsoft.WorkloadMonitor/monitors/{monitorId}/history": {
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{providerName}/{resourceCollectionName}/{resourceName}/providers/Microsoft.WorkloadMonitor/monitors/{monitorId}/history": {
       "get": {
-        "summary": "Get history of a monitor of a resource (with optional filter).",
-        "operationId": "Monitors_ListStateChanges",
+        "summary": "Get the health state changes of a monitor of a virtual machine within the provided time window (default is the last 24 hours). Optional parameters: $expand (retrieve the monitor's evidence and configuration) and $filter (filter by heartbeat condition).",
+        "operationId": "HealthMonitors_ListStateChanges",
         "x-ms-pageable": {
           "nextLinkName": "nextLink"
         },
@@ -190,10 +190,10 @@
             "$ref": "#/parameters/resourceGroupName"
           },
           {
-            "$ref": "#/parameters/resourceNamespace"
+            "$ref": "#/parameters/providerName"
           },
           {
-            "$ref": "#/parameters/resourceType"
+            "$ref": "#/parameters/resourceCollectionName"
           },
           {
             "$ref": "#/parameters/resourceName"
@@ -202,7 +202,7 @@
             "$ref": "#/parameters/monitorId"
           },
           {
-            "$ref": "#/parameters/filter"
+            "$ref": "#/parameters/heartbeatFilter"
           },
           {
             "$ref": "#/parameters/expand"
@@ -210,7 +210,7 @@
           {
             "in": "query",
             "name": "startTimestampUtc",
-            "description": "The start Timestamp for the desired history",
+            "description": "The start of the time window.",
             "required": false,
             "type": "string",
             "format": "date-time"
@@ -218,7 +218,7 @@
           {
             "in": "query",
             "name": "endTimestampUtc",
-            "description": "The end Timestamp for the desired history",
+            "description": "The end of the time window.",
             "required": false,
             "type": "string",
             "format": "date-time"
@@ -226,35 +226,35 @@
         ],
         "responses": {
           "200": {
-            "description": "search results matching criteria",
+            "description": "The health monitor state changes matching the specified criteria.",
             "schema": {
-              "$ref": "#/definitions/MonitorStateChangeList"
+              "$ref": "#/definitions/HealthMonitorStateChangeList"
             }
           },
           "default": {
             "description": "Error response describing why the operation failed.",
             "schema": {
-              "$ref": "#/definitions/DefaultError"
+              "$ref": "#/definitions/ErrorResponse"
             }
           }
         },
         "x-ms-examples": {
-          "Get monitor history with default values": {
+          "Get monitor state changes with default values": {
             "$ref": "./examples/MonitorHistory_GetDefault.json"
           },
-          "Get monitor list with filtered values": {
+          "Get monitor state changes with filtered values": {
             "$ref": "./examples/MonitorHistory_GetFiltered.json"
           },
-          "Get monitor history with expanded values": {
+          "Get monitor state changes with expanded values": {
             "$ref": "./examples/MonitorHistory_GetExpanded.json"
           }
         }
       }
     },
-    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceNamespace}/{resourceType}/{resourceName}/providers/Microsoft.WorkloadMonitor/monitors/{monitorId}/history/{timestampUnix}": {
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{providerName}/{resourceCollectionName}/{resourceName}/providers/Microsoft.WorkloadMonitor/monitors/{monitorId}/history/{timestampUnix}": {
       "get": {
-        "summary": "Get the status of a monitor at a specific timestamp in history.",
-        "operationId": "Monitors_GetStateChange",
+        "summary": "Get the health state change of a monitor of a virtual machine at the provided timestamp. Optional parameter: $expand (retrieve the monitor's evidence and configuration).",
+        "operationId": "HealthMonitors_GetStateChange",
         "produces": [
           "application/json"
         ],
@@ -269,10 +269,10 @@
             "$ref": "#/parameters/resourceGroupName"
           },
           {
-            "$ref": "#/parameters/resourceNamespace"
+            "$ref": "#/parameters/providerName"
           },
           {
-            "$ref": "#/parameters/resourceType"
+            "$ref": "#/parameters/resourceCollectionName"
           },
           {
             "$ref": "#/parameters/resourceName"
@@ -289,15 +289,15 @@
         ],
         "responses": {
           "200": {
-            "description": "search results matching criteria",
+            "description": "The health monitor state change matching the specified criteria.",
             "schema": {
-              "$ref": "#/definitions/MonitorStateChange"
+              "$ref": "#/definitions/HealthMonitorStateChange"
             }
           },
           "default": {
             "description": "Error response describing why the operation failed.",
             "schema": {
-              "$ref": "#/definitions/DefaultError"
+              "$ref": "#/definitions/ErrorResponse"
             }
           }
         },
@@ -316,7 +316,7 @@
     "api-version": {
       "name": "api-version",
       "in": "query",
-      "description": "The API version to use for this operation.",
+      "description": "The API version to use for the operation.",
       "required": true,
       "type": "string",
       "enum": [
@@ -328,7 +328,7 @@
       "name": "subscriptionId",
       "required": true,
       "type": "string",
-      "description": "The subscriptionId of the resource",
+      "description": "The subscription Id of the virtual machine.",
       "x-ms-parameter-location": "method"
     },
     "resourceGroupName": {
@@ -336,23 +336,23 @@
       "name": "resourceGroupName",
       "required": true,
       "type": "string",
-      "description": "The resourceGroupName of the resource",
+      "description": "The resource group of the virtual machine.",
       "x-ms-parameter-location": "method"
     },
-    "resourceNamespace": {
+    "providerName": {
       "in": "path",
-      "name": "resourceNamespace",
+      "name": "providerName",
       "required": true,
       "type": "string",
-      "description": "The resourceNamespace of the resource",
+      "description": "The provider name (ex: Microsoft.Compute for virtual machines).",
       "x-ms-parameter-location": "method"
     },
-    "resourceType": {
+    "resourceCollectionName": {
       "in": "path",
-      "name": "resourceType",
+      "name": "resourceCollectionName",
       "required": true,
       "type": "string",
-      "description": "The resourceType of the resource",
+      "description": "The resource collection name (ex: virtualMachines for virtual machines).",
       "x-ms-parameter-location": "method"
     },
     "resourceName": {
@@ -360,13 +360,13 @@
       "name": "resourceName",
       "required": true,
       "type": "string",
-      "description": "The resourceType of the resource",
+      "description": "The name of the virtual machine.",
       "x-ms-parameter-location": "method"
     },
     "monitorId": {
       "in": "path",
       "name": "monitorId",
-      "description": "The monitorId of the resource (url encoded)",
+      "description": "The monitor Id of the virtual machine.",
       "required": true,
       "type": "string",
       "x-ms-parameter-location": "method"
@@ -374,15 +374,23 @@
     "timestampUnix": {
       "in": "path",
       "name": "timestampUnix",
-      "description": "The timestamp of the state change (Unix format)",
+      "description": "The timestamp of the state change (unix format).",
       "required": true,
       "type": "string",
       "x-ms-parameter-location": "method"
     },
-    "filter": {
+    "monitorNameFilter": {
+      "name": "$filter",
+      "in": "query",
+      "description": "Optionally filter by monitor name. Example: $filter=monitorName eq 'logical-disks|C:|disk-free-space-mb.'",
+      "required": false,
+      "type": "string",
+      "x-ms-parameter-location": "method"
+    },
+    "heartbeatFilter": {
       "name": "$filter",
       "in": "query",
-      "description": "list example: $filter=monitorName eq 'logical-disks|C:|disk-free-space-mb'; history example: $filter=isHeartbeat eq false",
+      "description": "Optionally filter by heartbeat condition. Example: $filter=isHeartbeat eq false.",
       "required": false,
       "type": "string",
       "x-ms-parameter-location": "method"
@@ -390,62 +398,56 @@
     "expand": {
       "name": "$expand",
       "in": "query",
-      "description": "ex: $expand=evidence,configuration",
+      "description": "Optionally expand the monitor’s evidence and/or configuration. Example: $expand=evidence,configuration.",
       "required": false,
       "type": "string",
       "x-ms-parameter-location": "method"
     }
   },
   "definitions": {
-    "MonitorStateChangeList": {
-      "title": "Monitor History",
-      "description": "The monitor history of a monitor",
+    "HealthMonitorStateChangeList": {
+      "title": "Information about the health state changes of the monitor within the provided time window.",
       "type": "object",
       "readOnly": true,
       "properties": {
         "value": {
-          "title": "State Change Array",
-          "description": "Array of state change transitions.",
+          "description": "Array of health state changes within the specified time window.",
           "type": "array",
           "items": {
-            "$ref": "#/definitions/MonitorStateChange"
+            "$ref": "#/definitions/HealthMonitorStateChange"
           }
         },
         "nextLink": {
-          "title": "Pageable next link",
-          "description": "Link to next page if list is too long.",
+          "description": "Link to next page if the list is too long.",
           "type": "string"
         }
       }
     },
-    "MonitorList": {
-      "title": "Monitor List",
-      "description": "Basic information about the current status of a monitor.",
+    "HealthMonitorList": {
+      "title": "Information about the current health statuses of the monitors.",
       "type": "object",
       "readOnly": true,
       "properties": {
         "value": {
-          "title": "Monitor Array",
-          "description": "Array of monitors.",
+          "description": "Array of health monitors of the virtual machine.",
           "type": "array",
           "items": {
-            "$ref": "#/definitions/Monitor"
+            "$ref": "#/definitions/HealthMonitor"
           }
         },
         "nextLink": {
-          "title": "Pageable next link",
-          "description": "Link to next page if list is too long.",
+          "description": "Link to next page if the list is too long.",
           "type": "string"
         }
       }
     },
-    "Monitor": {
-      "title": "Monitor Status",
-      "description": "Information about a monitor.",
+    "HealthMonitor": {
+      "title": "Information about the monitor’s current health status.",
       "properties": {
         "properties": {
+          "description": "Properties of the monitor's health status.",
           "x-ms-client-flatten": true,
-          "$ref": "#/definitions/MonitorProperties"
+          "$ref": "#/definitions/HealthMonitorProperties"
         }
       },
       "allOf": [
@@ -460,107 +462,92 @@
       "properties": {
         "id": {
           "readOnly": true,
-          "title": "Arm ID",
-          "description": "Arm ID of this monitor.",
+          "description": "The resource Id.",
           "type": "string",
           "example": "/subscriptions/bc27da3b-3ba2-4e00-a6ec-1fde64aa1e21/resourceGroups/tugamidiAlerts/providers/Microsoft.Compute/virtualMachines/linuxEUS/providers/Microsoft.WorkloadMonitor/monitors/logical-disks|C@3A"
         },
         "name": {
           "readOnly": true,
-          "title": "Url-encoded monitor name",
-          "description": "Url-encoded monitor name.",
+          "description": "The resource name.",
           "type": "string",
           "example": "logical-disks|C@3A"
         },
         "type": {
           "readOnly": true,
-          "title": "Resource type",
-          "description": "Type of ARM resource.",
+          "description": "The resource type.",
           "type": "string",
           "example": "Microsoft.WorkloadMonitor/monitors"
         }
       },
       "x-ms-azure-resource": true
     },
-    "MonitorProperties": {
-      "title": "Monitor Properties",
+    "HealthMonitorProperties": {
       "description": "Properties of the monitor.",
       "type": "object",
       "properties": {
         "monitorName": {
-          "title": "Monitor Name",
-          "description": "Human-readable name of this monitor.",
+          "description": "Human-readable name of the monitor.",
           "type": "string",
           "example": "logical-disks|C:"
         },
         "monitorType": {
-          "title": "Monitor Type",
-          "description": "Type of this monitor.",
+          "description": "Type of the monitor.",
           "type": "string",
           "example": "logical-disks|*"
         },
         "monitoredObject": {
-          "title": "Monitored Object",
-          "description": "Dynamic monitored object of this monitor.",
+          "description": "Dynamic monitored object of the monitor.",
           "type": "string",
           "example": "C:"
         },
         "parentMonitorName": {
-          "title": "Parent Monitor Name",
-          "description": "Name of this monitor's parent.",
+          "description": "Name of the parent monitor.",
           "type": "string",
           "example": "logical-disks"
         },
         "previousMonitorState": {
-          "title": "Health State",
-          "description": "Current health state of this monitor.",
+          "description": "Previous health state of the monitor.",
           "$ref": "#/definitions/HealthState",
           "example": "Healthy"
         },
         "currentMonitorState": {
-          "title": "Health State",
-          "description": "Current health state of this monitor.",
+          "description": "Current health state of the monitor.",
           "$ref": "#/definitions/HealthState",
           "example": "Healthy"
         },
         "evaluationTimestamp": {
-          "title": "Last Evaluated",
-          "description": "Timestamp that this monitor was last evaluated.",
+          "description": "Timestamp of the monitor's last health evaluation.",
           "type": "string",
           "example": "2020-02-15T20:20:18.5765757Z"
         },
         "currentStateFirstObservedTimestamp": {
-          "title": "Last State Change",
-          "description": "Timestamp of this monitor's last state change.",
+          "description": "Timestamp of the monitor's last health state change.",
           "type": "string",
           "example": "2020-02-15T20:20:1.5765757Z"
         },
         "lastReportedTimestamp": {
-          "title": "Last Reported",
-          "description": "Timestamp of this monitor's last reported state.",
+          "description": "Timestamp of the monitor's last reported health state.",
           "type": "string",
           "example": "2020-02-15T20:20:1.5765757Z"
         },
         "evidence": {
-          "title": "Evidence",
-          "description": "Evidence of this monitor's last state change.",
+          "description": "Evidence validating the monitor's current health state.",
           "type": "object"
         },
         "monitorConfiguration": {
-          "title": "Configuration",
-          "description": "Configuration settings at the time of this monitor's last state change.",
+          "description": "The configuration settings at the time of the monitor's health evaluation.",
           "type": "object"
         }
       }
     },
-    "MonitorStateChange": {
-      "title": "Monitor State Change",
-      "description": "Information about a state transition of a monitor.",
+    "HealthMonitorStateChange": {
+      "title": "Information about the monitor’s health state change at the provided timestamp.",
       "type": "object",
       "properties": {
         "properties": {
+          "description": "Properties of the monitor's state change.",
           "x-ms-client-flatten": true,
-          "$ref": "#/definitions/MonitorStateChangeProperties"
+          "$ref": "#/definitions/HealthMonitorStateChangeProperties"
         }
       },
       "allOf": [
@@ -569,75 +556,66 @@
         }
       ]
     },
-    "MonitorStateChangeProperties": {
-      "title": "Monitor Properties",
+    "HealthMonitorStateChangeProperties": {
       "description": "Properties of the monitor.",
       "type": "object",
       "properties": {
         "monitorName": {
-          "title": "Monitor Name",
-          "description": "Human-readable name of this monitor.",
+          "description": "Human-readable name of the monitor.",
           "type": "string",
           "example": "logical-disks|C:"
         },
         "monitorType": {
-          "title": "Monitor Type",
-          "description": "Type of this monitor.",
+          "description": "Type of the monitor.",
           "type": "string",
           "example": "logical-disks|*"
         },
         "monitoredObject": {
-          "title": "Monitored Object",
-          "description": "Dynamic monitored object of this monitor.",
+          "description": "Dynamic monitored object of the monitor.",
           "type": "string",
           "example": "C:"
         },
         "evaluationTimestamp": {
-          "title": "Timestamp",
-          "description": "Timestamp of that this event ocurred.",
+          "description": "Timestamp of the monitor's last health evaluation.",
           "type": "string",
           "example": "2020-01-08T20:20:18.5765757Z"
         },
         "currentStateFirstObservedTimestamp": {
-          "title": "Timestamp",
-          "description": "Timestamp of that this health state first ocurred.",
+          "description": "Timestamp of the monitor's last health state change.",
           "type": "string",
           "example": "2020-01-08T20:20:18.5765757Z"
         },
         "previousMonitorState": {
-          "title": "Previous Health State",
-          "description": "Previous health state.",
+          "description": "Previous health state of the monitor.",
           "$ref": "#/definitions/HealthState",
           "example": "Healthy"
         },
         "currentMonitorState": {
-          "title": "New Health State",
-          "description": "New health state.",
+          "description": "Current health state of the monitor.",
           "$ref": "#/definitions/HealthState",
           "example": "Critical"
         },
         "evidence": {
-          "title": "Evidence",
-          "description": "Evidence of this monitor's last state change.",
+          "description": "Evidence validating the monitor's current health state.",
           "type": "object"
         },
         "monitorConfiguration": {
-          "title": "Configuration",
-          "description": "Configuration settings at the time of this monitor's last state change.",
+          "description": "The configuration settings at the time of the monitor's health evaluation.",
           "type": "object"
         }
       }
     },
     "HealthState": {
-      "title": "Health State",
-      "description": "Possible health states of a monitor.",
+      "title": "One of health states - healthy, critical, warning, unknown, none, disabled.",
       "type": "string",
       "readOnly": true,
       "enum": [
         "Healthy",
         "Critical",
         "Warning",
-        "Unknown"
+        "Unknown",
+        "Disabled",
+        "None"
       ],
       "x-ms-enum": {
         "name": "HealthState",
@@ -645,29 +623,25 @@
       }
     },
     "OperationList": {
-      "title": "Operation List",
-      "description": "List of possible operations.",
+      "title": "List of available REST API operations",
       "type": "object",
       "readOnly": true,
       "properties": {
         "value": {
-          "title": "Operations Array",
-          "description": "Array of possible operations.",
+          "description": "Array of available REST API operations.",
           "type": "array",
           "items": {
             "$ref": "#/definitions/Operation"
           }
         },
         "nextLink": {
-          "title": "Pageable next link",
-          "description": "Link to next page if list is too long.",
+          "description": "Link to next page if the list is too long.",
           "type": "string"
         }
       }
     },
     "Operation": {
-      "title": "Operation",
-      "description": "Operation supported by the resource provider.",
+      "title": "Operation supported by the resource provider.",
       "type": "object",
       "readOnly": true,
       "required": [
@@ -677,14 +651,12 @@
       ],
       "properties": {
         "name": {
-          "title": "Operation Name",
-          "description": "Name of the operation.",
+          "description": "The name of the operation being performed on this particular object.",
           "type": "string",
           "example": "Microsoft.WorkloadMonitor/monitors/read"
         },
         "display": {
-          "title": "Display",
-          "description": "The properties of the resource operation.",
+          "description": "The localized display information for this particular operation or action.",
           "type": "object",
           "required": [
             "provider",
@@ -694,47 +666,40 @@
           ],
           "properties": {
             "provider": {
-              "title": "Provider Name",
-              "description": "Provider name of this operation.",
+              "description": "Operation resource provider name.",
               "type": "string",
               "example": "Microsoft.WorkloadMonitor"
             },
             "resource": {
-              "title": "Resource Name",
-              "description": "Resource name of this operation.",
+              "description": "Resource on which the operation is performed.",
               "type": "string",
               "example": "Monitors"
             },
             "operation": {
-              "title": "Operation Name",
-              "description": "Operation name of the operation.",
+              "description": "Human-readable, friendly name for the operation.",
               "type": "string",
               "example": "Get monitors"
             },
             "description": {
-              "title": "Description",
-              "description": "Description of the operation.",
+              "description": "Operation description.",
               "type": "string",
               "example": "Gets monitors and their current health state"
             }
           }
         },
         "origin": {
-          "title": "Origin",
-          "description": "The origin of the operation.",
+          "description": "The intended executor of the operation.",
           "type": "string",
           "example": "user, system"
         }
       }
     },
-    "DefaultError": {
-      "title": "Default Error",
-      "description": "Error body contract.",
+    "ErrorResponse": {
+      "title": "Error response",
       "type": "object",
       "properties": {
         "error": {
-          "title": "error details",
-          "description": "Details about the error",
+          "description": "Error info.",
           "type": "object",
           "properties": {
             "code": {
@@ -746,7 +711,7 @@
               "type": "string"
             },
             "details": {
-              "description": "Details of the error.",
+              "description": "Error details.",
               "type": "array",
               "items": {
                 "$ref": "#/definitions/ErrorDetails"
@@ -757,16 +722,15 @@
       }
     },
     "ErrorDetails": {
-      "title": "Error Details",
-      "description": "Error details of the error body contract.",
+      "title": "Error details",
       "type": "object",
       "properties": {
         "code": {
-          "description": "Property level error code.",
+          "description": "Error code identifying the specific error.",
           "type": "string"
         },
         "message": {
-          "description": "Human-readable representation of property-level error.",
+          "description": "A human-readable error message.",
           "type": "string"
         }
       }
diff --git a/specification/workloadmonitor/resource-manager/Microsoft.WorkloadMonitor/preview/2020-01-13-preview/examples/MonitorHistory_GetDefault.json b/specification/workloadmonitor/resource-manager/Microsoft.WorkloadMonitor/preview/2020-01-13-preview/examples/MonitorHistory_GetDefault.json
index 45677764722b..0f955d216545 100644
--- a/specification/workloadmonitor/resource-manager/Microsoft.WorkloadMonitor/preview/2020-01-13-preview/examples/MonitorHistory_GetDefault.json
+++ b/specification/workloadmonitor/resource-manager/Microsoft.WorkloadMonitor/preview/2020-01-13-preview/examples/MonitorHistory_GetDefault.json
@@ -2,58 +2,58 @@
   "parameters": {
     "subscriptionId": "bc27da3b-3ba2-4e00-a6ec-1fde64aa1e21",
     "resourceGroupName": "tugamidiAlerts",
-    "resourceNamespace": "Microsoft.Compute",
-    "resourceType": "virtualMachines",
+    "providerName": "Microsoft.Compute",
+    "resourceCollectionName": "virtualMachines",
     "resourceName": "linuxEUS",
     "monitorId": "logical-disks|C@3A",
     "api-version": "2020-01-13-preview",
-    "startTimestampUtc": "2020-01-04T20:20:18.5765757Z",
-    "endTimestampUtc": "2020-01-09T20:20:18.5765757Z"
+    "startTimestampUtc": "2020-10-19T19:24:14Z",
+    "endTimestampUtc": "2020-10-20T01:24:14Z"
   },
   "responses": {
     "200": {
       "body": {
         "value": [
           {
-            "id": "/subscriptions/bc27da3b-3ba2-4e00-a6ec-1fde64aa1e21/resourceGroups/tugamidiAlerts/providers/Microsoft.Compute/virtualMachines/linuxEUS/providers/Microsoft.WorkloadMonitor/monitors/logical-disks|C@3A|disk-free-space-mb/history/1578514818",
+            "id": "/subscriptions/bc27da3b-3ba2-4e00-a6ec-1fde64aa1e21/resourceGroups/tugamidiAlerts/providers/Microsoft.Compute/virtualMachines/linuxEUS/providers/Microsoft.WorkloadMonitor/monitors/logical-disks|C@3A|free-space/history/1578514818",
             "name": "1578514818",
             "type": "Microsoft.WorkloadMonitor/monitors/history",
             "properties": {
-              "monitorName": "logical-disks|C:|disk-free-space-mb",
-              "monitorType": "logical-disks|*|disk-free-space-mb",
+              "monitorName": "logical-disks|C:|free-space",
+              "monitorType": "logical-disks|*|free-space",
               "monitoredObject": "C:",
-              "evaluationTimestamp": "2020-01-07T20:20:18.5765757Z",
-              "currentStateFirstObservedTimestamp": "2020-01-07T20:20:18.5765757Z",
-              "previousMonitorState": "Warning",
-              "currentMonitorState": "Critical"
+              "evaluationTimestamp": "2020-10-19T19:24:14Z",
+              "currentStateFirstObservedTimestamp": "2020-10-19T19:24:14Z",
+              "previousMonitorState": "Healthy",
+              "currentMonitorState": "Warning"
             }
           },
           {
-            "id": "/subscriptions/bc27da3b-3ba2-4e00-a6ec-1fde64aa1e21/resourceGroups/tugamidiAlerts/providers/Microsoft.Compute/virtualMachines/linuxEUS/providers/Microsoft.WorkloadMonitor/monitors/logical-disks|C@3A|disk-free-space-mb/history/1578255618",
+            "id": "/subscriptions/bc27da3b-3ba2-4e00-a6ec-1fde64aa1e21/resourceGroups/tugamidiAlerts/providers/Microsoft.Compute/virtualMachines/linuxEUS/providers/Microsoft.WorkloadMonitor/monitors/logical-disks|C@3A|free-space/history/1578255618",
             "name": "1578255618",
             "type": "Microsoft.WorkloadMonitor/monitors/history",
             "properties": {
-              "monitorName": "logical-disks|C:|disk-free-space-mb",
-              "monitorType": "logical-disks|*|disk-free-space-mb",
+              "monitorName": "logical-disks|C:|free-space",
+              "monitorType": "logical-disks|*|free-space",
               "monitoredObject": "C:",
-              "evaluationTimestamp": "2020-01-06T20:20:18.5765757Z",
-              "currentStateFirstObservedTimestamp": "2020-01-05T20:20:18.5765757Z",
+              "evaluationTimestamp": "2020-10-20T07:24:14Z",
+              "currentStateFirstObservedTimestamp": "2020-10-20T01:24:14Z",
               "previousMonitorState": "Warning",
               "currentMonitorState": "Warning"
             }
           },
           {
-            "id": "/subscriptions/bc27da3b-3ba2-4e00-a6ec-1fde64aa1e21/resourceGroups/tugamidiAlerts/providers/Microsoft.Compute/virtualMachines/linuxEUS/providers/Microsoft.WorkloadMonitor/monitors/logical-disks|C@3A|disk-free-space-mb/history/1578255618",
+            "id": "/subscriptions/bc27da3b-3ba2-4e00-a6ec-1fde64aa1e21/resourceGroups/tugamidiAlerts/providers/Microsoft.Compute/virtualMachines/linuxEUS/providers/Microsoft.WorkloadMonitor/monitors/logical-disks|C@3A|free-space/history/1578255618",
             "name": "1578255618",
             "type": "Microsoft.WorkloadMonitor/monitors/history",
             "properties": {
-              "monitorName": "logical-disks|C:|disk-free-space-mb",
-              "monitorType": "logical-disks|*|disk-free-space-mb",
+              "monitorName": "logical-disks|C:|free-space",
+              "monitorType": "logical-disks|*|free-space",
               "monitoredObject": "C:",
-              "evaluationTimestamp": "2020-01-05T20:20:18.5765757Z",
-              "currentStateFirstObservedTimestamp": "2020-01-05T20:20:18.5765757Z",
-              "previousMonitorState": "Healthy",
-              "currentMonitorState": "Warning"
+              "evaluationTimestamp": "2020-10-20T01:24:14Z",
+              "currentStateFirstObservedTimestamp": "2020-10-20T01:24:14Z",
+              "previousMonitorState": "Warning",
+              "currentMonitorState": "Critical"
             }
           }
         ],
diff --git a/specification/workloadmonitor/resource-manager/Microsoft.WorkloadMonitor/preview/2020-01-13-preview/examples/MonitorHistory_GetExpanded.json b/specification/workloadmonitor/resource-manager/Microsoft.WorkloadMonitor/preview/2020-01-13-preview/examples/MonitorHistory_GetExpanded.json
index a4b82ea11c1f..04db19d38389 100644
--- a/specification/workloadmonitor/resource-manager/Microsoft.WorkloadMonitor/preview/2020-01-13-preview/examples/MonitorHistory_GetExpanded.json
+++ b/specification/workloadmonitor/resource-manager/Microsoft.WorkloadMonitor/preview/2020-01-13-preview/examples/MonitorHistory_GetExpanded.json
@@ -2,13 +2,13 @@
   "parameters": {
     "subscriptionId": "bc27da3b-3ba2-4e00-a6ec-1fde64aa1e21",
     "resourceGroupName": "tugamidiAlerts",
-    "resourceNamespace": "Microsoft.Compute",
-    "resourceType": "virtualMachines",
+    "providerName": "Microsoft.Compute",
+    "resourceCollectionName": "virtualMachines",
     "resourceName": "linuxEUS",
     "monitorId": "logical-disks|C@3A",
     "api-version": "2020-01-13-preview",
-    "startTimestampUtc": "2020-01-04T20:20:18.5765757Z",
-    "endTimestampUtc": "2020-01-09T20:20:18.5765757Z",
+    "startTimestampUtc": "2020-10-19T07:22:25.824Z",
+    "endTimestampUtc": "2020-10-21T13:22:25.822Z",
     "$expand": "evidence,configuration"
   },
   "responses": {
@@ -16,96 +16,153 @@
       "body": {
         "value": [
           {
-            "id": "/subscriptions/bc27da3b-3ba2-4e00-a6ec-1fde64aa1e21/resourceGroups/tugamidiAlerts/providers/Microsoft.Compute/virtualMachines/linuxEUS/providers/Microsoft.WorkloadMonitor/monitors/logical-disks|C@3A|disk-free-space-mb/history/1578514818",
+            "id": "/subscriptions/bc27da3b-3ba2-4e00-a6ec-1fde64aa1e21/resourceGroups/tugamidiAlerts/providers/Microsoft.Compute/virtualMachines/linuxEUS/providers/Microsoft.WorkloadMonitor/monitors/logical-disks|C@3A|free-space/history/1578514818",
             "name": "1578514818",
             "type": "Microsoft.WorkloadMonitor/monitors/history",
             "properties": {
-              "monitorName": "logical-disks|C:|disk-free-space-mb",
-              "monitorType": "logical-disks|*|disk-free-space-mb",
+              "monitorName": "logical-disks|C:|free-space",
+              "monitorType": "logical-disks|*|free-space",
               "monitoredObject": "C:",
-              "evaluationTimestamp": "2020-01-07T20:20:18.5765757Z",
-              "currentStateFirstObservedTimestamp": "2020-01-07T20:20:18.5765757Z",
-              "previousMonitorState": "Warning",
-              "currentMonitorState": "Critical",
+              "evaluationTimestamp": "2020-10-20T07:24:14Z",
+              "currentStateFirstObservedTimestamp": "2020-10-20T07:24:14Z",
+              "previousMonitorState": "Critical",
+              "currentMonitorState": "Warning",
               "evidence": {
                 "reason": {
-                  "code": 2100,
-                  "message": "Collected samples met critical condition for this monitor."
+                  "code": 2200,
+                  "message": "Collected samples met warning condition for this monitor."
                 },
                 "samples": [
                   {
-                    "value": 1361.019,
-                    "timestamp": "2020-03-24T20:51:00.6058242Z"
+                    "value": 7.9,
+                    "timestamp": "2020-10-20T07:21:25.823Z"
                   },
                   {
-                    "value": 1261.019,
-                    "timestamp": "2020-03-24T21:51:00.6058242Z"
+                    "value": 5.7,
+                    "timestamp": "2020-10-20T07:22:25.824Z"
                   }
                 ]
               },
-              "monitorConfiguration": {}
+              "monitorConfiguration": {
+                "isEnabled": true,
+                "monitorConfiguration": {
+                  "criticalCondition": {
+                    "isEnabled": true,
+                    "operator": "<",
+                    "threshold": 5
+                  },
+                  "warningCondition": {
+                    "isEnabled": true,
+                    "operator": "<",
+                    "threshold": 8
+                  },
+                  "evaluationType": "Max",
+                  "evaluationFrequencySecs": 60,
+                  "lookbackSecs": 120,
+                  "maxSamples": 1,
+                  "minSamples": 1
+                }
+              }
             }
           },
           {
-            "id": "/subscriptions/bc27da3b-3ba2-4e00-a6ec-1fde64aa1e21/resourceGroups/tugamidiAlerts/providers/Microsoft.Compute/virtualMachines/linuxEUS/providers/Microsoft.WorkloadMonitor/monitors/logical-disks|C@3A|disk-free-space-mb/history/1578255618",
+            "id": "/subscriptions/bc27da3b-3ba2-4e00-a6ec-1fde64aa1e21/resourceGroups/tugamidiAlerts/providers/Microsoft.Compute/virtualMachines/linuxEUS/providers/Microsoft.WorkloadMonitor/monitors/logical-disks|C@3A|free-space/history/1578255618",
             "name": "1578255618",
             "type": "Microsoft.WorkloadMonitor/monitors/history",
             "properties": {
-              "monitorName": "logical-disks|C:|disk-free-space-mb",
-              "monitorType": "logical-disks|*|disk-free-space-mb",
+              "monitorName": "logical-disks|C:|free-space",
+              "monitorType": "logical-disks|*|free-space",
               "monitoredObject": "C:",
-              "evaluationTimestamp": "2020-01-06T20:20:18.5765757Z",
-              "currentStateFirstObservedTimestamp": "2020-01-05T20:20:18.5765757Z",
+              "evaluationTimestamp": "2020-10-20T13:24:14Z",
+              "currentStateFirstObservedTimestamp": "2020-10-19T19:24:14Z",
               "previousMonitorState": "Warning",
               "currentMonitorState": "Warning",
               "evidence": {
                 "reason": {
-                  "code": 2100,
-                  "message": "Collected samples met critical condition for this monitor."
+                  "code": 2200,
+                  "message": "Collected samples met warning condition for this monitor."
                 },
                 "samples": [
                   {
-                    "value": 1361.019,
-                    "timestamp": "2020-03-24T20:51:00.6058242Z"
+                    "value": 6.7,
+                    "timestamp": "2020-10-19T19:21:25.822Z"
                   },
                   {
-                    "value": 1261.019,
-                    "timestamp": "2020-03-24T21:51:00.6058242Z"
+                    "value": 7,
+                    "timestamp": "2020-10-19T19:22:25.822Z"
                   }
                 ]
               },
-              "monitorConfiguration": {}
+              "monitorConfiguration": {
+                "isEnabled": true,
+                "monitorConfiguration": {
+                  "criticalCondition": {
+                    "isEnabled": true,
+                    "operator": "<",
+                    "threshold": 5
+                  },
+                  "warningCondition": {
+                    "isEnabled": true,
+                    "operator": "<",
+                    "threshold": 8
+                  },
+                  "evaluationType": "Max",
+                  "evaluationFrequencySecs": 60,
+                  "lookbackSecs": 120,
+                  "maxSamples": 1,
+                  "minSamples": 1
+                }
+              }
             }
           },
           {
-            "id": "/subscriptions/bc27da3b-3ba2-4e00-a6ec-1fde64aa1e21/resourceGroups/tugamidiAlerts/providers/Microsoft.Compute/virtualMachines/linuxEUS/providers/Microsoft.WorkloadMonitor/monitors/logical-disks|C@3A|disk-free-space-mb/history/1578255618",
+            "id": "/subscriptions/bc27da3b-3ba2-4e00-a6ec-1fde64aa1e21/resourceGroups/tugamidiAlerts/providers/Microsoft.Compute/virtualMachines/linuxEUS/providers/Microsoft.WorkloadMonitor/monitors/logical-disks|C@3A|free-space/history/1578255618",
             "name": "1578255618",
             "type": "Microsoft.WorkloadMonitor/monitors/history",
             "properties": {
-              "monitorName": "logical-disks|C:|disk-free-space-mb",
-              "monitorType": "logical-disks|*|disk-free-space-mb",
+              "monitorName": "logical-disks|C:|free-space",
+              "monitorType": "logical-disks|*|free-space",
               "monitoredObject": "C:",
-              "evaluationTimestamp": "2020-01-05T20:20:18.5765757Z",
-              "currentStateFirstObservedTimestamp": "2020-01-05T20:20:18.5765757Z",
-              "previousMonitorState": "Healthy",
-              "currentMonitorState": "Warning",
+              "evaluationTimestamp": "2020-10-20T19:24:14Z",
+              "currentStateFirstObservedTimestamp": "2020-10-20T19:24:14Z",
+              "previousMonitorState": "Warning",
+              "currentMonitorState": "Healthy",
               "evidence": {
                 "reason": {
-                  "code": 2100,
-                  "message": "Collected samples met critical condition for this monitor."
+                  "code": 2300,
+                  "message": "Collected samples met healthy condition for this monitor."
                 },
                 "samples": [
                   {
-                    "value": 1361.019,
-                    "timestamp": "2020-03-24T20:51:00.6058242Z"
+                    "value": 9,
+                    "timestamp": "2020-10-19T19:21:25.822Z"
                   },
                   {
-                    "value": 1261.019,
-                    "timestamp": "2020-03-24T21:51:00.6058242Z"
+                    "value": 10.6,
+                    "timestamp": "2020-10-19T19:22:25.822Z"
                   }
                 ]
               },
-              "monitorConfiguration": {}
+              "monitorConfiguration": {
+                "isEnabled": true,
+                "monitorConfiguration": {
+                  "criticalCondition": {
+                    "isEnabled": true,
+                    "operator": "<",
+                    "threshold": 5
+                  },
+                  "warningCondition": {
+                    "isEnabled": true,
+                    "operator": "<",
+                    "threshold": 8
+                  },
+                  "evaluationType": "Max",
+                  "evaluationFrequencySecs": 60,
+                  "lookbackSecs": 120,
+                  "maxSamples": 1,
+                  "minSamples": 1
+                }
+              }
             }
           }
         ],
diff --git a/specification/workloadmonitor/resource-manager/Microsoft.WorkloadMonitor/preview/2020-01-13-preview/examples/MonitorHistory_GetFiltered.json b/specification/workloadmonitor/resource-manager/Microsoft.WorkloadMonitor/preview/2020-01-13-preview/examples/MonitorHistory_GetFiltered.json
index 304e91636dfd..7924e3d8bdd3 100644
--- a/specification/workloadmonitor/resource-manager/Microsoft.WorkloadMonitor/preview/2020-01-13-preview/examples/MonitorHistory_GetFiltered.json
+++ b/specification/workloadmonitor/resource-manager/Microsoft.WorkloadMonitor/preview/2020-01-13-preview/examples/MonitorHistory_GetFiltered.json
@@ -2,10 +2,10 @@
   "parameters": {
     "subscriptionId": "bc27da3b-3ba2-4e00-a6ec-1fde64aa1e21",
     "resourceGroupName": "tugamidiAlerts",
-    "resourceNamespace": "Microsoft.Compute",
-    "resourceType": "virtualMachines",
+    "providerName": "Microsoft.Compute",
+    "resourceCollectionName": "virtualMachines",
     "resourceName": "linuxEUS",
-    "monitorId": "logical-disks|C@3A|disk-free-space-mb",
+    "monitorId": "logical-disks|C@3A|free-space",
     "api-version": "2020-01-13-preview",
     "startTimestampUtc": "2020-01-04T20:20:18.5765757Z",
     "endTimestampUtc": "2020-01-09T20:20:18.5765757Z",
@@ -16,31 +16,31 @@
       "body": {
         "value": [
           {
-            "id": "/subscriptions/bc27da3b-3ba2-4e00-a6ec-1fde64aa1e21/resourceGroups/tugamidiAlerts/providers/Microsoft.Compute/virtualMachines/linuxEUS/providers/Microsoft.WorkloadMonitor/monitors/logical-disks|C@3A|disk-free-space-mb/history/1578514818",
+            "id": "/subscriptions/bc27da3b-3ba2-4e00-a6ec-1fde64aa1e21/resourceGroups/tugamidiAlerts/providers/Microsoft.Compute/virtualMachines/linuxEUS/providers/Microsoft.WorkloadMonitor/monitors/logical-disks|C@3A|free-space/history/1578514818",
             "name": "1578514818",
             "type": "Microsoft.WorkloadMonitor/monitors/history",
             "properties": {
-              "monitorName": "logical-disks|C:|disk-free-space-mb",
-              "monitorType": "logical-disks|*|disk-free-space-mb",
+              "monitorName": "logical-disks|C:|free-space",
+              "monitorType": "logical-disks|*|free-space",
               "monitoredObject": "C:",
-              "evaluationTimestamp": "2020-01-07T20:20:18.5765757Z",
-              "currentStateFirstObservedTimestamp": "2020-01-07T20:20:18.5765757Z",
-              "previousMonitorState": "Warning",
-              "currentMonitorState": "Critical"
+              "evaluationTimestamp": "2020-10-20T07:24:14Z",
+              "currentStateFirstObservedTimestamp": "2020-10-20T07:24:14Z",
+              "previousMonitorState": "Critical",
+              "currentMonitorState": "Warning"
             }
           },
           {
-            "id": "/subscriptions/bc27da3b-3ba2-4e00-a6ec-1fde64aa1e21/resourceGroups/tugamidiAlerts/providers/Microsoft.Compute/virtualMachines/linuxEUS/providers/Microsoft.WorkloadMonitor/monitors/logical-disks|C@3A|disk-free-space-mb/history/1578255618",
+            "id": "/subscriptions/bc27da3b-3ba2-4e00-a6ec-1fde64aa1e21/resourceGroups/tugamidiAlerts/providers/Microsoft.Compute/virtualMachines/linuxEUS/providers/Microsoft.WorkloadMonitor/monitors/logical-disks|C@3A|free-space/history/1578255618",
             "name": "1578255618",
             "type": "Microsoft.WorkloadMonitor/monitors/history",
             "properties": {
-              "monitorName": "logical-disks|C:|disk-free-space-mb",
-              "monitorType": "logical-disks|*|disk-free-space-mb",
+              "monitorName": "logical-disks|C:|free-space",
+              "monitorType": "logical-disks|*|free-space",
               "monitoredObject": "C:",
-              "evaluationTimestamp": "2020-01-05T20:20:18.5765757Z",
-              "currentStateFirstObservedTimestamp": "2020-01-05T20:20:18.5765757Z",
-              "previousMonitorState": "Healthy",
-              "currentMonitorState": "Warning"
+              "evaluationTimestamp": "2020-10-20T19:24:14Z",
+              "currentStateFirstObservedTimestamp": "2020-10-20T19:24:14Z",
+              "previousMonitorState": "Warning",
+              "currentMonitorState": "Healthy"
             }
           }
         ],
diff --git a/specification/workloadmonitor/resource-manager/Microsoft.WorkloadMonitor/preview/2020-01-13-preview/examples/MonitorList_GetDefault.json b/specification/workloadmonitor/resource-manager/Microsoft.WorkloadMonitor/preview/2020-01-13-preview/examples/MonitorList_GetDefault.json
index 0d9aa2903374..205bb2726e01 100644
--- a/specification/workloadmonitor/resource-manager/Microsoft.WorkloadMonitor/preview/2020-01-13-preview/examples/MonitorList_GetDefault.json
+++ b/specification/workloadmonitor/resource-manager/Microsoft.WorkloadMonitor/preview/2020-01-13-preview/examples/MonitorList_GetDefault.json
@@ -2,8 +2,8 @@
   "parameters": {
     "subscriptionId": "bc27da3b-3ba2-4e00-a6ec-1fde64aa1e21",
     "resourceGroupName": "tugamidiAlerts",
-    "resourceNamespace": "Microsoft.Compute",
-    "resourceType": "virtualMachines",
+    "providerName": "Microsoft.Compute",
+    "resourceCollectionName": "virtualMachines",
     "resourceName": "linuxEUS",
     "api-version": "2020-01-13-preview"
   },
@@ -60,12 +60,12 @@
             }
           },
           {
-            "id": "/subscriptions/bc27da3b-3ba2-4e00-a6ec-1fde64aa1e21/resourceGroups/tugamidiAlerts/providers/Microsoft.Compute/virtualMachines/linuxEUS/providers/Microsoft.WorkloadMonitor/monitors/logical-disks|C@3A|disk-free-space-mb",
-            "name": "logical-disks|C@3A|disk-free-space-mb",
+            "id": "/subscriptions/bc27da3b-3ba2-4e00-a6ec-1fde64aa1e21/resourceGroups/tugamidiAlerts/providers/Microsoft.Compute/virtualMachines/linuxEUS/providers/Microsoft.WorkloadMonitor/monitors/logical-disks|C@3A|free-space",
+            "name": "logical-disks|C@3A|free-space",
             "type": "Microsoft.WorkloadMonitor/monitors",
             "properties": {
-              "monitorName": "logical-disks|C:|disk-free-space-mb",
-              "monitorType": "logical-disks|*|disk-free-space-mb",
+              "monitorName": "logical-disks|C:|free-space",
+              "monitorType": "logical-disks|*|free-space",
               "monitoredObject": "C:",
               "parentMonitorName": "logical-disks|C:",
               "evaluationTimestamp": "2020-02-15T20:20:18.5765757Z",
@@ -76,12 +76,12 @@
             }
           },
           {
-            "id": "/subscriptions/bc27da3b-3ba2-4e00-a6ec-1fde64aa1e21/resourceGroups/tugamidiAlerts/providers/Microsoft.Compute/virtualMachines/linuxEUS/providers/Microsoft.WorkloadMonitor/monitors/cpu-utilization-percentage",
-            "name": "cpu-utilization-percentage",
+            "id": "/subscriptions/bc27da3b-3ba2-4e00-a6ec-1fde64aa1e21/resourceGroups/tugamidiAlerts/providers/Microsoft.Compute/virtualMachines/linuxEUS/providers/Microsoft.WorkloadMonitor/monitors/cpu-utilization",
+            "name": "cpu-utilization",
             "type": "Microsoft.WorkloadMonitor/monitors",
             "properties": {
-              "monitorName": "cpu-utilization-percentage",
-              "monitorType": "cpu-utilization-percentage",
+              "monitorName": "cpu-utilization",
+              "monitorType": "cpu-utilization",
               "monitoredObject": "",
               "parentMonitorName": "root",
               "evaluationTimestamp": "2020-02-15T20:20:18.5765757Z",
@@ -108,12 +108,12 @@
             }
           },
           {
-            "id": "/subscriptions/bc27da3b-3ba2-4e00-a6ec-1fde64aa1e21/resourceGroups/tugamidiAlerts/providers/Microsoft.Compute/virtualMachines/linuxEUS/providers/Microsoft.WorkloadMonitor/monitors/available-mb",
-            "name": "available-mb",
+            "id": "/subscriptions/bc27da3b-3ba2-4e00-a6ec-1fde64aa1e21/resourceGroups/tugamidiAlerts/providers/Microsoft.Compute/virtualMachines/linuxEUS/providers/Microsoft.WorkloadMonitor/monitors/memory|available",
+            "name": "memory|available",
             "type": "Microsoft.WorkloadMonitor/monitors",
             "properties": {
-              "monitorName": "memory|available-mb",
-              "monitorType": "memory|available-mb",
+              "monitorName": "memory|available",
+              "monitorType": "memory|available",
               "monitoredObject": "",
               "parentMonitorName": "memory",
               "evaluationTimestamp": "2020-02-15T20:20:18.5765757Z",
diff --git a/specification/workloadmonitor/resource-manager/Microsoft.WorkloadMonitor/preview/2020-01-13-preview/examples/MonitorList_GetExpanded.json b/specification/workloadmonitor/resource-manager/Microsoft.WorkloadMonitor/preview/2020-01-13-preview/examples/MonitorList_GetExpanded.json
index e9ae8b79d179..c03b49ea8fbb 100644
--- a/specification/workloadmonitor/resource-manager/Microsoft.WorkloadMonitor/preview/2020-01-13-preview/examples/MonitorList_GetExpanded.json
+++ b/specification/workloadmonitor/resource-manager/Microsoft.WorkloadMonitor/preview/2020-01-13-preview/examples/MonitorList_GetExpanded.json
@@ -2,8 +2,8 @@
   "parameters": {
     "subscriptionId": "bc27da3b-3ba2-4e00-a6ec-1fde64aa1e21",
     "resourceGroupName": "tugamidiAlerts",
-    "resourceNamespace": "Microsoft.Compute",
-    "resourceType": "virtualMachines",
+    "providerName": "Microsoft.Compute",
+    "resourceCollectionName": "virtualMachines",
     "resourceName": "linuxEUS",
     "api-version": "2020-01-13-preview",
     "$expand": "evidence,configuration"
@@ -21,13 +21,37 @@
               "monitorType": "root",
               "monitoredObject": "",
               "parentMonitorName": "",
-              "evaluationTimestamp": "2020-02-15T20:20:18.5765757Z",
-              "currentStateFirstObservedTimestamp": "2020-02-15T20:20:1.5765757Z",
-              "lastReportedTimestamp": "2020-02-15T20:20:18.5765757Z",
+              "evaluationTimestamp": "2020-10-20T16:05:12Z",
+              "currentStateFirstObservedTimestamp": "2020-09-15T17:01:46Z",
+              "lastReportedTimestamp": "2020-10-20T16:05:12Z",
               "previousMonitorState": "Critical",
               "currentMonitorState": "Critical",
-              "evidence": {},
-              "monitorConfiguration": {}
+              "evidence": {
+                "memberMonitors": [
+                  {
+                    "monitorName": "logical-disks",
+                    "timestamp": "2020-10-20T13:24:14.742Z",
+                    "state": "critical"
+                  },
+                  {
+                    "monitorName": "memory",
+                    "timestamp": "2020-10-20T13:24:14.742Z",
+                    "state": "healthy"
+                  },
+                  {
+                    "monitorName": "cpu-utilization",
+                    "timestamp": "2020-10-20T13:24:14.742Z",
+                    "state": "warning"
+                  }
+                ],
+                "reason": {
+                  "Message": "Aggregate monitor state evaluated to the worst state of its member monitors.",
+                  "Code": 1100
+                }
+              },
+              "monitorConfiguration": {
+                "isEnabled": true
+              }
             }
           },
           {
@@ -39,13 +63,27 @@
               "monitorType": "logical-disks",
               "monitoredObject": "",
               "parentMonitorName": "root",
-              "evaluationTimestamp": "2020-02-15T20:20:18.5765757Z",
-              "currentStateFirstObservedTimestamp": "2020-02-15T20:20:1.5765757Z",
-              "lastReportedTimestamp": "2020-02-15T20:20:18.5765757Z",
+              "evaluationTimestamp": "2020-10-20T13:24:14Z",
+              "currentStateFirstObservedTimestamp": "2020-09-15T17:01:46Z",
+              "lastReportedTimestamp": "2020-10-20T16:05:12Z",
               "previousMonitorState": "Critical",
               "currentMonitorState": "Critical",
-              "evidence": {},
-              "monitorConfiguration": {}
+              "evidence": {
+                "memberMonitors": [
+                  {
+                    "monitorName": "logical-disks|C:",
+                    "timestamp": "2020-10-20T13:24:14.742Z",
+                    "state": "critical"
+                  }
+                ],
+                "reason": {
+                  "Message": "Aggregate monitor state evaluated to the worst state of its member monitors.",
+                  "Code": 1100
+                }
+              },
+              "monitorConfiguration": {
+                "isEnabled": true
+              }
             }
           },
           {
@@ -57,49 +95,126 @@
               "monitorType": "logical-disks|*",
               "monitoredObject": "C:",
               "parentMonitorName": "logical-disks",
-              "evaluationTimestamp": "2020-02-15T20:20:18.5765757Z",
-              "currentStateFirstObservedTimestamp": "2020-02-15T20:20:1.5765757Z",
-              "lastReportedTimestamp": "2020-02-15T20:20:18.5765757Z",
+              "evaluationTimestamp": "2020-10-20T13:24:14Z",
+              "currentStateFirstObservedTimestamp": "2020-09-07T21:28:44Z",
+              "lastReportedTimestamp": "2020-10-20T16:05:12Z",
               "previousMonitorState": "Critical",
               "currentMonitorState": "Critical",
-              "evidence": {},
-              "monitorConfiguration": {}
+              "evidence": {
+                "memberMonitors": [
+                  {
+                    "monitorName": "logical-disks|C:|free-space",
+                    "timestamp": "2020-10-20T13:24:14.742Z",
+                    "state": "critical"
+                  }
+                ],
+                "reason": {
+                  "Message": "Aggregate monitor state evaluated to the worst state of its member monitors.",
+                  "Code": 1100
+                }
+              },
+              "monitorConfiguration": {
+                "isEnabled": true
+              }
             }
           },
           {
-            "id": "/subscriptions/bc27da3b-3ba2-4e00-a6ec-1fde64aa1e21/resourceGroups/tugamidiAlerts/providers/Microsoft.Compute/virtualMachines/linuxEUS/providers/Microsoft.WorkloadMonitor/monitors/logical-disks|C@3A|disk-free-space-mb",
-            "name": "logical-disks|C@3A|disk-free-space-mb",
+            "id": "/subscriptions/bc27da3b-3ba2-4e00-a6ec-1fde64aa1e21/resourceGroups/tugamidiAlerts/providers/Microsoft.Compute/virtualMachines/linuxEUS/providers/Microsoft.WorkloadMonitor/monitors/logical-disks|C@3A|free-space",
+            "name": "logical-disks|C@3A|free-space",
             "type": "Microsoft.WorkloadMonitor/monitors",
             "properties": {
-              "monitorName": "logical-disks|C:|disk-free-space-mb",
-              "monitorType": "logical-disks|*|disk-free-space-mb",
+              "monitorName": "logical-disks|C:|free-space",
+              "monitorType": "logical-disks|*|free-space",
               "monitoredObject": "C:",
               "parentMonitorName": "logical-disks|C:",
-              "evaluationTimestamp": "2020-02-15T20:20:18.5765757Z",
-              "currentStateFirstObservedTimestamp": "2020-02-15T20:20:1.5765757Z",
-              "lastReportedTimestamp": "2020-02-15T20:20:18.5765757Z",
+              "evaluationTimestamp": "2020-10-20T13:24:14Z",
+              "currentStateFirstObservedTimestamp": "2020-09-07T21:28:44Z",
+              "lastReportedTimestamp": "2020-10-20T16:05:12Z",
               "previousMonitorState": "Critical",
               "currentMonitorState": "Critical",
-              "evidence": {},
-              "monitorConfiguration": {}
+              "evidence": {
+                "reason": {
+                  "Message": "Collected samples met critical condition for this monitor.",
+                  "Code": 2100
+                },
+                "samples": [
+                  {
+                    "timestamp": "2020-10-20T13:23:25.823Z",
+                    "value": 4
+                  }
+                ]
+              },
+              "monitorConfiguration": {
+                "isEnabled": true,
+                "monitorConfiguration": {
+                  "criticalCondition": {
+                    "isEnabled": true,
+                    "operator": "<",
+                    "threshold": 5
+                  },
+                  "evaluationType": "Max",
+                  "evaluationFrequencySecs": 60,
+                  "lookbackSecs": 120,
+                  "maxSamples": 1,
+                  "minSamples": 1
+                }
+              }
             }
           },
           {
-            "id": "/subscriptions/bc27da3b-3ba2-4e00-a6ec-1fde64aa1e21/resourceGroups/tugamidiAlerts/providers/Microsoft.Compute/virtualMachines/linuxEUS/providers/Microsoft.WorkloadMonitor/monitors/cpu-utilization-percentage",
-            "name": "cpu-utilization-percentage",
+            "id": "/subscriptions/bc27da3b-3ba2-4e00-a6ec-1fde64aa1e21/resourceGroups/tugamidiAlerts/providers/Microsoft.Compute/virtualMachines/linuxEUS/providers/Microsoft.WorkloadMonitor/monitors/cpu-utilization",
+            "name": "cpu-utilization",
             "type": "Microsoft.WorkloadMonitor/monitors",
             "properties": {
-              "monitorName": "cpu-utilization-percentage",
-              "monitorType": "cpu-utilization-percentage",
+              "monitorName": "cpu-utilization",
+              "monitorType": "cpu-utilization",
               "monitoredObject": "",
               "parentMonitorName": "root",
-              "evaluationTimestamp": "2020-02-15T20:20:18.5765757Z",
-              "currentStateFirstObservedTimestamp": "2020-02-15T20:20:1.5765757Z",
-              "lastReportedTimestamp": "2020-02-15T20:20:18.5765757Z",
+              "evaluationTimestamp": "2020-10-20T13:24:14Z",
+              "currentStateFirstObservedTimestamp": "2020-09-07T21:30:28Z",
+              "lastReportedTimestamp": "2020-10-20T16:05:12Z",
               "previousMonitorState": "Warning",
               "currentMonitorState": "Warning",
-              "evidence": {},
-              "monitorConfiguration": {}
+              "evidence": {
+                "reason": {
+                  "Message": "Collected samples met warning condition for this monitor.",
+                  "Code": 2200
+                },
+                "samples": [
+                  {
+                    "timestamp": "2020-10-20T13:21:25.819Z",
+                    "value": 75
+                  },
+                  {
+                    "timestamp": "2020-10-20T13:22:25.822Z",
+                    "value": 80
+                  },
+                  {
+                    "timestamp": "2020-10-20T13:23:25.82Z",
+                    "value": 83
+                  }
+                ]
+              },
+              "monitorConfiguration": {
+                "isEnabled": true,
+                "monitorConfiguration": {
+                  "criticalCondition": {
+                    "isEnabled": true,
+                    "operator": ">",
+                    "threshold": 90
+                  },
+                  "warningCondition": {
+                    "isEnabled": true,
+                    "operator": ">",
+                    "threshold": 70
+                  },
+                  "evaluationType": "Min",
+                  "evaluationFrequencySecs": 60,
+                  "lookbackSecs": 240,
+                  "maxSamples": 3,
+                  "minSamples": 2
+                }
+              }
             }
           },
           {
@@ -111,31 +226,78 @@
               "monitorType": "memory",
               "monitoredObject": "",
               "parentMonitorName": "root",
-              "evaluationTimestamp": "2020-02-15T20:20:18.5765757Z",
-              "currentStateFirstObservedTimestamp": "2020-02-15T20:20:1.5765757Z",
-              "lastReportedTimestamp": "2020-02-15T20:20:18.5765757Z",
+              "evaluationTimestamp": "2020-10-20T13:24:14Z",
+              "currentStateFirstObservedTimestamp": "2020-09-07T21:29:28Z",
+              "lastReportedTimestamp": "2020-10-20T16:05:12Z",
               "previousMonitorState": "Healthy",
               "currentMonitorState": "Healthy",
-              "evidence": {},
-              "monitorConfiguration": {}
+              "evidence": {
+                "memberMonitors": [
+                  {
+                    "monitorName": "memory|available",
+                    "timestamp": "2020-10-20T13:24:14.742Z",
+                    "state": "healthy"
+                  }
+                ],
+                "reason": {
+                  "Message": "Aggregate monitor state evaluated to the worst state of its member monitors.",
+                  "Code": 1100
+                }
+              },
+              "monitorConfiguration": {
+                "isEnabled": true
+              }
             }
           },
           {
-            "id": "/subscriptions/bc27da3b-3ba2-4e00-a6ec-1fde64aa1e21/resourceGroups/tugamidiAlerts/providers/Microsoft.Compute/virtualMachines/linuxEUS/providers/Microsoft.WorkloadMonitor/monitors/available-mb",
-            "name": "available-mb",
+            "id": "/subscriptions/bc27da3b-3ba2-4e00-a6ec-1fde64aa1e21/resourceGroups/tugamidiAlerts/providers/Microsoft.Compute/virtualMachines/linuxEUS/providers/Microsoft.WorkloadMonitor/monitors/memory|available",
+            "name": "memory|available",
             "type": "Microsoft.WorkloadMonitor/monitors",
             "properties": {
-              "monitorName": "memory|available-mb",
-              "monitorType": "memory|available-mb",
+              "monitorName": "memory|available",
+              "monitorType": "memory|available",
               "monitoredObject": "",
               "parentMonitorName": "memory",
-              "evaluationTimestamp": "2020-02-15T20:20:18.5765757Z",
-              "currentStateFirstObservedTimestamp": "2020-02-15T20:20:1.5765757Z",
-              "lastReportedTimestamp": "2020-02-15T20:20:18.5765757Z",
+              "evaluationTimestamp": "2020-10-20T13:24:14Z",
+              "currentStateFirstObservedTimestamp": "2020-09-07T21:29:28Z",
+              "lastReportedTimestamp": "2020-10-20T16:05:12Z",
               "previousMonitorState": "Healthy",
               "currentMonitorState": "Healthy",
-              "evidence": {},
-              "monitorConfiguration": {}
+              "evidence": {
+                "reason": {
+                  "Message": "Collected samples met healthy condition for this monitor.",
+                  "Code": 2300
+                },
+                "samples": [
+                  {
+                    "timestamp": "2020-10-20T13:21:25.82Z",
+                    "value": 73.27
+                  },
+                  {
+                    "timestamp": "2020-10-20T13:22:25.822Z",
+                    "value": 77.28
+                  },
+                  {
+                    "timestamp": "2020-10-20T13:23:25.821Z",
+                    "value": 60.95
+                  }
+                ]
+              },
+              "monitorConfiguration": {
+                "isEnabled": true,
+                "monitorConfiguration": {
+                  "criticalCondition": {
+                    "isEnabled": true,
+                    "operator": "<",
+                    "threshold": 100
+                  },
+                  "evaluationType": "Max",
+                  "evaluationFrequencySecs": 60,
+                  "lookbackSecs": 240,
+                  "maxSamples": 3,
+                  "minSamples": 2
+                }
+              }
             }
           }
         ],
diff --git a/specification/workloadmonitor/resource-manager/Microsoft.WorkloadMonitor/preview/2020-01-13-preview/examples/MonitorList_GetFiltered.json b/specification/workloadmonitor/resource-manager/Microsoft.WorkloadMonitor/preview/2020-01-13-preview/examples/MonitorList_GetFiltered.json
index 1b829fbd8f2b..a1b8e5761f73 100644
--- a/specification/workloadmonitor/resource-manager/Microsoft.WorkloadMonitor/preview/2020-01-13-preview/examples/MonitorList_GetFiltered.json
+++ b/specification/workloadmonitor/resource-manager/Microsoft.WorkloadMonitor/preview/2020-01-13-preview/examples/MonitorList_GetFiltered.json
@@ -2,8 +2,8 @@
   "parameters": {
     "subscriptionId": "bc27da3b-3ba2-4e00-a6ec-1fde64aa1e21",
     "resourceGroupName": "tugamidiAlerts",
-    "resourceNamespace": "Microsoft.Compute",
-    "resourceType": "virtualMachines",
+    "providerName": "Microsoft.Compute",
+    "resourceCollectionName": "virtualMachines",
     "resourceName": "linuxEUS",
     "api-version": "2020-01-13-preview",
     "$filter": "monitorName eq 'root'"
diff --git a/specification/workloadmonitor/resource-manager/Microsoft.WorkloadMonitor/preview/2020-01-13-preview/examples/MonitorStateChange_GetDefault.json b/specification/workloadmonitor/resource-manager/Microsoft.WorkloadMonitor/preview/2020-01-13-preview/examples/MonitorStateChange_GetDefault.json
index 6ed263019f4c..b08af9997b22 100644
--- a/specification/workloadmonitor/resource-manager/Microsoft.WorkloadMonitor/preview/2020-01-13-preview/examples/MonitorStateChange_GetDefault.json
+++ b/specification/workloadmonitor/resource-manager/Microsoft.WorkloadMonitor/preview/2020-01-13-preview/examples/MonitorStateChange_GetDefault.json
@@ -2,8 +2,8 @@
   "parameters": {
     "subscriptionId": "bc27da3b-3ba2-4e00-a6ec-1fde64aa1e21",
     "resourceGroupName": "tugamidiAlerts",
-    "resourceNamespace": "Microsoft.Compute",
-    "resourceType": "virtualMachines",
+    "providerName": "Microsoft.Compute",
+    "resourceCollectionName": "virtualMachines",
     "resourceName": "linuxEUS",
     "monitorId": "logical-disks|C@3A",
     "timestampUnix": "1584316800",
@@ -12,12 +12,12 @@
   "responses": {
     "200": {
       "body": {
-        "id": "/subscriptions/bc27da3b-3ba2-4e00-a6ec-1fde64aa1e21/resourceGroups/tugamidiAlerts/providers/Microsoft.Compute/virtualMachines/linuxEUS/providers/Microsoft.WorkloadMonitor/monitors/logical-disks|C@3A|disk-free-space-mb/history/1578514818",
+        "id": "/subscriptions/bc27da3b-3ba2-4e00-a6ec-1fde64aa1e21/resourceGroups/tugamidiAlerts/providers/Microsoft.Compute/virtualMachines/linuxEUS/providers/Microsoft.WorkloadMonitor/monitors/logical-disks|C@3A|free-space/history/1578514818",
         "name": "1578514818",
         "type": "Microsoft.WorkloadMonitor/monitors/history",
         "properties": {
-          "monitorName": "logical-disks|C:|disk-free-space-mb",
-          "monitorType": "logical-disks|*|disk-free-space-mb",
+          "monitorName": "logical-disks|C:|free-space",
+          "monitorType": "logical-disks|*|free-space",
           "monitoredObject": "C:",
           "evaluationTimestamp": "2020-01-07T20:20:18.5765757Z",
           "currentStateFirstObservedTimestamp": "2020-01-07T20:20:18.5765757Z",
diff --git a/specification/workloadmonitor/resource-manager/Microsoft.WorkloadMonitor/preview/2020-01-13-preview/examples/MonitorStateChange_GetExpanded.json b/specification/workloadmonitor/resource-manager/Microsoft.WorkloadMonitor/preview/2020-01-13-preview/examples/MonitorStateChange_GetExpanded.json
index ff00d1dab28d..c3d027d272b1 100644
--- a/specification/workloadmonitor/resource-manager/Microsoft.WorkloadMonitor/preview/2020-01-13-preview/examples/MonitorStateChange_GetExpanded.json
+++ b/specification/workloadmonitor/resource-manager/Microsoft.WorkloadMonitor/preview/2020-01-13-preview/examples/MonitorStateChange_GetExpanded.json
@@ -2,8 +2,8 @@
   "parameters": {
     "subscriptionId": "bc27da3b-3ba2-4e00-a6ec-1fde64aa1e21",
     "resourceGroupName": "tugamidiAlerts",
-    "resourceNamespace": "Microsoft.Compute",
-    "resourceType": "virtualMachines",
+    "providerName": "Microsoft.Compute",
+    "resourceCollectionName": "virtualMachines",
     "resourceName": "linuxEUS",
     "monitorId": "logical-disks|C@3A",
     "timestampUnix": "1584316800",
@@ -13,18 +13,29 @@
   "responses": {
     "200": {
       "body": {
-        "id": "/subscriptions/bc27da3b-3ba2-4e00-a6ec-1fde64aa1e21/resourceGroups/tugamidiAlerts/providers/Microsoft.Compute/virtualMachines/linuxEUS/providers/Microsoft.WorkloadMonitor/monitors/logical-disks|C@3A|disk-free-space-mb/history/1578514818",
+        "id": "/subscriptions/bc27da3b-3ba2-4e00-a6ec-1fde64aa1e21/resourceGroups/tugamidiAlerts/providers/Microsoft.Compute/virtualMachines/linuxEUS/providers/Microsoft.WorkloadMonitor/monitors/logical-disks|C@3A|free-space/history/1578514818",
         "name": "1578514818",
         "type": "Microsoft.WorkloadMonitor/monitors/history",
         "properties": {
-          "monitorName": "logical-disks|C:|disk-free-space-mb",
-          "monitorType": "logical-disks|*|disk-free-space-mb",
+          "monitorName": "logical-disks|C:|free-space",
+          "monitorType": "logical-disks|*|free-space",
           "monitoredObject": "C:",
           "evaluationTimestamp": "2020-01-07T20:20:18.5765757Z",
           "currentStateFirstObservedTimestamp": "2020-01-07T20:20:18.5765757Z",
-          "previousMonitorState": "Warning",
-          "currentMonitorState": "Critical",
-          "evidence": {}
+          "previousMonitorState": "Critical",
+          "currentMonitorState": "Warning",
+          "evidence": {
+            "reason": {
+              "Message": "Collected samples met warning condition for this monitor.",
+              "Code": 2200
+            },
+            "samples": [
+              {
+                "timestamp": "2020-10-20T13:23:25.823Z",
+                "value": 87.1828
+              }
+            ]
+          }
         }
       }
     }
diff --git a/specification/workloadmonitor/resource-manager/Microsoft.WorkloadMonitor/preview/2020-01-13-preview/examples/Monitor_GetDefault.json b/specification/workloadmonitor/resource-manager/Microsoft.WorkloadMonitor/preview/2020-01-13-preview/examples/Monitor_GetDefault.json
index 71880f7954e1..a6c1e04ed1af 100644
--- a/specification/workloadmonitor/resource-manager/Microsoft.WorkloadMonitor/preview/2020-01-13-preview/examples/Monitor_GetDefault.json
+++ b/specification/workloadmonitor/resource-manager/Microsoft.WorkloadMonitor/preview/2020-01-13-preview/examples/Monitor_GetDefault.json
@@ -2,21 +2,21 @@
   "parameters": {
     "subscriptionId": "bc27da3b-3ba2-4e00-a6ec-1fde64aa1e21",
     "resourceGroupName": "tugamidiAlerts",
-    "resourceNamespace": "Microsoft.Compute",
-    "resourceType": "virtualMachines",
+    "providerName": "Microsoft.Compute",
+    "resourceCollectionName": "virtualMachines",
     "resourceName": "linuxEUS",
-    "monitorId": "logical-disks|C@3A|disk-free-space-mb",
+    "monitorId": "logical-disks|C@3A|free-space",
     "api-version": "2020-01-13-preview"
   },
   "responses": {
     "200": {
       "body": {
-        "id": "/subscriptions/bc27da3b-3ba2-4e00-a6ec-1fde64aa1e21/resourceGroups/tugamidiAlerts/providers/Microsoft.Compute/virtualMachines/linuxEUS/providers/Microsoft.WorkloadMonitor/monitors/logical-disks|C@3A|disk-free-space-mb",
-        "name": "logical-disks|C@3A|disk-free-space-mb",
+        "id": "/subscriptions/bc27da3b-3ba2-4e00-a6ec-1fde64aa1e21/resourceGroups/tugamidiAlerts/providers/Microsoft.Compute/virtualMachines/linuxEUS/providers/Microsoft.WorkloadMonitor/monitors/logical-disks|C@3A|free-space",
+        "name": "logical-disks|C@3A|free-space",
         "type": "Microsoft.WorkloadMonitor/monitors",
         "properties": {
-          "monitorName": "logical-disks|C:|disk-free-space-mb",
-          "monitorType": "logical-disks|*|disk-free-space-mb",
+          "monitorName": "logical-disks|C:|free-space",
+          "monitorType": "logical-disks|*|free-space",
           "monitoredObject": "C:",
           "parentMonitorName": "logical-disks|C:",
           "evaluationTimestamp": "2020-02-15T20:20:18.5765757Z",
diff --git a/specification/workloadmonitor/resource-manager/Microsoft.WorkloadMonitor/preview/2020-01-13-preview/examples/Monitor_GetExpanded.json b/specification/workloadmonitor/resource-manager/Microsoft.WorkloadMonitor/preview/2020-01-13-preview/examples/Monitor_GetExpanded.json
index 6488fd31df6c..79139bcf2782 100644
--- a/specification/workloadmonitor/resource-manager/Microsoft.WorkloadMonitor/preview/2020-01-13-preview/examples/Monitor_GetExpanded.json
+++ b/specification/workloadmonitor/resource-manager/Microsoft.WorkloadMonitor/preview/2020-01-13-preview/examples/Monitor_GetExpanded.json
@@ -2,22 +2,22 @@
   "parameters": {
     "subscriptionId": "bc27da3b-3ba2-4e00-a6ec-1fde64aa1e21",
     "resourceGroupName": "tugamidiAlerts",
-    "resourceNamespace": "Microsoft.Compute",
-    "resourceType": "virtualMachines",
+    "providerName": "Microsoft.Compute",
+    "resourceCollectionName": "virtualMachines",
     "resourceName": "linuxEUS",
-    "monitorId": "logical-disks|C@3A|disk-free-space-mb",
+    "monitorId": "logical-disks|C@3A|free-space",
     "api-version": "2020-01-13-preview",
     "$expand": "evidence"
   },
   "responses": {
     "200": {
       "body": {
-        "id": "/subscriptions/bc27da3b-3ba2-4e00-a6ec-1fde64aa1e21/resourceGroups/tugamidiAlerts/providers/Microsoft.Compute/virtualMachines/linuxEUS/providers/Microsoft.WorkloadMonitor/monitors/logical-disks|C@3A|disk-free-space-mb",
-        "name": "logical-disks|C@3A|disk-free-space-mb",
+        "id": "/subscriptions/bc27da3b-3ba2-4e00-a6ec-1fde64aa1e21/resourceGroups/tugamidiAlerts/providers/Microsoft.Compute/virtualMachines/linuxEUS/providers/Microsoft.WorkloadMonitor/monitors/logical-disks|C@3A|free-space",
+        "name": "logical-disks|C@3A|free-space",
         "type": "Microsoft.WorkloadMonitor/monitors",
         "properties": {
-          "monitorName": "logical-disks|C:|disk-free-space-mb",
-          "monitorType": "logical-disks|*|disk-free-space-mb",
+          "monitorName": "logical-disks|C:|free-space",
+          "monitorType": "logical-disks|*|free-space",
           "monitoredObject": "C:",
           "parentMonitorName": "logical-disks|C:",
           "evaluationTimestamp": "2020-02-15T20:20:18.5765757Z",
@@ -27,16 +27,16 @@
           "currentMonitorState": "Warning",
           "evidence": {
             "reason": {
-              "code": 2100,
-              "message": "Collected samples met critical condition for this monitor."
+              "code": 2200,
+              "message": "Collected samples met warning condition for this monitor."
             },
             "samples": [
               {
-                "value": 1361.019,
+                "value": 7.019,
                 "timestamp": "2020-03-24T20:51:00.6058242Z"
               },
               {
-                "value": 1261.019,
+                "value": 6.019,
                 "timestamp": "2020-03-24T21:51:00.6058242Z"
               }
             ]
diff --git a/specification/workloadmonitor/resource-manager/readme.md b/specification/workloadmonitor/resource-manager/readme.md
index c576f595b4bb..6f34c7bef723 100644
--- a/specification/workloadmonitor/resource-manager/readme.md
+++ b/specification/workloadmonitor/resource-manager/readme.md
@@ -59,6 +59,16 @@ directive:
 ```
 
 ---
+
+## Suppression:
+``` yaml
+directive:
+  - from: Microsoft.WorkloadMonitor.json
+    suppress:
+      - R4017 # HealthMonitors only applied to top-level resources.
+    
+```
+
 # Code Generation
 
 
@@ -71,6 +81,7 @@ This is not used by Autorest itself.
 swagger-to-sdk:
   - repo: azure-sdk-for-net
   - repo: azure-sdk-for-python
+  - repo: azure-sdk-for-python-track2
   - repo: azure-sdk-for-java
   - repo: azure-sdk-for-go
   - repo: azure-sdk-for-node
@@ -96,31 +107,7 @@ csharp:
 
 ## Python
 
-These settings apply only when `--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>`.
-Use `--python-mode=update` if you already have a setup.py and just want to update the code itself.
-``` yaml $(python)
-python-mode: create
-python:
-  azure-arm: true
-  license-header: MICROSOFT_MIT_NO_VERSION
-  payload-flattening-threshold: 2
-  namespace: azure.mgmt.workloadmonitor
-  package-name: azure-mgmt-workloadmonitor
-  clear-output-folder: true
-```
-``` yaml $(python) && $(python-mode) == 'update'
-python:
-  no-namespace-folders: true
-  output-folder: $(python-sdks-folder)/azure-mgmt-workloadmonitor/azure/mgmt/workloadmonitor
-```
-``` yaml $(python) && $(python-mode) == 'create'
-python:
-  basic-setup-py: true
-  output-folder: $(python-sdks-folder)/azure-mgmt-workloadmonitor
-```
-
-
+See configuration in [readme.python.md](./readme.python.md)
 
 ## Go
 
@@ -201,4 +188,4 @@ 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
-```
\ No newline at end of file
+```
diff --git a/specification/workloadmonitor/resource-manager/readme.python.md b/specification/workloadmonitor/resource-manager/readme.python.md
new file mode 100644
index 000000000000..549e82fe6ac4
--- /dev/null
+++ b/specification/workloadmonitor/resource-manager/readme.python.md
@@ -0,0 +1,43 @@
+## Python
+
+These settings apply only when `--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>`.
+Use `--python-mode=update` if you already have a setup.py and just want to update the code itself.
+
+```yaml !$(track2)
+python-mode: create
+python:
+  azure-arm: true
+  license-header: MICROSOFT_MIT_NO_VERSION
+  payload-flattening-threshold: 2
+  namespace: azure.mgmt.workloadmonitor
+  package-name: azure-mgmt-workloadmonitor
+  package-version: 1.0.0
+  clear-output-folder: true
+```
+
+These settings apply only when `--track2` is specified on the command line.
+
+``` yaml $(track2)
+azure-arm: true
+license-header: MICROSOFT_MIT_NO_VERSION
+package-name: azure-mgmt-workloadmonitor
+no-namespace-folders: true
+package-version: 1.0.0
+```
+
+``` yaml $(python) && $(python-mode) == 'update'
+python:
+  no-namespace-folders: true
+  output-folder: $(python-sdks-folder)/workloadmonitor/azure-mgmt-workloadmonitor/azure/mgmt/workloadmonitor
+no-namespace-folders: true
+output-folder: $(python-sdks-folder)/workloadmonitor/azure-mgmt-workloadmonitor/azure/mgmt/workloadmonitor
+```
+
+``` yaml $(python) && $(python-mode) == 'create'
+python:
+  basic-setup-py: true
+  output-folder: $(python-sdks-folder)/workloadmonitor/azure-mgmt-workloadmonitor
+basic-setup-py: true
+output-folder: $(python-sdks-folder)/workloadmonitor/azure-mgmt-workloadmonitor
+```