Skip to content

Accept GLACIER/DEEP_ARCHIVE as cold locations, advertise the Veeam archive tier - #6329

Merged
bert-e merged 4 commits into
development/9.5from
improvement/CLDSRV-988-archive-storage-class
Oct 16, 2026
Merged

bert-e merged 4 commits into
development/9.5from
improvement/CLDSRV-988-archive-storage-class

Conversation

@francoisferrand

@francoisferrand francoisferrand commented Oct 14, 2026 •

Copy link
Copy Markdown
Contributor

Veeam and the AWS CLI only know the official S3 storage classes, so there was no way for them to write directly to a cold location: locations have lower case names, and our UI does not let you create one named GLACIER anyway. This makes the Veeam archive tier (and basic testing with the CLI) impossible.

The PR fills the gap:

  • GLACIER and DEEP_ARCHIVE are accepted as storage classes and resolve to the cold location of the same name (glacier, deep_archive). Objects stored there are reported back with the AWS name, so clients see what they sent. Internally nothing changes: metadata keeps the location name, and the transition works as before.
  • system.xml can carry the EnableOnPremArchiveTier capability. What Veeam gets told reflects what the deployment actually supports (direct-to-cold enabled, and a glacier cold location) rather than a value frozen when the file was written, and trying to enable it on a deployment that cannot do it is refused.
  • RestoreObject now accepts the Bulk and Expedited tiers instead of answering NotImplemented. Veeam may send them; they don't make no difference for us (a restore is a restore), so they are simply ignored.

A note on policies: IAM policies see the storage class as sent (GLACIER), bucket policies see the location name (glacier), because the former are evaluated on the signed request before we touch the header and the latter afterwards.

Issue: CLDSRV-988

@bert-e

bert-e commented Oct 14, 2026

Copy link
Copy Markdown
Contributor

Hello francoisferrand,

My role is to assist you with the merge of this
pull request. Please type @bert-e help to get information
on this process, or consult the user documentation.

Available options
name description privileged authored
/after_pull_request Wait for the given pull request id to be merged before continuing with the current one.
/bypass_author_approval Bypass the pull request author's approval ⭐
/bypass_build_status Bypass the build and test status ⭐
/bypass_commit_size Bypass the check on the size of the changeset TBA ⭐
/bypass_incompatible_branch Bypass the check on the source branch prefix ⭐
/bypass_jira_check Bypass the Jira issue check ⭐
/bypass_peer_approval Bypass the pull request peers' approval ⭐
/bypass_leader_approval Bypass the pull request leaders' approval ⭐
/bypass_source_branch_lineage Bypass the cross-branch contamination check ⭐
/approve Instruct Bert-E that the author has approved the pull request. ✍️
/create_pull_requests Allow the creation of integration pull requests.
/create_integration_branches Allow the creation of integration branches.
/no_octopus Prevent Wall-E from doing any octopus merge and use multiple consecutive merge instead
/unanimity Change review acceptance criteria from one reviewer at least to all reviewers
/wait Instruct Bert-E not to run until further notice.
Available commands
name description privileged
/help Print Bert-E's manual in the pull request.
/status Print Bert-E's current status in the pull request.
/clear Remove all comments from Bert-E from the history TBA
/retry Re-start a fresh build TBA
/build Re-start a fresh build TBA
/force_reset Delete integration branches & pull requests, and restart merge process from the beginning.
/reset Try to remove integration branches unless there are commits on them which do not appear on the source branch.

Status report is not available.

Comment thread lib/api/bucketGet.js
@codecov

codecov Bot commented Oct 14, 2026 •

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 90.23%. Comparing base (0eed88a) to head (76eed95).
⚠️ Report is 4 commits behind head on development/9.5.
✅ All tests successful. No failed tests found.

Additional details and impacted files

Impacted file tree graph

Files with missing lines Coverage Δ
lib/api/apiUtils/object/objectAttributes.js 100.00% <100.00%> (ø)
lib/api/apiUtils/object/storageClass.js 100.00% <100.00%> (ø)
lib/api/bucketGet.js 97.57% <100.00%> (+0.02%) ⬆️
lib/api/listMultipartUploads.js 96.06% <100.00%> (+0.11%) ⬆️
lib/api/listParts.js 93.64% <100.00%> (+0.01%) ⬆️
lib/routes/veeam/put.js 92.47% <100.00%> (+0.08%) ⬆️
lib/routes/veeam/schemas/system.js 100.00% <100.00%> (ø)
lib/routes/veeam/utils.js 96.98% <100.00%> (+0.07%) ⬆️
lib/utilities/collectResponseHeaders.js 100.00% <100.00%> (ø)

... and 1 file with indirect coverage changes

@@                 Coverage Diff                 @@
##           development/9.5    #6329      +/-   ##
===================================================
+ Coverage            90.22%   90.23%   +0.01%     
===================================================
  Files                  206      206              
  Lines                38589    38673      +84     
===================================================
+ Hits                 34817    34897      +80     
- Misses                3772     3776       +4     
Flag Coverage Δ
checksums-disabled-tests 46.21% <57.89%> (+0.02%) ⬆️
file-ft-tests 76.00% <71.57%> (-0.04%) ⬇️
file-ft-tests-null-compat 76.50% <72.63%> (-0.05%) ⬇️
kmip-ft-tests 37.72% <46.31%> (+0.02%) ⬆️
mongo-v0-ft-tests 77.09% <72.63%> (-0.04%) ⬇️
mongo-v1-ft-tests 77.10% <72.63%> (+0.01%) ⬆️
multiple-backend 44.56% <57.89%> (+0.02%) ⬆️
s3c-ft-tests-v0 71.71% <72.63%> (-0.04%) ⬇️
s3c-ft-tests-v0-null-compat 71.77% <72.63%> (+<0.01%) ⬆️
s3c-ft-tests-v1 71.68% <72.63%> (-0.01%) ⬇️
sur-tests 45.17% <76.84%> (+0.07%) ⬆️
sur-tests-inflights 48.57% <76.84%> (+0.06%) ⬆️
unit 79.76% <97.89%> (+0.03%) ⬆️
utapi-v2-tests 45.13% <56.84%> (+0.02%) ⬆️

Flags with carried forward coverage won't be shown. Click here to find out more.

🚀 New features to boost your workflow:
  • 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

@bert-e

bert-e commented Oct 14, 2026

Copy link
Copy Markdown
Contributor

Request integration branches

Waiting for integration branch creation to be requested by the user.

To request integration branches, please comment on this pull request with the following command:

/create_integration_branches

Alternatively, the /approve and /create_pull_requests commands will automatically
create the integration branches.

@scality scality deleted a comment from bert-e Oct 14, 2026
@francoisferrand
francoisferrand force-pushed the improvement/CLDSRV-988-archive-storage-class branch from 6957fbd to 6b5a944 Compare October 14, 2026 22:08
Comment thread lib/api/apiUtils/object/storageClass.js
Comment thread lib/routes/veeam/schemas/system.js Outdated
@francoisferrand
francoisferrand force-pushed the improvement/CLDSRV-988-archive-storage-class branch 2 times, most recently from 93118d6 to b60553f Compare October 15, 2026 14:12
@francoisferrand
francoisferrand requested review from a team, benzekrimaha and delthas October 15, 2026 14:54
@francoisferrand
francoisferrand marked this pull request as ready for review October 15, 2026 14:55
@francoisferrand
francoisferrand requested review from DarkIsDude and removed request for delthas October 16, 2026 07:41
Comment thread lib/api/apiUtils/object/storageClass.js
Comment thread constants.js
Comment thread lib/api/listMultipartUploads.js Outdated
Comment thread lib/routes/veeam/schemas/system.js Outdated
@francoisferrand
francoisferrand force-pushed the improvement/CLDSRV-988-archive-storage-class branch from b5780c1 to bb1089d Compare October 16, 2026 14:36
Standard S3 clients (AWS CLI, Veeam...) only accept the official storage
class names, so they cannot write directly to a cold location: the
location names are lower case, and cannot be created with an upper case
name anyway.

GLACIER and DEEP_ARCHIVE in x-amz-storage-class are now mapped to a
location of the same (lower case) name, when the header is validated by
the object write APIs. IAM policies are evaluated before that (by Vault,
on the signed header), so they apply to the storage class as sent by the
client; bucket policies are evaluated afterwards, so they apply to the
location name. Conversely, an object stored in a location named after
one of these classes is reported with the AWS name in HeadObject,
GetObject, ListObjects(Versions), GetObjectAttributes, ListParts and
ListMultipartUploads.

Issue: CLDSRV-988
Veeam only offers a bucket as an on-premises archive tier when its
system.xml declares the EnableOnPremArchiveTier capability. The field is
now part of the SOSAPI schema.

Whether the archive tier can actually be used depends on the deployment:
Veeam writes to it with the GLACIER storage class, which needs
direct-to-cold writes and a cold location named glacier. This can change
after system.xml was written, so the served value is computed on read:
what is supported when the field is not set, and otherwise the stored
value, still restricted to what is supported. Setting it to true is
rejected when not supported, rather than silently serving false.

Issue: CLDSRV-988
RestoreObject rejected the Bulk and Expedited tiers with NotImplemented,
although there is nothing to implement: the restore from a cold location
is the same whatever the tier, which is only an AWS pricing/latency
option. Veeam (and any client exposing the option) could not restore from
the archive tier with a non-default tier.

All three tiers are now accepted, and ignored.

Issue: CLDSRV-988
@francoisferrand
francoisferrand force-pushed the improvement/CLDSRV-988-archive-storage-class branch from bb1089d to 76eed95 Compare October 16, 2026 16:45
Comment thread package.json
@francoisferrand

Copy link
Copy Markdown
Contributor Author

/approve

@scality scality deleted a comment from bert-e Oct 16, 2026
@bert-e

bert-e commented Oct 16, 2026

Copy link
Copy Markdown
Contributor

I have successfully merged the changeset of this pull request
into targetted development branches:

  • ✔️ development/9.5

  • ✔️ development/9.6

The following branches have NOT changed:

  • development/7.10
  • development/7.4
  • development/7.70
  • development/8.8
  • development/9.0
  • development/9.1
  • development/9.2
  • development/9.3
  • development/9.4

This pull request did not target the following hotfix branch(es) so they
were left untouched:

  • hotfix/7.70.21
  • hotfix/7.70.73
  • hotfix/8.8.45
  • hotfix/7.10.27
  • hotfix/7.10.3
  • hotfix/7.10.49
  • hotfix/7.4.2
  • hotfix/7.2.0
  • hotfix/7.10.8
  • hotfix/7.8.0
  • hotfix/7.10.0
  • hotfix/7.4.4
  • hotfix/7.7.0
  • hotfix/7.10.30
  • hotfix/9.2.36
  • hotfix/9.0.7
  • hotfix/9.0.32
  • hotfix/7.4.10
  • hotfix/7.70.11
  • hotfix/7.4.9
  • hotfix/7.4.5
  • hotfix/7.6.0
  • hotfix/7.10.15
  • hotfix/7.70.45
  • hotfix/7.4.7
  • hotfix/7.4.1
  • hotfix/9.3.13
  • hotfix/7.10.2
  • hotfix/7.4.6
  • hotfix/7.10.4
  • hotfix/9.2.24
  • hotfix/7.10.1
  • hotfix/7.10.28
  • hotfix/7.4.8
  • hotfix/7.4.0
  • hotfix/7.70.51
  • hotfix/7.9.0
  • hotfix/6.4.7
  • hotfix/7.4.3

Please check the status of the associated issue CLDSRV-988.

Goodbye francoisferrand.

The following options are set: approve

@bert-e
bert-e merged commit 76eed95 into development/9.5 Oct 16, 2026
39 checks passed
@bert-e
bert-e deleted the improvement/CLDSRV-988-archive-storage-class branch October 16, 2026 17:16
@eve-ci-cd
eve-ci-cd Bot had a problem deploying to zenko/improvement/ZENKO-5376@2.16 October 16, 2026 17:39 Failure
@eve-ci-cd
eve-ci-cd Bot deployed to zenko/improvement/ZENKO-5376@2.16 October 16, 2026 19:25 Active
@eve-ci-cd
eve-ci-cd Bot deployed to zenko/development/2.16 October 17, 2026 08:22 Active
@eve-ci-cd
eve-ci-cd Bot deployed to zenko/2.16.0-preview.4 October 17, 2026 09:29 Active

This branch was successfully deployed

3 active deployments
zenko/2.16.0-preview.4 — 76eed955 Deployed Oct 17, 2026 by eve-ci-cd[bot]
zenko/development/2.16 — 76eed955 Deployed Oct 17, 2026 by eve-ci-cd[bot]
zenko/improvement/ZENKO-5376@2.16 — 76eed955 Deployed Oct 16, 2026 by eve-ci-cd[bot]
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.

4 participants