Diagnostiquer une erreur et consulter les journaux
Commencez par le message de l’action qui a échoué. Une permission refusée, une capacité désactivée et une erreur réseau demandent des corrections différentes. Si l’action porte sur plusieurs éléments, consultez leurs sous-opérations et le bilan disponible : des modifications peuvent avoir réussi avant l’erreur.
Vérifier la connexion et les identifiants
- Ouvrez File > Accounts….
- Sélectionnez le compte concerné et cliquez sur Edit….
- Cliquez sur Test connection.
- Cliquez sur Details… pour ouvrir Connection test et lire les détails du résultat et de l’erreur. Vérifiez les champs ou la source d’identifiants concernés avant de recommencer.
Le test charge les identifiants puis effectue une requête S3. Il ne vérifie pas toutes les permissions nécessaires aux transferts ou aux propriétés.
| Symptôme ou code | Cause et action |
|---|---|
| AccessDenied dans le test | Le service a refusé la lecture de la liste des buckets ou du contenu du premier bucket configuré. Vérifiez le détail du refus et les autorisations ; pour un compte sans droit de lister les buckets, vérifiez aussi sa liste de buckets configurés. |
| InvalidAccessKeyId | Le service ne reconnaît pas la clé d’accès. Vérifiez le compte, le service visé et la clé. |
| SignatureDoesNotMatch | La signature a été rejetée. Vérifiez la clé secrète, l’endpoint, la région et la version de signature. |
| RequestExpired | La requête a expiré. Vérifiez l’horloge de l’ordinateur puis relancez le test. |
| ExpiredToken ou TokenRefreshRequired | Les identifiants temporaires ou le jeton de session ont expiré. Renouvelez-les auprès de leur source ; pour SSO, vérifiez votre session de connexion. |
| Credentials could not be loaded: … | La source d’identifiants n’a pas fourni d’identifiants utilisables. Vérifiez le profil, le processus externe, la session SSO ou le service de métadonnées indiqué. |
| Connection failed., avec des détails indiquant une erreur de proxy | Le proxy ou son authentification empêche la requête. Vérifiez Tools > Options… > Network. |
| Connection failed., avec des détails indiquant une erreur réseau | La requête n’a pas abouti au niveau réseau. Vérifiez l’hôte, le port, la résolution DNS, la connexion et le détail de l’erreur TLS ou réseau. |
Consultez les connexions, les sources d’identifiants et le proxy pour les procédures correspondantes. Pour un refus S3 lors d’une autre action, vérifiez les permissions propres à cette action ; la réussite du test de connexion ne les garantit pas.
Comprendre une commande indisponible ou un refus
Vérifiez le panneau actif, la sélection et le type d’élément : certaines commandes exigent un seul objet, un dossier ou un bucket. Un marqueur de suppression n’a pas de contenu à copier ou prévisualiser. Une version historique n’offre pas nécessairement les mêmes modifications que l’objet courant.
Si la commande dépend d’une capacité du compte, ouvrez File > Accounts…, sélectionnez le compte, puis cliquez sur Edit… et ouvrez Capabilities. Vérifiez la capacité et la politique concernées en suivant leur configuration. Le service doit prendre en charge la fonction et vos identifiants doivent disposer des permissions nécessaires.
Certains réglages dépendent aussi de l’état du bucket, notamment du versionnement, d’Object Lock et de la propriété des objets. Si un onglet indique une lecture refusée ou échouée, corrigez sa cause puis rechargez ses données avant de le modifier.
Lors d’une copie, répondez au dialogue de confirmation d’écrasement ou de fusion qui s’ouvre automatiquement. Une synchronisation n’offre pas de décision par fichier : un conflit détecté figure dans son résultat et demande de vérifier les emplacements puis de préparer une nouvelle synchronisation. Avant de recommencer une action partiellement exécutée, vérifiez la source et la destination. Consultez le suivi des opérations et la synchronisation.
Comprendre un refus lié aux ACL
Consultez le code et le message complet de l’erreur. Les réglages se trouvent dans File > Accounts… > Edit… > Capabilities > ACL policy.
| Symptôme | Cause et action |
|---|---|
AclDisabled | Le message distingue les opérations ACL désactivées dans le compte d’une désactivation imposée par le bucket. Une ACL explicite reste refusée ; choisissez le défaut de destination si vous n’exigez aucune ACL. |
AclPreservationImpossible | L’opération exige la conservation de l’ACL, mais ne peut pas la garantir. Vérifiez les comptes, le bucket et les capacités nécessaires. Désactiver les opérations ACL ne satisfait pas cette exigence. |
AclWritePathUnavailable | Aucun mode d’écriture configuré ne peut porter l’ACL demandée sur le transfert choisi. Vérifiez les formes de requête réellement prises en charge. Avec les opérations ACL désactivées dans le compte destination, un transfert ordinaire au défaut de destination ne nécessite aucun mode d’écriture ACL. |
AccessDenied | Les identifiants ne permettent pas la requête. Vérifiez les politiques et permissions ; ce refus ne prouve pas que les ACL sont désactivées ou non prises en charge. |
Après une modification du compte, rouvrez le dialogue et préparez une nouvelle opération : une opération déjà préparée conserve sa configuration capturée. Voir ACL et propriété pour distinguer le choix local, Bucket owner enforced et les limites d’API.
Reconnaître un résultat partiel ou un aperçu refusé
Après une interruption ou une erreur de navigation, la liste affichée peut être provisoire ou provenir de la lecture précédente. Elle ne suffit pas à confirmer la totalité du contenu actuel. Le dialogue Navigation error indique la cause d’un échec de lecture ou d’actualisation. Corrigez-la puis actualisez, comme expliqué dans le guide des panneaux.
Après une copie, une suppression ou une modification en lot, vérifiez les sous-opérations et les éléments en erreur, ainsi que le bilan lorsqu’il est disponible, puis actualisez l’emplacement concerné. Une interruption conserve les changements déjà effectués ; elle ne restaure pas automatiquement l’état initial.
Un aperçu refusé peut venir du format, d’une limite de taille, du décodage, d’une clé SSE-C manquante ou d’un objet archivé non restauré. Vérifiez les aperçus, les réglages d’aperçu, le chiffrement et les archives selon le message affiché. Un aperçu textuel partiel peut simplement avoir atteint la limite de contenu configurée.
Activer les traces HTTP/HTTPS
La journalisation est désactivée par défaut. Activez-la avant de reproduire l’action : elle ne reconstruit pas les échanges passés. Elle ajoute du traitement et du contenu en mémoire, surtout pour de grandes réponses XML.
- Ouvrez Tools > Options… > HTTP Logging.
- Cochez Enable HTTP logging pour enregistrer les traces des échanges des opérations S3.
- Choisissez Add request bodies (xml elements) et Add response bodies (xml elements) si les corps XML sont utiles. Ces deux cases sont cochées par défaut, mais ne sont actives que lorsque la journalisation est activée. Elles ne constituent pas une capture du contenu des fichiers transférés.
- Add signing details (‘canonical request’ and ‘string to sign’) ajoute les détails de signature. Cette case est décochée par défaut, disponible aussi dans les versions de diffusion et activable uniquement avec la journalisation.
- Validez avec OK, puis reproduisez l’action concernée.
Les valeurs sensibles reconnues dans les en-têtes, paramètres de signature et éléments XML sont remplacées par [redacted] : autorisation, jetons et clés SSE-C, par exemple. Les journaux peuvent contenir des noms de buckets, des clés d’objets, des endpoints et des métadonnées. Relisez-les avant de les transmettre.
Consulter et exporter les détails
- Dans la liste des opérations sous les panneaux, attendez que l’opération soit terminée ou interrompue, puis sélectionnez une seule ligne. Développez son arborescence si vous souhaitez consulter une sous-opération.
- Choisissez Show details dans le menu contextuel ou utilisez le bouton correspondant. La commande est disponible lorsque la ligne terminée ou interrompue possède un journal, une erreur ou un bilan à consulter.
- Dans Operation details, lisez les détails et, s’il est présent, le bilan. Les champs Font et Size changent uniquement la présentation du texte.
- Cliquez sur Save….
- Choisissez le nom et l’emplacement du fichier texte puis enregistrez. Le texte des détails est exporté en UTF-8 ; copiez séparément le bilan affiché au-dessus s’il est utile au signalement.
Show error message affiche le message de la ligne sélectionnée lorsqu’elle possède une erreur. Enregistrez les détails avant de retirer une opération ou de fermer S3Client ; les journaux de la session ne sont pas conservés comme historique.
Pour signaler un problème, écrivez à en indiquant la version de S3Client, la plateforme, le service S3, l’action et la sélection, le résultat attendu, le message ou code exact et les étapes permettant de reproduire le problème. Joignez les détails utiles après relecture, sans clé secrète, jeton ni clé SSE-C.
Après le diagnostic, retournez dans HTTP Logging, décochez Enable HTTP logging et validez avec OK.