Skip to content

Commit 3ccd6ff

Browse files
authored
Merge pull request #338 from mikekistler/discourage-count
Add guidance for count field in pageable response
2 parents 53b6989 + d107f85 commit 3ccd6ff

File tree

1 file changed

+3
-1
lines changed

1 file changed

+3
-1
lines changed

azure/Guidelines.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -524,7 +524,9 @@ Note: The service is responsible for performing any URL-encoding required on the
524524

525525
:no_entry: **DO NOT** return the `nextLink` field at all when returning the last page of the collection.
526526

527-
:no_entry: **DO NOT** ever return a `nextLink` field with a value of null.
527+
:no_entry: **DO NOT** return the `nextLink` field with a value of null.
528+
529+
:warning: **YOU SHOULD NOT** return a `count` of all objects in the collection as this may be expensive to compute.
528530

529531
#### Query options
530532
:heavy_check_mark: **YOU MAY** support the following query parameters allowing customers to control the list operation:

0 commit comments

Comments
 (0)