Créez un rapport de cache pour votre passerelle de fichiers S3

S3 File Gateway peut générer un rapport des métadonnées pour les fichiers qui se trouvent actuellement dans le cache de téléchargement local pour un partage de fichiers spécifique. Vous pouvez appliquer des filtres et des critères supplémentaires qui déterminent les types spécifiques de fichiers mis en cache qui apparaissent dans le rapport. Vous pouvez utiliser ce rapport pour identifier et résoudre les problèmes liés à la passerelle. Par exemple, si le chargement de certains fichiers depuis votre passerelle vers Amazon S3 échoue, vous pouvez générer un rapport répertoriant les fichiers spécifiques qui échouent et les raisons de l'échec du téléchargement. Le rapport est un fichier CSV contenant une liste de fichiers correspondant à l'ensemble de paramètres de filtre que vous spécifiez. Le fichier de sortie est stocké en tant qu'objet Amazon S3 dans un emplacement de compartiment que vous spécifiez lors de la configuration du rapport. Pour créer un rapport de cache à l'aide de l' AWS Storage Gateway API, reportez-vous StartCacheReportà la section Storage Gateway API Reference. Pour créer un rapport de cache dans la console Storage Gateway, procédez comme suit.

Prérequis

• Votre passerelle doit disposer s3:PutObject d's3:AbortMultipartUploadautorisations pour le compartiment Amazon S3 dans lequel vous souhaitez stocker le rapport de cache.

• Aucun autre rapport de cache ne peut actuellement être en cours pour le partage de fichiers.

• Il doit y avoir moins de 10 rapports de cache existants pour le partage de fichiers.

• La passerelle doit être en ligne et connectée à AWS.

• Le disque racine de la passerelle doit disposer d'au moins 20 Go d'espace libre.

Pour créer un rapport de cache à l'aide de la console Storage Gateway

1. Ouvrez la console Storage Gateway à l'adresse https://console.aws.amazon.com/storagegateway/home/.

2. Dans le volet de navigation sur le côté gauche de la page, choisissez Partage de fichiers, puis choisissez le partage de fichiers pour lequel vous souhaitez créer un rapport de cache.

3. Dans le menu déroulant Actions, choisissez Créer un rapport de cache.

4. Pour l'emplacement Amazon S3, entrez le compartiment Amazon S3 et le préfixe de l'emplacement où vous souhaitez enregistrer l'objet de fichier CSV du rapport de cache terminé dans Amazon S3. Pour sélectionner le compartiment et le préfixe dans votre espace de stockage Amazon S3 existant, choisissez Browse S3.

5. Pour le rôle IAM, effectuez l'une des opérations suivantes pour spécifier un rôle IAM qui accorde à votre passerelle de fichiers l'autorisation de générer et de stocker votre rapport de cache :

   • Pour spécifier un rôle IAM existant, choisissez-en un dans la liste déroulante.

   • Pour créer manuellement un nouveau rôle IAM, choisissez Create a role, puis créez le nouveau rôle à l'aide de la console IAM.

   Note

   Le rôle IAM que vous spécifiez doit disposer des autorisations suivantes pour écrire des objets dans le compartiment de rapports, à l'emplacement Amazon S3, et pour arrêter les téléchargements partitionnés vers le compartiment de rapports :

   • s3:PutObject

   • s3:AbortMultipartUpload

   Le rôle doit également permettre au storagegateway.amazonaws.com service d'assumer le rôle à l'aide de l'sts:AssumeRoleaction.

6. Pour le filtre de rapport, effectuez l'une des opérations suivantes pour déterminer quels fichiers seront inclus dans le rapport de cache :

   • Pour inclure tous les fichiers mis en cache dont le chargement sur Amazon S3 échoue actuellement, sélectionnez Tous les fichiers ne parvenant pas à être chargés.

   • Pour inclure uniquement les fichiers dont le chargement sur Amazon S3 échoue pour une raison spécifique, sélectionnez uniquement les raisons spécifiques de l'échec du téléchargement. Ensuite, dans la zone Motifs d'échec, sélectionnez une ou plusieurs des raisons suivantes :

     • Classe de stockage inaccessible : la passerelle ne peut pas accéder à la classe de stockage Amazon S3 dans laquelle l'objet est stocké. Pour plus d'informations, consultez la section Erreur : InaccessibleStorageClass.

     • État de l'objet non valide : l'état du fichier sur la passerelle ne correspond pas à son état dans Amazon S3. Pour plus d'informations, consultez la section Erreur : InvalidObjectState.

     • Objet manquant — L'objet a été supprimé ou déplacé dans Amazon S3. Pour plus d'informations, consultez la section Erreur : ObjectMissing.

     • Accès S3 refusé — Le rôle IAM d'accès au compartiment Amazon S3 n'autorise pas la passerelle à effectuer l'opération de téléchargement. Pour plus d'informations, consultez Erreur : S3 AccessDenied.

   Note

   L'indicateur d'échec du téléchargement des fichiers est réinitialisé toutes les 24 heures et lors du redémarrage de la passerelle. Si ce rapport capture les fichiers après la réinitialisation, mais avant qu'ils ne soient à nouveau marqués, ils ne seront pas signalés comme fichiers ayant échoué au téléchargement.

7. Pour utiliser un point de terminaison VPC pour vous connecter à S3 ? , effectuez l'une des opérations suivantes pour spécifier la manière dont votre passerelle se connectera au compartiment Amazon S3 :

   • Pour vous connecter directement sans utiliser Amazon VPC, choisissez Connect directly to the bucket.

   • Pour parcourir la liste des points de terminaison Amazon VPC existants, choisissez Choisir un point de terminaison VPC, puis spécifiez un point de terminaison dans la liste déroulante des points de terminaison VPC qui s'affiche.

   • Pour spécifier un point de terminaison Amazon VPC existant par son nom DNS, choisissez Entrez le nom DNS du point de terminaison VPC, puis entrez le nom DNS dans le champ Nom DNS du point de terminaison VPC qui apparaît.

   Note

   Si votre partage de fichiers utilise un point de terminaison VPC pour se connecter à Amazon S3 pour des opérations normales, nous vous recommandons d'utiliser le même VPC lorsque vous configurez votre rapport de cache. La création du rapport de cache échouera si la passerelle ne parvient pas à se connecter au compartiment Amazon S3 pour une raison quelconque, y compris une configuration VPC non valide.

8. (Facultatif) Sous Balises - facultatif, choisissez Ajouter une nouvelle balise, puis entrez une clé et une valeur pour votre rapport de cache.

   Une balise est une paire clé-valeur distinguant majuscules et minuscules qui vous aide à classer vos ressources Storage Gateway. L'ajout de balises peut faciliter le filtrage et la recherche de votre rapport de cache. Vous pouvez répéter cette étape pour ajouter jusqu'à 50 balises.

9. Choisissez Créer un rapport lorsque vous avez terminé.

   Storage Gateway commence à générer le rapport. Vous pouvez vérifier la progression et consulter l'état dans l'onglet Rapports du cache de la page de détails du partage de fichiers.