Hinweis zum Ende des Supports: Am 31. März 2027 AWS wird der Support für Amazon WorkMail eingestellt. Nach dem 31. März 2027 können Sie nicht mehr auf die WorkMail Amazon-Konsole oder die Amazon-Ressourcen zugreifen. WorkMail Weitere Informationen finden Sie unter WorkMail Ende des Supports https://docs.aws.amazon.com/workmail/latest/adminguide/workmail-end-of-support.html bei Amazon.

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Postfachinhalt exportieren

Verwenden Sie die StartMailboxExportJob API-Aktion in der WorkMail Amazon-API-Referenz, um WorkMail Amazon-Postfachinhalte in einen Amazon Simple Storage Service (Amazon S3) -Bucket zu exportieren. Diese Aktion exportiert alle E-Mail-Nachrichten und Kalendereinträge aus dem angegebenen Postfach in eine .zip Datei im Amazon S3-Bucket im MIME-Format. Andere Elemente, wie Kontakte und Aufgaben, werden nicht exportiert.

Die Zeit, die benötigt wird, bis der Postfach-Exportauftrag abgeschlossen ist, hängt von der Größe und Anzahl der Elemente im Postfach ab. Da der Postfachexportauftrag über einen bestimmten Zeitraum erfolgt, stellt er keine Momentaufnahme des Postfachinhalts zu einem bestimmten Zeitpunkt dar. Um den Status eines Exportauftrags einzusehen, verwenden Sie die DescribeMailboxExportJob oder ListMailboxExportJobs API-Aktionen in der WorkMail Amazon-API-Referenz.

Wenn ein Postfach-Exportauftrag abgeschlossen ist, wird die .zip Datei im Amazon S3-Bucket mit dem von Ihnen angegebenen symmetrischen AWS Key Management Service (AWS KMS) Customer Master Key (CMK) verschlüsselt. Da die AWS KMS Verschlüsselung in Amazon S3 integriert ist, sind die entschlüsselten Daten für den Benutzer sichtbar, der sie herunterlädt, sofern der Benutzer Zugriff auf das CMK hat. AWS KMS

Voraussetzungen

Für den Export von Postfachinhalten gelten die folgenden Voraussetzungen:

Beispiele für IAM-Richtlinien und Rollenerstellung

Das folgende Beispiel zeigt eine IAM-Richtlinie, die die Erlaubnis erteilt, in den Amazon S3-Bucket zu schreiben und die gesendeten Dateien mit dem CMK zu verschlüsseln. AWS KMS Um diese Beispielrichtlinie im folgenden Beispiel: Exportieren von Postfachinhalten Verfahren zu verwenden, speichern Sie die Richtlinie als JSON-Datei mit dem Dateinamen. mailbox-export-policy.json

JSON

{
    "Version":"2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "s3:AbortMultipartUpload",
                "s3:PutObject",
                "s3:GetBucketPolicyStatus"
            ],
            "Resource": [
                "arn:aws:s3:::amzn-s3-demo-bucket",
                "arn:aws:s3:::amzn-s3-demo-bucket/*"
            ]
        },
        {
            "Effect": "Allow",
            "Action": [
                "kms:Decrypt",
                "kms:GenerateDataKey"
            ],
            "Resource": [
                "arn:aws:kms:us-east-1:111122223333:key/KEY-ID"
            ],
            "Condition": {
                "StringEquals": {
                    "kms:ViaService": "s3.us-east-1.amazonaws.com"
                },
                "StringLike": {
                    "kms:EncryptionContext:aws:s3:arn": [
                        "arn:aws:s3:::amzn-s3-demo-bucket",
                        "arn:aws:s3:::amzn-s3-demo-bucket/S3-PREFIX*"
                    ]
                }
            }
        }
    ]
}

Das folgende Beispiel zeigt eine IAM-Vertrauensrichtlinie, die der von Ihnen erstellten IAM-Rolle zugeordnet ist. Um diese Beispielrichtlinie im folgenden Beispiel: Exportieren von Postfachinhalten Verfahren zu verwenden, speichern Sie die Richtlinie als JSON-Datei mit dem Dateinamen. mailbox-export-trust-policy.json

Sie müssen die aws:SourceAccount Bedingungen aws:SourceArn und nicht gleichzeitig verwenden. Sie können beispielsweise aws:SourceArn aus der Richtlinie entfernen, wenn Sie dieselbe Rolle verwenden müssen, um Nachrichten von verschiedenen WorkMail Amazon-Organisationen unter demselben AWS Konto zu exportieren. Weitere Informationen zu Bedingungsschlüsseln finden Sie in den AWS globalen Bedingungskontextschlüsseln im AWS Identity and Access Management-Benutzerhandbuch.

JSON

{
  "Version":"2012-10-17",
  "Statement": [
    {
      "Sid": "",
      "Effect": "Allow",
      "Principal": {
        "Service": "export.workmail.amazonaws.com"
      },
      "Action": "sts:AssumeRole",
      "Condition": {
        "StringEquals": { 
          "aws:SourceAccount": "111122223333"
        },
        "ArnLike": {
          "aws:SourceArn": "arn:aws:workmail:us-east-1:111122223333:organization/m-a123b4c5de678fg9h0ij1k2lm234no56"
        }
      }
    }
  ]
}

Sie können die verwenden AWS CLI , um die IAM-Rolle in Ihrem Konto zu erstellen, indem Sie die folgenden Befehle ausführen.

aws iam create-role --role-name WorkmailMailboxExportRole --assume-role-policy-document file://mailbox-export-trust-policy.json --region us-east-1

aws iam put-role-policy --role-name WorkmailMailboxExportRole --policy-name MailboxExport --policy-document file://mailbox-export-policy.json

Weitere Informationen dazu finden Sie im AWS Command Line Interface Benutzerhandbuch. AWS CLI

Beispiel: Exportieren von Postfachinhalten

Nachdem Sie die IAM-Rolle und die Richtlinien im vorherigen Abschnitt erstellt haben, führen Sie die folgenden Schritte aus, um den Inhalt Ihres Postfachs zu exportieren. Sie benötigen Ihre WorkMail Amazon-Organisations-ID und Benutzer-ID (Entitäts-ID), auf die Sie in der WorkMail Amazon-Konsole oder mithilfe der WorkMail Amazon-API zugreifen können.

Wenn der Status des Postfachexportauftrags COMPLETED lautet, sind die exportierten Postfachelemente in einer .zip Datei im angegebenen Amazon S3-Bucket verfügbar.

Das Folgende ist ein Beispiel für das Ausgabeprotokoll des exportierten Postfachs:

{
  "totalNonExportableItems" : "13",
  "totalMessages" : "76",
  "sha384Hash" : "4de93a***96a1dd",
  "totalBytes" : "161892",
  "totalFolders" : "15",
  "startTime" : "168***380",
  "endTime" : "168***384"
}   
        

Überlegungen

Beim Exportieren von Postfachaufträgen für Amazon WorkMail gelten die folgenden Überlegungen: