Skip to content

Examples#

Index > CloudTrail > Examples

Auto-generated documentation for CloudTrail type annotations stubs module types-boto3-cloudtrail.

Client#

Implicit type annotations#

Can be used with types-boto3[cloudtrail] package installed.

Write your CloudTrail code as usual, type checking and code completion should work out of the box.

Client method usage example#

# CloudTrailClient usage example

from boto3.session import Session


session = Session()

client = session.client("cloudtrail")  # (1)
result = client.cancel_query()  # (2)
  1. client: CloudTrailClient
  2. result: CancelQueryResponseTypeDef

Paginator usage example#

# ListImportFailuresPaginator usage example

from boto3.session import Session


session = Session()
client = session.client("cloudtrail")  # (1)

paginator = client.get_paginator("list_import_failures")  # (2)
for item in paginator.paginate(...):
    print(item)  # (3)
  1. client: CloudTrailClient
  2. paginator: ListImportFailuresPaginator
  3. item: ListImportFailuresResponseTypeDef

Explicit type annotations#

With types-boto3-lite[cloudtrail] or a standalone types_boto3_cloudtrail package, you have to explicitly specify client: CloudTrailClient type annotation.

All other type annotations are optional, as types should be discovered automatically. However, these type annotations can be helpful in your functions and methods.

Client method usage example#

# CloudTrailClient usage example with type annotations

from boto3.session import Session

from types_boto3_cloudtrail.client import CloudTrailClient
from types_boto3_cloudtrail.type_defs import CancelQueryResponseTypeDef
from types_boto3_cloudtrail.type_defs import CancelQueryRequestTypeDef


session = Session()

client: CloudTrailClient = session.client("cloudtrail")

kwargs: CancelQueryRequestTypeDef = {...}
result: CancelQueryResponseTypeDef = client.cancel_query(**kwargs)

Paginator usage example#

# ListImportFailuresPaginator usage example with type annotations

from boto3.session import Session

from types_boto3_cloudtrail.client import CloudTrailClient
from types_boto3_cloudtrail.paginator import ListImportFailuresPaginator
from types_boto3_cloudtrail.type_defs import ListImportFailuresResponseTypeDef


session = Session()
client: CloudTrailClient = session.client("cloudtrail")

paginator: ListImportFailuresPaginator = client.get_paginator("list_import_failures")
for item in paginator.paginate(...):
    item: ListImportFailuresResponseTypeDef
    print(item)