Duplicate entry example

Retrieve page N; the last resource displayed on page N is resource with ID X.

A new resource, matching the List filters, is created.

Retrieve page N+1; if the results are ordered by descending create timestamp, resource with ID X will also display on page N+1.

Missing entry example

Retrieve page N; the last resource displayed on page N is resource with ID X.

If page N+1 is retrieved at this time, the first resource on page N+1 has ID Y.

Resource with ID X is updated and no longer matches the List filters.

Retrieve page N+1; resource with ID Y will not display on page N+1.

Page-level consistency

No duplicate entry example

Retrieve page N; the last resource on page N is resource with ID X.

A new resource with ID Y, matching the List filters, is created.

Retrieve page N+1; resource with ID X will not display on page N+1.

If the List endpoint offers best-effort consistency guarantee, resource with ID X may display again on page N+1.

No missing entry example

Retrieve page N; the last resource displayed on page N is resource with ID X.

If page N+1 is retrieved at this time, the first resource on page N+1 has ID Y.

Resource with ID X is updated and no longer matches the List filters.

Retrieve page N+1; Resource with ID Y will display on page N+1.

If the List endpoint offers best-effort consistency guarantee, resource with ID Y may not display on page N+1.

No snapshot view example

Retrieve page N at time t.

A new resource with ID X, matching the List filters, is created at time t+1.

Resource with ID X may or may not appear on later pages, depending on ordering. For example, if the results are ordered by:

Descending create timestamp, resource with ID X would not appear on later pages as it is the most recently-created resource.

Ascending create timestamp, resource with ID X appears on the last page.