List changes after a sequence

GET

/v0/namespaces/{namespace_id}/changes

Returns committed changes after a sequence. A snapshot limits the feed to its captured sequence.

Authorizations

• bearer_auth

Parameters

Path Parameters

namespace_id

required

string

Namespace id

Query Parameters

after_seq

required

Sequence number assigned to a namespace commit. It determines the order in which commits become visible.

integer format: int64

<= 9007199254740991

Return committed changes after this sequence

limit

integer format: int32

default: 1000 >= 1 <= 1000

Maximum page size

snapshot_id

Durable pin identifier. The manifest number determines which namespace manifest it pins.

string

/^pin_[0-9]{20}-[0-9a-f]{16}$/

Example

pin_00000000000000000001-0000000000000002

End the feed at this snapshot’s captured sequence

Responses

200

Committed changes

Change-feed response after a cursor.

object

after_seq

required

Exclusive cursor supplied by the caller, or the endpoint’s initial position.

integer format: int64

<= 9007199254740991

changes

required

Logical commits after after_seq, ordered by ascending namespace sequence.

Array<object>

One committed logical commit: its identity and the events it applied.

object

commit_id

required

The idempotency key for the commit.

string

/^[a-z0-9][a-z0-9._-]{0,127}$/

Example

c_f3a9c2d4b6e8417a90c5d2f8e1b7a6c0

committed_at_ms

required

The commit time in Unix milliseconds; committed_seq defines commit order.

integer format: int64

committed_by

required

Actor responsible for the commit, as supplied by the application.

string

/^[\x21-\x7E]{1,256}$/

Example

usr_8f3c

committed_seq

required

Sequence number where the commit became visible.

integer format: int64

<= 9007199254740991

events

required

The semantic filesystem operations the commit applied, in request order.

Array

One of: discriminator: kind

directory_created

directory_created

A directory was created.

object

binding_version

required

Opaque identifier for the binding created by this event.

string

/^[0-9a-f]+$/

display_name

required

User-facing spelling of the new entry.

string

Example

report.txt

inode_id

required

Newly allocated namespace-scoped inode identity.

string

/^ino_[1-9][0-9]*$/

Example

ino_123

kind

required

string

Allowed values: directory_created

parent_inode_id

required

Directory the new entry was bound under.

string

/^ino_[1-9][0-9]*$/

Example

ino_123

file_created

file_created

A file and its first revision were created.

object

binding_version

required

Opaque identifier for the binding created by this event.

string

/^[0-9a-f]+$/

content_ref

required

Content of the first revision.

object

checksum

required

Mandatory checksum over the complete object.

object

algorithm

required

Algorithm that produced value.

string

Allowed values: sha256 crc64nvme crc32c

value

required

The canonical lowercase hexadecimal checksum without a prefix.

string

content_id

required

Immutable identity of the content; with the owner, it determines the object key.

string

/^con_[0-9a-f]{32}$/

Example

con_9f2a6c0e4b7d4a90b13f0d8c5e6a2b41

kind

required

Content strategy used by the referenced content.

string

Allowed values: blob_v1

owner_namespace_id

required

Namespace that originally wrote the bytes.

string

/^[a-z0-9][a-z0-9._-]{0,127}$/

Example

demo

size_bytes

required

Complete byte length of the referenced content.

integer format: int64

display_name

required

User-facing spelling of the new entry.

string

Example

report.txt

inode_id

required

Newly allocated namespace-scoped inode identity.

string

/^ino_[1-9][0-9]*$/

Example

ino_123

kind

required

string

Allowed values: file_created

parent_inode_id

required

Directory the new entry was bound under.

string

/^ino_[1-9][0-9]*$/

Example

ino_123

revision_no

required

First revision number.

integer format: int64

<= 9007199254740991

content_changed

content_changed

A file received a new current revision from a put or revision restore.

object

content_ref

required

Immutable content published by the revision.

object

checksum

required

Mandatory checksum over the complete object.

object

algorithm

required

Algorithm that produced value.

string

Allowed values: sha256 crc64nvme crc32c

value

required

The canonical lowercase hexadecimal checksum without a prefix.

string

content_id

required

Immutable identity of the content; with the owner, it determines the object key.

string

/^con_[0-9a-f]{32}$/

Example

con_9f2a6c0e4b7d4a90b13f0d8c5e6a2b41

kind

required

Content strategy used by the referenced content.

string

Allowed values: blob_v1

owner_namespace_id

required

Namespace that originally wrote the bytes.

string

/^[a-z0-9][a-z0-9._-]{0,127}$/

Example

demo

size_bytes

required

Complete byte length of the referenced content.

integer format: int64

inode_id

required

File inode whose history advanced.

string

/^ino_[1-9][0-9]*$/

Example

ino_123

kind

required

string

Allowed values: content_changed

revision_no

required

New monotonic position in that file’s revision history.

integer format: int64

<= 9007199254740991

moved

moved

An inode moved to a new parent directory or name.

object

binding_version

required

Opaque identifier for the binding created by this event.

string

/^[0-9a-f]+$/

destination_display_name

required

Spelling of the new binding.

string

Example

report.txt

destination_parent_inode_id

required

Directory holding the new binding.

string

/^ino_[1-9][0-9]*$/

Example

ino_123

inode_id

required

Inode whose binding changed.

string

/^ino_[1-9][0-9]*$/

Example

ino_123

kind

required

string

Allowed values: moved

source_display_name

required

Spelling of the removed binding.

string

Example

report.txt

source_parent_inode_id

required

Directory that held the removed binding.

string

/^ino_[1-9][0-9]*$/

Example

ino_123

deleted

deleted

A file or directory subtree was deleted.

object

deleted_binding

required

Directory binding removed by the deletion.

object

display_name

required

Name shown to users.

string

Example

report.txt

name_key

required

Name used to look up the entry.

string

Example

report.txt

parent_inode_id

required

Parent directory containing the entry.

string

/^ino_[1-9][0-9]*$/

Example

ino_123

inode_id

required

Inode at the root of the deleted subtree.

string

/^ino_[1-9][0-9]*$/

Example

ino_123

kind

required

string

Allowed values: deleted

undeleted

undeleted

A deleted inode was recovered and re-bound.

object

binding_version

required

Opaque identifier for the binding created by this event.

string

/^[0-9a-f]+$/

display_name

required

Spelling of the recovered binding.

string

Example

report.txt

inode_id

required

Recovered inode.

string

/^ino_[1-9][0-9]*$/

Example

ino_123

kind

required

string

Allowed values: undeleted

parent_inode_id

required

Directory the recovered entry was bound under.

string

/^ino_[1-9][0-9]*$/

Example

ino_123

attributes_changed

attributes_changed

An inode’s attributes changed.

object

attributes

required

The inode’s complete attribute map after the update, including an empty map when all attributes were cleared.

object

key

additional properties

A validated inode attribute value of at most 4,096 UTF-8 bytes.

Empty strings and control characters are valid, and only an explicit remove operation deletes an attribute.

string

Example

platform

attributes_revision_no

required

New attribute revision for that inode.

integer format: int64

<= 9007199254740991

inode_id

required

Inode whose attributes advanced.

string

/^ino_[1-9][0-9]*$/

Example

ino_123

kind

required

string

Allowed values: attributes_changed

access_changed

access_changed

An inode’s access row was replaced. grants is the complete direct grant map after the update.

object

access_revision_no

required

Revision published by the update.

integer format: int64

<= 9007199254740991

boundary

required

Whether the directory stops inheritance from its ancestors.

boolean

grants

required

The inode’s complete direct grants after this update.

object

key

additional properties

A set of rights. Encoded as distinct names in read, history, write, create, remove, share, manage, admin order. Decoding accepts any order and rejects repeated names.

Array<string>

Allowed values: read history write create remove share manage admin

inode_id

required

Inode whose access state advanced.

string

/^ino_[1-9][0-9]*$/

Example

ino_123

kind

required

string

Allowed values: access_changed

message

The optional caller annotation for the commit.

string

namespace_id

required

Namespace that changed.

string

/^[a-z0-9][a-z0-9._-]{0,127}$/

Example

demo

namespace_id

required

Namespace whose ordered commit stream was read.

string

/^[a-z0-9][a-z0-9._-]{0,127}$/

Example

demo

next_after_seq

Cursor to request when another page remains, absent at through_seq.

integer format: int64

<= 9007199254740991

through_seq

required

Namespace head through which this page was evaluated.

integer format: int64

<= 9007199254740991

400

Invalid change cursor, limit, snapshot id, non-snapshot checkpoint, or after_seq above the snapshot sequence

HTTP error body used by LoonFS APIs.

object

code

required

The stable machine-readable error code as a string.

string

details

The optional machine-readable context for the error code.

object

active_acquired_at_ms

The Unix-millisecond time when the current writer acquired its epoch, when available.

integer format: int64

active_writer_epoch

Epoch that currently owns the namespace.

integer format: int64

<= 9007199254740991

active_writer_id

The writer ID recorded for the current epoch, when available.

string

actual_access_revision_no

Access revision that is actually current for the inode.

integer format: int64

<= 9007199254740991

actual_attributes_revision_no

Attribute revision that is actually current for the inode.

integer format: int64

<= 9007199254740991

actual_binding_version

Current binding token; absent for the root, which has no binding.

string

/^[0-9a-f]+$/

actual_deletion_seq

Deletion sequence actually active for the inode.

integer format: int64

<= 9007199254740991

actual_head_seq

The actual namespace head sequence.

integer format: int64

<= 9007199254740991

actual_inode_id

The path actually contained this inode.

string

/^ino_[1-9][0-9]*$/

Example

ino_123

actual_revision_no

Revision that is actually current; absent when the inode has none.

integer format: int64

<= 9007199254740991

after_seq

Change-feed cursor the request asked to resume after.

integer format: int64

<= 9007199254740991

commit_id

Idempotency key of the commit the error concerns.

string

/^[a-z0-9][a-z0-9._-]{0,127}$/

Example

c_f3a9c2d4b6e8417a90c5d2f8e1b7a6c0

committed_fingerprint

The fingerprint of the mutation that landed under commit_id, present with committed_seq.

string

committed_seq

The sequence where this commit ID already landed, when recorded by a durable receipt.

integer format: int64

<= 9007199254740991

expected_access_revision_no

Access revision the request expected to be current.

integer format: int64

<= 9007199254740991

expected_attributes_revision_no

Attribute revision the request expected to be current.

integer format: int64

<= 9007199254740991

expected_binding_version

Opaque binding token supplied by the request.

string

/^[0-9a-f]+$/

expected_deletion_seq

Deletion sequence the undelete expected to be active.

integer format: int64

<= 9007199254740991

expected_head_seq

The head sequence required by the request.

integer format: int64

<= 9007199254740991

expected_inode_id

The request expected the path to contain this inode.

string

/^ino_[1-9][0-9]*$/

Example

ino_123

expected_revision_no

Revision the request expected to be current.

integer format: int64

<= 9007199254740991

fenced_writer_epoch

Epoch the failing writer session held when it was displaced.

integer format: int64

<= 9007199254740991

inode_id

Inode the failed precondition or operation targeted.

string

/^ino_[1-9][0-9]*$/

Example

ino_123

max_writer_sessions

Maximum writer sessions admitted by the node.

integer

namespace_id

The deleted namespace that caused the operation to fail.

string

/^[a-z0-9][a-z0-9._-]{0,127}$/

Example

demo

operation_index

The index of the failed operation in the request.

integer format: int32

precondition_index

Zero-based position of the failed request precondition.

integer format: int32

retention_floor_seq

Oldest sequence still promised for incremental replay.

integer format: int64

<= 9007199254740991

feature

The capability feature key for a not_supported error.

string

message

required

Human-readable error message.

string

param

The invalid JSON Pointer, parameter name, CLI flag, or CLI argument.

string

request_id

The request correlation ID also sent in the x-request-id response header.

string

401

Unauthorized

HTTP error body used by LoonFS APIs.

object

code

required

The stable machine-readable error code as a string.

string

details

The optional machine-readable context for the error code.

object

active_acquired_at_ms

The Unix-millisecond time when the current writer acquired its epoch, when available.

integer format: int64

active_writer_epoch

Epoch that currently owns the namespace.

integer format: int64

<= 9007199254740991

active_writer_id

The writer ID recorded for the current epoch, when available.

string

actual_access_revision_no

Access revision that is actually current for the inode.

integer format: int64

<= 9007199254740991

actual_attributes_revision_no

Attribute revision that is actually current for the inode.

integer format: int64

<= 9007199254740991

actual_binding_version

Current binding token; absent for the root, which has no binding.

string

/^[0-9a-f]+$/

actual_deletion_seq

Deletion sequence actually active for the inode.

integer format: int64

<= 9007199254740991

actual_head_seq

The actual namespace head sequence.

integer format: int64

<= 9007199254740991

actual_inode_id

The path actually contained this inode.

string

/^ino_[1-9][0-9]*$/

Example

ino_123

actual_revision_no

Revision that is actually current; absent when the inode has none.

integer format: int64

<= 9007199254740991

after_seq

Change-feed cursor the request asked to resume after.

integer format: int64

<= 9007199254740991

commit_id

Idempotency key of the commit the error concerns.

string

/^[a-z0-9][a-z0-9._-]{0,127}$/

Example

c_f3a9c2d4b6e8417a90c5d2f8e1b7a6c0

committed_fingerprint

The fingerprint of the mutation that landed under commit_id, present with committed_seq.

string

committed_seq

The sequence where this commit ID already landed, when recorded by a durable receipt.

integer format: int64

<= 9007199254740991

expected_access_revision_no

Access revision the request expected to be current.

integer format: int64

<= 9007199254740991

expected_attributes_revision_no

Attribute revision the request expected to be current.

integer format: int64

<= 9007199254740991

expected_binding_version

Opaque binding token supplied by the request.

string

/^[0-9a-f]+$/

expected_deletion_seq

Deletion sequence the undelete expected to be active.

integer format: int64

<= 9007199254740991

expected_head_seq

The head sequence required by the request.

integer format: int64

<= 9007199254740991

expected_inode_id

The request expected the path to contain this inode.

string

/^ino_[1-9][0-9]*$/

Example

ino_123

expected_revision_no

Revision the request expected to be current.

integer format: int64

<= 9007199254740991

fenced_writer_epoch

Epoch the failing writer session held when it was displaced.

integer format: int64

<= 9007199254740991

inode_id

Inode the failed precondition or operation targeted.

string

/^ino_[1-9][0-9]*$/

Example

ino_123

max_writer_sessions

Maximum writer sessions admitted by the node.

integer

namespace_id

The deleted namespace that caused the operation to fail.

string

/^[a-z0-9][a-z0-9._-]{0,127}$/

Example

demo

operation_index

The index of the failed operation in the request.

integer format: int32

precondition_index

Zero-based position of the failed request precondition.

integer format: int32

retention_floor_seq

Oldest sequence still promised for incremental replay.

integer format: int64

<= 9007199254740991

feature

The capability feature key for a not_supported error.

string

message

required

Human-readable error message.

string

param

The invalid JSON Pointer, parameter name, CLI flag, or CLI argument.

string

request_id

The request correlation ID also sent in the x-request-id response header.

string

404

Namespace or snapshot not found

HTTP error body used by LoonFS APIs.

object

code

required

The stable machine-readable error code as a string.

string

details

The optional machine-readable context for the error code.

object

active_acquired_at_ms

The Unix-millisecond time when the current writer acquired its epoch, when available.

integer format: int64

active_writer_epoch

Epoch that currently owns the namespace.

integer format: int64

<= 9007199254740991

active_writer_id

The writer ID recorded for the current epoch, when available.

string

actual_access_revision_no

Access revision that is actually current for the inode.

integer format: int64

<= 9007199254740991

actual_attributes_revision_no

Attribute revision that is actually current for the inode.

integer format: int64

<= 9007199254740991

actual_binding_version

Current binding token; absent for the root, which has no binding.

string

/^[0-9a-f]+$/

actual_deletion_seq

Deletion sequence actually active for the inode.

integer format: int64

<= 9007199254740991

actual_head_seq

The actual namespace head sequence.

integer format: int64

<= 9007199254740991

actual_inode_id

The path actually contained this inode.

string

/^ino_[1-9][0-9]*$/

Example

ino_123

actual_revision_no

Revision that is actually current; absent when the inode has none.

integer format: int64

<= 9007199254740991

after_seq

Change-feed cursor the request asked to resume after.

integer format: int64

<= 9007199254740991

commit_id

Idempotency key of the commit the error concerns.

string

/^[a-z0-9][a-z0-9._-]{0,127}$/

Example

c_f3a9c2d4b6e8417a90c5d2f8e1b7a6c0

committed_fingerprint

The fingerprint of the mutation that landed under commit_id, present with committed_seq.

string

committed_seq

The sequence where this commit ID already landed, when recorded by a durable receipt.

integer format: int64

<= 9007199254740991

expected_access_revision_no

Access revision the request expected to be current.

integer format: int64

<= 9007199254740991

expected_attributes_revision_no

Attribute revision the request expected to be current.

integer format: int64

<= 9007199254740991

expected_binding_version

Opaque binding token supplied by the request.

string

/^[0-9a-f]+$/

expected_deletion_seq

Deletion sequence the undelete expected to be active.

integer format: int64

<= 9007199254740991

expected_head_seq

The head sequence required by the request.

integer format: int64

<= 9007199254740991

expected_inode_id

The request expected the path to contain this inode.

string

/^ino_[1-9][0-9]*$/

Example

ino_123

expected_revision_no

Revision the request expected to be current.

integer format: int64

<= 9007199254740991

fenced_writer_epoch

Epoch the failing writer session held when it was displaced.

integer format: int64

<= 9007199254740991

inode_id

Inode the failed precondition or operation targeted.

string

/^ino_[1-9][0-9]*$/

Example

ino_123

max_writer_sessions

Maximum writer sessions admitted by the node.

integer

namespace_id

The deleted namespace that caused the operation to fail.

string

/^[a-z0-9][a-z0-9._-]{0,127}$/

Example

demo

operation_index

The index of the failed operation in the request.

integer format: int32

precondition_index

Zero-based position of the failed request precondition.

integer format: int32

retention_floor_seq

Oldest sequence still promised for incremental replay.

integer format: int64

<= 9007199254740991

feature

The capability feature key for a not_supported error.

string

message

required

Human-readable error message.

string

param

The invalid JSON Pointer, parameter name, CLI flag, or CLI argument.

string

request_id

The request correlation ID also sent in the x-request-id response header.

string

409

The cursor is older than the retained change history; restart from a fresh listing or checkpoint

HTTP error body used by LoonFS APIs.

object

code

required

The stable machine-readable error code as a string.

string

details

The optional machine-readable context for the error code.

object

active_acquired_at_ms

The Unix-millisecond time when the current writer acquired its epoch, when available.

integer format: int64

active_writer_epoch

Epoch that currently owns the namespace.

integer format: int64

<= 9007199254740991

active_writer_id

The writer ID recorded for the current epoch, when available.

string

actual_access_revision_no

Access revision that is actually current for the inode.

integer format: int64

<= 9007199254740991

actual_attributes_revision_no

Attribute revision that is actually current for the inode.

integer format: int64

<= 9007199254740991

actual_binding_version

Current binding token; absent for the root, which has no binding.

string

/^[0-9a-f]+$/

actual_deletion_seq

Deletion sequence actually active for the inode.

integer format: int64

<= 9007199254740991

actual_head_seq

The actual namespace head sequence.

integer format: int64

<= 9007199254740991

actual_inode_id

The path actually contained this inode.

string

/^ino_[1-9][0-9]*$/

Example

ino_123

actual_revision_no

Revision that is actually current; absent when the inode has none.

integer format: int64

<= 9007199254740991

after_seq

Change-feed cursor the request asked to resume after.

integer format: int64

<= 9007199254740991

commit_id

Idempotency key of the commit the error concerns.

string

/^[a-z0-9][a-z0-9._-]{0,127}$/

Example

c_f3a9c2d4b6e8417a90c5d2f8e1b7a6c0

committed_fingerprint

The fingerprint of the mutation that landed under commit_id, present with committed_seq.

string

committed_seq

The sequence where this commit ID already landed, when recorded by a durable receipt.

integer format: int64

<= 9007199254740991

expected_access_revision_no

Access revision the request expected to be current.

integer format: int64

<= 9007199254740991

expected_attributes_revision_no

Attribute revision the request expected to be current.

integer format: int64

<= 9007199254740991

expected_binding_version

Opaque binding token supplied by the request.

string

/^[0-9a-f]+$/

expected_deletion_seq

Deletion sequence the undelete expected to be active.

integer format: int64

<= 9007199254740991

expected_head_seq

The head sequence required by the request.

integer format: int64

<= 9007199254740991

expected_inode_id

The request expected the path to contain this inode.

string

/^ino_[1-9][0-9]*$/

Example

ino_123

expected_revision_no

Revision the request expected to be current.

integer format: int64

<= 9007199254740991

fenced_writer_epoch

Epoch the failing writer session held when it was displaced.

integer format: int64

<= 9007199254740991

inode_id

Inode the failed precondition or operation targeted.

string

/^ino_[1-9][0-9]*$/

Example

ino_123

max_writer_sessions

Maximum writer sessions admitted by the node.

integer

namespace_id

The deleted namespace that caused the operation to fail.

string

/^[a-z0-9][a-z0-9._-]{0,127}$/

Example

demo

operation_index

The index of the failed operation in the request.

integer format: int32

precondition_index

Zero-based position of the failed request precondition.

integer format: int32

retention_floor_seq

Oldest sequence still promised for incremental replay.

integer format: int64

<= 9007199254740991

feature

The capability feature key for a not_supported error.

string

message

required

Human-readable error message.

string

param

The invalid JSON Pointer, parameter name, CLI flag, or CLI argument.

string

request_id

The request correlation ID also sent in the x-request-id response header.

string

410

Namespace deleted or snapshot deleted or expired

HTTP error body used by LoonFS APIs.

object

code

required

The stable machine-readable error code as a string.

string

details

The optional machine-readable context for the error code.

object

active_acquired_at_ms

The Unix-millisecond time when the current writer acquired its epoch, when available.

integer format: int64

active_writer_epoch

Epoch that currently owns the namespace.

integer format: int64

<= 9007199254740991

active_writer_id

The writer ID recorded for the current epoch, when available.

string

actual_access_revision_no

Access revision that is actually current for the inode.

integer format: int64

<= 9007199254740991

actual_attributes_revision_no

Attribute revision that is actually current for the inode.

integer format: int64

<= 9007199254740991

actual_binding_version

Current binding token; absent for the root, which has no binding.

string

/^[0-9a-f]+$/

actual_deletion_seq

Deletion sequence actually active for the inode.

integer format: int64

<= 9007199254740991

actual_head_seq

The actual namespace head sequence.

integer format: int64

<= 9007199254740991

actual_inode_id

The path actually contained this inode.

string

/^ino_[1-9][0-9]*$/

Example

ino_123

actual_revision_no

Revision that is actually current; absent when the inode has none.

integer format: int64

<= 9007199254740991

after_seq

Change-feed cursor the request asked to resume after.

integer format: int64

<= 9007199254740991

commit_id

Idempotency key of the commit the error concerns.

string

/^[a-z0-9][a-z0-9._-]{0,127}$/

Example

c_f3a9c2d4b6e8417a90c5d2f8e1b7a6c0

committed_fingerprint

The fingerprint of the mutation that landed under commit_id, present with committed_seq.

string

committed_seq

The sequence where this commit ID already landed, when recorded by a durable receipt.

integer format: int64

<= 9007199254740991

expected_access_revision_no

Access revision the request expected to be current.

integer format: int64

<= 9007199254740991

expected_attributes_revision_no

Attribute revision the request expected to be current.

integer format: int64

<= 9007199254740991

expected_binding_version

Opaque binding token supplied by the request.

string

/^[0-9a-f]+$/

expected_deletion_seq

Deletion sequence the undelete expected to be active.

integer format: int64

<= 9007199254740991

expected_head_seq

The head sequence required by the request.

integer format: int64

<= 9007199254740991

expected_inode_id

The request expected the path to contain this inode.

string

/^ino_[1-9][0-9]*$/

Example

ino_123

expected_revision_no

Revision the request expected to be current.

integer format: int64

<= 9007199254740991

fenced_writer_epoch

Epoch the failing writer session held when it was displaced.

integer format: int64

<= 9007199254740991

inode_id

Inode the failed precondition or operation targeted.

string

/^ino_[1-9][0-9]*$/

Example

ino_123

max_writer_sessions

Maximum writer sessions admitted by the node.

integer

namespace_id

The deleted namespace that caused the operation to fail.

string

/^[a-z0-9][a-z0-9._-]{0,127}$/

Example

demo

operation_index

The index of the failed operation in the request.

integer format: int32

precondition_index

Zero-based position of the failed request precondition.

integer format: int32

retention_floor_seq

Oldest sequence still promised for incremental replay.

integer format: int64

<= 9007199254740991

feature

The capability feature key for a not_supported error.

string

message

required

Human-readable error message.

string

param

The invalid JSON Pointer, parameter name, CLI flag, or CLI argument.

string

request_id

The request correlation ID also sent in the x-request-id response header.

string

503

The server cannot complete the request now. Inspect code to determine whether the cause is a deadline, shutdown, load, writer-session admission, required maintenance, or invalid storage credentials. A mutation may still complete after a deadline or lost acknowledgment, so determine its outcome before retrying.

HTTP error body used by LoonFS APIs.

object

code

required

The stable machine-readable error code as a string.

string

details

The optional machine-readable context for the error code.

object

active_acquired_at_ms

The Unix-millisecond time when the current writer acquired its epoch, when available.

integer format: int64

active_writer_epoch

Epoch that currently owns the namespace.

integer format: int64

<= 9007199254740991

active_writer_id

The writer ID recorded for the current epoch, when available.

string

actual_access_revision_no

Access revision that is actually current for the inode.

integer format: int64

<= 9007199254740991

actual_attributes_revision_no

Attribute revision that is actually current for the inode.

integer format: int64

<= 9007199254740991

actual_binding_version

Current binding token; absent for the root, which has no binding.

string

/^[0-9a-f]+$/

actual_deletion_seq

Deletion sequence actually active for the inode.

integer format: int64

<= 9007199254740991

actual_head_seq

The actual namespace head sequence.

integer format: int64

<= 9007199254740991

actual_inode_id

The path actually contained this inode.

string

/^ino_[1-9][0-9]*$/

Example

ino_123

actual_revision_no

Revision that is actually current; absent when the inode has none.

integer format: int64

<= 9007199254740991

after_seq

Change-feed cursor the request asked to resume after.

integer format: int64

<= 9007199254740991

commit_id

Idempotency key of the commit the error concerns.

string

/^[a-z0-9][a-z0-9._-]{0,127}$/

Example

c_f3a9c2d4b6e8417a90c5d2f8e1b7a6c0

committed_fingerprint

The fingerprint of the mutation that landed under commit_id, present with committed_seq.

string

committed_seq

The sequence where this commit ID already landed, when recorded by a durable receipt.

integer format: int64

<= 9007199254740991

expected_access_revision_no

Access revision the request expected to be current.

integer format: int64

<= 9007199254740991

expected_attributes_revision_no

Attribute revision the request expected to be current.

integer format: int64

<= 9007199254740991

expected_binding_version

Opaque binding token supplied by the request.

string

/^[0-9a-f]+$/

expected_deletion_seq

Deletion sequence the undelete expected to be active.

integer format: int64

<= 9007199254740991

expected_head_seq

The head sequence required by the request.

integer format: int64

<= 9007199254740991

expected_inode_id

The request expected the path to contain this inode.

string

/^ino_[1-9][0-9]*$/

Example

ino_123

expected_revision_no

Revision the request expected to be current.

integer format: int64

<= 9007199254740991

fenced_writer_epoch

Epoch the failing writer session held when it was displaced.

integer format: int64

<= 9007199254740991

inode_id

Inode the failed precondition or operation targeted.

string

/^ino_[1-9][0-9]*$/

Example

ino_123

max_writer_sessions

Maximum writer sessions admitted by the node.

integer

namespace_id

The deleted namespace that caused the operation to fail.

string

/^[a-z0-9][a-z0-9._-]{0,127}$/

Example

demo

operation_index

The index of the failed operation in the request.

integer format: int32

precondition_index

Zero-based position of the failed request precondition.

integer format: int32

retention_floor_seq

Oldest sequence still promised for incremental replay.

integer format: int64

<= 9007199254740991

feature

The capability feature key for a not_supported error.

string

message

required

Human-readable error message.

string

param

The invalid JSON Pointer, parameter name, CLI flag, or CLI argument.

string

request_id

The request correlation ID also sent in the x-request-id response header.

string