internal

save lists of active commits for garbage collection

Changed on
post/repositories/{repository}/gc/prepare_commits

Request

  • Base URL
    /api/v1 (relative, and the document was published on a file host, not at the API’s origin)
  • URL
    /api/v1/repositories/{repository}/gc/prepare_commits
  • Auth
    • HTTP bearer
    • or HTTP basic
    • or API key in cookie internal_auth_session

Response

paths to commit dataset

run_idstring required

a unique identifier generated for this GC job

gc_commits_locationstring required

location of the resulting commits csv table (partitioned by run_id)

gc_addresses_locationstring required

location to use for expired addresses parquet table (partitioned by run_id)

gc_commits_presigned_urlstring

a presigned url to download the commits csv

Example response

{
  "run_id": "64eaa103-d726-4a33-bcb8-7c0b4abfe09e",
  "gc_commits_location": "s3://my-storage-namespace/_lakefs/retention/commits",
  "gc_addresses_location": "s3://my-storage-namespace/_lakefs/retention/addresses"
}

Changes