Suivi de l'état de la tâche et des rapports de fin de tâche

Grâce aux opérations par lot S3, vous pouvez afficher et mettre à jour l'état d'une tâche, ajouter des notifications et effectuer la journalisation, suivre les échecs de tâche et générer des rapports de fin de tâches.

Statuts de la tâche

Après la création et l'exécution d'une tâche, celle-ci passe par une série d'états. Le tableau suivant décrit les états et les transitions possibles entre eux.

Mise à jour de l'état

Les AWS SDK for Java exemples suivants AWS CLI mettent à jour le statut d'une tâche Batch Operations. Pour plus d'informations sur l'utilisation de la console Amazon S3 pour gérer les tâches Batch Operations, consultezUtilisation de la console Simple Storage Service (Amazon S3) pour gérer vos tâches d'opérations par lot S3.

package aws.example.s3control;


import com.amazonaws.AmazonServiceException;
import com.amazonaws.SdkClientException;
import com.amazonaws.auth.profile.ProfileCredentialsProvider;
import com.amazonaws.services.s3control.AWSS3Control;
import com.amazonaws.services.s3control.AWSS3ControlClient;
import com.amazonaws.services.s3control.model.UpdateJobStatusRequest;

import static com.amazonaws.regions.Regions.US_WEST_2;

public class UpdateJobStatus {
    public static void main(String[] args) {
        String accountId = "Account ID";
        String jobId = "00e123a4-c0d8-41f4-a0eb-b46f9ba5b07c";

        try {
            AWSS3Control s3ControlClient = AWSS3ControlClient.builder()
                    .withCredentials(new ProfileCredentialsProvider())
                    .withRegion(US_WEST_2)
                    .build();

            s3ControlClient.updateJobStatus(new UpdateJobStatusRequest()
                    .withAccountId(accountId)
                    .withJobId(jobId)
                    .withRequestedJobStatus("Ready"));

        } catch (AmazonServiceException e) {
            // The call was transmitted successfully, but Amazon S3 couldn't process
            // it and returned an error response.
            e.printStackTrace();
        } catch (SdkClientException e) {
            // Amazon S3 couldn't be contacted for a response, or the client
            // couldn't parse the response from Amazon S3.
            e.printStackTrace();
        }
    }
}

Notifications et journalisation

En plus de demander des rapports d'achèvement, vous pouvez également capturer, examiner et auditer l'activité des opérations par lots en utilisant AWS CloudTrail. Dans la mesure où Batch Operations utilise les API opérations Amazon S3 existantes pour effectuer des tâches, celles-ci émettent également les mêmes événements que si vous les appeliez directement. Par conséquent, vous pouvez suivre et enregistrer la progression de votre tâche et de toutes ses tâches en utilisant les mêmes outils et processus de notification, de journalisation et d'audit que ceux que vous utilisez déjà avec Amazon S3. Pour plus d'informations, consultez les exemples dans les sections suivantes.

Pour de plus amples informations sur les évènements Amazon S3, veuillez consulter Notifications d'événements Amazon S3.

Suivi des échecs au travail

Si une tâche d'opérations par lot S3 rencontre un problème qui l'empêche de s'exécuter avec succès, comme le fait de ne pas pouvoir lire le manifeste spécifié, elle échoue. Lorsqu'une tâche échoue, elle génère un ou plusieurs codes d'échec ou causes d'échec. S3 Batch Operations enregistre les codes d'échec et les raisons de l'échec avec la tâche afin que vous puissiez les consulter en demandant les détails de la tâche. Si vous avez demandé un rapport de fin de tâche, ce dernier inclut également les codes et les raisons d'échec.

Pour empêcher les tâches d'exécuter un grand nombre d'opérations infructueuses, Amazon S3 impose un seuil d'échec à chaque tâche d'opérations par lot. Lorsqu'une tâche a exécuté au moins 1 000 tâches, Amazon S3 surveille le taux d'échec des tâches. Si, à un moment donné, le taux d'échec (le nombre de tâches ayant échoué par rapport au nombre total de tâches exécutées) dépasse 50 %, la tâche échoue. Lorsqu'une tâche échoue parce qu'elle dépasse ce seul, vous pouvez identifier la cause de cet échec. Il se peut, par exemple, que vous ayez inclus par erreur des objets dans le manifeste qui ne sont pas dans le compartiment spécifié. Après avoir corrigé les erreurs, vous pouvez renvoyer la tâche.

Rapports de fin de tâche

Lorsque vous créez une tâche, vous pouvez demander un rapport de fin de tâche. Tant que S3 Batch Operations appelle avec succès au moins une tâche, Amazon S3 génère un rapport d'achèvement une fois que la tâche a terminé d'exécuter les tâches, a échoué ou a été annulée. Vous pouvez configurer le rapport de fin de tâche pour y inclure toutes les tâches ou uniquement celles ayant échoué.

Le rapport d'achèvement inclut la configuration, le statut et les informations relatives à chaque tâche, notamment la clé et la version de l'objet, le statut, les codes d'erreur et les descriptions des erreurs éventuelles. Les rapports de fin de tâche fournissent un moyen facile de consulter les résultats de vos tâches dans un format consolidé sans nécessiter de configuration supplémentaire. Les rapports d'achèvement sont chiffrés à l'aide d'un chiffrement côté serveur avec des clés gérées par Amazon S3 (SSE-S3). Pour obtenir un exemple de rapport de fin de tâche, veuillez consulter Exemples : Rapports de fin de tâche d'opérations par lot S3.

Si vous ne configurez pas de rapport d'achèvement, vous pouvez toujours surveiller et auditer votre tâche et ses tâches à l'aide d' CloudTrail Amazon CloudWatch. Pour plus d’informations, consultez les rubriques suivantes :