Struct DynamicStorageOptionsCredentialProvider 

pub struct DynamicStorageOptionsCredentialProvider { /* private fields */ }

AWS Credential Provider that uses StorageOptionsProvider

This adapter converts our generic StorageOptionsProvider trait into AWS-specific credentials that can be used with S3. It caches credentials and automatically refreshes them before they expire.

Future Work

TODO: Support AWS/GCP/Azure together in a unified credential provider. Currently this is AWS-specific. Needs investigation of how GCP and Azure credential refresh mechanisms work and whether they can be unified with AWS’s approach.

See: https://github.com/lance-format/lance/pull/4905#discussion_r2474605265

Implementations

impl DynamicStorageOptionsCredentialProvider

pub fn new( provider: Arc<dyn StorageOptionsProvider>, refresh_offset: Duration, ) -> Self

Create a new credential provider without initial credentials

Arguments

• provider - The storage options provider
• refresh_offset - Duration before expiry to refresh credentials

pub fn new_with_initial_credential( provider: Arc<dyn StorageOptionsProvider>, refresh_offset: Duration, credential: Arc<ObjectStoreAwsCredential>, expires_at_millis: u64, ) -> Self

Create a new credential provider with initial credentials from an explicit credential

Arguments

• provider - The storage options provider
• refresh_offset - Duration before expiry to refresh credentials
• credential - Initial credential to cache
• expires_at_millis - Expiration time in milliseconds since epoch (required for refresh)

Trait Implementations

impl CredentialProvider for DynamicStorageOptionsCredentialProvider

type Credential = AwsCredential

The type of credential returned by this provider

fn get_credential<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = ObjectStoreResult<Arc<Self::Credential>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Return a credential

impl Debug for DynamicStorageOptionsCredentialProvider

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

Formats the value using the given formatter.