MailManager / Client / get_archive_export

get_archive_export#

MailManager.Client.get_archive_export(**kwargs)#

Retrieves the details and current status of a specific email archive export job.

See also: AWS API Documentation

Request Syntax

response = client.get_archive_export(
    ExportId='string'
)
Parameters:

ExportId (string) –

[REQUIRED]

The identifier of the export job to get details for.

Return type:

dict

Returns:

Response Syntax

{
    'ArchiveId': 'string',
    'ExportDestinationConfiguration': {
        'S3': {
            'S3Location': 'string'
        }
    },
    'Filters': {
        'Include': [
            {
                'BooleanExpression': {
                    'Evaluate': {
                        'Attribute': 'HAS_ATTACHMENTS'
                    },
                    'Operator': 'IS_TRUE'|'IS_FALSE'
                },
                'StringExpression': {
                    'Evaluate': {
                        'Attribute': 'TO'|'FROM'|'CC'|'SUBJECT'|'ENVELOPE_TO'|'ENVELOPE_FROM'
                    },
                    'Operator': 'CONTAINS',
                    'Values': [
                        'string',
                    ]
                }
            },
        ],
        'Unless': [
            {
                'BooleanExpression': {
                    'Evaluate': {
                        'Attribute': 'HAS_ATTACHMENTS'
                    },
                    'Operator': 'IS_TRUE'|'IS_FALSE'
                },
                'StringExpression': {
                    'Evaluate': {
                        'Attribute': 'TO'|'FROM'|'CC'|'SUBJECT'|'ENVELOPE_TO'|'ENVELOPE_FROM'
                    },
                    'Operator': 'CONTAINS',
                    'Values': [
                        'string',
                    ]
                }
            },
        ]
    },
    'FromTimestamp': datetime(2015, 1, 1),
    'MaxResults': 123,
    'Status': {
        'CompletionTimestamp': datetime(2015, 1, 1),
        'ErrorMessage': 'string',
        'State': 'QUEUED'|'PREPROCESSING'|'PROCESSING'|'COMPLETED'|'FAILED'|'CANCELLED',
        'SubmissionTimestamp': datetime(2015, 1, 1)
    },
    'ToTimestamp': datetime(2015, 1, 1)
}

Response Structure

  • (dict) –

    The response containing details of the specified archive export job.

    • ArchiveId (string) –

      The identifier of the archive the email export was performed from.

    • ExportDestinationConfiguration (dict) –

      Where the exported emails are being delivered.

      Note

      This is a Tagged Union structure. Only one of the following top level keys will be set: S3. 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'}
      
      • S3 (dict) –

        Configuration for delivering to an Amazon S3 bucket.

        • S3Location (string) –

          The S3 location to deliver the exported email data.

    • Filters (dict) –

      The criteria used to filter emails included in the export.

      • Include (list) –

        The filter conditions for emails to include.

        • (dict) –

          A filter condition used to include or exclude emails when exporting from or searching an archive.

          Note

          This is a Tagged Union structure. Only one of the following top level keys will be set: BooleanExpression, StringExpression. 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'}
          
          • BooleanExpression (dict) –

            A boolean expression to evaluate against email attributes.

            • Evaluate (dict) –

              The email attribute value to evaluate.

              Note

              This is a Tagged Union structure. Only one of the following top level keys will be set: Attribute. 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'}
              
              • Attribute (string) –

                The name of the email attribute to evaluate.

            • Operator (string) –

              The boolean operator to use for evaluation.

          • StringExpression (dict) –

            A string expression to evaluate against email attributes.

            • Evaluate (dict) –

              The attribute of the email to evaluate.

              Note

              This is a Tagged Union structure. Only one of the following top level keys will be set: Attribute. 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'}
              
              • Attribute (string) –

                The name of the email attribute to evaluate.

            • Operator (string) –

              The operator to use when evaluating the string values.

            • Values (list) –

              The list of string values to evaluate the email attribute against.

              • (string) –

      • Unless (list) –

        The filter conditions for emails to exclude.

        • (dict) –

          A filter condition used to include or exclude emails when exporting from or searching an archive.

          Note

          This is a Tagged Union structure. Only one of the following top level keys will be set: BooleanExpression, StringExpression. 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'}
          
          • BooleanExpression (dict) –

            A boolean expression to evaluate against email attributes.

            • Evaluate (dict) –

              The email attribute value to evaluate.

              Note

              This is a Tagged Union structure. Only one of the following top level keys will be set: Attribute. 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'}
              
              • Attribute (string) –

                The name of the email attribute to evaluate.

            • Operator (string) –

              The boolean operator to use for evaluation.

          • StringExpression (dict) –

            A string expression to evaluate against email attributes.

            • Evaluate (dict) –

              The attribute of the email to evaluate.

              Note

              This is a Tagged Union structure. Only one of the following top level keys will be set: Attribute. 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'}
              
              • Attribute (string) –

                The name of the email attribute to evaluate.

            • Operator (string) –

              The operator to use when evaluating the string values.

            • Values (list) –

              The list of string values to evaluate the email attribute against.

              • (string) –

    • FromTimestamp (datetime) –

      The start of the timestamp range the exported emails cover.

    • MaxResults (integer) –

      The maximum number of email items included in the export.

    • Status (dict) –

      The current status of the export job.

      • CompletionTimestamp (datetime) –

        The timestamp of when the export job completed (if finished).

      • ErrorMessage (string) –

        An error message if the export job failed.

      • State (string) –

        The current state of the export job.

      • SubmissionTimestamp (datetime) –

        The timestamp of when the export job was submitted.

    • ToTimestamp (datetime) –

      The end of the date range the exported emails cover.

Exceptions

  • MailManager.Client.exceptions.ValidationException

  • MailManager.Client.exceptions.AccessDeniedException

  • MailManager.Client.exceptions.ThrottlingException