diff --git a/specification/containerservice/resource-manager/Microsoft.ContainerService/stable/2019-06-01/examples/AgentPools_Update.json b/specification/containerservice/resource-manager/Microsoft.ContainerService/stable/2019-06-01/examples/AgentPools_Update.json
new file mode 100644
index 000000000000..d1387137a84e
--- /dev/null
+++ b/specification/containerservice/resource-manager/Microsoft.ContainerService/stable/2019-06-01/examples/AgentPools_Update.json
@@ -0,0 +1,72 @@
+{
+  "parameters": {
+    "api-version": "2019-06-01",
+    "subscriptionId": "subid1",
+    "resourceGroupName": "rg1",
+    "resourceName": "clustername1",
+    "agentPoolName": "agentpool1",
+    "parameters": {
+      "properties": {
+        "orchestratorVersion": "",
+        "enableAutoScaling": true,
+        "minCount": 2,
+        "maxCount": 2,
+        "vmSize": "Standard_DS1_v2",
+        "osType": "Linux",
+        "nodeTaints": [
+          "Key1=Value1:NoSchedule"
+        ],
+        "scaleSetPriority": "Low",
+        "scaleSetEvictionPolicy": "Delete"
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid1/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
+        "type": "Microsoft.ContainerService/managedClusters/agentPools",
+        "name": "agentpool1",
+        "properties": {
+          "provisioningState": "Succeeded",
+          "orchestratorVersion": "1.9.6",
+          "enableAutoScaling": true,
+          "minCount": 2,
+          "maxCount": 2,
+          "count": 3,
+          "vmSize": "Standard_DS1_v2",
+          "maxPods": 110,
+          "osType": "Linux",
+          "nodeTaints": [
+            "Key1=Value1:NoSchedule"
+          ],
+          "scaleSetPriority": "Low",
+          "scaleSetEvictionPolicy": "Delete"
+        }
+      }
+    },
+    "201": {
+      "body": {
+        "id": "/subscriptions/subid1/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
+        "type": "Microsoft.ContainerService/managedClusters/agentPools",
+        "name": "agentpool1",
+        "properties": {
+          "provisioningState": "Updating",
+          "orchestratorVersion": "1.9.6",
+          "count": 3,
+          "enableAutoScaling": true,
+          "minCount": 2,
+          "maxCount": 2,
+          "vmSize": "Standard_DS1_v2",
+          "maxPods": 110,
+          "osType": "Linux",
+          "nodeTaints": [
+            "Key1=Value1:NoSchedule"
+          ],
+          "scaleSetPriority": "Low",
+          "scaleSetEvictionPolicy": "Delete"
+        }
+      }
+    }
+  }
+}
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 57e98ffa0c12..2adcf5c68ab2 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
@@ -676,6 +676,9 @@
         "x-ms-examples": {
           "Create/Update Agent Pool": {
             "$ref": "./examples/AgentPoolsCreate_Update.json"
+          },
+          "Update Agent Pool": {
+            "$ref": "./examples/AgentPools_Update.json"
           }
         }
       },
@@ -1336,10 +1339,7 @@
         "count": {
           "type": "integer",
           "format": "int32",
-          "maximum": 100,
-          "minimum": 1,
-          "description": "Number of agents (VMs) to host docker containers. Allowed values must be in the range of 1 to 100 (inclusive). The default value is 1. ",
-          "default": 1
+          "description": "Number of agents (VMs) to host docker containers. Allowed values must be in the range of 1 to 100 (inclusive). The default value is 1."
         },
         "vmSize": {
           "$ref": "#/definitions/ContainerServiceVMSize",
@@ -1416,10 +1416,6 @@
           "description": "Taints added to new nodes during node pool create and scale. For example, key=value:NoSchedule."
         }
       },
-      "required": [
-        "vmSize",
-        "count"
-      ],
       "description": "Properties for the container service agent pool profile."
     },
     "ManagedClusterAgentPoolProfile": {
diff --git a/specification/containerservice/resource-manager/Microsoft.ContainerService/stable/2019-08-01/examples/AgentPools_Update.json b/specification/containerservice/resource-manager/Microsoft.ContainerService/stable/2019-08-01/examples/AgentPools_Update.json
new file mode 100644
index 000000000000..4328104e0709
--- /dev/null
+++ b/specification/containerservice/resource-manager/Microsoft.ContainerService/stable/2019-08-01/examples/AgentPools_Update.json
@@ -0,0 +1,72 @@
+{
+  "parameters": {
+    "api-version": "2019-08-01",
+    "subscriptionId": "subid1",
+    "resourceGroupName": "rg1",
+    "resourceName": "clustername1",
+    "agentPoolName": "agentpool1",
+    "parameters": {
+      "properties": {
+        "orchestratorVersion": "",
+        "enableAutoScaling": true,
+        "minCount": 2,
+        "maxCount": 2,
+        "vmSize": "Standard_DS1_v2",
+        "osType": "Linux",
+        "nodeTaints": [
+          "Key1=Value1:NoSchedule"
+        ],
+        "scaleSetPriority": "Low",
+        "scaleSetEvictionPolicy": "Delete"
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid1/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
+        "type": "Microsoft.ContainerService/managedClusters/agentPools",
+        "name": "agentpool1",
+        "properties": {
+          "provisioningState": "Succeeded",
+          "orchestratorVersion": "1.9.6",
+          "count": 3,
+          "enableAutoScaling": true,
+          "minCount": 2,
+          "maxCount": 2,
+          "vmSize": "Standard_DS1_v2",
+          "maxPods": 110,
+          "osType": "Linux",
+          "nodeTaints": [
+            "Key1=Value1:NoSchedule"
+          ],
+          "scaleSetPriority": "Low",
+          "scaleSetEvictionPolicy": "Delete"
+        }
+      }
+    },
+    "201": {
+      "body": {
+        "id": "/subscriptions/subid1/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
+        "type": "Microsoft.ContainerService/managedClusters/agentPools",
+        "name": "agentpool1",
+        "properties": {
+          "provisioningState": "Updating",
+          "orchestratorVersion": "1.9.6",
+          "count": 3,
+          "enableAutoScaling": true,
+          "minCount": 2,
+          "maxCount": 2,
+          "vmSize": "Standard_DS1_v2",
+          "maxPods": 110,
+          "osType": "Linux",
+          "nodeTaints": [
+            "Key1=Value1:NoSchedule"
+          ],
+          "scaleSetPriority": "Low",
+          "scaleSetEvictionPolicy": "Delete"
+        }
+      }
+    }
+  }
+}
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 15d5f5ecc635..c16a98053709 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
@@ -676,6 +676,9 @@
         "x-ms-examples": {
           "Create/Update Agent Pool": {
             "$ref": "./examples/AgentPoolsCreate_Update.json"
+          },
+          "Update Agent Pool": {
+            "$ref": "./examples/AgentPools_Update.json"
           }
         }
       },
@@ -1380,10 +1383,7 @@
         "count": {
           "type": "integer",
           "format": "int32",
-          "maximum": 100,
-          "minimum": 1,
-          "description": "Number of agents (VMs) to host docker containers. Allowed values must be in the range of 1 to 100 (inclusive). The default value is 1. ",
-          "default": 1
+          "description": "Number of agents (VMs) to host docker containers. Allowed values must be in the range of 1 to 100 (inclusive). The default value is 1."
         },
         "vmSize": {
           "$ref": "#/definitions/ContainerServiceVMSize",
@@ -1460,10 +1460,6 @@
           "description": "Taints added to new nodes during node pool create and scale. For example, key=value:NoSchedule."
         }
       },
-      "required": [
-        "vmSize",
-        "count"
-      ],
       "description": "Properties for the container service agent pool profile."
     },
     "ManagedClusterAgentPoolProfile": {
diff --git a/specification/containerservice/resource-manager/Microsoft.ContainerService/stable/2019-10-01/examples/AgentPools_Update.json b/specification/containerservice/resource-manager/Microsoft.ContainerService/stable/2019-10-01/examples/AgentPools_Update.json
new file mode 100644
index 000000000000..c9d121e3d76a
--- /dev/null
+++ b/specification/containerservice/resource-manager/Microsoft.ContainerService/stable/2019-10-01/examples/AgentPools_Update.json
@@ -0,0 +1,73 @@
+{
+  "parameters": {
+    "api-version": "2019-10-01",
+    "subscriptionId": "subid1",
+    "resourceGroupName": "rg1",
+    "resourceName": "clustername1",
+    "agentPoolName": "agentpool1",
+    "parameters": {
+      "properties": {
+        "orchestratorVersion": "",
+        "count": 3,
+        "enableAutoScaling": true,
+        "minCount": 2,
+        "maxCount": 2,
+        "vmSize": "Standard_DS1_v2",
+        "osType": "Linux",
+        "nodeTaints": [
+          "Key1=Value1:NoSchedule"
+        ],
+        "scaleSetPriority": "Low",
+        "scaleSetEvictionPolicy": "Delete"
+      }
+    }
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid1/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
+        "type": "Microsoft.ContainerService/managedClusters/agentPools",
+        "name": "agentpool1",
+        "properties": {
+          "provisioningState": "Succeeded",
+          "orchestratorVersion": "1.9.6",
+          "count": 3,
+          "enableAutoScaling": true,
+          "minCount": 2,
+          "maxCount": 2,
+          "vmSize": "Standard_DS1_v2",
+          "maxPods": 110,
+          "osType": "Linux",
+          "nodeTaints": [
+            "Key1=Value1:NoSchedule"
+          ],
+          "scaleSetPriority": "Low",
+          "scaleSetEvictionPolicy": "Delete"
+        }
+      }
+    },
+    "201": {
+      "body": {
+        "id": "/subscriptions/subid1/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/agentPools/agentpool1",
+        "type": "Microsoft.ContainerService/managedClusters/agentPools",
+        "name": "agentpool1",
+        "properties": {
+          "provisioningState": "Updating",
+          "orchestratorVersion": "1.9.6",
+          "count": 3,
+          "enableAutoScaling": true,
+          "minCount": 2,
+          "maxCount": 2,
+          "vmSize": "Standard_DS1_v2",
+          "maxPods": 110,
+          "osType": "Linux",
+          "nodeTaints": [
+            "Key1=Value1:NoSchedule"
+          ],
+          "scaleSetPriority": "Low",
+          "scaleSetEvictionPolicy": "Delete"
+        }
+      }
+    }
+  }
+}
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 7195255be966..62a0092e0909 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
@@ -676,6 +676,9 @@
         "x-ms-examples": {
           "Create/Update Agent Pool": {
             "$ref": "./examples/AgentPoolsCreate_Update.json"
+          },
+          "Update Agent Pool": {
+            "$ref": "./examples/AgentPools_Update.json"
           }
         }
       },
@@ -1380,10 +1383,7 @@
         "count": {
           "type": "integer",
           "format": "int32",
-          "maximum": 100,
-          "minimum": 1,
-          "description": "Number of agents (VMs) to host docker containers. Allowed values must be in the range of 1 to 100 (inclusive). The default value is 1. ",
-          "default": 1
+          "description": "Number of agents (VMs) to host docker containers. Allowed values must be in the range of 1 to 100 (inclusive). The default value is 1."
         },
         "vmSize": {
           "$ref": "#/definitions/ContainerServiceVMSize",
@@ -1460,10 +1460,6 @@
           "description": "Taints added to new nodes during node pool create and scale. For example, key=value:NoSchedule."
         }
       },
-      "required": [
-        "vmSize",
-        "count"
-      ],
       "description": "Properties for the container service agent pool profile."
     },
     "ManagedClusterAgentPoolProfile": {