aiobotocore

Common errors

Warnings

Install

Install compatibility verified last tested: 2026-05-12

Imports

• get_session
  wrong

  import aiobotocore; aiobotocore.get_session(loop=loop)

  correct

  from aiobotocore.session import get_session

  Top-level aiobotocore.get_session(loop=...) is the old pre-1.0 pattern. The loop parameter was removed. Always import from aiobotocore.session.

• AioSession

  from aiobotocore.session import AioSession

  Use when you need to subclass or explicitly type the session object.

• AioConfig

  from aiobotocore.config import AioConfig

  Required to pass connector_args (keepalive_timeout, use_dns_cache, etc.) or to set the experimental httpx backend.

• AIOHTTPSession

  from aiobotocore.httpsession import AIOHTTPSession

  Default HTTP session class; import only needed when customising the session class directly.

• HttpxSession

  from aiobotocore.httpxsession import HttpxSession

  Experimental httpx backend. Pass via AioConfig(http_session_cls=HttpxSession). Not fully tested; some aiohttp features are unported.

• ClientError

  import botocore.exceptions; botocore.exceptions.ClientError

  Error types live in botocore, not aiobotocore. Always catch botocore.exceptions.ClientError for AWS API errors.

Quickstart verified last tested: 2026-04-23

List S3 buckets using an async context-managed client with credentials from environment variables.

import asyncio
import os
from aiobotocore.session import get_session
import botocore.exceptions

async def main():
    session = get_session()
    async with session.create_client(
        's3',
        region_name='us-east-1',
        aws_access_key_id=os.environ.get('AWS_ACCESS_KEY_ID', ''),
        aws_secret_access_key=os.environ.get('AWS_SECRET_ACCESS_KEY', ''),
    ) as client:
        try:
            response = await client.list_buckets()
            for bucket in response.get('Buckets', []):
                print(bucket['Name'])
        except botocore.exceptions.ClientError as e:
            print(f"AWS error: {e.response['Error']['Code']} - {e.response['Error']['Message']}")
        except botocore.exceptions.NoCredentialsError:
            print('No credentials found')

asyncio.run(main())