Skip to content

Commit fe940d9

Browse files
Update api-concepts.md
1 parent 5959626 commit fe940d9

File tree

1 file changed

+15
-1
lines changed

1 file changed

+15
-1
lines changed

content/en/docs/reference/using-api/api-concepts.md

Lines changed: 15 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -192,7 +192,21 @@ For example, if there are 1,253 pods on the cluster and the client wants to rece
192192
}
193193
```
194194

195-
Note that the `resourceVersion` of the list remains constant across each request, indicating the server is showing us a consistent snapshot of the pods. Pods that are created, updated, or deleted after version `10245` would not be shown unless the user makes a list request without the `continue` token. This allows clients to break large requests into smaller chunks and then perform a watch operation on the full set without missing any updates. `remainingItemCount` is the number of subsequent items in the list which are not included in this list response. If the list request contained label or field selectors, then the number of remaining items is unknown and the API server does not include a `remainingItemCount` field in its response. If the list is complete (either because it is not chunking or because this is the last chunk), then there are no more remaining items and the API server does not include a `remainingItemCount` field in its response. The intended use of the `remainingItemCount` is estimating the size of a collection.
195+
Note that the `resourceVersion` of the list remains constant across each request,
196+
indicating the server is showing us a consistent snapshot of the pods. Pods that
197+
are created, updated, or deleted after version `10245` would not be shown unless
198+
the user makes a list request without the `continue` token. This allows clients
199+
to break large requests into smaller chunks and then perform a watch operation
200+
on the full set without missing any updates.
201+
202+
`remainingItemCount` is the number of subsequent items in the list which are not
203+
included in this list response. If the list request contained label or field selectors,
204+
then the number of remaining items is unknown and the API server does not include
205+
a `remainingItemCount` field in its response. If the list is complete (either
206+
because it is not chunking or because this is the last chunk), then there are no
207+
more remaining items and the API server does not include a `remainingItemCount`
208+
field in its response. The intended use of the `remainingItemCount` is estimating
209+
the size of a collection.
196210

197211

198212
## Receiving resources as Tables

0 commit comments

Comments
 (0)