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 pour 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 d’opérations par lot, consultez Utilisation 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 de fin de tâche, vous pouvez également capturer, examiner et auditer l’activité des opérations par lot à l’aide d’ AWS CloudTrail. Puisque les opérations par lot utilisent des opérations d’API Amazon S3 existantes pour exécuter des tâches, ces dernières émettent également les mêmes événements que si vous les appeliez directement. Dès lors, vous pouvez suivre et enregistrer la progression de votre tâche et l’ensemble de ses tâches à l’aide des mêmes outils et processus de notification, de journalisation et d’audit 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, consultez Notifications d'événements Amazon S3.

Suivi de l’échec d’une tâche

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. La fonctionnalité d’opérations par lot S3 stocke les codes et les causes d’é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. 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. Si la fonctionnalité d’opérations par lot S3 invoque avec succès au moins une tâche, Amazon S3 génère un rapport de fin de tâche après avoir terminé l’exécution des tâches, après avoir échoué ou après avoir été annulé. Vous pouvez configurer le rapport de fin de tâche pour y inclure toutes les tâches ou uniquement celles ayant échoué.

Le rapport de fin de tâche inclut la configuration et le statut des tâches, ainsi que des informations sur chaque tâche, y compris la clé d’objet et la version, le statut, les codes d’erreur et la description des erreurs. 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 de fin de tâche sont chiffrés à l’aide du 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, consultez 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 :