{
  "slug": "object-list-pagination",
  "term": "Object-list pagination",
  "aliases": [
    "paginated object listing",
    "object listing pagination"
  ],
  "definition": "Object-list pagination divides a selected object listing into multiple responses that a client traverses using the interface's continuation rules.",
  "note": "For S3 ListObjectsV2, IsTruncated=true requires continuation with NextContinuationToken as the next request's ContinuationToken. MaxKeys is an upper bound, not a completion signal: inspect IsTruncated even when fewer keys are returned. This opaque token is not an object key; StartAfter is a separate key-based selector. [s3-list-v2]\n\nIn a flat CLI v2 list-objects-v2 listing without a delimiter, --page-size controls service-call size, while --max-items caps command output. Resume CLI output with NextToken and --starting-token, not by passing that CLI token directly to another interface. [s3-cli-list-v2]\n\n--no-paginate stops automatic traversal after one service request; --no-cli-pager only disables the output display program. Neither a screenful nor a capped command output establishes complete listing coverage. [aws-cli-pagination]\n\nDelimiter grouping changes which results represent individual objects; version listings use their own continuation protocol. See object-key-prefix and object-version-id. This definition describes traversal, not checksum verification or a multi-request snapshot guarantee. [s3-list-v2]",
  "status": "shipping",
  "advantages": [
    {
      "text": "Allows clients to traverse listings without requiring one unbounded service response.",
      "citationIds": [
        "s3-list-v2"
      ]
    }
  ],
  "limitations": [
    {
      "text": "Continuation tokens belong to their interface; service and CLI output limits are not interchangeable.",
      "citationIds": [
        "s3-cli-list-v2"
      ]
    }
  ],
  "related": [
    "object-key-prefix",
    "object-version-id"
  ],
  "supersedes": [],
  "supersededBy": [],
  "firstSeen": null,
  "lastSeen": null,
  "updated": "2026-11-12",
  "citations": [
    {
      "id": "s3-list-v2",
      "title": "Amazon S3 API: ListObjectsV2, continuation and result grouping",
      "url": "https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListObjectsV2.html",
      "accessed": "2026-11-12"
    },
    {
      "id": "s3-cli-list-v2",
      "title": "AWS CLI v2: list-objects-v2, output limits and CLI tokens",
      "url": "https://docs.aws.amazon.com/cli/latest/reference/s3api/list-objects-v2.html",
      "accessed": "2026-11-12"
    },
    {
      "id": "aws-cli-pagination",
      "title": "AWS CLI v2: service pagination and the client-side pager",
      "url": "https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-pagination.html",
      "accessed": "2026-11-12"
    }
  ],
  "provenance": [
    "CLI behavior refers to AWS CLI v2 documentation, not a live service test."
  ]
}