Amazon Chime

2020/05/20 - Amazon Chime - 2 new api methods

Changes  Amazon Chime enterprise account administrators can now set custom retention policies on chat data in the Amazon Chime application.

GetRetentionSettings (new) Link ¶

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.

PutRetentionSettings (new) Link ¶

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.