{"id":7814,"library":"types-aiobotocore-acm","title":"Types for aiobotocore ACM Service","description":"types-aiobotocore-acm provides type annotations for the aiobotocore AWS Certificate Manager (ACM) service client, generated by mypy-boto3-builder. These annotations enable static type checking with tools like MyPy, Pyright, and enhance IDE auto-completion for asynchronous AWS client interactions. The library maintains a versioning in sync with the corresponding aiobotocore and botocore versions and is actively developed with frequent releases.","status":"active","version":"3.4.0","language":"en","source_language":"en","source_url":"https://github.com/youtype/mypy_boto3_builder","tags":["aws","aiobotocore","types","mypy","typing","acm","stubs"],"install":[{"cmd":"pip install types-aiobotocore-acm","lang":"bash","label":"Install specific service types"},{"cmd":"pip install 'types-aiobotocore[acm]'","lang":"bash","label":"Install with 'types-aiobotocore' extras"}],"dependencies":[{"reason":"Provides the underlying asynchronous AWS client for which types are generated.","package":"aiobotocore","optional":false},{"reason":"Requires Python 3.9 or higher. Python 3.8 support was removed in mypy-boto3-builder 8.12.0.","package":"python","optional":false}],"imports":[{"note":"Required for explicit client type annotation.","symbol":"ACMClient","correct":"from types_aiobotocore_acm.client import ACMClient"},{"note":"Standard import for creating aiobotocore sessions.","symbol":"get_session","correct":"from aiobotocore.session import get_session"}],"quickstart":{"code":"import asyncio\nfrom aiobotocore.session import get_session\nfrom types_aiobotocore_acm.client import ACMClient\n\nasync def list_acm_certificates():\n    session = get_session()\n    async with session.create_client(\"acm\", region_name=\"us-east-1\") as client:\n        client: ACMClient # Explicit type annotation for the client\n        response = await client.list_certificates(CertificateStatuses=['ISSUED'])\n        for cert in response.get('CertificateSummaryList', []):\n            print(f\"Certificate ARN: {cert['CertificateArn']}\")\n\nif __name__ == \"__main__\":\n    asyncio.run(list_acm_certificates())","lang":"python","description":"This quickstart demonstrates how to initialize an aiobotocore ACM client and use the `ACMClient` type annotation from `types-aiobotocore-acm` to enable static type checking and IDE auto-completion for client methods and their parameters. It lists issued certificates in a specified region."},"warnings":[{"fix":"Upgrade your Python environment to version 3.9 or later. Alternatively, pin `types-aiobotocore-acm` to a version compatible with Python 3.8 if available for your specific aiobotocore version.","message":"Support for Python 3.8 was officially removed with mypy-boto3-builder version 8.12.0. Users on Python 3.8 will need to upgrade their Python version to 3.9 or newer to use current versions of `types-aiobotocore-acm`.","severity":"breaking","affected_versions":"mypy-boto3-builder >= 8.12.0 (equivalent to types-aiobotocore-acm >= 3.4.0)"},{"fix":"Update your type annotations in code to reflect the new, shorter TypeDef names and corrected `Extra` postfix placements. Refer to the `types-aiobotocore` documentation for the exact TypeDef names for your service and method.","message":"TypeDef names for packed method arguments were shortened (e.g., `CreateDistributionRequestRequestTypeDef` -> `CreateDistributionRequestTypeDef`) and conflicting `Extra` postfixes were moved (e.g., `CreateDistributionExtraRequestTypeDef` -> `CreateDistributionRequestExtraTypeDef`). This affects type hint usage for request/response dictionaries.","severity":"breaking","affected_versions":"mypy-boto3-builder >= 8.9.0"},{"fix":"Ensure `aiobotocore` is installed in your environment: `pip install aiobotocore`.","message":"This package provides only type annotations (stubs) and does not include the actual `aiobotocore` library. You must install `aiobotocore` separately for the code to run, otherwise you will encounter `ModuleNotFoundError` for `aiobotocore` components.","severity":"gotcha","affected_versions":"All versions"},{"fix":"For explicit typing, always annotate your client objects (e.g., `client: ACMClient`). If experiencing issues with `mypy`, verify your `mypy.ini` configuration and that the stub package is installed in an accessible location for your type checker.","message":"Since `mypy-boto3-builder` migrated to PEP 561 packages, type checkers typically auto-discover types. However, for explicit typing or complex environments (e.g., custom `MYPYPATH`), ensure your type checker is correctly configured to find stub packages. `types-aiobotocore-lite` users must always use explicit type annotations.","severity":"gotcha","affected_versions":"mypy-boto3-builder >= 8.12.0"}],"env_vars":null,"last_verified":"2026-04-16T00:00:00.000Z","next_check":"2026-07-15T00:00:00.000Z","problems":[{"fix":"Install the `aiobotocore` library: `pip install aiobotocore`.","cause":"The `aiobotocore` library itself is not installed.","error":"ModuleNotFoundError: No module named 'aiobotocore.session'"},{"fix":"Install `types-aiobotocore-acm`: `pip install types-aiobotocore-acm` or `pip install 'types-aiobotocore[acm]'`.","cause":"The `types-aiobotocore-acm` type stub package is not installed or incorrectly installed.","error":"ModuleNotFoundError: No module named 'types_aiobotocore_acm.client'"},{"fix":"Add an explicit type annotation for your client variable: `client: ACMClient = await session.create_client(\"acm\")`.","cause":"MyPy or another type checker cannot infer the type of the `aiobotocore` client, usually because an explicit type hint (e.g., `client: ACMClient`) is missing or the type stubs are not correctly picked up.","error":"error: Need type annotation for 'client' (hint: \"client: Any = ...\")"},{"fix":"Ensure the values passed match the `types_aiobotocore_acm.literals.CertificateStatusType` or other specific TypedDict/Literal types. Import literals for clarity, e.g., `from types_aiobotocore_acm.literals import CertificateStatusType`.","cause":"Using a string literal that is not a valid `CertificateStatusType` or a mistyped list of strings when the stub expects specific literal types.","error":"error: Argument 'CertificateStatuses' to 'list_certificates' of 'ACMClient' has incompatible type 'List[str]'; expected 'List[CertificateStatusType]'  [arg-type]"}]}