Pemberitahuan akhir dukungan: Pada tanggal 31 Maret 2027, dukungan untuk Amazon AWS WorkMail akan berakhir. Setelah 31 Maret 2027, Anda tidak akan lagi dapat mengakses WorkMail konsol Amazon atau WorkMail sumber daya Amazon. Untuk informasi selengkapnya, lihat WorkMail Akhir dukungan Amazon.

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Mengekspor konten kotak pesan

Gunakan tindakan StartMailboxExportJob API di Referensi WorkMail API Amazon untuk mengekspor konten WorkMail kotak surat Amazon ke bucket Amazon Simple Storage Service (Amazon S3). Tindakan ini mengekspor semua pesan email dan item kalender dari kotak pesan yang ditentukan ke file .zip di bucket Amazon S3, dalam format MIME. Item lain, seperti kontak dan tugas, tidak diekspor.

Waktu yang diperlukan untuk menyelesaikan tugas ekspor kotak pesan tergantung pada ukuran dan jumlah item di kotak pesan. Karena tugas ekspor kotak pesan berlangsung selama periode waktu tertentu, itu tidak mewakili snapshot konten kotak pesan pada satu titik waktu. Untuk melihat status pekerjaan ekspor, gunakan tindakan ListMailboxExportJobs API DescribeMailboxExportJob atau di Referensi WorkMail API Amazon.

Ketika pekerjaan ekspor kotak pesan selesai, .zip file di bucket Amazon S3 dienkripsi menggunakan kunci master pelanggan symmetric AWS Key Management Service (AWS KMS) (CMK) yang Anda berikan. Karena AWS KMS enkripsi terintegrasi dengan Amazon S3, data yang didekripsi dapat dilihat oleh pengguna yang mengunduhnya, selama pengguna memiliki akses ke AWS KMS CMK.

Prasyarat

Berikut ini adalah prasyarat untuk mengekspor konten kotak pesan:

Contoh kebijakan IAM dan pembuatan peran

Contoh berikut menunjukkan kebijakan IAM yang memberikan izin untuk menulis ke bucket Amazon S3 dan mengenkripsi file yang dikirim dengan AWS KMS CMK. Untuk menggunakan kebijakan contoh ini berikut: prosedur Contoh: Mengekspor konten kotak surat, menyimpan kebijakan sebagai file JSON dengan nama file 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*"
                    ]
                }
            }
        }
    ]
}

Contoh berikut adalah kebijakan kepercayaan IAM yang melekat pada IAM role yang Anda buat. Untuk menggunakan kebijakan contoh ini berikut: prosedur Contoh: Mengekspor konten kotak surat, menyimpan kebijakan sebagai file JSON dengan nama file mailbox-export-trust-policy.json.

Anda tidak harus menggunakan aws:SourceAccount kondisi aws:SourceArn dan pada saat yang bersamaan. Misalnya, Anda dapat menghapus aws:SourceArn dari kebijakan jika perlu menggunakan peran yang sama untuk mengekspor pesan dari WorkMail organisasi Amazon yang berbeda di bawah AWS akun yang sama. Untuk informasi selengkapnya tentang kunci kondisi, lihat kunci konteks kondisi AWS global di panduan pengguna AWS Identitas dan Manajemen Akses.

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

Anda dapat menggunakan AWS CLI untuk membuat peran IAM di akun Anda dengan menjalankan perintah berikut.

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

Untuk informasi selengkapnya AWS CLI, lihat Panduan AWS Command Line Interface Pengguna.

Contoh: Mengekspor konten kotak surat

Setelah Anda membuat IAM role dan kebijakannya di bagian sebelumnya, selesaikan langkah-langkah berikut untuk mengekspor konten kotak pesan. Anda harus memiliki ID WorkMail organisasi Amazon dan ID pengguna (ID entitas), yang dapat Anda akses di WorkMail konsol Amazon atau dengan menggunakan WorkMail API Amazon.

Ketika satus tugas ekspor kotak pesan SELESAI, item kotak pesan yang diekspor tersedia di file .zip di bucket Amazon S3 yang ditentukan.

Berikut ini adalah contoh log keluaran dari kotak surat yang diekspor:

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

Pertimbangan-pertimbangan

Pertimbangan berikut berlaku saat mengekspor pekerjaan kotak surat untuk Amazon WorkMail: