Summary
Let head inspect a specific file version by file-id and expose the full metadata fields the SDK returns for file versions.
Why
head currently works by file name only. That cannot inspect historical versions, hidden versions, or an exact version selected from listFileVersions. The SDK also returns richer metadata than the action currently emits, including encryption, Object Lock, legal hold, and replication status, which are useful for audits and compliance checks.
SDK support (already available)
B2Object.headById(fileId, options)
B2Object.getFileInfo(fileId)
RawClient.getFileInfo(...)
FileVersion.serverSideEncryption
FileVersion.fileRetention
FileVersion.legalHold
FileVersion.replicationStatus
Proposed surface
New input:
file-id: when supplied with action: head, inspect that exact version instead of resolving by name.
New/expanded outputs in summary-json and step outputs:
server-side-encryption
file-retention
legal-hold
replication-status
- exact
file-id and file-name
Acceptance criteria
Out of scope
Summary
Let
headinspect a specific file version byfile-idand expose the full metadata fields the SDK returns for file versions.Why
headcurrently works by file name only. That cannot inspect historical versions, hidden versions, or an exact version selected fromlistFileVersions. The SDK also returns richer metadata than the action currently emits, including encryption, Object Lock, legal hold, and replication status, which are useful for audits and compliance checks.SDK support (already available)
B2Object.headById(fileId, options)B2Object.getFileInfo(fileId)RawClient.getFileInfo(...)FileVersion.serverSideEncryptionFileVersion.fileRetentionFileVersion.legalHoldFileVersion.replicationStatusProposed surface
New input:
file-id: when supplied withaction: head, inspect that exact version instead of resolving by name.New/expanded outputs in
summary-jsonand step outputs:server-side-encryptionfile-retentionlegal-holdreplication-statusfile-idandfile-nameAcceptance criteria
headcan inspect a specific version byfile-id.headbehavior remains unchanged whenfile-idis omitted.summary-jsonincludes encryption, retention, legal hold, and replication status when the SDK provides them.Out of scope