describe_retention_configurations

ConfigService.Client.describe_retention_configurations(**kwargs)

Returns the details of one or more retention configurations. If the retention configuration name is not specified, this action returns the details for all the retention configurations for that account.

Note

Currently, Config supports only one retention configuration per region in your account.

See also: AWS API Documentation

Request Syntax

response = client.describe_retention_configurations(
    RetentionConfigurationNames=[
        'string',
    ],
    NextToken='string'
)
Parameters
  • RetentionConfigurationNames (list) --

    A list of names of retention configurations for which you want details. If you do not specify a name, Config returns details for all the retention configurations for that account.

    Note

    Currently, Config supports only one retention configuration per region in your account.

    • (string) --
  • NextToken (string) -- The nextToken string returned on a previous page that you use to get the next page of results in a paginated response.
Return type

dict

Returns

Response Syntax

{
    'RetentionConfigurations': [
        {
            'Name': 'string',
            'RetentionPeriodInDays': 123
        },
    ],
    'NextToken': 'string'
}

Response Structure

  • (dict) --

    • RetentionConfigurations (list) --

      Returns a retention configuration object.

      • (dict) --

        An object with the name of the retention configuration and the retention period in days. The object stores the configuration for data retention in Config.

        • Name (string) --

          The name of the retention configuration object.

        • RetentionPeriodInDays (integer) --

          Number of days Config stores your historical information.

          Note

          Currently, only applicable to the configuration item history.

    • NextToken (string) --

      The nextToken string returned on a previous page that you use to get the next page of results in a paginated response.

Exceptions

  • ConfigService.Client.exceptions.InvalidParameterValueException
  • ConfigService.Client.exceptions.NoSuchRetentionConfigurationException
  • ConfigService.Client.exceptions.InvalidNextTokenException