Get a volume version
Returns a single version of the volume. Address it with :<tag> for a tag, @<digest> for a full content digest or a prefix of at least 12 hexadecimal characters, or head for the version a reference with no tag or digest resolves to. A digest prefix that matches more than one version is rejected: supply more characters.
Authorizations
Send Authorization: Bearer <api_key>. The legacy Authorization: Api-Key <api_key> scheme is also accepted.
Path Parameters
Response
One version, with the fields only a single-version read reports.
Namespace the volume belongs to, in lowercase.
Name of the volume, in lowercase.
Full address of this version, as bdn:<namespace>/<volume>@<digest>. Paste this into the bdn.mounts section of a config.yaml to pin to it.
Content digest of the version, as b3:<hex>.
Revision the version was committed at. Null for versions committed before the volume service recorded it.
Lifecycle state of the version, for example ALIVE or TOMBSTONED.
Whether the reserved head tag points at this version.
Tags pointing at this version that your API key can read.
Total size of the version's files in bytes. Null when not recorded.
When the version was committed, in ISO 8601 format.
When the version was deleted, in ISO 8601 format. Null unless the lifecycle is TOMBSTONED.
When the version stops being restorable, in ISO 8601 format. Null unless the lifecycle is TOMBSTONED.
Number of files in the version. Null when not recorded.
Revision of the volume as a whole when this version was read. Pass it as expected_sequence on a later delete to make that delete conditional on the volume not having changed since.