{"id":24765,"library":"types-boto3-ssm","title":"types-boto3-ssm","description":"Type annotations for boto3 SSM (Simple Systems Manager) service, generated by mypy-boto3-builder. Provides static type checking and IDE autocompletion for boto3 SSM client and resources. Current version is 1.43.0, following boto3 SSM API version 1.43.0. Release cadence matches boto3 service updates. Requires Python >=3.9.","status":"active","version":"1.43.0","language":"python","source_language":"en","source_url":"https://github.com/youtype/mypy_boto3_builder","tags":["type-annotations","boto3","ssm","aws","mypy","stubs"],"install":[{"cmd":"pip install types-boto3-ssm","lang":"bash","label":"PyPI"},{"cmd":"pip install 'types-boto3-ssm[doc]'","lang":"bash","label":"With dependencies for doc generation"}],"dependencies":[{"reason":"Required for type annotations on Python <3.11","package":"typing-extensions","optional":false}],"imports":[{"note":"types-boto3-ssm does not export top-level classes; import from mypy_boto3_ssm submodules","wrong":"from types_boto3_ssm import SSMClient","symbol":"SSMClient","correct":"from mypy_boto3_ssm.client import SSMClient"},{"note":"SSMServiceResource is a type stub, not a boto3 runtime class","wrong":"from boto3.ssm import SSMServiceResource","symbol":"SSMServiceResource","correct":"from mypy_boto3_ssm.service_resource import SSMServiceResource"},{"note":"Paginator types are in mypy_boto3_ssm.paginator, not boto3","wrong":"from boto3.ssm.paginator import DescribeInstanceInformationPaginator","symbol":"Paginator","correct":"from mypy_boto3_ssm.paginator import DescribeInstanceInformationPaginator"},{"note":"","wrong":"","symbol":"ServiceResource","correct":"from mypy_boto3_ssm.service_resource import ServiceResource as SSMServiceResource"},{"note":"Alternatively, import from top-level mypy_boto3_ssm for convenience","wrong":"","symbol":"SSMClient","correct":"from mypy_boto3_ssm import SSMClient"}],"quickstart":{"code":"import boto3\nfrom mypy_boto3_ssm import SSMClient\n\nclient: SSMClient = boto3.client('ssm', region_name='us-east-1')\nresponse = client.describe_parameters(MaxResults=10)\nfor param in response['Parameters']:\n    print(param['Name'])","lang":"python","description":"Basic usage: create an SSM client with type annotations and list parameters."},"warnings":[{"fix":"Update imports: e.g., 'CreateDistributionRequestRequestTypeDef' becomes 'CreateDistributionRequestTypeDef' for non-conflicting names. For conflicting names, 'CreateDistributionExtraRequestTypeDef' becomes 'CreateDistributionRequestExtraTypeDef'.","message":"Version 8.9.0 introduced breaking changes: TypeDef names for packed arguments were shortened and conflicting TypeDefs had 'Extra' postfix moved to end. If you import specific TypeDefs, update your imports.","severity":"breaking","affected_versions":"<8.9.0"},{"fix":"Use 'import mypy_boto3_ssm' or 'from mypy_boto3_ssm import SSMClient'.","message":"Do not import from 'types_boto3_ssm' directly. The package installs as 'types-boto3-ssm' but the Python module is 'mypy_boto3_ssm'.","severity":"gotcha","affected_versions":"all"},{"fix":"Use only for type hints. For runtime checks, use boto3's native types or typeguard.","message":"The type stubs are designed for static type checkers like mypy or pyright. They do not add runtime behavior. If you use them at runtime (e.g., isinstance checks), you may encounter errors because these classes don't exist at runtime.","severity":"gotcha","affected_versions":"all"},{"fix":"Use Python >=3.9 or install an older version: pip install 'types-boto3-ssm<8.12.0'.","message":"Support for Python 3.8 was removed in version 8.12.0. If you need Python 3.8 support, pin to versions <8.12.0.","severity":"deprecated","affected_versions":">=8.12.0"},{"fix":"Check the actual API version by inspecting the package's version or the boto3 SSM changelog.","message":"The package version number (e.g., 1.43.0) corresponds to the boto3 SSM API version, not the mypy-boto3-builder version. Do not confuse with builder versions like 8.12.0.","severity":"gotcha","affected_versions":"all"}],"env_vars":null,"last_verified":"2026-05-01T00:00:00.000Z","next_check":"2026-07-30T00:00:00.000Z","problems":[{"fix":"Use 'import mypy_boto3_ssm' or 'from mypy_boto3_ssm import SSMClient'.","cause":"Trying to import 'types_boto3_ssm' instead of 'mypy_boto3_ssm'.","error":"ModuleNotFoundError: No module named 'types_boto3_ssm'"},{"fix":"Install types-boto3-ssm and import from mypy_boto3_ssm: 'from mypy_boto3_ssm import SSMClient'.","cause":"SSMClient type stub is not part of boto3; it's in the types package.","error":"ImportError: cannot import name 'SSMClient' from 'boto3'"},{"fix":"Check installed version: pip show types-boto3-ssm. Update to latest: pip install -U types-boto3-ssm. Alternatively, import from submodule: 'from mypy_boto3_ssm.client import SSMClient'.","cause":"Maybe you installed an older version where the client class had a different name or wasn't exported.","error":"AttributeError: module 'mypy_boto3_ssm' has no attribute 'SSMClient'"},{"fix":"Install types-boto3-ssm and ensure mypy can see it: 'pip install types-boto3-ssm'. If using mypy, add '--ignore-missing-imports' or configure MYPYPATH.","cause":"mypy cannot find the type stub. Probably the types package is not installed or not in type-checking path.","error":"Name 'SSMClient' is not defined (mypy error)"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}