Struct CloudStorageConfig 

pub struct CloudStorageConfig {
    pub storage_type: StorageType,
    pub bucket: String,
    pub region: Option<String>,
    pub base_path: String,
    pub endpoint: Option<String>,
    pub access_key_id: Option<String>,
    pub secret_access_key: Option<String>,
    pub session_token: Option<String>,
}

Configuration for any storage backend.

Pure data: no I/O, no policy decisions. Embedders construct this to describe “use this storage backend” via the stable contract surface.

Fields

storage_type: StorageType

Storage type (file, s3, gcs, azure)

bucket: String

Bucket/container name

region: Option<String>

Region for S3, project ID for GCS

base_path: String

Base path within the bucket

endpoint: Option<String>

Custom endpoint (for S3-compatible services like MinIO, DigitalOcean Spaces)

access_key_id: Option<String>

Access key ID

secret_access_key: Option<String>

Secret access key

session_token: Option<String>

Session token (for temporary credentials)

Implementations

impl CloudStorageConfig

pub fn new(storage_type: StorageType, bucket: impl Into<String>) -> Self

Create a new CloudStorageConfig with the given bucket

pub fn file(base_path: impl Into<String>) -> Self

Create a file storage config

pub fn s3(bucket: impl Into<String>) -> Self

Create an S3 storage config

pub fn gcs(bucket: impl Into<String>) -> Self

Create a GCS storage config

pub fn azure(container: impl Into<String>) -> Self

Create an Azure storage config

pub fn with_region(self, region: impl Into<String>) -> Self

Set the region

pub fn with_base_path(self, path: impl Into<String>) -> Self

Set the base path

pub fn with_endpoint(self, endpoint: impl Into<String>) -> Self

Set custom endpoint (for S3-compatible services)

pub fn with_credentials( self, access_key_id: impl Into<String>, secret_access_key: impl Into<String>, ) -> Self

Set credentials

pub fn with_session_token(self, token: impl Into<String>) -> Self

Set session token

pub fn full_path(&self, relative_path: &str) -> String

Build full path from relative path

pub fn validate(&self) -> Result<(), ValidateStorageConfigError>

Validate the configuration

Trait Implementations

impl Clone for CloudStorageConfig

fn clone(&self) -> CloudStorageConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CloudStorageConfig

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

Formats the value using the given formatter.

impl Default for CloudStorageConfig

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for CloudStorageConfig

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for CloudStorageConfig

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

where __S: Serializer,

Serialize this value into the given Serde serializer.