To request only the number of items of a collection of entities or items of a collection-valued property, the client issues a GET request with /$count appended to the resource path of the collection.
On success, the response body MUST contain the exact count of items matching the request after applying any $filter or $search system query options, formatted as a simple primitive integer value with media type text/plain without charset parameter, and the response body following rule 1*DIGIT.
On success, the response body MUST contain the exact count of items matching the request after applying any $filter or $search system query options, formatted as a simple primitive integer value with media type text/plain without charset parameter, and the response body following rule 1*DIGIT, see OData-ABNF.
Clients SHOULD NOT combine the system query options $top, $skip, $orderby, $expand, and $format with the path suffix /$count. The result of such a request is undefined.
Example 69: return the number of products in the Products entity set
diff --git a/docs/odata-protocol/odata-protocol.md b/docs/odata-protocol/odata-protocol.md index b609c89f..250bbce7 100644 --- a/docs/odata-protocol/odata-protocol.md +++ b/docs/odata-protocol/odata-protocol.md @@ -3713,7 +3713,7 @@ matching the request after applying any [`$filter`](#SystemQueryOptionfilter) or [`$search`](#SystemQueryOptionsearch) system query options, formatted as a simple primitive integer value with media type `text/plain` without `charset` parameter, -and the response body following rule `1*DIGIT`. +and the response body following rule `1*DIGIT`, see [OData-ABNF](#ODataABNF). Clients SHOULD NOT combine the system query options [`$top`](#SystemQueryOptiontop), diff --git a/odata-protocol/11 Data Service Requests.md b/odata-protocol/11 Data Service Requests.md index 5ba183c2..86f3b193 100644 --- a/odata-protocol/11 Data Service Requests.md +++ b/odata-protocol/11 Data Service Requests.md @@ -1149,7 +1149,7 @@ matching the request after applying any [`$filter`](#SystemQueryOptionfilter) or [`$search`](#SystemQueryOptionsearch) system query options, formatted as a simple primitive integer value with media type `text/plain` without `charset` parameter, -and the response body following rule `1*DIGIT`. +and the response body following rule `1*DIGIT`, see [OData-ABNF](#ODataABNF). Clients SHOULD NOT combine the system query options [`$top`](#SystemQueryOptiontop),