SES / Client / list_configuration_sets

list_configuration_sets#

SES.Client.list_configuration_sets(**kwargs)#

Provides a list of the configuration sets associated with your Amazon SES account in the current Amazon Web Services Region. For information about using configuration sets, see Monitoring Your Amazon SES Sending Activity in the Amazon SES Developer Guide.

You can execute this operation no more than once per second. This operation returns up to 1,000 configuration sets each time it is run. If your Amazon SES account has more than 1,000 configuration sets, this operation also returns NextToken. You can then execute the ListConfigurationSets operation again, passing the NextToken parameter and the value of the NextToken element to retrieve additional results.

See also: AWS API Documentation

Request Syntax

response = client.list_configuration_sets(
    NextToken='string',
    MaxItems=123
)
Parameters:
  • NextToken (string) – A token returned from a previous call to ListConfigurationSets to indicate the position of the configuration set in the configuration set list.

  • MaxItems (integer) – The number of configuration sets to return.

Return type:

dict

Returns:

Response Syntax

{
    'ConfigurationSets': [
        {
            'Name': 'string'
        },
    ],
    'NextToken': 'string'
}

Response Structure

  • (dict) –

    A list of configuration sets associated with your Amazon Web Services account. Configuration sets enable you to publish email sending events. For information about using configuration sets, see the Amazon SES Developer Guide.

    • ConfigurationSets (list) –

      A list of configuration sets.

      • (dict) –

        The name of the configuration set.

        Configuration sets let you create groups of rules that you can apply to the emails you send using Amazon SES. For more information about using configuration sets, see Using Amazon SES Configuration Sets in the Amazon SES Developer Guide.

        • Name (string) –

          The name of the configuration set. The name must meet the following requirements:

          • Contain only letters (a-z, A-Z), numbers (0-9), underscores (_), or dashes (-).

          • Contain 64 characters or fewer.

    • NextToken (string) –

      A token indicating that there are additional configuration sets available to be listed. Pass this token to successive calls of ListConfigurationSets.