Configure the AWS SDK for Kotlin

This section explains how to configure a service client using the AWS SDK for Kotlin. For more information, see the SDK and Tools Reference Guide, which includes an overview of configuration that applies to all AWS SDKs.

Contents

• Create a service client
  • Configure a client in code
  • Configure a client from the environment
  • Close the client
• AWS Region selection
  • Default Region provider chain
• Credentials providers
  • The default credentials provider chain
  • Explicit credentials provider
• Configure client endpoints
  • Custom configuration
    • Set endpointUrl
    • Set endpointProvider
      • EndpointProvider properties
    • endpointUrl or endpointProvider
    • A note about Amazon S3
  • Examples
    • endpointUrl example
    • endpointProvider example
    • endpointUrl and endpointProvider
• HTTP
  • HTTP client configuration
    • Basic configuration
      • Imports
      • Code
    • Specify an HTTP engine type
      • Imports
      • Code
      • Use an explicit HTTP client
        • Imports
        • Code
  • Use an HTTP proxy
    • Use JVM system properties
    • Use environment variables
    • Use a proxy on EC2 instances
  • HTTP interceptors
    • Interceptor registration
      • Interceptor for all service client operations
      • Interceptor for only specific operations
  • Enforce a minimum TLS version
    • Configure the HTTP engine
    • Set the sdk.minTls JVM system property
    • Set the SDK_MIN_TLS environment variable
• Retries
  • Default retry configuration
  • Maximum attempts
  • Delays and backoff
  • Retry token bucket
  • Adaptive retries
• Observability
  • Configure a TelemetryProvider
    • Configure the default global telemetry provider
    • Configure a telemetry provider for a specific service client
  • Metrics
  • Logging
    • Specify log mode for wire-level messages
      • Set log mode in code
      • Set log mode from the environment
  • Telemetry providers
    • Configure the OpenTelemetry-based telemetry provider
      • Prerequisites
      • Configure the SDK
      • Resources
• Override service client configuration
  • Lifecycle of an overridden client
  • Resources shared between clients