Builder
Properties
An optional application specific identifier. When set it will be appended to the User-Agent header of every request in the form of: app/{applicationId}
. When not explicitly set, the value will be loaded from the following locations:
Configure the provider used to resolve the authentication scheme to use for a particular operation.
Register new or override default AuthSchemes configured for this client. By default, the set of auth schemes configured comes from the service model. An auth scheme configured explicitly takes precedence over the defaults and can be used to customize identity resolution and signing for specific authentication schemes.
A reader-friendly name for the client.
The minimum content length threshold (in bytes) for which to send Expect: 100-continue
HTTP headers. PUT requests with bodies at or above this length will include this header, as will PUT requests with a null content length. Defaults to 2 megabytes.
The AWS credentials provider to use for authenticating requests. If not provided a aws.sdk.kotlin.runtime.auth.credentials.DefaultChainCredentialsProvider instance will be used. NOTE: The caller is responsible for managing the lifetime of the provider when set. The SDK client will not close it when the client is closed.
Flag to disable S3 multi-region access points.
Disables this client's usage of Session Auth for S3Express buckets and reverts to using conventional SigV4 for those.
Flag to support S3 transfer acceleration with this client.
Flag to enable aws-chunked content encoding.
The endpoint provider used to determine where to make service requests. This is an advanced config option.
A custom endpoint to route requests to. The endpoint set here is passed to the configured endpointProvider, which may inspect and modify it as needed.
Flag to use legacy path-style addressing when making requests.
Add an aws.smithy.kotlin.runtime.client.Interceptor that will have access to read and modify the request and response objects as they are processed by the SDK. Interceptors added using this method are executed in the order they are configured and are always later than any added automatically by the SDK.
The AWS region (e.g. us-west-2
) to make requests to. See about AWS global infrastructure for more information
The policy to use for evaluating operation results and determining whether/how to retry.
The telemetry provider used to instrument the SDK operations with. By default, the global telemetry provider will be used.
Flag to enforce using a bucket arn with a region matching the client config when making requests with S3 access points.
` Disabled by default.