Select your cookie preferences

We use cookies and similar tools to enhance your experience, provide our services, deliver relevant advertising, and make improvements. Approved third parties also use these tools to help us deliver advertising and provide certain site features.

describe_retention_configurations

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