Skip to content

docs(s3): clarify AWS CLI v2.23+ workaround + restructure lifecycle/d…#308

Open
aelttil wants to merge 2 commits into
devfrom
fix/s3-doc-aws-cli-and-concepts
Open

docs(s3): clarify AWS CLI v2.23+ workaround + restructure lifecycle/d…#308
aelttil wants to merge 2 commits into
devfrom
fix/s3-doc-aws-cli-and-concepts

Conversation

@aelttil
Copy link
Copy Markdown
Contributor

@aelttil aelttil commented May 27, 2026

…eletion concepts

  • quickstart.md: rewrite the AWS CLI section to explicitly mention the v2.23.0+ default CRC64NVME issue on ECS-based storage. Sets both request_checksum_calculation AND response_checksum_validation to when_required (the latter was missing — downloads can also fail without it). Restores the endpoint explanation that was removed.

  • concepts.md: introduce "Gestion du cycle de vie et protection des données" section that clearly separates two often-confused mechanisms:

    • lifecycle policy → actively deletes objects after N days
    • deletion protection → passively prevents deletion for N days Adds a note explaining the difference with standard S3 Object Lock (Cloud Temple's mechanism is bucket-level, doesn't require versioning).
  • quickstart.md: move detailed concept explanations to concepts.md (the quickstart stays action-focused) and link between the two pages.

Supersedes #304. Empirically tested on a CT S3 bucket:

  • XAmzContentSHA256Mismatch reproduced without the fix
  • both request_checksum_calculation and response_checksum_validation validated end-to-end (upload + download)

…eletion concepts

- quickstart.md: rewrite the AWS CLI section to explicitly mention the
  v2.23.0+ default CRC64NVME issue on ECS-based storage. Sets both
  request_checksum_calculation AND response_checksum_validation to
  when_required (the latter was missing — downloads can also fail
  without it). Restores the endpoint explanation that was removed.

- concepts.md: introduce "Gestion du cycle de vie et protection des
  données" section that clearly separates two often-confused mechanisms:
    * lifecycle policy → actively deletes objects after N days
    * deletion protection → passively prevents deletion for N days
  Adds a note explaining the difference with standard S3 Object Lock
  (Cloud Temple's mechanism is bucket-level, doesn't require versioning).

- quickstart.md: move detailed concept explanations to concepts.md
  (the quickstart stays action-focused) and link between the two pages.

Supersedes #304. Empirically tested on a CT S3 bucket:
- XAmzContentSHA256Mismatch reproduced without the fix
- both request_checksum_calculation and response_checksum_validation
  validated end-to-end (upload + download)

Co-Authored-By: bquinsac <119865939+bquinsac@users.noreply.github.com>
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
…eality

Following review feedback on the previous draft of the lifecycle vs.
deletion protection section:

- Lifecycle: drop the inaccurate claim that ECS automatically deletes
  expired objects. The Lifecycle Delete Scanner (LDS) is disabled by
  default on ECS 3.2.1+, so actual deletion depends on platform-side
  configuration. Adds an :::info note pointing users to support if
  expiration doesn't take effect.

- Deletion protection: clarify that activation is NOT self-service —
  it requires an explicit support request, and is contractually binding.

- Adds a :::danger block on irreversibility with explicit business
  consequences:
    * the configured duration cannot be shortened, even by Cloud Temple
    * if a 99-year protection is set, the data is locked for 99 years
    * if the customer stops using the service or terminates the contract,
      the locked volume remains billable pro-rata until the period ends
    * no bypass mechanism exists (shared SecNumCloud infrastructure)

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant