Use ListConfigurationSets with an AWS SDK
The following code example shows how to use ListConfigurationSets.
Action examples are code excerpts from larger programs and must be run in context. You can see this action in
context in the following code example:
- Python
-
- SDK for Python (Boto3)
-
Filter configuration sets by name using the Amazon SES API v2 filter support.
class SearchFilterWrapper:
"""Encapsulates Amazon SES v2 search-and-filter operations."""
def __init__(self, sesv2_client: boto3.client):
"""
Initializes the SearchFilterWrapper with an Amazon SES v2 client.
:param sesv2_client: A Boto3 Amazon SES v2 client.
"""
self.sesv2_client = sesv2_client
@classmethod
def from_client(cls) -> "SearchFilterWrapper":
"""
Creates a SearchFilterWrapper instance with a default Boto3 SES v2 client.
:return: An initialized SearchFilterWrapper instance.
"""
sesv2_client = boto3.client("sesv2")
return cls(sesv2_client)
def list_configuration_sets(
self,
filter_params: Optional[Dict[str, str]] = None,
page_size: Optional[int] = None,
) -> List[str]:
"""
Lists configuration sets associated with the account in the current
region. Supports optional filter parameters and pagination.
:param filter_params: Optional dictionary of filter key-value pairs
(e.g., {"CONFIGURATION_SET_NAME_CONTAINS": "marketing"}).
:param page_size: Optional number of results per page.
:return: A list of configuration set name strings.
"""
try:
# ListConfigurationSets has no registered Boto3 paginator, so
# pagination is handled manually using the NextToken field.
configuration_sets = list()
next_token = None
while True:
kwargs = dict()
if filter_params is not None:
kwargs["Filter"] = filter_params
if page_size is not None:
kwargs["PageSize"] = page_size
if next_token is not None:
kwargs["NextToken"] = next_token
response = self.sesv2_client.list_configuration_sets(**kwargs)
configuration_sets.extend(response.get("ConfigurationSets", list()))
next_token = response.get("NextToken")
if not next_token:
break
logger.info("Listed %d configuration sets.", len(configuration_sets))
return configuration_sets
except ClientError as err:
if err.response["Error"]["Code"] == "BadRequestException":
logger.error(
"Bad request when listing configuration sets: %s",
err.response["Error"]["Message"],
)
else:
logger.error(
"Error listing configuration sets: %s",
err.response["Error"]["Message"],
)
raise
For a complete list of AWS SDK developer guides and code examples, see
Using Amazon SES with an AWS SDK.
This topic also includes information about getting started and details about previous SDK versions.