Cette page explique comment gérer les tâches et opérations de transfert existantes.
Pour créer une tâche de transfert, consultez la page Créer des transferts.
Modifier une configuration de transfert
Vous pouvez modifier les propriétés suivantes d'un transfert existant:
- Description de la tâche de transfert
- Identifiants de la source Microsoft Azure Blob Storage ou Amazon S3
- Tous les filtres appliqués à la tâche de transfert
- Options d'écrasement ou de suppression des fichiers
Calendrier de la tâche de transfert
CLI gcloud
Pour modifier une configuration de transfert existante, utilisez la commande gcloud transfer jobs update
.
gcloud transfer jobs update \
JOB_NAME \
[options]
Où :
JOB_NAME est le nom unique de la tâche à mettre à jour.
Les options pouvant être mises à jour sont répertoriées en exécutant la commande
gcloud transfer jobs update --help
.
Par exemple, pour mettre à jour la source et la destination d'une tâche, ainsi que pour supprimer sa description, exécutez la commande suivante:
gcloud transfer jobs update \
JOB_NAME \
--source=gs://new-bucket-1 \
--destination=gs://new-bucket-2 \
--clear-description
console Google Cloud
Pour modifier une tâche de transfert, procédez comme suit :
Dans la console Google Cloud, accédez à la page Service de transfert de stockage.
Cliquez sur la description de la tâche de transfert. La page Détails de la tâche s'affiche.
Cliquez sur Configuration La configuration de la tâche de transfert s'affiche.
Pour modifier un élément, cliquez sur
Modifier à côté de l'élément.Pour démarrer une tâche avec les modifications, cliquez sur Lancer une exécution.
REST
Pour modifier une configuration de transfert, utilisez la
transferJobs.patch
.
Exécuter une tâche de transfert à partir d'une configuration existante
Vous pouvez exécuter une tâche de transfert existante. Cela vous permet de démarrer des tâches sans planification ou de démarrer une tâche en dehors de sa planification.
CLI gcloud
Pour exécuter un transfert à partir d'une configuration existante, utilisez gcloud transfer jobs run
:
gcloud transfer jobs run JOB_NAME
Vous pouvez spécifier l'option --no-async
facultative pour bloquer d'autres tâches dans votre terminal jusqu'à la fin de l'opération de transfert.
console Google Cloud
Pour exécuter un transfert à partir d'une configuration existante, procédez comme suit :
Dans la console Google Cloud, accédez à la page Service de transfert de stockage.
Cliquez sur la description de la tâche de transfert. La page Détails de la tâche s'affiche.
Pour démarrer une tâche de transfert, cliquez sur Lancer une exécution.
REST
Pour exécuter un job de transfert, utilisez la
transferJobs.run
.
Surveiller une tâche de transfert
CLI gcloud
Pour surveiller la progression d'une tâche en temps réel, utilisez gcloud transfer jobs monitor
.
gcloud transfer jobs monitor JOB_NAME
La réponse indique l'opération en cours, l'heure de début de la tâche et la quantité de données transférées. Les octets ignorés et les erreurs sont également comptabilisés.
Cloud Monitoring
Pour en savoir plus sur l'utilisation de Cloud Monitoring avec le service de transfert de stockage, consultez Surveiller les tâches de transfert.
Afficher les détails d'une tâche de transfert
CLI gcloud
Pour afficher les détails d'une tâche de transfert, utilisez gcloud transfer jobs describe
:
gcloud transfer jobs describe JOB_NAME
Pour afficher l'opération la plus récente de cette tâche, transmettez la valeur de latestOperationName
à la commande operations describe
:
gcloud transfer operations describe OPERATION_NAME
Pour répertorier toutes les opérations de transfert d'une tâche, utilisez la commande gcloud transfer operations list
:
gcloud transfer operations list --job-names=JOB_NAME
Vous pouvez afficher les opérations de plusieurs tâches en les répertoriant, en les séparant par des virgules, en tant que valeur de --job-names
. Ne renseignez pas --job-names
pour afficher les opérations de toutes les tâches.
console Google Cloud
Vous pouvez afficher les informations suivantes sur le job à partir de la console Google Cloud:
- Description et nom de la tâche
- Type de source et emplacement
- Emplacement de destination
- Fréquence de la tâche
- Statistiques de tâche
Pour afficher les détails d'une tâche de transfert, procédez comme suit :
Dans la console Google Cloud, accédez à la page Service de transfert de stockage.
Cliquez sur la description de la tâche de transfert. La page Détails de la tâche s'affiche.
Pour afficher les détails d'une exécution spécifique, cliquez sur Heure de début de l'exécution de la tâche. Voici les informations disponibles sur la tâche :
- État du transfert
- Heures de début et de fin
- Durée
- Progression
- Données transférées
- Nombre d'erreurs
- Données ignorées
- Estimation de la vitesse moyenne
REST
Pour afficher les détails d'une tâche de transfert, utilisez la méthode transferJobs.get
pour renvoyer des informations sur une tâche de transfert spécifique, comme son ID d'opération.
Bibliothèques clientes
Une ressource TransferJob
est renvoyée lorsque vous utilisez transferJobs.create
.
Vous pouvez vérifier l'état du transfert après avoir créé la tâche à l'aide de
transferJobs.get
. Si l'opération de transfert
a démarré, elle renvoie une
TransferJob
contenant un champ
latestOperationName
rempli.
Dans le cas contraire, si l'opération de la tâche de transfert n'a pas démarré, le
champ latestOperationName
est vide.
Pour vérifier l'état d'une tâche de transfert
REST
Effectuez une requête à l'aide de la méthode transferJobs get :GET https://storagetransfer.googleapis.com/v1/{jobName="name"}
Go
Java
Vous recherchez des exemples plus anciens ? Consultez le Guide de migration du service de transfert de stockage
Node.js
Python
Vous recherchez des exemples plus anciens ? Consultez le guide de migration du service de transfert de stockage.
Suspendre une tâche de transfert
Vous pouvez suspendre un transfert en cours d'exécution. Lorsque vous suspendez le transfert, l'état de la tâche est conservé et vous pouvez réactiver le transfert ultérieurement. Lorsqu'un transfert est suspendu, la planification ne déclenche pas une nouvelle exécution de la tâche.
CLI gcloud
Pour suspendre une tâche de transfert, transmettez le nom actuel de l'opération de la tâche à gcloud transfer operations pause
.
gcloud transfer operations pause OPERATION_NAME
Pour reprendre une tâche de transfert précédemment suspendue, qui redémarre la tâche au même emplacement que celui où elle a été suspendue, utilisez gcloud transfer operations resume
.
gcloud transfer operations resume OPERATION_NAME
console Google Cloud
Pour suspendre une tâche de transfert, procédez comme suit :
Dans la console Google Cloud, accédez à la page Service de transfert de stockage.
Cliquez sur la description de la tâche de transfert. La page Détails de la tâche s'affiche.
Cliquez sur Suspendre l'exécution. L'état de l'opération en cours est défini sur Suspendu.
Pour reprendre une tâche de transfert précédemment suspendue et la redémarrer à l'endroit où elle a été suspendue, procédez comme suit.
Dans la console Google Cloud, accédez à la page Service de transfert de stockage.
Cliquez sur la description de la tâche de transfert. La page Détails de la tâche s'affiche.
Cliquez sur Reprendre l'exécution.
L'état de l'opération en cours est défini sur En cours.
REST
Pour suspendre une tâche de transfert, utilisez la méthode transferOperations.pause
.
Désactiver une tâche de transfert
La désactivation d'une tâche de transfert empêche la tâche de transfert de démarrer d'autres opérations planifiées ou des opérations démarrées manuellement à partir de la console. Cela n'empêche pas de démarrer une tâche manuellement avec l'API ou avec la commande gcloud jobs run
.
CLI gcloud
Pour désactiver une tâche de transfert, définissez l'état de la tâche sur disabled
.
gcloud transfer jobs update JOB_NAME --status=disabled
Pour réactiver une tâche, définissez --status=enabled
.
console Google Cloud
Pour désactiver une tâche de transfert, procédez comme suit :
Dans la console Google Cloud, accédez à la page Service de transfert de stockage.
Cliquez sur la description de la tâche de transfert. La page Détails de la tâche s'affiche.
Cliquez sur Désactiver la tâche. La boîte de dialogue Désactiver la tâche de transfert ? s'affiche.
Lisez la boîte de dialogue, puis confirmez la désactivation de la tâche en cliquant sur Confirmer.
Une notification en haut de la page Informations sur la tâche s'affiche pour vous rappeler que la tâche est désactivée.
REST
Utilisez la méthode transferJobs.patch
pour définir l'état de la tâche de transfert sur DISABLED
.
Supprimer une tâche de transfert
Vous pouvez supprimer les tâches de transfert dont vous n'avez plus besoin. La suppression d'une tâche entraîne les actions suivantes :
- Arrêt de tous les transferts existants de la tâche
- Arrêt de tous les transferts récurrents de la tâche
- Suppression des détails de la configuration de la tâche
La suppression d'une tâche est définitive. Une fois la tâche de transfert supprimée, elle est supprimée de la liste des tâches de transfert. Les informations sur la tâche de transfert sont complètement supprimées du service de transfert de stockage au bout de 30 jours.
Vous pouvez également désactiver la tâche de transfert. Elle reste ainsi répertoriée sur la page Tâches, et vous pouvez la réactiver ou la modifier.
CLI gcloud
Pour supprimer une tâche de transfert, utilisez gcloud transfer jobs delete
.
gcloud transfer jobs delete JOB_NAME
console Google Cloud
Pour supprimer une tâche de transfert, procédez comme suit :
Dans la console Google Cloud, accédez à la page Service de transfert de stockage.
Cochez la case à côté de la tâche de transfert à supprimer.
Cliquez sur Supprimer la tâche.
La boîte de dialogue Supprimer la tâche de transfert ? s'affiche.
Lisez la boîte de dialogue, confirmez la suppression de la tâche en saisissant le nom qui lui a été attribué automatiquement dans le champ, puis cliquez sur Supprimer.
La tâche est supprimée de la page Tâches.
REST
Pour supprimer une tâche de transfert à l'aide de l'API REST, consultez la documentation de référence sur transferJobs.delete
.
Voir les détails des erreurs
Si vous rencontrez des erreurs pendant l'exécution d'un transfert, vous pouvez afficher leurs détails pour vous aider à les corriger.
Pour afficher les détails d'une erreur de l'exécution d'une tâche de transfert, procédez comme suit :
Dans la console Google Cloud, accédez à la page Service de transfert de stockage.
Cliquez sur la description de la tâche de transfert. La page Détails de la tâche s'affiche.
Effectuez l'une des opérations suivantes pour afficher les détails de la tâche :
Dernière tâche exécutée:cliquez sur le bouton See error details (Afficher les détails de l'erreur) ou sur le lien View error details (Afficher les détails de l'erreur). La page Détails de l'erreur s'affiche.
Historique des tâches exécutées:
Cliquez sur l'heure de début de l'exécution de la tâche.
La page Détails de l'exécution s'affiche.
Cliquez sur le lien Afficher les détails de l'erreur.
La page Détails de l'erreur s'affiche.
Pour afficher des informations supplémentaires sur chaque erreur affichée, cliquez sur expand_more Développer.
Pour filtrer les erreurs, saisissez les propriétés à filtrer dans le champ Saisir le nom ou la valeur de la propriété.
Lorsque vous placez le curseur dans le champ, un menu déroulant s'affiche avec des options pertinentes pour vous aider à créer votre filtre.