Struct ErrorDetails 

pub struct ErrorDetails {

    pub commit_id: Option<CommitId>,
    pub committed_seq: Option<ChangeSeq>,
    pub committed_fingerprint: Option<String>,
    pub operation_index: Option<u32>,
    pub fenced_writer_epoch: Option<WriterEpoch>,
    pub active_writer_epoch: Option<WriterEpoch>,
    pub active_writer: Option<String>,
    pub active_acquired_at_ms: Option<u64>,
    pub inode_id: Option<InodeId>,
    pub expected_revision_no: Option<RevisionNo>,
    pub actual_revision_no: Option<RevisionNo>,
    pub expected_attributes_revision_no: Option<AttributeRevisionNo>,
    pub actual_attributes_revision_no: Option<AttributeRevisionNo>,
    pub after_seq: Option<ChangeSeq>,
    pub retention_floor_seq: Option<ChangeSeq>,
    pub expected_deletion_seq: Option<ChangeSeq>,
    pub actual_deletion_seq: Option<ChangeSeq>,
    pub expected_head_seq: Option<ChangeSeq>,
    pub actual_head_seq: Option<ChangeSeq>,
}

Optional machine-readable details for an ApiError.

Clients make retry decisions from the error code and use these fields for relevant identifiers such as commit ids, writer epochs, and revisions. Fields may be absent and clients must ignore fields they do not use.

Fields

commit_id: Option<CommitId>

Idempotency key of the commit the error concerns.

committed_seq: Option<ChangeSeq>

Sequence at which that commit id already landed. Present when the failure was decided against a durable commit receipt, which is what holds the sequence; absent when nothing has committed under the id yet and two live requests are simply claiming it at once.

committed_fingerprint: Option<String>

Semantic identity of the mutation that already landed under that commit id, from the same receipt as committed_seq and present exactly when it is. A retry recomputes this value from the request it just made — see put_retry_fingerprint — and equality is what proves the two are the same request.

operation_index: Option<u32>

Position, in the request’s operation list, of the operation that failed. A commit applies all of its operations or none of them, so this names the one that stopped the whole request.

fenced_writer_epoch: Option<WriterEpoch>

Epoch the failing writer session held when it was displaced.

active_writer_epoch: Option<WriterEpoch>

Epoch that currently owns the namespace.

active_writer: Option<String>

Writer id recorded by the current epoch’s acquirer, when the head recorded one.

active_acquired_at_ms: Option<u64>

Unix milliseconds at which the current epoch’s acquirer took it, when the head recorded one. Writer ids are process labels, so two runs on one machine can share one; the stamp is what tells them apart.

inode_id: Option<InodeId>

Inode the failed precondition or operation targeted.

expected_revision_no: Option<RevisionNo>

Revision the request expected to be current.

actual_revision_no: Option<RevisionNo>

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

expected_attributes_revision_no: Option<AttributeRevisionNo>

Attribute revision the request expected to be current.

actual_attributes_revision_no: Option<AttributeRevisionNo>

Attribute revision that is actually current for the inode.

after_seq: Option<ChangeSeq>

Change-feed cursor the request asked to resume after.

retention_floor_seq: Option<ChangeSeq>

Oldest sequence still promised for incremental replay.

expected_deletion_seq: Option<ChangeSeq>

Deletion generation the undelete expected to be active.

actual_deletion_seq: Option<ChangeSeq>

Deletion generation actually active for the inode.

expected_head_seq: Option<ChangeSeq>

Head sequence a namespace delete required the namespace to still be at.

actual_head_seq: Option<ChangeSeq>

Head sequence the namespace was actually at, which is what a caller that still means to delete it retries against.

Trait Implementations

impl Clone for ErrorDetails

fn clone(&self) -> ErrorDetails

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ErrorDetails

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for ErrorDetails

fn default() -> ErrorDetails

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for ErrorDetails

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for ErrorDetails

impl PartialEq for ErrorDetails

fn eq(&self, other: &ErrorDetails) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl Serialize for ErrorDetails

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for ErrorDetails