Enum UploadError

#[non_exhaustive]
pub enum UploadError {
    UnexpectedRewind {
        offset: u64,
        persisted: u64,
    },
    TooMuchProgress {
        sent: u64,
        persisted: u64,
    },
}

An unrecoverable problem in the upload protocol.

Example

use std::error::Error as _;
let upload = client
    .upload_object("projects/_/buckets/my-bucket", "my-object", "hello world")
    .with_if_generation_not_match(0);
match upload.send().await {
    Ok(object) => println!("Successfully uploaded the object"),
    Err(error) if error.is_serialization() => {
        println!("Some problem {error:?} sending the data to the service");
        if let Some(m) = error.source().and_then(|e| e.downcast_ref::<UploadError>()) {
            println!("{m}");
        }
    },
    Err(e) => return Err(e.into()), // not handled in this example
}

Troubleshoot

These errors indicate a bug in the resumable upload protocol implementation, either in the service or the client library. Neither are expected to be common, but neither are impossible. We recommend you open a bug, there is little you could do to recover from this problem.

While it is customary to panic!() when a bug triggers a problem, we do not believe it is appropriate to do so in this case, as the invariants involve different machines and the upload protocol.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

UnexpectedRewind

Fields

offset: u64

persisted: u64

TooMuchProgress

Fields

sent: u64

persisted: u64

Trait Implementations

impl Debug for UploadError

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

Formats the value using the given formatter.

impl Display for UploadError

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

Formats the value using the given formatter.

impl Error for UploadError

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.