Création de vos rapports de DataSync tâches - AWS DataSync
PrérequisCréation d'un rapport de tâches récapitulatif uniquementCréation d'un rapport de tâches standard

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.

Création de vos rapports de DataSync tâches

AWS DataSync les rapports de tâches ne peuvent être qu'un résumé de l'exécution de vos tâches ou un ensemble de rapports détaillés sur les DataSync tentatives de transfert, d'omission, de vérification et de suppression.

Prérequis

Avant de créer un rapport de tâches, vous devez effectuer les opérations suivantes.

Créez un compartiment S3 pour vos rapports de tâches

Si vous n'en avez pas déjà un, créez un compartiment S3 dans lequel DataSync vous pourrez télécharger votre rapport de tâches. Les rapports sont stockés dans la classe de stockage S3 Standard.

Nous recommandons ce qui suit pour ce compartiment :

  • Si vous envisagez de transférer des données vers un compartiment S3, n'utilisez pas le même compartiment pour votre rapport de tâches si vous désactivez l'option Conserver les fichiers supprimés. Sinon, tous les rapports de tâches précédents DataSync seront supprimés chaque fois que vous exécuterez une tâche, car ces rapports n'existent pas dans votre emplacement source.

  • Pour éviter une configuration complexe des autorisations d'accès, assurez-vous que le compartiment de votre rapport de tâches se trouve dans la même Compte AWS région que votre tâche de DataSync transfert.

DataSync Autoriser le téléchargement de rapports de tâches dans votre compartiment S3

Vous devez configurer un rôle AWS Identity and Access Management (IAM) qui permet de DataSync télécharger un rapport de tâches dans votre compartiment S3.

Dans la DataSync console, vous pouvez créer un rôle IAM qui, dans la plupart des cas, inclut automatiquement les autorisations nécessaires pour télécharger un rapport de tâches dans votre compartiment. N'oubliez pas que ce rôle généré automatiquement peut ne pas répondre à vos besoins du point de vue du moindre privilège. Ce rôle ne fonctionnera pas non plus si votre compartiment est chiffré à l'aide d'une clé gérée par le client AWS Key Management Service (AWS KMS) (SSE-KMS). Dans ces cas, vous pouvez créer le rôle manuellement à condition que le rôle effectue au moins les tâches suivantes :

  • Empêche le problème de confusion entre les services au sein de l'entité de confiance associée au rôle.

    L'exemple complet suivant montre comment utiliser les touches contextuelles de condition aws:SourceAccount globale aws:SourceArn et les touches contextuelles pour éviter le problème de confusion lié aux adjoints DataSync. 

    {
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Principal": {
                "Service": "datasync.amazonaws.com"
            },
            "Action": "sts:AssumeRole",
            "Condition": {
                "StringEquals": {
                    "aws:SourceAccount": "123456789012"
                },
                "StringLike": {
                    "aws:SourceArn": "arn:aws:datasync:us-east-2:123456789012:*"
                }
            }
        }
    ]
}

  • Permet DataSync de télécharger un rapport de tâches dans votre compartiment S3.

    Pour ce faire, l'exemple suivant inclut l's3:PutObjectaction uniquement pour un préfixe spécifique (reports/) dans votre compartiment.

    {
        "Version": "2012-10-17",
        "Statement": [{
            "Action": [
                "s3:PutObject"
            ],
            "Effect": "Allow",
            "Resource": "arn:aws:s3:::your-task-reports-bucket/reports/*"
        }]
}

  • Si votre compartiment S3 est chiffré à l'aide d'une clé SSE-KMS gérée par le client, la politique de la clé doit inclure le rôle IAM DataSync utilisé pour accéder au compartiment.

    Pour de plus amples informations, veuillez consulter Accès aux compartiments S3 à l'aide du chiffrement côté serveur.

Création d'un rapport de tâches récapitulatif uniquement

Vous pouvez configurer un rapport de tâche qui inclut un résumé uniquement lors de la création, du démarrage ou de la mise à jour de la tâche. DataSync

Les étapes suivantes montrent comment configurer un rapport de tâches récapitulatif uniquement lors de la création d'une tâche.

  1. Ouvrez la AWS DataSync console à l'adresse https://console.aws.amazon.com/datasync/.

  2. Dans le volet de navigation de gauche, développez Transfert de données, puis choisissez Tâches, puis choisissez Créer une tâche.

  3. Configurez les emplacements source et de destination de votre tâche.

    Pour plus d’informations, consultez Où puis-je transférer mes données AWS DataSync ?.

  4. Faites défiler la page jusqu'à la section Rapport des tâches. Pour le type de rapport, sélectionnez Résumé uniquement.

  5. Pour le compartiment S3 pour les rapports, choisissez un compartiment S3 dans lequel vous DataSync souhaitez télécharger votre rapport de tâches.

    Astuce

    Si vous envisagez de transférer des données vers un compartiment S3, n'utilisez pas le même compartiment pour votre rapport de tâches si vous désactivez l'option Conserver les fichiers supprimés. Sinon, tous les rapports de tâches précédents DataSync seront supprimés chaque fois que vous exécuterez une tâche, car ces rapports n'existent pas dans votre emplacement source.

  6. Pour Dossier, entrez un préfixe à utiliser pour votre rapport de tâches lors du DataSync téléchargement du rapport dans votre compartiment S3 (par exemple,reports/).

    Assurez-vous d'inclure le caractère délimiteur approprié à la fin de votre préfixe. Ce caractère est généralement une barre oblique (/). Pour plus d'informations, consultez la section Organisation des objets à l'aide de préfixes dans le guide de l'utilisateur Amazon S3.

  7. Pour IAM role (Rôle IAM), effectuez l'une des opérations suivantes :

    • Choisissez Autogenerate pour créer DataSync automatiquement un rôle IAM avec les autorisations requises pour accéder au compartiment S3.

      Si un rôle IAM a DataSync déjà été créé pour ce compartiment S3, ce rôle est choisi par défaut.

    • Choisissez un rôle IAM personnalisé que vous avez créé.

      Dans certains cas, vous devrez peut-être créer le rôle vous-même. Pour de plus amples informations, veuillez consulter DataSync Autoriser le téléchargement de rapports de tâches dans votre compartiment S3.

      Important

      Si votre compartiment S3 est chiffré à l'aide d'une clé SSE-KMS gérée par le client, la politique de la clé doit inclure le rôle IAM DataSync utilisé pour accéder au compartiment.

      Pour de plus amples informations, veuillez consulter Accès aux compartiments S3 à l'aide du chiffrement côté serveur.

  8. Terminez la création de votre tâche, puis lancez-la pour commencer à transférer vos données.

Lorsque votre transfert est terminé, vous pouvez consulter votre rapport de tâches.

  1. Copiez la commande suivante create-task AWS Command Line Interface (AWS CLI) :

    aws datasync create-task \
  --source-location-arn arn:aws:datasync:us-east-1:123456789012:location/loc-12345678abcdefgh \
  --destination-location-arn arn:aws:datasync:us-east-1:123456789012:location/loc-abcdefgh12345678 \
  --task-report-config '{
    "Destination":{
      "S3":{
        "Subdirectory":"reports/",
        "S3BucketArn":"arn:aws:s3:::your-task-reports-bucket",
        "BucketAccessRoleArn":"arn:aws:iam::123456789012:role/bucket-iam-role"
        }
    },
    "OutputType":"SUMMARY_ONLY"  
  }'

  2. Pour le --source-location-arn paramètre, spécifiez l'Amazon Resource Name (ARN) de l'emplacement source de votre transfert. Remplacez us-east-1 par le numéro approprié Région AWS, remplacez 123456789012 par le Compte AWS numéro approprié et remplacez 12345678abcdefgh par l'ID d'emplacement source approprié.

  3. Pour le --destination-location-arn paramètre, spécifiez l'ARN de l'emplacement de destination de votre transfert. Remplacez us-east-1 par le numéro approprié Région AWS, remplacez 123456789012 par le Compte AWS numéro approprié et remplacez abcdefgh12345678 par le numéro de localisation de destination approprié.

  4. Pour le --task-report-config paramètre, procédez comme suit :

    • Subdirectory— reports/ Remplacez-le par le préfixe de votre compartiment S3 dans lequel vous DataSync souhaitez télécharger vos rapports de tâches.

      Assurez-vous d'inclure le caractère délimiteur approprié à la fin de votre préfixe. Ce caractère est généralement une barre oblique (/). Pour plus d'informations, consultez la section Organisation des objets à l'aide de préfixes dans le guide de l'utilisateur Amazon S3.

    • S3BucketArn— Spécifiez l'ARN du compartiment S3 dans lequel vous souhaitez télécharger votre rapport de tâches.

      Astuce

      Si vous envisagez de transférer des données vers un compartiment S3, n'utilisez pas le même compartiment pour votre rapport de tâches si vous désactivez l'option Conserver les fichiers supprimés. Sinon, tous les rapports de tâches précédents DataSync seront supprimés chaque fois que vous exécuterez une tâche, car ces rapports n'existent pas dans votre emplacement source.

    • BucketAccessRoleArn— Spécifiez le rôle IAM qui permet DataSync de télécharger un rapport de tâches dans votre compartiment S3.

      Pour de plus amples informations, veuillez consulter DataSync Autoriser le téléchargement de rapports de tâches dans votre compartiment S3.

      Important

      Si votre compartiment S3 est chiffré à l'aide d'une clé SSE-KMS gérée par le client, la politique de la clé doit inclure le rôle IAM DataSync utilisé pour accéder au compartiment.

      Pour de plus amples informations, veuillez consulter Accès aux compartiments S3 à l'aide du chiffrement côté serveur.

    • OutputType— SpécifiezSUMMARY_ONLY.

      Pour de plus amples informations, veuillez consulter Rapports de tâches récapitulatifs uniquement.

  5. Exécutez la create-task commande pour créer votre tâche.

    Vous obtenez une réponse semblable à la suivante qui indique l'ARN de la tâche que vous avez créée. Vous aurez besoin de cet ARN pour exécuter la start-task-execution commande.

    {
    "TaskArn": "arn:aws:datasync:us-east-1:123456789012:task/task-12345678abcdefgh"
}

  6. Copiez la start-task-execution commande suivante.

    aws datasync-task-report start-task-execution \
  --task-arn arn:aws:datasync:us-east-1:123456789012:task/task-12345678abcdefgh

  7. Pour le --task-arn paramètre, spécifiez l'ARN de la tâche que vous démarrez. Utilisez l'ARN que vous avez reçu lors de l'exécution de la create-task commande.

  8. Exécutez la commande start-task-execution.

Lorsque votre transfert est terminé, vous pouvez consulter votre rapport de tâches.

Création d'un rapport de tâches standard

Vous pouvez configurer un rapport de tâche standard lors de la création, du démarrage ou de la mise à jour de la tâche. DataSync

Les étapes suivantes montrent comment configurer un rapport de tâche standard lors de la création d'une tâche.

  1. Ouvrez la AWS DataSync console à l'adresse https://console.aws.amazon.com/datasync/.

  2. Dans le volet de navigation de gauche, développez Transfert de données, puis choisissez Tâches, puis choisissez Créer une tâche.

  3. Configurez les emplacements source et de destination de votre tâche.

    Pour plus d’informations, consultez Où puis-je transférer mes données AWS DataSync ?.

  4. Faites défiler la page jusqu'à la section Rapport des tâches. Pour Type de rapport, choisissez Rapport standard.

  5. Pour le niveau du rapport, choisissez l'une des options suivantes :

    • Erreurs uniquement : votre rapport de tâches inclut uniquement les problèmes liés aux DataSync tentatives de transfert, d'omission, de vérification et de suppression.

    • Succès et erreurs : votre rapport de tâches indique ce qui a été transféré, ignoré, vérifié et supprimé DataSync avec succès et ce qui n'a pas été le cas.

    • Personnalisé : vous permet de choisir si vous souhaitez voir uniquement les erreurs ou les réussites et les erreurs pour des aspects spécifiques de votre rapport de tâches.

      Par exemple, vous pouvez sélectionner Succès et erreurs pour la liste des fichiers transférés, mais Erreurs uniquement pour le reste du rapport.

  6. Si vous effectuez un transfert vers un compartiment S3 qui utilise la gestion des versions d'objets, maintenez l'option Inclure les versions d'objets Amazon S3 sélectionnée si vous souhaitez que votre rapport inclue la nouvelle version pour chaque objet transféré.

  7. Pour le compartiment S3 pour les rapports, choisissez un compartiment S3 dans lequel vous DataSync souhaitez télécharger votre rapport de tâches.

    Astuce

    Si vous envisagez de transférer des données vers un compartiment S3, n'utilisez pas le même compartiment pour votre rapport de tâches si vous désactivez l'option Conserver les fichiers supprimés. Sinon, tous les rapports de tâches précédents DataSync seront supprimés chaque fois que vous exécuterez une tâche, car ces rapports n'existent pas dans votre emplacement source.

  8. Pour Dossier, entrez un préfixe à utiliser pour votre rapport de tâches lors du DataSync téléchargement du rapport dans votre compartiment S3 (par exemple,reports/). Assurez-vous d'inclure le caractère délimiteur approprié à la fin de votre préfixe. Ce caractère est généralement une barre oblique (/). Pour plus d'informations, consultez la section Organisation des objets à l'aide de préfixes dans le guide de l'utilisateur Amazon S3.

  9. Pour IAM role (Rôle IAM), effectuez l'une des opérations suivantes :

    • Choisissez Autogenerate pour créer DataSync automatiquement un rôle IAM avec les autorisations requises pour accéder au compartiment S3.

      Si un rôle IAM a DataSync déjà été créé pour ce compartiment S3, ce rôle est choisi par défaut.

    • Choisissez un rôle IAM personnalisé que vous avez créé.

      Dans certains cas, vous devrez peut-être créer le rôle vous-même. Pour de plus amples informations, veuillez consulter DataSync Autoriser le téléchargement de rapports de tâches dans votre compartiment S3.

      Important

      Si votre compartiment S3 est chiffré à l'aide d'une clé SSE-KMS gérée par le client, la politique de la clé doit inclure le rôle IAM DataSync utilisé pour accéder au compartiment.

      Pour de plus amples informations, veuillez consulter Accès aux compartiments S3 à l'aide du chiffrement côté serveur.

  10. Terminez la création de votre tâche et lancez-la pour commencer à transférer vos données.

Lorsque votre transfert est terminé, vous pouvez consulter votre rapport de tâches.

  1. Copiez la create-task commande suivante :

    aws datasync create-task \
  --source-location-arn arn:aws:datasync:us-east-1:123456789012:location/loc-12345678abcdefgh \
  --destination-location-arn arn:aws:datasync:us-east-1:123456789012:location/loc-abcdefgh12345678 \
  --task-report-config '{
    "Destination":{
      "S3":{
        "Subdirectory":"reports/",
        "S3BucketArn":"arn:aws:s3:::your-task-reports-bucket",
        "BucketAccessRoleArn":"arn:aws:iam::123456789012:role/bucket-iam-role"
        }
    },
    "OutputType":"STANDARD",
    "ReportLevel":"level-of-detail",
    "ObjectVersionIds":"include-or-not"    
  }'

  2. Pour le --source-location-arn paramètre, spécifiez l'ARN de l'emplacement source dans votre transfert. Remplacez us-east-1 par le numéro approprié Région AWS, remplacez 123456789012 par le Compte AWS numéro approprié et remplacez 12345678abcdefgh par l'ID d'emplacement source approprié.

  3. Pour le --destination-location-arn paramètre, spécifiez l'ARN de l'emplacement de destination de votre transfert. Remplacez us-east-1 par le numéro approprié Région AWS, remplacez 123456789012 par le Compte AWS numéro approprié et remplacez abcdefgh12345678 par le numéro de localisation de destination approprié.

  4. Pour le --task-report-config paramètre, procédez comme suit :

    • Subdirectory— reports/ Remplacez-le par le préfixe de votre compartiment S3 dans lequel vous DataSync souhaitez télécharger vos rapports de tâches. Assurez-vous d'inclure le caractère délimiteur approprié à la fin de votre préfixe. Ce caractère est généralement une barre oblique (/). Pour plus d'informations, consultez la section Organisation des objets à l'aide de préfixes dans le guide de l'utilisateur Amazon S3.

    • S3BucketArn— Spécifiez l'ARN du compartiment S3 dans lequel vous souhaitez télécharger votre rapport de tâches.

      Astuce

      Si vous envisagez de transférer des données vers un compartiment S3, n'utilisez pas le même compartiment pour votre rapport de tâches si vous désactivez l'option Conserver les fichiers supprimés. Sinon, tous les rapports de tâches précédents DataSync seront supprimés chaque fois que vous exécuterez une tâche, car ces rapports n'existent pas dans votre emplacement source.

    • BucketAccessRoleArn— Spécifiez le rôle IAM qui permet DataSync de télécharger un rapport de tâches dans votre compartiment S3.

      Pour de plus amples informations, veuillez consulter DataSync Autoriser le téléchargement de rapports de tâches dans votre compartiment S3.

      Important

      Si votre compartiment S3 est chiffré à l'aide d'une clé SSE-KMS gérée par le client, la politique de la clé doit inclure le rôle IAM DataSync utilisé pour accéder au compartiment.

      Pour de plus amples informations, veuillez consulter Accès aux compartiments S3 à l'aide du chiffrement côté serveur.

    • OutputType— Spécifiez STANDARD le rapport.

      Pour plus d'informations, consultez la section Rapports de tâches standard Types de rapports de tâches.

    • (Facultatif) ReportLevel — Spécifiez si vous le souhaitez ERRORS_ONLY (par défaut) ou SUCCESSES_AND_ERRORS dans votre rapport.

    • (Facultatif) ObjectVersionIds — Si vous effectuez un transfert vers un compartiment S3 qui utilise le contrôle de version des objets, spécifiez NONE si vous ne souhaitez pas inclure la nouvelle version pour chaque objet transféré dans le rapport.

      Par défaut, cette option est définie surINCLUDE.

    • (Facultatif) Overrides — Personnalisez un aspect particulier de votre rapport. ReportLevel

      Par exemple, vous voudrez peut-être voir SUCCESSES_AND_ERRORS la liste de ce qui est DataSync supprimé dans votre lieu de destination, mais vous voulez tout ERRORS_ONLY le reste. Dans cet exemple, vous devez ajouter l'Overridesoption suivante au --task-report-config paramètre :

      "Overrides":{
  "Deleted":{
    "ReportLevel":"SUCCESSES_AND_ERRORS"
  }
}

      Si vous ne l'utilisez pasOverrides, l'ensemble de votre rapport utilise ReportLevel ce que vous spécifiez.

  5. Exécutez la create-task commande pour créer votre tâche.

    Vous obtenez une réponse semblable à la suivante qui indique l'ARN de la tâche que vous avez créée. Vous aurez besoin de cet ARN pour exécuter la start-task-execution commande.

    {
    "TaskArn": "arn:aws:datasync:us-east-1:123456789012:task/task-12345678abcdefgh"
}

  6. Copiez la start-task-execution commande suivante.

    aws datasync-task-report start-task-execution \
  --task-arn arn:aws:datasync:us-east-1:123456789012:task/task-12345678abcdefgh

  7. Pour le --task-arn paramètre, spécifiez l'ARN de la tâche que vous exécutez. Utilisez l'ARN que vous avez reçu lors de l'exécution de la create-task commande.

  8. Exécutez la commande start-task-execution.

Lorsque votre transfert est terminé, vous pouvez consulter votre rapport de tâches.