MailManager / Client / get_archive



Retrieves the full details and current state of a specified email archive.

See also: AWS API Documentation

Request Syntax

response = client.get_archive(

ArchiveId (string) –


The identifier of the archive to retrieve.

Return type:



Response Syntax

    'ArchiveArn': 'string',
    'ArchiveId': 'string',
    'ArchiveName': 'string',
    'ArchiveState': 'ACTIVE'|'PENDING_DELETION',
    'CreatedTimestamp': datetime(2015, 1, 1),
    'KmsKeyArn': 'string',
    'LastUpdatedTimestamp': datetime(2015, 1, 1),
    'Retention': {

Response Structure

  • (dict) –

    The response containing details of the requested archive.

    • ArchiveArn (string) –

      The Amazon Resource Name (ARN) of the archive.

    • ArchiveId (string) –

      The unique identifier of the archive.

    • ArchiveName (string) –

      The unique name assigned to the archive.

    • ArchiveState (string) –

      The current state of the archive:

      • ACTIVE – The archive is ready and available for use.

      • PENDING_DELETION – The archive has been marked for deletion and will be permanently deleted in 30 days. No further modifications can be made in this state.

    • CreatedTimestamp (datetime) –

      The timestamp of when the archive was created.

    • KmsKeyArn (string) –

      The Amazon Resource Name (ARN) of the KMS key used to encrypt the archive.

    • LastUpdatedTimestamp (datetime) –

      The timestamp of when the archive was modified.

    • Retention (dict) –

      The retention period for emails in this archive.


      This is a Tagged Union structure. Only one of the following top level keys will be set: RetentionPeriod. If a client receives an unknown member it will set SDK_UNKNOWN_MEMBER as the top level key, which maps to the name or tag of the unknown member. The structure of SDK_UNKNOWN_MEMBER is as follows:

      'SDK_UNKNOWN_MEMBER': {'name': 'UnknownMemberName'}
      • RetentionPeriod (string) –

        The enum value sets the period for retaining emails in an archive.


  • MailManager.Client.exceptions.ValidationException

  • MailManager.Client.exceptions.AccessDeniedException

  • MailManager.Client.exceptions.ResourceNotFoundException

  • MailManager.Client.exceptions.ThrottlingException