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