Erstellen Sie einen Cache-Bericht für Ihr S3 File Gateway - AWS Storage Gateway

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Erstellen Sie einen Cache-Bericht für Ihr S3 File Gateway

S3 File Gateway kann einen Bericht mit den Metadaten für Dateien generieren, die sich derzeit im lokalen Upload-Cache für eine bestimmte Dateifreigabe befinden. Sie können Filter und zusätzliche Kriterien anwenden, die bestimmen, welche spezifischen Typen von zwischengespeicherten Dateien im Bericht erscheinen. Sie können diesen Bericht verwenden, um Gateway-Probleme zu identifizieren und zu lösen. Wenn Sie beispielsweise Dateien haben, die nicht von Ihrem Gateway zu Amazon S3 hochgeladen werden können, können Sie einen Bericht erstellen, der die spezifischen Dateien auflistet, die nicht hochgeladen werden konnten, sowie die Gründe für den Upload-Fehler. Der Bericht ist eine CSV-Datei mit einer Liste von Dateien, die den von Ihnen angegebenen Filterparametern entsprechen. Die Ausgabedatei wird als Amazon S3 S3-Objekt an einem Bucket-Speicherort gespeichert, den Sie bei der Konfiguration des Berichts angeben. Informationen zum Erstellen eines Cache-Berichts mithilfe der AWS Storage Gateway API finden Sie StartCacheReportin der Storage Gateway API-Referenz. Gehen Sie wie folgt vor, um einen Cache-Bericht in der Storage Gateway Gateway-Konsole zu erstellen.

Voraussetzungen

  • Ihr Gateway muss über s3:PutObject s3:AbortMultipartUpload Berechtigungen für den Amazon S3 S3-Bucket verfügen, in dem Sie den Cache-Bericht speichern möchten.

  • Derzeit können keine anderen Cache-Berichte für die Dateifreigabe bearbeitet werden.

  • Es müssen weniger als 10 Cacheberichte für die Dateifreigabe vorhanden sein.

  • Das Gateway muss online und verbunden sein AWS.

  • Die Gateway-Root-Festplatte muss über mindestens 20 GB freien Speicherplatz verfügen.

So erstellen Sie einen Cache-Bericht mit der Storage Gateway Gateway-Konsole

  1. Öffnen Sie die Storage Gateway Gateway-Konsole zu https://console.aws.amazon.com/storagegateway/Hause/.

  2. Wählen Sie im Navigationsbereich auf der linken Seite die Option Dateifreigaben und dann die Dateifreigabe aus, für die Sie einen Cache-Bericht erstellen möchten.

  3. Wählen Sie im Dropdownmenü Aktionen die Option Cache-Bericht erstellen aus.

  4. Geben Sie für den Amazon S3-Standort den Amazon S3 S3-Bucket und das Präfix des Speicherorts ein, an dem Sie das CSV-Dateiobjekt für den vollständigen Cache-Bericht in Amazon S3 speichern möchten. Um den Bucket und das Präfix aus Ihrem vorhandenen Amazon S3 S3-Speicher auszuwählen, wählen Sie Browse S3.

  5. Gehen Sie für die IAM-Rolle wie folgt vor, um eine IAM-Rolle anzugeben, die Ihrem File Gateway Berechtigungen zum Generieren und Speichern Ihres Cache-Berichts gewährt:

    • Um eine bestehende IAM-Rolle anzugeben, wählen Sie eine Rolle aus der Dropdownliste aus.

    • Um eine neue IAM-Rolle manuell zu erstellen, wählen Sie Create a role und erstellen Sie dann die neue Rolle mithilfe der IAM-Konsole.

    Anmerkung

    Die von Ihnen angegebene IAM-Rolle muss über die folgenden Berechtigungen verfügen, um Objekte in den Amazon S3 S3-Speicherort des Berichts-Buckets zu schreiben und mehrteilige Uploads in den Berichts-Bucket zu stoppen:

    • s3:PutObject

    • s3:AbortMultipartUpload

    Die Rolle muss es dem storagegateway.amazonaws.com Service auch ermöglichen, die Rolle mithilfe der Aktion zu übernehmen. sts:AssumeRole

  6. Führen Sie für den Berichtsfilter einen der folgenden Schritte aus, um zu bestimmen, welche Dateien in den Cache-Bericht aufgenommen werden sollen:

    • Um alle zwischengespeicherten Dateien einzubeziehen, die derzeit nicht auf Amazon S3 hochgeladen werden können, wählen Sie Alle Dateien, die nicht hochgeladen werden können.

    • Um nur die Dateien einzubeziehen, bei denen der Upload zu Amazon S3 aus einem bestimmten Grund fehlschlägt, wählen Sie Nur bestimmte Gründe für Upload-Fehler. Wählen Sie dann unter Gründe für Fehler einen oder mehrere der folgenden Gründe aus:

      • Unzugängliche Speicherklasse — Das Gateway kann nicht auf die Amazon S3 S3-Speicherklasse zugreifen, in der das Objekt gespeichert ist. Weitere Informationen finden Sie unter Fehler: InaccessibleStorageClass.

      • Ungültiger Objektstatus — Der Status der Datei auf dem Gateway entspricht nicht dem Status in Amazon S3. Weitere Informationen finden Sie unter Fehler: InvalidObjectState.

      • Objekt fehlt — Das Objekt wurde in Amazon S3 gelöscht oder verschoben. Weitere Informationen finden Sie unter Fehler: ObjectMissing.

      • S3-Zugriff verweigert — Die IAM-Rolle für den Amazon S3 S3-Bucket-Zugriff erlaubt dem Gateway nicht, den Upload-Vorgang durchzuführen. Weitere Informationen finden Sie unter Fehler: S3 AccessDenied.

    Anmerkung

    Das Flag Files Fail Upload wird alle 24 Stunden und beim Neustart des Gateways zurückgesetzt. Wenn in diesem Bericht die Dateien nach dem Zurücksetzen, aber bevor sie erneut gekennzeichnet werden, erfasst werden, werden sie nicht als Dateien, die nicht hochgeladen wurden, gemeldet.

  7. Für Verwenden Sie einen VPC-Endpunkt, um eine Verbindung zu S3 herzustellen? , führen Sie einen der folgenden Schritte aus, um anzugeben, wie Ihr Gateway eine Verbindung zum Amazon S3 S3-Bucket herstellen soll:

    • Um eine direkte Verbindung herzustellen, ohne Amazon VPC zu verwenden, wählen Sie Direkt mit dem Bucket verbinden.

    • Um eine Liste vorhandener Amazon VPC-Endpunkte zu durchsuchen, wählen Sie einen VPC-Endpunkt auswählen und geben Sie dann einen Endpunkt aus der angezeigten VPC-Endpunkt-Dropdownliste an.

    • Um einen vorhandenen Amazon VPC-Endpunkt anhand seines DNS-Namens anzugeben, wählen Sie Geben Sie einen VPC-Endpunkt-DNS-Namen ein und geben Sie dann den DNS-Namen in das angezeigte Feld VPC-Endpunkt-DNS-Name ein.

    Anmerkung

    Wenn Ihre Dateifreigabe einen VPC-Endpunkt verwendet, um für den normalen Betrieb eine Verbindung zu Amazon S3 herzustellen, empfehlen wir, bei der Konfiguration Ihres Cache-Berichts dieselbe VPC zu verwenden. Die Erstellung eines Cache-Berichts schlägt fehl, wenn das Gateway aus irgendeinem Grund, einschließlich einer ungültigen VPC-Konfiguration, keine Verbindung zum Amazon S3 S3-Bucket herstellen kann.

  8. (Optional) Wählen Sie unter Tags — optional die Option Neues Tag hinzufügen aus und geben Sie dann einen Schlüssel und einen Wert für Ihren Cache-Bericht ein.

    Ein Tag ist ein Schlüssel-Wert-Paar, bei dem Groß- und Kleinschreibung beachtet wird und Ihnen hilft, Ihre Storage Gateway Gateway-Ressourcen zu kategorisieren. Das Hinzufügen von Tags kann das Filtern und Suchen nach Ihrem Cache-Bericht vereinfachen. Sie können diesen Schritt wiederholen, um bis zu 50 Tags hinzuzufügen.

  9. Wählen Sie Bericht erstellen, wenn Sie fertig sind.

    Storage Gateway beginnt mit der Generierung des Berichts. Sie können den Fortschritt überprüfen und den Status auf der Registerkarte Cache-Berichte auf der Detailseite für die Dateifreigabe einsehen.