Enum SparkError 

pub enum SparkError {
    InvalidTtl,
    TooLarge,
    WriteLimit,
    QuotaExceeded,
    NotAvailable,
    Internal,
    ReadLimit,
    BadKey,
    NoCapability,
    Unknown(i32),
}

Errors returned by Spark write operations.

The numeric codes below are stable across SDK versions and match the sparkErr* constants in internal/corona/hostapi_spark.go.

Variants

InvalidTtl

TTL value is invalid (negative, or above the host’s per-flare cap).

TooLarge

Value exceeds the host’s per-key size cap (max_kv_value_bytes, default 64 KiB).

WriteLimit

Per-invocation write count exceeded.

QuotaExceeded

On-disk quota for this site is full.

NotAvailable

Spark is not configured on this edge.

Internal

Internal host error - see edge logs for details.

ReadLimit

Per-invocation read count exceeded. (Not currently returned by the host but reserved in the protocol.)

BadKey

Key failed validation (must match [a-zA-Z0-9:._-]{1,256} and not start with __flaron: or __sys:).

NoCapability

Flare lacks the WritesSparkKV capability for this operation.

Unknown(i32)

Unknown error code returned by the host.

Trait Implementations

impl Debug for SparkError

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

Formats the value using the given formatter.

impl Display for SparkError

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

Formats the value using the given formatter.

impl Error for SparkError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.