Avis de fin de support : le 31 mars 2027, le support d'Amazon AWS WorkMail prendra fin. Après le 31 mars 2027, vous ne pourrez plus accéder à la WorkMail console Amazon ni aux WorkMail ressources Amazon. Pour plus d'informations, consultez la section WorkMail Fin du support d'Amazon.

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Exportation du contenu d'une boîte

Utilisez l'action d'StartMailboxExportJobAPI dans la référence d' WorkMail API Amazon pour exporter le contenu de la WorkMail boîte aux lettres Amazon vers un compartiment Amazon Simple Storage Service (Amazon S3). Cette action exporte tous les e-mails et éléments de calendrier de la boîte aux lettres spécifiée vers un .zip fichier du compartiment Amazon S3, au format MIME. Les autres éléments, tels que les contacts et les tâches, ne sont pas exportés.

Le temps nécessaire à la fin de la tâche d'exportation de la boîte aux lettres dépend de la taille et du nombre d'éléments contenus dans la boîte aux lettres. Étant donné que la tâche d'exportation de la boîte aux lettres s'effectue sur une certaine période, elle ne représente pas un instantané du contenu de la boîte aux lettres à un moment donné. Pour voir l'état d'une tâche d'exportation, utilisez les actions DescribeMailboxExportJob ou ListMailboxExportJobs API dans le Amazon WorkMail API Reference.

Lorsqu'une tâche d'exportation de boîte aux lettres est terminée, le .zip fichier du compartiment Amazon S3 est chiffré à l'aide de la clé principale client AWS Key Management Service (CMK AWS KMS) symétrique () que vous fournissez. AWS KMS Le chiffrement étant intégré à Amazon S3, les données déchiffrées sont visibles pour l'utilisateur qui les télécharge, tant que celui-ci a accès à la CMK. AWS KMS

Conditions préalables

Les conditions préalables à l'exportation du contenu d'une boîte aux lettres sont les suivantes :

Exemples de politiques IAM et création de rôles

L'exemple suivant illustre une politique IAM qui accorde l'autorisation d'écrire dans le compartiment Amazon S3 et de chiffrer les fichiers envoyés avec la AWS KMS CMK. Pour utiliser cet exemple de stratégie dans la Exemple : exportation du contenu d'une boîte aux lettres procédure suivante, enregistrez-la dans un fichier JSON avec un nom de fichiermailbox-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*"
                    ]
                }
            }
        }
    ]
}

L'exemple suivant montre une politique de confiance IAM associée au rôle IAM que vous créez. Pour utiliser cet exemple de stratégie dans la Exemple : exportation du contenu d'une boîte aux lettres procédure suivante, enregistrez-la dans un fichier JSON avec un nom de fichiermailbox-export-trust-policy.json.

Vous n'êtes pas obligé d'utiliser les aws:SourceAccount conditions aws:SourceArn et en même temps. Par exemple, vous pouvez supprimer aws:SourceArn de la politique si vous devez utiliser le même rôle pour exporter des messages provenant de différentes WorkMail organisations Amazon sous le même AWS compte. Pour plus d'informations sur les clés de condition, reportez-vous aux clés contextuelles de condition AWS globales dans le guide de l'utilisateur de la gestion des AWS identités et des accès.

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

Vous pouvez utiliser le AWS CLI pour créer le rôle IAM dans votre compte en exécutant les commandes suivantes.

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

Pour plus d'informations sur le AWS CLI, consultez le Guide de AWS Command Line Interface l'utilisateur.

Exemple : exportation du contenu d'une boîte aux lettres

Après avoir créé le rôle et les politiques IAM dans la section précédente, procédez comme suit pour exporter le contenu de votre boîte aux lettres. Vous devez disposer de votre identifiant d' WorkMailorganisation Amazon et de votre ID utilisateur (ID d'entité), auxquels vous pouvez accéder dans la WorkMail console Amazon ou à l'aide de l' WorkMail API Amazon.

Lorsque l'état de la tâche d'exportation de boîtes aux lettres est TERMINÉ, les éléments de boîte aux lettres exportés sont disponibles dans un .zip fichier du compartiment Amazon S3 spécifié.

Voici un exemple du journal de sortie de la boîte aux lettres exportée :

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

Considérations

Les considérations suivantes s'appliquent lors de l'exportation de tâches de boîte aux lettres pour Amazon WorkMail :