Enum AmazonS3ConfigKey

#[non_exhaustive]
pub enum AmazonS3ConfigKey {
    AccessKeyId,
    SecretAccessKey,
    Region,
    DefaultRegion,
    Bucket,
    Endpoint,
    Token,
    ImdsV1Fallback,
    VirtualHostedStyleRequest,
    UnsignedPayload,
    Checksum,
    MetadataEndpoint,
    ContainerCredentialsRelativeUri,
    CopyIfNotExists,
    ConditionalPut,
    SkipSignature,
    DisableTagging,
    S3Express,
    Client(ClientConfigKey),
    Encryption(S3EncryptionConfigKey),
}

Available on crate feature aws only.

Configuration keys for AmazonS3Builder

Configuration via keys can be done via AmazonS3Builder::with_config

Example

let builder = AmazonS3Builder::new()
    .with_config("aws_access_key_id".parse().unwrap(), "my-access-key-id")
    .with_config(AmazonS3ConfigKey::DefaultRegion, "my-default-region");

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.

AccessKeyId

AWS Access Key

See AmazonS3Builder::with_access_key_id for details.

Supported keys:

• aws_access_key_id
• access_key_id

SecretAccessKey

Secret Access Key

See AmazonS3Builder::with_secret_access_key for details.

Supported keys:

• aws_secret_access_key
• secret_access_key

Region

Region

See AmazonS3Builder::with_region for details.

Supported keys:

• aws_region
• region

DefaultRegion

Default region

See AmazonS3Builder::with_region for details.

Supported keys:

• aws_default_region
• default_region

Bucket

Bucket name

See AmazonS3Builder::with_bucket_name for details.

Supported keys:

• aws_bucket
• aws_bucket_name
• bucket
• bucket_name

Endpoint

Sets custom endpoint for communicating with AWS S3.

See AmazonS3Builder::with_endpoint for details.

Supported keys:

• aws_endpoint
• aws_endpoint_url
• endpoint
• endpoint_url

Token

Token to use for requests (passed to underlying provider)

See AmazonS3Builder::with_token for details.

Supported keys:

• aws_session_token
• aws_token
• session_token
• token

ImdsV1Fallback

Fall back to ImdsV1

See AmazonS3Builder::with_imdsv1_fallback for details.

Supported keys:

• aws_imdsv1_fallback
• imdsv1_fallback

VirtualHostedStyleRequest

If virtual hosted style request has to be used

See AmazonS3Builder::with_virtual_hosted_style_request for details.

Supported keys:

• aws_virtual_hosted_style_request
• virtual_hosted_style_request

UnsignedPayload

Avoid computing payload checksum when calculating signature.

See AmazonS3Builder::with_unsigned_payload for details.

Supported keys:

• aws_unsigned_payload
• unsigned_payload

Checksum

Set the checksum algorithm for this client

See AmazonS3Builder::with_checksum_algorithm

MetadataEndpoint

Set the instance metadata endpoint

See AmazonS3Builder::with_metadata_endpoint for details.

Supported keys:

• aws_metadata_endpoint
• metadata_endpoint

ContainerCredentialsRelativeUri

Set the container credentials relative URI

https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task-iam-roles.html

CopyIfNotExists

Configure how to provide copy_if_not_exists

See S3CopyIfNotExists

ConditionalPut

Configure how to provide conditional put operations

See S3ConditionalPut

SkipSignature

Skip signing request

DisableTagging

Disable tagging objects

This can be desirable if not supported by the backing store

Supported keys:

• aws_disable_tagging
• disable_tagging

S3Express

Enable Support for S3 Express One Zone

Supported keys:

• aws_s3_express
• s3_express

Client(ClientConfigKey)

Client options

Encryption(S3EncryptionConfigKey)

Encryption options

Trait Implementations

impl AsRef<str> for AmazonS3ConfigKey

fn as_ref(&self) -> &str

Converts this type into a shared reference of the (usually inferred) input type.

impl Clone for AmazonS3ConfigKey

fn clone(&self) -> AmazonS3ConfigKey

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for AmazonS3ConfigKey

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for AmazonS3ConfigKey

fn deserialize<__D>( __deserializer: __D, ) -> Result<AmazonS3ConfigKey, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl FromStr for AmazonS3ConfigKey

type Err = Error

The associated error which can be returned from parsing.

fn from_str( s: &str, ) -> Result<AmazonS3ConfigKey, <AmazonS3ConfigKey as FromStr>::Err>

Parses a string s to return a value of this type.

impl Hash for AmazonS3ConfigKey

fn hash<__H>(&self, state: &mut __H)

where __H: Hasher,

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for AmazonS3ConfigKey

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for AmazonS3ConfigKey

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Copy for AmazonS3ConfigKey

impl Eq for AmazonS3ConfigKey

impl StructuralPartialEq for AmazonS3ConfigKey