Install & Compatibility
Where this runs
tested against v3.7.0 · pip install
no network on importno background threads
Install × environment matrix
Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux
muslpy 3.10–3.940 runs
installs and imports cleanly · install 0.0s · import 1.267s · 61.9MB
glibcpy 3.10–3.940 runs
installs and imports cleanly · install 7.5s · import 1.149s · 64MB
62MB installed
● package 62MB
Code
Verified usage
Verified import paths — ran on the pinned version, not inferred.
SSMClient
✓ from types_aiobotocore_ssm.client import SSMClient
Main client type for SSM service operations.
CommandExecutedWaiter
✓ from types_aiobotocore_ssm.waiter import CommandExecutedWaiter
Type annotation for the `CommandExecuted` waiter.
AccountSharingInfoTypeDef
✓ from types_aiobotocore_ssm.type_defs import AccountSharingInfoTypeDef
Example of importing a generated TypedDict for request/response structures.
AccessRequestStatusType
✓ from types_aiobotocore_ssm.literals import AccessRequestStatusType
Example of importing a literal type for static checking.
This quickstart demonstrates how to use `types-aiobotocore-ssm` with `aiobotocore` to create a typed SSM client, call an asynchronous operation, and retrieve a typed waiter. Explicit type annotations (e.g., `# type: SSMClient`) are optional but can improve clarity and provide better IDE support. Remember to install `aiobotocore` as a runtime dependency.
import asyncio
from aiobotocore.session import get_session
from types_aiobotocore_ssm.client import SSMClient
from types_aiobotocore_ssm.waiter import CommandExecutedWaiter
async def describe_instance_information():
session = get_session()
async with session.create_client("ssm") as client: # type: SSMClient
# Use explicit type annotation for client for clarity, though often inferred
print("Describing instance information...")
response = await client.describe_instance_information(
MaxResults=5
)
print(f"Instances: {[instance['InstanceId'] for instance in response.get('InstanceInformationList', [])]}")
# Example of using a waiter
print("Getting CommandExecuted waiter...")
waiter: CommandExecutedWaiter = client.get_waiter("command_executed")
# await waiter.wait(CommandId="your-command-id", InstanceId="your-instance-id")
print("Waiter retrieved. Actual wait requires command/instance IDs.")
if __name__ == "__main__":
asyncio.run(describe_instance_information())
Debug
Known issues
breakingPython 3.8 support has been removed from all `mypy-boto3-builder` generated stub packages, including `types-aiobotocore-ssm`, starting with `mypy-boto3-builder` version 8.12.0.fixUpgrade your Python interpreter to version 3.9 or newer.
affects: mypy-boto3-builder >= 8.12.0, types-aiobotocore-ssm >= 3.4.0
breakingType definition (TypeDef) naming conventions were changed in `mypy-boto3-builder` version 8.9.0. This includes shorter names for packed method arguments (e.g., `CreateDistributionRequestRequestTypeDef` -> `CreateDistributionRequestTypeDef`) and moving the `Extra` postfix. Code explicitly importing and using these TypeDefs may break.fixReview your code for any explicit imports or usage of `TypeDef` names, and update them according to the new naming conventions. Consult the specific service's `type_defs.pyi` for correct names if unsure.
affects: mypy-boto3-builder >= 8.9.0
gotcha`types-aiobotocore-ssm` provides only type annotations (stubs) for the `aiobotocore` SSM client. It does not include the actual `aiobotocore` runtime library, which must be installed separately for your application to function.fixAlways ensure `aiobotocore` is installed in your environment alongside `types-aiobotocore-ssm`. For example: `pip install types-aiobotocore-ssm aiobotocore`.
affects: All versions
gotchaAs of `mypy-boto3-builder` 8.12.0, stub packages have migrated to PEP 561 compliance. This means stubs are installed alongside the runtime library and are automatically discovered by type checkers like MyPy. If you had custom configurations for stub discovery, they might need adjustment.fixEnsure your type checker is up-to-date and correctly configured to find PEP 561-style stub packages. Most common setups should work without manual intervention.
affects: mypy-boto3-builder >= 8.12.0, types-aiobotocore-ssm >= 3.4.0
gotchaPyCharm users might experience slow performance or high CPU usage with Literal overloads in type stubs (issue PY-40997).fixConsider using `types-aiobotocore-lite` instead, which is more RAM-friendly. Alternatively, disable PyCharm's internal type checker and use an external tool like `mypy` or `pyright` for type checking.
affects: All versions, specific to PyCharm users
Upgrade
Version history
3.7.0latest on PyPI · released May 10, 2026
Audit
Dependencies
aiobotocorerequiredRuntime library for AWS SDK functionality. `types-aiobotocore-ssm` only provides type stubs.
pythonrequiredRequires Python 3.9 or newer due to removal of Python 3.8 support in mypy-boto3-builder 8.12.0.