From a402c9ced593b0234b156306612b1d7937130b07 Mon Sep 17 00:00:00 2001 From: "hotdata-automation[bot]" <267177015+hotdata-automation[bot]@users.noreply.github.com> Date: Tue, 6 Oct 2026 19:44:52 +0000 Subject: [PATCH] chore(uploads): clarify finalized upload retention period --- CHANGELOG.md | 1 + docs/UploadsApi.md | 2 +- src/apis/uploads_api.rs | 2 +- 3 files changed, 3 insertions(+), 2 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 0ce118f..8274a30 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -9,6 +9,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0 ### Changed +- chore(uploads): clarify finalized upload retention period - chore(loads): clarify idempotency key conflict behavior - chore(uploads): clarify finalize token validation errors - feat(jobs): add ivf_index_hold job type support diff --git a/docs/UploadsApi.md b/docs/UploadsApi.md index d4f07fb..c76fede 100644 --- a/docs/UploadsApi.md +++ b/docs/UploadsApi.md @@ -76,7 +76,7 @@ Name | Type | Description | Required | Notes > models::FinalizeUploadResponse finalize_upload_handler(upload_id, x_upload_finalize_token, finalize_upload_request) Finalize upload -Confirm that a file has been uploaded and make it usable as managed-table contents. Supply the `finalize_token` returned when the session was created, in the `X-Upload-Finalize-Token` header. When you declared a size at create time, the uploaded file's size is validated against it and a mismatch is rejected. An upload created without a declared size is finalized from its uploaded parts; it must be non-empty and is rejected if it exceeds the maximum upload size (16 GiB by default, the same for every file format). Finalize is exactly-once: a second finalize of the same upload is rejected. +Confirm that a file has been uploaded and make it usable as managed-table contents. Supply the `finalize_token` returned when the session was created, in the `X-Upload-Finalize-Token` header. When you declared a size at create time, the uploaded file's size is validated against it and a mismatch is rejected. An upload created without a declared size is finalized from its uploaded parts; it must be non-empty and is rejected if it exceeds the maximum upload size (16 GiB by default, the same for every file format). Finalize is exactly-once: a second finalize of the same upload is rejected. Load a finalized upload within 7 days (by default). An upload that has not been loaded by then is deleted, and loading it afterwards fails as not found. ### Parameters diff --git a/src/apis/uploads_api.rs b/src/apis/uploads_api.rs index bac7ce0..c9f5a9a 100644 --- a/src/apis/uploads_api.rs +++ b/src/apis/uploads_api.rs @@ -181,7 +181,7 @@ pub async fn create_upload_sessions_batch_handler( } } -/// Confirm that a file has been uploaded and make it usable as managed-table contents. Supply the `finalize_token` returned when the session was created, in the `X-Upload-Finalize-Token` header. When you declared a size at create time, the uploaded file's size is validated against it and a mismatch is rejected. An upload created without a declared size is finalized from its uploaded parts; it must be non-empty and is rejected if it exceeds the maximum upload size (16 GiB by default, the same for every file format). Finalize is exactly-once: a second finalize of the same upload is rejected. +/// Confirm that a file has been uploaded and make it usable as managed-table contents. Supply the `finalize_token` returned when the session was created, in the `X-Upload-Finalize-Token` header. When you declared a size at create time, the uploaded file's size is validated against it and a mismatch is rejected. An upload created without a declared size is finalized from its uploaded parts; it must be non-empty and is rejected if it exceeds the maximum upload size (16 GiB by default, the same for every file format). Finalize is exactly-once: a second finalize of the same upload is rejected. Load a finalized upload within 7 days (by default). An upload that has not been loaded by then is deleted, and loading it afterwards fails as not found. pub async fn finalize_upload_handler( configuration: &configuration::Configuration, upload_id: &str,