本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

导出邮箱内容

使用亚马逊 StartMailboxExportJobAPI 参考中的 WorkMail API 操作将亚马逊 WorkMail 邮箱内容导出到亚马逊简单存储服务 (Amazon S3) 存储桶。此操作会以 MIME 格式将指定邮箱中的所有电子邮件和日历项目导出到 Amazon S3 存储桶中的一个 .zip 文件中。不会导出联系人和任务等其他项目。

完成邮箱导出作业所需的时间取决于邮箱中项目的大小和数量。由于邮箱导出作业会持续一段时间，因此它不代表邮箱内容在单个时间点的快照。要查看导出任务的状态，请使用亚马逊 ListMailboxExportJobsAPI 参考中的DescribeMailboxExportJob或 WorkMail API 操作。

邮箱导出任务完成后，Amazon S3 存储桶中的.zip文件将使用您提供的对称 AWS Key Management Service (AWS KMS) 客户主密钥 (CMK) 进行加密。由于 AWS KMS 加密已与 Amazon S3 集成，因此只要用户有权访问 CMK，下载解密数据的用户就可以看到该 AWS KMS 数据。

先决条件

以下是导出邮箱内容的先决条件：

IAM 策略示例和角色创建

以下示例显示了一个 IAM 策略，该策略授予写入 Amazon S3 存储桶并使用 AWS KMS CMK 加密已发送文件的权限。要在以下示例：导出邮箱内容过程中使用此示例策略，请将该策略另存为文件名为 mailbox-export-policy.json 的 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/S3-PREFIX*"
                }
            }
        }
    ]
}

以下示例显示了一个附加到您创建的 IAM 角色的 IAM 信任策略。要在以下示例：导出邮箱内容过程中使用此示例策略，请将该策略另存为文件名为 mailbox-export-trust-policy.json 的 JSON 文件。

您不必同时使用 aws:SourceArn 和 aws:SourceAccount 条件。例如，如果您需要使用相同的角色在同一 AWS 账户下导出aws:SourceArn来自不同 Amazon WorkMail 组织的邮件，则可以从政策中删除。有关条件键的更多信息，请参阅《AWS Identity and Access Management 用户指南》中的 AWS 全局条件上下文键。

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"
        }
      }
    }
  ]
}

您可以使用通过运行以下命令在您的账户中创建 IAM 角色。 AWS CLI

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

有关更多信息 AWS CLI，请参阅《AWS Command Line Interface 用户指南》。

示例：导出邮箱内容

在上一部分中创建 IAM 角色和策略后，请完成以下步骤导出邮箱内容。您必须拥有自己的亚马逊 WorkMail组织 ID 和用户 ID（实体 ID），您可以在亚马逊 WorkMail 控制台中或使用亚马逊 WorkMail API 进行访问。

当邮箱导出作业状态为已完成时，导出的邮箱项目会以 .zip 文件的形式存在于指定的 Amazon S3 存储桶中。

以下是导出邮箱的输出日志示例：

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

注意事项

导出适用于 Amazon 的邮箱任务时，需要考虑以下注意事项 WorkMail：