boto3 client cache for use by client suppliers.

New in version 1.5.0.


No guarantee is provided on the modules and APIs within this namespace staying consistent. Directly reference at your own risk.


ClientCache(botocore_session, client_config) Provide boto3 clients regional clients, caching by region.
class aws_encryption_sdk.keyrings.aws_kms._client_cache.ClientCache(botocore_session, client_config)

Bases: object

Provide boto3 clients regional clients, caching by region.

Any clients that throw an error when used are immediately removed from the cache.

New in version 1.5.0.

  • botocore_session (botocore.session.Session) – Botocore session to use when creating clients
  • client_config (botocore.config.Config) – Config to use when creating client
client(region_name, service)

Get a client for the specified region and service.

Generate a new client if needed. Otherwise, retrieve an existing client from the internal cache.

  • region_name (str) – Client region
  • service (str) – Client service
Return type: