Amazon Chime

Puts retention settings for the specified Amazon Chime Enterprise account. We recommend using AWS CloudTrail to monitor usage of this API for your account. For more information, see Logging Amazon Chime API Calls with AWS CloudTrail in the Amazon Chime Administration Guide.

To turn off existing retention settings, remove the number of days from the corresponding RetentionDays field in the RetentionSettings object. For more information about retention settings, see Managing Chat Retention Policies in the Amazon Chime Administration Guide.

See also: AWS API Documentation

Request Syntax

client.put_retention_settings(
    AccountId='string',
    RetentionSettings={
        'RoomRetentionSettings': {
            'RetentionDays': 123
        },
        'ConversationRetentionSettings': {
            'RetentionDays': 123
        }
    }
)

type AccountId:

string

param AccountId:

[REQUIRED]

The Amazon Chime account ID.

type RetentionSettings:

dict

param RetentionSettings:

[REQUIRED]

The retention settings.

• RoomRetentionSettings (dict) --

  The chat room retention settings.

  • RetentionDays (integer) --

    The number of days for which to retain chat room messages.

• ConversationRetentionSettings (dict) --

  The chat conversation retention settings.

  • RetentionDays (integer) --

    The number of days for which to retain chat conversation messages.

rtype:

dict

returns:

Response Syntax

{
    'RetentionSettings': {
        'RoomRetentionSettings': {
            'RetentionDays': 123
        },
        'ConversationRetentionSettings': {
            'RetentionDays': 123
        }
    },
    'InitiateDeletionTimestamp': datetime(2015, 1, 1)
}

Response Structure

• (dict) --

  • RetentionSettings (dict) --

    The retention settings.

    • RoomRetentionSettings (dict) --

      The chat room retention settings.

      • RetentionDays (integer) --

        The number of days for which to retain chat room messages.

    • ConversationRetentionSettings (dict) --

      The chat conversation retention settings.

      • RetentionDays (integer) --

        The number of days for which to retain chat conversation messages.

  • InitiateDeletionTimestamp (datetime) --

    The timestamp representing the time at which the specified items are permanently deleted, in ISO 8601 format.

Gets the retention settings for the specified Amazon Chime Enterprise account. For more information about retention settings, see Managing Chat Retention Policies in the Amazon Chime Administration Guide.

See also: AWS API Documentation

Request Syntax

client.get_retention_settings(
    AccountId='string'
)

type AccountId:

string

param AccountId:

[REQUIRED]

The Amazon Chime account ID.

rtype:

dict

returns:

Response Syntax

{
    'RetentionSettings': {
        'RoomRetentionSettings': {
            'RetentionDays': 123
        },
        'ConversationRetentionSettings': {
            'RetentionDays': 123
        }
    },
    'InitiateDeletionTimestamp': datetime(2015, 1, 1)
}

Response Structure

• (dict) --

  • RetentionSettings (dict) --

    The retention settings.

    • RoomRetentionSettings (dict) --

      The chat room retention settings.

      • RetentionDays (integer) --

        The number of days for which to retain chat room messages.

    • ConversationRetentionSettings (dict) --

      The chat conversation retention settings.

      • RetentionDays (integer) --

        The number of days for which to retain chat conversation messages.

  • InitiateDeletionTimestamp (datetime) --

    The timestamp representing the time at which the specified items are permanently deleted, in ISO 8601 format.