Nguyentim/resources list top update (#16273)

tim-nguyen-cs · Tim Nguyen · web-flow · commit 23b8c3e5ecc0 · 2021-10-08T09:41:27.000+08:00
* removed support for `filter` + `top`

* rolled back `top` definition on resources_list

Co-authored-by: Tim Nguyen &lt;you@example.com&gt;
diff --git a/specification/resources/resource-manager/Microsoft.Resources/stable/2015-11-01/resources.json b/specification/resources/resource-manager/Microsoft.Resources/stable/2015-11-01/resources.json
@@ -864,7 +864,7 @@
             "required": false,
             "type": "integer",
             "format": "int32",
-            "description": "The maximum number of results to return. If null is passed, returns all resources."
+            "description": "The number of results to return. If null is passed, returns all resources."
           },
           {
             "$ref": "#/parameters/ApiVersionParameter"
diff --git a/specification/resources/resource-manager/Microsoft.Resources/stable/2016-02-01/resources.json b/specification/resources/resource-manager/Microsoft.Resources/stable/2016-02-01/resources.json
@@ -964,7 +964,7 @@
             "required": false,
             "type": "integer",
             "format": "int32",
-            "description": "The maximum number of results to return. If null is passed, returns all resources."
+            "description": "The number of results to return. If null is passed, returns all resources."
           },
           {
             "$ref": "#/parameters/ApiVersionParameter"
diff --git a/specification/resources/resource-manager/Microsoft.Resources/stable/2016-07-01/resources.json b/specification/resources/resource-manager/Microsoft.Resources/stable/2016-07-01/resources.json
@@ -964,7 +964,7 @@
             "required": false,
             "type": "integer",
             "format": "int32",
-            "description": "The maximum number of results to return. If null is passed, returns all resources."
+            "description": "The number of results to return. If null is passed, returns all resources."
           },
           {
             "$ref": "#/parameters/ApiVersionParameter"
diff --git a/specification/resources/resource-manager/Microsoft.Resources/stable/2016-09-01/resources.json b/specification/resources/resource-manager/Microsoft.Resources/stable/2016-09-01/resources.json
@@ -992,7 +992,7 @@
             "required": false,
             "type": "integer",
             "format": "int32",
-            "description": "The maximum number of results to return. If null is passed, returns all resources."
+            "description": "The number of results to return. If null is passed, returns all resources."
           },
           {
             "$ref": "#/parameters/ApiVersionParameter"
diff --git a/specification/resources/resource-manager/Microsoft.Resources/stable/2017-05-10/resources.json b/specification/resources/resource-manager/Microsoft.Resources/stable/2017-05-10/resources.json
@@ -613,7 +613,7 @@
             "required": false,
             "type": "integer",
             "format": "int32",
-            "description": "The maximum number of results to return. If null is passed, returns all resources."
+            "description": "The number of results to return. If null is passed, returns all resources."
           },
           {
             "$ref": "#/parameters/ApiVersionParameter"
@@ -1041,7 +1041,7 @@
             "required": false,
             "type": "integer",
             "format": "int32",
-            "description": "The maximum number of results to return. If null is passed, returns all resources."
+            "description": "The number of results to return. If null is passed, returns all resources."
           },
           {
             "$ref": "#/parameters/ApiVersionParameter"
diff --git a/specification/resources/resource-manager/Microsoft.Resources/stable/2018-02-01/resources.json b/specification/resources/resource-manager/Microsoft.Resources/stable/2018-02-01/resources.json
@@ -621,7 +621,7 @@
             "required": false,
             "type": "integer",
             "format": "int32",
-            "description": "The maximum number of results to return. If null is passed, returns all resources."
+            "description": "The number of results to return. If null is passed, returns all resources."
           },
           {
             "$ref": "#/parameters/ApiVersionParameter"
@@ -1049,7 +1049,7 @@
             "required": false,
             "type": "integer",
             "format": "int32",
-            "description": "The maximum number of results to return. If null is passed, returns all resources."
+            "description": "The number of results to return. If null is passed, returns all resources."
           },
           {
             "$ref": "#/parameters/ApiVersionParameter"
diff --git a/specification/resources/resource-manager/Microsoft.Resources/stable/2018-05-01/resources.json b/specification/resources/resource-manager/Microsoft.Resources/stable/2018-05-01/resources.json
@@ -961,7 +961,7 @@
             "required": false,
             "type": "integer",
             "format": "int32",
-            "description": "The maximum number of results to return. If null is passed, returns all resources."
+            "description": "The number of results to return. If null is passed, returns all resources."
           },
           {
             "$ref": "#/parameters/ApiVersionParameter"
@@ -1394,7 +1394,7 @@
             "required": false,
             "type": "integer",
             "format": "int32",
-            "description": "The maximum number of results to return. If null is passed, returns all resources."
+            "description": "The number of results to return. If null is passed, returns all resources."
           },
           {
             "$ref": "#/parameters/ApiVersionParameter"
diff --git a/specification/resources/resource-manager/Microsoft.Resources/stable/2019-03-01/resources.json b/specification/resources/resource-manager/Microsoft.Resources/stable/2019-03-01/resources.json
@@ -961,7 +961,7 @@
             "required": false,
             "type": "integer",
             "format": "int32",
-            "description": "The maximum number of results to return. If null is passed, returns all resources."
+            "description": "The number of results to return. If null is passed, returns all resources."
           },
           {
             "$ref": "#/parameters/ApiVersionParameter"
@@ -1402,7 +1402,7 @@
             "required": false,
             "type": "integer",
             "format": "int32",
-            "description": "The maximum number of results to return. If null is passed, returns all resources."
+            "description": "The number of results to return. If null is passed, returns all resources."
           },
           {
             "$ref": "#/parameters/ApiVersionParameter"
diff --git a/specification/resources/resource-manager/Microsoft.Resources/stable/2019-05-01/resources.json b/specification/resources/resource-manager/Microsoft.Resources/stable/2019-05-01/resources.json
@@ -1134,7 +1134,7 @@
             "required": false,
             "type": "integer",
             "format": "int32",
-            "description": "The maximum number of results to return. If null is passed, returns all resources."
+            "description": "The number of results to return. If null is passed, returns all resources."
           },
           {
             "$ref": "#/parameters/ApiVersionParameter"
@@ -1575,7 +1575,7 @@
             "required": false,
             "type": "integer",
             "format": "int32",
-            "description": "The maximum number of results to return. If null is passed, returns all resources."
+            "description": "The number of results to return. If null is passed, returns all resources."
           },
           {
             "$ref": "#/parameters/ApiVersionParameter"
diff --git a/specification/resources/resource-manager/Microsoft.Resources/stable/2019-05-10/resources.json b/specification/resources/resource-manager/Microsoft.Resources/stable/2019-05-10/resources.json
@@ -1210,7 +1210,7 @@
             "required": false,
             "type": "integer",
             "format": "int32",
-            "description": "The maximum number of results to return. If null is passed, returns all resources."
+            "description": "The number of results to return. If null is passed, returns all resources."
           },
           {
             "$ref": "#/parameters/ApiVersionParameter"
@@ -1651,7 +1651,7 @@
             "required": false,
             "type": "integer",
             "format": "int32",
-            "description": "The maximum number of results to return. If null is passed, returns all resources."
+            "description": "The number of results to return. If null is passed, returns all resources."
           },
           {
             "$ref": "#/parameters/ApiVersionParameter"
diff --git a/specification/resources/resource-manager/Microsoft.Resources/stable/2019-07-01/resources.json b/specification/resources/resource-manager/Microsoft.Resources/stable/2019-07-01/resources.json
@@ -2150,7 +2150,7 @@
             "required": false,
             "type": "integer",
             "format": "int32",
-            "description": "The maximum number of results to return. If null is passed, returns all resources."
+            "description": "The number of results to return. If null is passed, returns all resources."
           },
           {
             "$ref": "#/parameters/ApiVersionParameter"
@@ -2648,7 +2648,7 @@
             "required": false,
             "type": "integer",
             "format": "int32",
-            "description": "The maximum number of results to return. If null is passed, returns all resources."
+            "description": "The number of results to return. If null is passed, returns all resources."
           },
           {
             "$ref": "#/parameters/ApiVersionParameter"
diff --git a/specification/resources/resource-manager/Microsoft.Resources/stable/2019-08-01/resources.json b/specification/resources/resource-manager/Microsoft.Resources/stable/2019-08-01/resources.json
@@ -2150,7 +2150,7 @@
             "required": false,
             "type": "integer",
             "format": "int32",
-            "description": "The maximum number of results to return. If null is passed, returns all resources."
+            "description": "The number of results to return. If null is passed, returns all resources."
           },
           {
             "$ref": "#/parameters/ApiVersionParameter"
@@ -2648,7 +2648,7 @@
             "required": false,
             "type": "integer",
             "format": "int32",
-            "description": "The maximum number of results to return. If null is passed, returns all resources."
+            "description": "The number of results to return. If null is passed, returns all resources."
           },
           {
             "$ref": "#/parameters/ApiVersionParameter"
diff --git a/specification/resources/resource-manager/Microsoft.Resources/stable/2019-10-01/resources.json b/specification/resources/resource-manager/Microsoft.Resources/stable/2019-10-01/resources.json
@@ -2297,7 +2297,7 @@
             "required": false,
             "type": "integer",
             "format": "int32",
-            "description": "The maximum number of results to return. If null is passed, returns all resources."
+            "description": "The number of results to return. If null is passed, returns all resources."
           },
           {
             "$ref": "#/parameters/ApiVersionParameter"
@@ -2795,7 +2795,7 @@
             "required": false,
             "type": "integer",
             "format": "int32",
-            "description": "The maximum number of results to return. If null is passed, returns all resources."
+            "description": "The number of results to return. If null is passed, returns all resources."
           },
           {
             "$ref": "#/parameters/ApiVersionParameter"
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
@@ -2335,7 +2335,7 @@
             "required": false,
             "type": "integer",
             "format": "int32",
-            "description": "The maximum number of results to return. If null is passed, returns all resources."
+            "description": "The number of results to return. If null is passed, returns all resources."
           },
           {
             "$ref": "#/parameters/ApiVersionParameter"
@@ -2841,7 +2841,7 @@
             "required": false,
             "type": "integer",
             "format": "int32",
-            "description": "The maximum number of results to return. If null is passed, returns all resources."
+            "description": "The number of results to return. If null is passed, returns all resources."
           },
           {
             "$ref": "#/parameters/ApiVersionParameter"
diff --git a/specification/resources/resource-manager/Microsoft.Resources/stable/2020-08-01/resources.json b/specification/resources/resource-manager/Microsoft.Resources/stable/2020-08-01/resources.json
@@ -2360,7 +2360,7 @@
             "required": false,
             "type": "integer",
             "format": "int32",
-            "description": "The maximum number of results to return. If null is passed, returns all resources."
+            "description": "The number of results to return. If null is passed, returns all resources."
           },
           {
             "$ref": "#/parameters/ApiVersionParameter"
@@ -2851,7 +2851,7 @@
             "required": false,
             "type": "integer",
             "format": "int32",
-            "description": "The maximum number of results to return. If null is passed, returns all resources."
+            "description": "The number of results to return. If null is passed, returns all resources."
           },
           {
             "$ref": "#/parameters/ApiVersionParameter"
diff --git a/specification/resources/resource-manager/Microsoft.Resources/stable/2020-10-01/resources.json b/specification/resources/resource-manager/Microsoft.Resources/stable/2020-10-01/resources.json
@@ -2398,7 +2398,7 @@
             "required": false,
             "type": "integer",
             "format": "int32",
-            "description": "The maximum number of results to return. If null is passed, returns all resources."
+            "description": "The number of results to return. If null is passed, returns all resources."
           },
           {
             "$ref": "#/parameters/ApiVersionParameter"
@@ -2889,7 +2889,7 @@
             "required": false,
             "type": "integer",
             "format": "int32",
-            "description": "The maximum number of results to return. If null is passed, returns all resources."
+            "description": "The number of results to return. If null is passed, returns all resources."
           },
           {
             "$ref": "#/parameters/ApiVersionParameter"
diff --git a/specification/resources/resource-manager/Microsoft.Resources/stable/2021-01-01/resources.json b/specification/resources/resource-manager/Microsoft.Resources/stable/2021-01-01/resources.json
@@ -2408,7 +2408,7 @@
             "required": false,
             "type": "integer",
             "format": "int32",
-            "description": "The maximum number of results to return. If null is passed, returns all resources."
+            "description": "The number of results to return. If null is passed, returns all resources."
           },
           {
             "$ref": "#/parameters/ApiVersionParameter"
@@ -2921,7 +2921,7 @@
             "required": false,
             "type": "integer",
             "format": "int32",
-            "description": "The maximum number of results to return. If null is passed, returns all resources."
+            "description": "The number of results to return. If null is passed, returns all resources."
           },
           {
             "$ref": "#/parameters/ApiVersionParameter"
diff --git a/specification/resources/resource-manager/Microsoft.Resources/stable/2021-04-01/resources.json b/specification/resources/resource-manager/Microsoft.Resources/stable/2021-04-01/resources.json
@@ -2444,7 +2444,7 @@
             "required": false,
             "type": "integer",
             "format": "int32",
-            "description": "The maximum number of results to return. If null is passed, returns all resources."
+            "description": "The number of results to return. If null is passed, returns all resources."
           },
           {
             "$ref": "#/parameters/ApiVersionParameter"
@@ -2942,7 +2942,7 @@
             "in": "query",
             "required": false,
             "type": "string",
-            "description": "The filter to apply on the operation.<br><br>Filter comparison operators include `eq` (equals) and `ne` (not equals) and may be used with the following properties: `location`, `resourceType`, `name`, `resourceGroup`, `identity`, `identity/principalId`, `plan`, `plan/publisher`, `plan/product`, `plan/name`, `plan/version`, and `plan/promotionCode`.<br><br>For example, to filter by a resource type, use `$filter=resourceType eq 'Microsoft.Network/virtualNetworks'`<br><br><br>`substringof(value, property)` can  be used to filter for substrings of the following currently-supported properties: `name` and `resourceGroup`<br><br>For example, to get all resources with 'demo' anywhere in the resource name, use `$filter=substringof('demo', name)`<br><br>Multiple substring operations can also be combined using `and`/`or` operators.<br><br><br>Resources can be filtered by tag names and values. For example, to filter for a tag name and value, use `$filter=tagName eq 'tag1' and tagValue eq 'Value1'`. Note that when resources are filtered by tag name and value, <b>the original tags for each resource will not be returned in the results.</b> Any list of additional properties queried via `$expand` may also not be compatible when filtering by tag names/values. <br><br>For tag names only, resources can be filtered by prefix using the following syntax: `$filter=startswith(tagName, 'depart')`. This query will return all resources with a tag name prefixed by the phrase `depart` (i.e.`department`, `departureDate`, `departureTime`, etc.)<br><br><br>Note that some properties can be combined when filtering resources, which include the following: `substringof() and/or resourceType`, `plan and plan/publisher and plan/name`, and `identity and identity/principalId`."
+            "description": "The filter to apply on the operation.<br><br>Filter comparison operators include `eq` (equals) and `ne` (not equals) and may be used with the following properties: `location`, `resourceType`, `name`, `resourceGroup`, `identity`, `identity/principalId`, `plan`, `plan/publisher`, `plan/product`, `plan/name`, `plan/version`, and `plan/promotionCode`.<br><br>For example, to filter by a resource type, use `$filter=resourceType eq 'Microsoft.Network/virtualNetworks'`<br><br><br>`substringof(value, property)` can  be used to filter for substrings of the following currently-supported properties: `name` and `resourceGroup`<br><br>For example, to get all resources with 'demo' anywhere in the resource name, use `$filter=substringof('demo', name)`<br><br>Multiple substring operations can also be combined using `and`/`or` operators.<br><br>Note that any truncated number of results queried via `$top` may also not be compatible when using a filter.<br><br><br>Resources can be filtered by tag names and values. For example, to filter for a tag name and value, use `$filter=tagName eq 'tag1' and tagValue eq 'Value1'`. Note that when resources are filtered by tag name and value, <b>the original tags for each resource will not be returned in the results.</b> Any list of additional properties queried via `$expand` may also not be compatible when filtering by tag names/values. <br><br>For tag names only, resources can be filtered by prefix using the following syntax: `$filter=startswith(tagName, 'depart')`. This query will return all resources with a tag name prefixed by the phrase `depart` (i.e.`department`, `departureDate`, `departureTime`, etc.)<br><br><br>Note that some properties can be combined when filtering resources, which include the following: `substringof() and/or resourceType`, `plan and plan/publisher and plan/name`, and `identity and identity/principalId`."
           },
           {
             "name": "$expand",
@@ -2957,7 +2957,7 @@
             "required": false,
             "type": "integer",
             "format": "int32",
-            "description": "The maximum number of results to return. If null is passed, returns all resources."
+            "description": "The number of results to return. If null is passed, returns all resources."
           },
           {
             "$ref": "#/parameters/ApiVersionParameter"

Original file line number	Diff line number	Diff line change
`@@ -864,7 +864,7 @@`
`864`	`864`	`"required": false,`
`865`	`865`	`"type": "integer",`
`866`	`866`	`"format": "int32",`
`867`		`- "description": "The maximum number of results to return. If null is passed, returns all resources."`
	`867`	`+ "description": "The number of results to return. If null is passed, returns all resources."`
`868`	`868`	`},`
`869`	`869`	`{`
`870`	`870`	`"$ref": "#/parameters/ApiVersionParameter"`
Original file line number	Diff line number	Diff line change
`@@ -964,7 +964,7 @@`
`964`	`964`	`"required": false,`
`965`	`965`	`"type": "integer",`
`966`	`966`	`"format": "int32",`
`967`		`- "description": "The maximum number of results to return. If null is passed, returns all resources."`
	`967`	`+ "description": "The number of results to return. If null is passed, returns all resources."`
`968`	`968`	`},`
`969`	`969`	`{`
`970`	`970`	`"$ref": "#/parameters/ApiVersionParameter"`
Original file line number	Diff line number	Diff line change
`@@ -992,7 +992,7 @@`
`992`	`992`	`"required": false,`
`993`	`993`	`"type": "integer",`
`994`	`994`	`"format": "int32",`
`995`		`- "description": "The maximum number of results to return. If null is passed, returns all resources."`
	`995`	`+ "description": "The number of results to return. If null is passed, returns all resources."`
`996`	`996`	`},`
`997`	`997`	`{`
`998`	`998`	`"$ref": "#/parameters/ApiVersionParameter"`