

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 eines Amazon-S3-Storage-Lens-Dashboards
<a name="storage_lens_creating_dashboard"></a>

Sie können zusätzliche benutzerdefinierte S3 Storage Lens-Dashboards erstellen, die auf Ihr Unternehmen AWS Organizations oder auf bestimmte AWS-Regionen Bereiche innerhalb eines Kontos zugeschnitten werden können. 

**Anmerkung**  
Es kann bis zu 48 Stunden dauern, bis Änderungen an der Dashboard-Konfiguration genau angezeigt bzw. visualisiert werden.

## Verwenden der S3-Konsole
<a name="storage_lens_console_creating"></a>

Verwenden Sie die folgenden Schritte, um ein Amazon S3-Storage-Lens-Dashboard auf der Amazon S3-Konsole zu erstellen.

**Schritt 1: Konfigurieren Sie die allgemeinen Einstellungen**

1. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die Amazon S3 S3-Konsole unter [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).

1. Wählen Sie in der Navigationsleiste oben auf der Seite den Namen der aktuell angezeigten Datei aus AWS-Region. Wählen Sie dann die Region aus, zu der Sie wechseln möchten. 

1. Wählen Sie im linken Navigationsbereich unter **S3 Storage Lens** die Option **Dashboards** aus.

1. Klicken Sie auf **Create dashboard (Dashboard erstellen)**.

1. Führen Sie auf der Seite **Dashboard** im Abschnitt **Allgemein** die folgenden Schritte aus:

   1. Zeigen Sie die **Heimatregion** für Ihr Dashboard an. In der Heimatregion werden die AWS-Region Konfiguration und die Metriken für dieses Storage Lens-Dashboard gespeichert.

   1. Geben Sie einen Dashboard-Namen ein. 

      Dashboard-Namen müssen weniger als 65 Zeichen lang sein und dürfen keine Sonderzeichen oder Leerzeichen enthalten. 
**Anmerkung**  
Nach dem Erstellen des Dashboards kann der Name nicht mehr geändert werden.

   1. Wählen Sie **Aktiviert**, um aktualisierte Tagesmetriken in Ihrem Dashboard anzuzeigen.

   1. (Optional) Sie können wählen, ob Sie Ihrem Dashboard **Tags** hinzufügen möchten. Sie können Markierungen verwenden, um Berechtigungen für Ihr Dashboard zu verwalten und die Kosten für S3 Storage Lens nachzuverfolgen. Weitere Informationen finden Sie unter [Steuern des Zugriffs auf AWS Ressourcen mithilfe von Tags](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html) im *IAM-Benutzerhandbuch* und [Verwenden von AWS generierten Tags](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/aws-tags.html) im *AWS Billing Benutzerhandbuch*.
**Anmerkung**  
Sie können Ihrer Dashboard-Konfiguration bis zu 50 Markierungen hinzufügen.

1. Wählen Sie **Weiter**, um Ihre Änderungen zu speichern und fortzufahren.

**Schritt 2: Definieren Sie den Umfang des Dashboards**

1. Wählen Sie im **Bereich Dashboard-Bereich** die Regionen und Buckets aus, die S3 Storage Lens im Dashboard ein- oder ausschließen soll.

1. Wählen Sie die Buckets in den ausgewählten Regionen aus, die S3 Storage Lens ein- oder ausschließen soll. Sie können Buckets entweder ein- oder ausschließen. Beides ist nicht möglich. Diese Option ist nicht verfügbar, wenn Sie Dashboards auf Organisationsebene erstellen.
**Anmerkung**  
Sie können Regionen und Buckets entweder ein- oder ausschließen. Diese Option ist nur auf Regionen beschränkt, wenn Sie Dashboards auf Organisationsebene für alle Mitgliedskonten in Ihrer Organisation erstellen. 
Sie können bis zu 50 Buckets auswählen, die Sie einschließen oder ausschließen möchten.

1. Wählen Sie **Weiter**, um Ihre Änderungen zu speichern und fortzufahren.

**Schritt 3: Wählen Sie Ihre Storage Lens-Stufe**

1. Wählen Sie im **Abschnitt Storage Lens-Stufe** die Funktionsstufe aus, die Sie für dieses Dashboard zusammenfassen möchten.

   1. Wählen Sie „Kostenloses **Kontingent**“, um kostenlose Messwerte einzubeziehen, die auf Bucket-Ebene aggregiert und 14 Tage lang für Abfragen verfügbar sind.

   1. Um erweiterte Metriken zu aktivieren, wählen Sie das **Kontingent „Erweitert**“. Zu diesen Optionen gehören die Aggregation von Präfix- oder Storage Lens-Gruppen, die CloudWatch Veröffentlichung durch Amazon, der erweiterte Präfixbericht und kontextuelle Empfehlungen. Daten stehen für Abfragen für 15 Monate zur Verfügung. Erweiterte Metriken und Empfehlungen sind mit zusätzlichen Kosten verbunden. Weitere Informationen finden Sie unter [Amazon S3 – Preise](https://aws.amazon.com/s3/pricing/).

      Weitere Informationen zu erweiterten und zu kostenlosen Metriken finden Sie unter [Auswahl der Metriken](storage_lens_basics_metrics_recommendations.md#storage_lens_basics_metrics_selection).

1. Wählen Sie unter **Erweiterte Metrikkategorien** die Metrikkategorie aus, die Sie aktivieren möchten:
   + **Metriken für Aktivitäten**
   + **Detailed status code metrics** (Detaillierte Statuscode-Metriken)
   + **Kennzahlen zur Kostenoptimierung**
   + **Kennzahlen zum Datenschutz**
   + **Leistungskennzahlen**

   Um eine Vorschau der Metriken anzuzeigen, die in den einzelnen Kategorien enthalten sind, verwenden Sie den Dropdown-Pfeil unter der Checkbox-Liste der Metrik-Kategorien. Weitere Informationen zu den Metrikkategorien finden Sie unter [Metrikkategorien](storage_lens_basics_metrics_recommendations.md#storage_lens_basics_metrics_types). Eine vollständige Liste der Metriken finden Sie unter [Amazon S3-Storage-Lens-Metrikglossar](storage_lens_metrics_glossary.md).

1. Wählen Sie ein **Präfix-Trennzeichen**, oder geben Sie es an, um die Stufen innerhalb der einzelnen Präfixe voneinander zu unterscheiden. Mit diesem Wert werden die einzelnen Präfixebenen identifiziert. Der Standardwert in Amazon S3 ist das Zeichen "`/`", aber Ihre Speicherstruktur verwendet möglicherweise andere Trennzeichen.

1. Wählen Sie **Weiter**, um Ihre Änderungen zu speichern und fortzufahren.

**Schritt 4: (Optional) Wählen Sie Ihre Metrik-Aggregation**

1. Wählen Sie unter **Aggregation zusätzlicher Metriken** aus, welche Metriken Sie aggregieren möchten:
   + Präfixzusammenfassung
   + Aggregation von Storage-Lens-Gruppen

1. Wenn Sie die **Präfixaggregation** aktiviert haben, geben Sie den **Mindestpräfixschwellenwert** für Ihr Dashboard und die **Präfixtiefe** an. Wählen Sie dann **Weiter**, um zu speichern und fortzufahren.
**Anmerkung**  
Die Einstellung **Präfixtiefe** bestimmt, wie viele Hierarchieebenen tief S3 Storage Lens Ihre Objektpräfixe analysiert, wobei die maximale Grenze bei 10 Ebenen liegt. Der **Präfix-Schwellenwert** gibt den Mindestprozentsatz des Gesamtspeichers an, den ein Präfix repräsentieren muss, bevor es in die Storage Lens-Metriken aufgenommen wird.

1. Wenn Sie die **Storage Lens-Gruppenaggregation** aktiviert haben, wählen Sie eine der folgenden Optionen:
   + **Storage Lens-Gruppen einbeziehen**
   + **Schließen Sie Storage Lens-Gruppen aus**

1. Wenn Sie Storage Lens-Gruppen in Ihre Aggregation aufnehmen, können Sie entweder **alle Storage Lens-Gruppen in Ihrer Heimatregion einbeziehen** oder Storage Lens-Gruppen angeben, die eingeschlossen werden sollen.

1. Wählen Sie **Weiter**, um Ihre Änderungen zu speichern und fortzufahren.

**Schritt 5: (Optional) Wählen Sie Ihre Einstellungen für den Export und die Veröffentlichung von Kennzahlen**

1. Wählen Sie unter **Veröffentlichung von Metriken** die Option **CloudWatchVeröffentlichen** aus, wenn Sie in Ihrem CloudWatch Dashboard auf Ihre Storage Lens-Metriken zugreifen möchten.
**Anmerkung**  
Metriken auf Präfix-Ebene sind in nicht verfügbar. CloudWatch

1. Wählen Sie unter **Metrikexport** aus, welche Storage Lens-Dashboard-Daten Sie täglich exportieren möchten:
   + **Standardbericht über Metriken**
   + **Erweiterter Bericht über Präfix-Metriken**

1. (Optional) Wenn Sie den **Standardmetrikbericht** ausgewählt haben, wählen Sie in den Einstellungen für den **Standardmetrikbericht** den Bucket-Typ aus. Sie können den Bericht entweder in einen Amazon S3 S3-Bucket für allgemeine Zwecke oder in einen AWS verwalteten S3-Tabellen-Bucket exportieren. Aktualisieren Sie je nach ausgewähltem Bucket-Typ die Zieleinstellungen für **Allzweck-Buckets oder Zieleinstellungen** für **Table-Buckets**.
**Anmerkung**  
Der **Standardmetrikbericht** enthält nur Präfixe innerhalb des in den Präfixaggregationseinstellungen festgelegten Schwellenwerts und der Tiefe.  
Wenn Sie einen Verschlüsselungsschlüssel angeben möchten, müssen Sie einen AWS KMS Schlüssel (SSE-KMS) oder einen von Amazon S3 verwalteten Schlüssel (SSE-S3) wählen. Wenn Ihre Ziel-Bucket-Richtlinie eine Verschlüsselung erfordert, müssen Sie einen Verschlüsselungsschlüssel für Ihren Metrikexport angeben. Ohne den Verschlüsselungsschlüssel schlägt der Export nach S3 fehl. Weitere Informationen finden Sie unter [Verwenden Sie eine AWS KMS key , um Ihre Metrikexporte zu verschlüsseln](storage_lens_encrypt_permissions.md).

1. (Optional) Wenn Sie den **Bericht mit erweiterten Präfix-Metriken** ausgewählt haben, wählen Sie in den Einstellungen für den **Bericht mit erweiterten Präfixen** den Bucket-Typ aus. Sie können den Bericht entweder in einen Amazon S3 S3-Bucket für allgemeine Zwecke oder in einen schreibgeschützten S3-Tabellen-Bucket exportieren. Aktualisieren Sie je nach ausgewähltem Bucket-Typ die Zieleinstellungen für **Allzweck-Buckets oder **Table-Bucket-Zieleinstellungen****.
**Anmerkung**  
Der **Bericht mit den Metriken für erweiterte Präfixe** enthält alle Präfixe bis zur Präfixtiefe 50 in allen ausgewählten Bereichen, die in Ihrem Dashboard-Bereich angegeben sind.  
Wenn Sie einen Verschlüsselungsschlüssel angeben möchten, müssen Sie einen AWS KMS Schlüssel (SSE-KMS) oder einen von Amazon S3 verwalteten Schlüssel (SSE-S3) wählen. Wenn Ihre Ziel-Bucket-Richtlinie eine Verschlüsselung erfordert, müssen Sie einen Verschlüsselungsschlüssel für Ihren Metrikexport angeben. Ohne den Verschlüsselungsschlüssel schlägt der Export nach S3 fehl. Weitere Informationen finden Sie unter [Verwenden Sie eine AWS KMS key , um Ihre Metrikexporte zu verschlüsseln](storage_lens_encrypt_permissions.md).

1. Wählen Sie **Weiter**, um Ihre Änderungen zu speichern und fortzufahren.

1. Überprüfe alles auf der Seite **„Überprüfen und erstellen**“. Wenn es keine weiteren Änderungen gibt, wählen Sie **Weiter**, um Ihre Änderungen zu speichern und Ihr Dashboard zu erstellen.

**Schritt 6: Überprüfen Sie Ihre Dashboard-Konfiguration und erstellen Sie Ihr Dashboard**

1. Überprüfen Sie im Bereich **Allgemein** Ihre Einstellungen. Wählen Sie **Bearbeiten**, um Änderungen vorzunehmen.

1. Überprüfen Sie im Abschnitt **Umfang des Dashboards** Ihre Einstellungen. Wählen Sie **Bearbeiten**, um Änderungen vorzunehmen.

1. Überprüfen Sie im Bereich **Storage Lens Tier** Ihre Einstellungen. Wählen Sie **Bearbeiten**, um Änderungen vorzunehmen.

1. Überprüfen Sie im Abschnitt **Metrik-Aggregation** Ihre Einstellungen. Wählen Sie **Bearbeiten**, um Änderungen vorzunehmen.

1. Überprüfen Sie im Abschnitt **Metrikexport** Ihre Einstellungen. Wählen Sie **Bearbeiten**, um Änderungen vorzunehmen.

1. Nachdem Sie alle Ihre Dashboard-Konfigurationseinstellungen überprüft und bestätigt haben, wählen Sie **Senden**, um Ihr Dashboard zu erstellen.

Nachdem Sie Ihr neues Storage Lens-Dashboard erfolgreich erstellt haben, können Sie Ihr neues Dashboard auf Ihrer Storage **Lens-Dashboard-Seite** einsehen.

## Verwenden Sie AWS CLI
<a name="S3PutStorageLensConfigurationTagsCLI"></a>

**Example**  
Der folgende Beispielbefehl erstellt eine Amazon-S3-Storage-Lens-Konfiguration mit Tags. Wenn Sie diese Beispiele verwenden möchten, ersetzen Sie die `{{user input placeholders}}` durch Ihre Informationen.  

```
aws s3control put-storage-lens-configuration --account-id={{111122223333}} --config-id={{example-dashboard-configuration-id}} --region={{us-east-1}} --storage-lens-configuration={{file://./config.json}} --tags={{file://./tags.json}}
```

**Example**  
Der folgende Beispielbefehl erstellt eine Amazon-S3-Storage-Lens-Konfiguration ohne Tags. Wenn Sie diese Beispiele verwenden möchten, ersetzen Sie die `{{user input placeholders}}` durch Ihre Informationen.  

```
aws s3control put-storage-lens-configuration --account-id={{222222222222}} --config-id={{your-configuration-id}} --region={{us-east-1}} --storage-lens-configuration={{file://./config.json}}
```

## Verwenden des AWS SDK for Java
<a name="S3CreateandUpdateStorageLensConfigurationJava"></a>

**Example – Erstellen und Aktualisieren einer Konfiguration für Amazon S3 Storage Lens**  
Das folgende Beispiel erstellt und aktualisiert eine Konfiguration für Amazon S3 Storage Lens im SDK für Java:  

```
package aws.example.s3control;

import software.amazon.awssdk.awscore.exception.AwsServiceException;
import software.amazon.awssdk.core.exception.SdkClientException;
import software.amazon.awssdk.auth.credentials.ProfileCredentialsProvider;
import software.amazon.awssdk.regions.Region;
import software.amazon.awssdk.services.s3control.S3ControlClient;
import software.amazon.awssdk.services.s3control.model.AccountLevel;
import software.amazon.awssdk.services.s3control.model.ActivityMetrics;
import software.amazon.awssdk.services.s3control.model.AdvancedCostOptimizationMetrics;
import software.amazon.awssdk.services.s3control.model.AdvancedDataProtectionMetrics;
import software.amazon.awssdk.services.s3control.model.AdvancedPerformanceMetrics;
import software.amazon.awssdk.services.s3control.model.BucketLevel;
import software.amazon.awssdk.services.s3control.model.CloudWatchMetrics;
import software.amazon.awssdk.services.s3control.model.DetailedStatusCodesMetrics;
import software.amazon.awssdk.services.s3control.model.Format;
import software.amazon.awssdk.services.s3control.model.Include;
import software.amazon.awssdk.services.s3control.model.OutputSchemaVersion;
import software.amazon.awssdk.services.s3control.model.PrefixLevel;
import software.amazon.awssdk.services.s3control.model.PrefixLevelStorageMetrics;
import software.amazon.awssdk.services.s3control.model.PutStorageLensConfigurationRequest;
import software.amazon.awssdk.services.s3control.model.S3BucketDestination;
import software.amazon.awssdk.services.s3control.model.SSES3;
import software.amazon.awssdk.services.s3control.model.SelectionCriteria;
import software.amazon.awssdk.services.s3control.model.StorageLensAwsOrg;
import software.amazon.awssdk.services.s3control.model.StorageLensConfiguration;
import software.amazon.awssdk.services.s3control.model.StorageLensDataExport;
import software.amazon.awssdk.services.s3control.model.StorageLensDataExportEncryption;
import software.amazon.awssdk.services.s3control.model.StorageLensExpandedPrefixesDataExport;
import software.amazon.awssdk.services.s3control.model.StorageLensTableDestination;
import software.amazon.awssdk.services.s3control.model.StorageLensTag;

import java.util.Arrays;
import java.util.List;

public class CreateAndUpdateDashboard {

    public static void main(String[] args) {
        String configurationId = "{{ConfigurationId}}";
        String sourceAccountId = "{{111122223333}}";
        String exportAccountId = "{{Destination Account ID}}";
        String exportBucketArn = "arn:aws:s3:::{{destBucketName}}"; // The destination bucket for your metrics export must be in the same Region as your S3 Storage Lens configuration.
        String awsOrgARN = "arn:aws:organizations::{{123456789012}}:organization/{{o-abcdefgh}}";
        Format exportFormat = Format.CSV;

        try {
            SelectionCriteria selectionCriteria = SelectionCriteria.builder()
                    .delimiter("{{/}}")
                    .maxDepth({{5}})
                    .minStorageBytesPercentage({{10.0}})
                    .build();

            PrefixLevelStorageMetrics prefixStorageMetrics = PrefixLevelStorageMetrics.builder()
                    .isEnabled({{true}})
                    .selectionCriteria(selectionCriteria)
                    .build();

            BucketLevel bucketLevel = BucketLevel.builder()
                    .activityMetrics(ActivityMetrics.builder().isEnabled({{true}}).build())
                    .advancedCostOptimizationMetrics(AdvancedCostOptimizationMetrics.builder().isEnabled({{true}}).build())
                    .advancedDataProtectionMetrics(AdvancedDataProtectionMetrics.builder().isEnabled({{true}}).build())
                    .advancedPerformanceMetrics(AdvancedPerformanceMetrics.builder().isEnabled({{true}}).build())
                    .detailedStatusCodesMetrics(DetailedStatusCodesMetrics.builder().isEnabled({{true}}).build())
                    .prefixLevel(PrefixLevel.builder().storageMetrics(prefixStorageMetrics).build())
                    .build();

            AccountLevel accountLevel = AccountLevel.builder()
                    .activityMetrics(ActivityMetrics.builder().isEnabled({{true}}).build())
                    .advancedCostOptimizationMetrics(AdvancedCostOptimizationMetrics.builder().isEnabled({{true}}).build())
                    .advancedPerformanceMetrics(AdvancedPerformanceMetrics.builder().isEnabled({{true}}).build())
                    .advancedDataProtectionMetrics(AdvancedDataProtectionMetrics.builder().isEnabled({{true}}).build())
                    .detailedStatusCodesMetrics(DetailedStatusCodesMetrics.builder().isEnabled({{true}}).build())
                    .bucketLevel(bucketLevel)
                    .build();

            Include include = Include.builder()
                    .buckets(Arrays.asList("arn:aws:s3:::{{bucketName}}"))
                    .regions(Arrays.asList("{{us-west-2}}"))
                    .build();

            StorageLensDataExportEncryption exportEncryption = StorageLensDataExportEncryption.builder()
                    .sses3(SSES3.builder().build())
                    .build();

            S3BucketDestination s3BucketDestination = S3BucketDestination.builder()
                    .accountId(exportAccountId)
                    .arn(exportBucketArn)
                    .encryption(exportEncryption)
                    .format(exportFormat)
                    .outputSchemaVersion(OutputSchemaVersion.V_1)
                    .prefix("{{Prefix}}")
                    .build();

            StorageLensTableDestination s3TablesDestination = StorageLensTableDestination.builder()
                    .encryption(exportEncryption)
                    .isEnabled({{true}})
                    .build();

            CloudWatchMetrics cloudWatchMetrics = CloudWatchMetrics.builder()
                    .isEnabled({{true}})
                    .build();

            StorageLensDataExport dataExport = StorageLensDataExport.builder()
                    .cloudWatchMetrics(cloudWatchMetrics)
                    .s3BucketDestination(s3BucketDestination)
                    .storageLensTableDestination(s3TablesDestination)
                    .build();

            StorageLensAwsOrg awsOrg = StorageLensAwsOrg.builder()
                    .arn(awsOrgARN)
                    .build();

            StorageLensExpandedPrefixesDataExport expandedPrefixesDataExport = StorageLensExpandedPrefixesDataExport.builder()
                    .s3BucketDestination(s3BucketDestination)
                    .storageLensTableDestination(s3TablesDestination)
                    .build();

            StorageLensConfiguration configuration = StorageLensConfiguration.builder()
                    .id(configurationId)
                    .accountLevel(accountLevel)
                    .include(include)
                    .dataExport(dataExport)
                    .awsOrg(awsOrg)
                    .expandedPrefixesDataExport(expandedPrefixesDataExport)
                    .prefixDelimiter("{{/}}")
                    .isEnabled({{true}})
                    .build();

            List<StorageLensTag> tags = Arrays.asList(
                    StorageLensTag.builder().key("{{key-1}}").value("{{value-1}}").build(),
                    StorageLensTag.builder().key("{{key-2}}").value("{{value-2}}").build()
            );

            S3ControlClient s3ControlClient = S3ControlClient.builder()
                    .region(Region.{{US_WEST_2}})
                    .credentialsProvider(ProfileCredentialsProvider.create())
                    .build();

            s3ControlClient.putStorageLensConfiguration(PutStorageLensConfigurationRequest.builder()
                    .accountId(sourceAccountId)
                    .configId(configurationId)
                    .storageLensConfiguration(configuration)
                    .tags(tags)
                    .build()
            );

        } catch (AwsServiceException 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();
        }
    }
}
```

Für den Zugriff auf S3 Storage Lens-Gruppen oder erweiterte Präfixe müssen Sie Ihr Dashboard aktualisieren, um die erweiterte Stufe zu verwenden. Es fallen zusätzliche Gebühren an. Weitere Informationen zu den Tarifen „Kostenlos“ und „Erweitert“ finden Sie unter[Auswahl der Metriken](storage_lens_basics_metrics_recommendations.md#storage_lens_basics_metrics_selection). Weitere Informationen zur Verwendung von S3-Storage-Lens-Gruppen finden Sie unter [Arbeiten mit S3-Storage-Lens-Gruppen zum Filtern und Aggregieren von Metriken](storage-lens-groups-overview.md). 