put_app_instance_retention_settings

ChimeSDKIdentity.Client.put_app_instance_retention_settings(**kwargs)

Sets the amount of time in days that a given AppInstance retains data.

See also: AWS API Documentation

Request Syntax

response = client.put_app_instance_retention_settings(
    AppInstanceArn='string',
    AppInstanceRetentionSettings={
        'ChannelRetentionSettings': {
            'RetentionDays': 123
        }
    }
)
Parameters
  • AppInstanceArn (string) --

    [REQUIRED]

    The ARN of the AppInstance .

  • AppInstanceRetentionSettings (dict) --

    [REQUIRED]

    The time in days to retain data. Data type: number.

    • ChannelRetentionSettings (dict) --

      The length of time in days to retain the messages in a channel.

      • RetentionDays (integer) --

        The time in days to retain the messages in a channel.

Return type

dict

Returns

Response Syntax

{
    'AppInstanceRetentionSettings': {
        'ChannelRetentionSettings': {
            'RetentionDays': 123
        }
    },
    'InitiateDeletionTimestamp': datetime(2015, 1, 1)
}

Response Structure

  • (dict) --

    • AppInstanceRetentionSettings (dict) --

      The time in days to retain data. Data type: number.

      • ChannelRetentionSettings (dict) --

        The length of time in days to retain the messages in a channel.

        • RetentionDays (integer) --

          The time in days to retain the messages in a channel.

    • InitiateDeletionTimestamp (datetime) --

      The time at which the API deletes data.

Exceptions

  • ChimeSDKIdentity.Client.exceptions.BadRequestException
  • ChimeSDKIdentity.Client.exceptions.ForbiddenException
  • ChimeSDKIdentity.Client.exceptions.ThrottledClientException
  • ChimeSDKIdentity.Client.exceptions.UnauthorizedClientException
  • ChimeSDKIdentity.Client.exceptions.ServiceUnavailableException
  • ChimeSDKIdentity.Client.exceptions.ServiceFailureException