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.
# Arbeiten mit Amazon S3 Storage Lens unter Verwendung der Konsole und der API
Amazon S3 Storage Lens ist eine Cloud-Speicheranalysefunktion, mit der Sie unternehmensweite Einblicke in die Nutzung und Aktivität von Objektspeichern erhalten können. Sie können Metriken von S3 Storage Lens verwenden, um zusammenfassende Erkenntnisse zu gewinnen und z. B. herauszufinden, wie viel Speicher Sie in Ihrer gesamten Organisation haben oder welche Buckets und Präfixe am schnellsten wachsen. Außerdem können Sie anhand der Metriken von S3 Storage Lens umfassende Möglichkeiten zur Kostenoptimierung aufdecken, bewährte Methoden für den Datenschutz implementieren und die Leistung von Anwendungs-Workloads verbessern. Sie können beispielsweise Buckets identifizieren, für die keine S3-Lebenszyklusregeln gelten, damit unvollständige mehrteilige Uploads, die älter als 7 Tage sind, ablaufen. Sie können auch Buckets identifizieren, die nicht den bewährten Datenschutzmethoden entsprechen, z. B. die Verwendung von S3 Replication oder S3 Versionierung. S3 Storage Lens analysiert Metriken, um kontextbezogene Empfehlungen zur Optimierung der Speicherkosten und zur Anwendung bewährter Datenschutzmethoden zu geben.
S3 Storage Lens aggregiert Ihre Metriken und zeigt die Informationen im Abschnitt **Konto-Snapshot** der Seite **Buckets** der Amazon-S3-Konsole an. S3 Storage Lens bietet auch ein interaktives Dashboard, mit dem Sie Erkenntnisse und Trends visualisieren, Ausreißer kennzeichnen und Empfehlungen zur Optimierung der Speicherkosten und zur Anwendung bewährter Datenschutzpraktiken erhalten können. Ihr Dashboard bietet Drilldown-Optionen zur Generierung und Visualisierung von Erkenntnissen auf Organisations-, Konto-, Speicherklassen- AWS-Region, Bucket-, Präfix- oder Storage Lens-Gruppenebene. Sie können auch einen täglichen Metrikbericht im CSV- oder Parquet Format an einen S3-Bucket für allgemeine Zwecke senden oder die Metriken direkt in einen AWS verwalteten S3-Tabellen-Bucket exportieren.
**Anmerkung**
Storage Lens aggregiert nur Metriken für [S3-Allzweck-Buckets](UsingBucket.md).
Dieser Abschnitt enthält Beispiele für das Erstellen, Aktualisieren und Anzeigen von S3-Storage-Lens-Konfigurationen und das Ausführen von funktionsbezogenen Vorgängen. Wenn Sie S3 Storage Lens mit verwenden AWS Organizations, decken diese Beispiele auch diese Anwendungsfälle ab. Ersetzen Sie in den Beispielen alle Platzhalterwerte.
**Topics**
+ [
# Erstellen eines Amazon-S3-Storage-Lens-Dashboards
](storage_lens_creating_dashboard.md)
+ [
# Anzeigen eines Amazon-S3-Storage-Lens-Dashboards
](storage_lens_editing.md)
+ [
# Deaktivieren eines Amazon-S3-Storage-Lens-Dashboards
](storage_lens_disabling.md)
+ [
# Löschen eines Amazon-S3-Storage-Lens-Dashboards
](storage_lens_deleting.md)
+ [
# Auflisten von Amazon-S3-Storage-Lens-Dashboards
](storage_lens_list_dashboard.md)
+ [
# Ansehen von Konfigurationsdetails von Amazon-S3-Storage-Lens-Dashboards
](storage_lens_viewing.md)
+ [
# Verwaltung von AWS Ressourcen-Tags mit S3 Storage Lens
](storage-lens-groups-manage-tags-dashboard.md)
+ [
# Hilfsdateien für die Verwendung von Amazon S3 Storage Lens
](S3LensHelperFilesCLI.md)
# Erstellen eines Amazon-S3-Storage-Lens-Dashboards
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
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, CloudWatch Amazon-Veröffentlichung, 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 oder geben Sie ein **Präfix-Trennzeichen** 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 für die **Präfixtiefe** bestimmt, wie viele Hierarchieebenen 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 Bereich **Dashboard-Umfang** 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
**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
**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 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).
# Anzeigen eines Amazon-S3-Storage-Lens-Dashboards
Das Standard-Dashboard von Amazon S3 Storage Lens ist `default-account-dashboard`. Dieses Dashboard ist von Amazon S3 vorkonfiguriert, damit Sie zusammengefasste Erkenntnisse und Trends der aggregierten kostenlosen und erweiterten Metriken Ihres gesamten Kontos in der Konsole visualisieren können. Sie können den Konfigurationsbereich des Standard-Dashboards nicht ändern, können aber die Metrikauswahl von den kostenlosen Metriken auf die kostenpflichtigen erweiterten Metriken und Empfehlungen upgraden, den optionalen Metrikexport konfigurieren oder sogar das Standard-Dashboard deaktivieren. Das Standard-Dashboard kann nicht gelöscht, sondern nur deaktiviert werden. Weitere Informationen finden Sie unter [Verwenden der S3-Konsole](storage_lens_console_deleting.md).
## Verwenden der S3-Konsole
Verwenden Sie die folgenden Schritte, um ein Amazon S3-Storage-Lens-Dashboard auf der Amazon S3-Konsole zu aktualisieren.
**Schritt 1: Aktualisieren Sie Ihr Dashboard und konfigurieren Sie Ihre 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 im linken Navigationsbereich **Storage Lens, Dashboards** aus.
1. Wählen Sie das Dashboard aus, das Sie bearbeiten möchten.
1. Wählen Sie **Dashboard-Konfigurationen anzeigen** aus.
1. Wählen Sie **Bearbeiten** aus. Sie können die Dashboard-Konfiguration nun Schritt für Schritt überprüfen. Um Änderungen an einem der Schritte vorzunehmen, können Sie über die linke Navigationsleiste direkt auf den Schritt klicken. Anweisungen zur Aktualisierung dieser Schritte finden Sie unter
**Anmerkung**
Folgendes können Sie nicht ändern:
Den Dashboard-Namen
Die Heimatregion
1. Auf der **Dashboard-Seite** können Sie im Abschnitt **Allgemein** folgende Änderungen vornehmen:
+ Wählen Sie **Aktiviert** oder **Deaktiviert**, um in Ihrem Dashboard zu aktualisieren, ob Sie tägliche Messwerte erhalten.
+ (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: Aktualisieren Sie den Umfang des Dashboards**
1. Aktualisieren Sie im **Bereich Dashboard-Bereich** die Regionen und Buckets, die S3 Storage Lens im Dashboard ein- oder ausschließen soll.
**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 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: Aktualisieren Sie Ihre Storage Lens-Stufe Konfigurieren Sie die Metrikauswahl**
1. Aktualisieren Sie im Abschnitt **Auswahl der Kennzahlen** für die **Storage Lens-Stufe** die Ebene der Metriken, die Sie für dieses Dashboard zusammenfassen möchten.
**Anmerkung**
Wenn Sie vom Tarif „**Kostenlos“ auf den Tarif** „**Erweitert“ umsteigen**, müssen Sie Ihre **Aggregationseinstellungen für Metrics** aktualisieren. Informationen zum Aktualisieren Ihrer **Einstellungen für die Metrik-Aggregation** finden Sie unter **Schritt 4: Aktualisieren Sie Ihre Metrik-Aggregation**.
Wenn Sie Ihr Storage Lens-Tarif vom **Advanced-Tarif** auf das **kostenlose Kontingent** aktualisieren, müssen Sie keine **Metric-Aggregationseinstellungen** aktualisieren. Die Funktion zur **Aggregation von Metriken** gilt nur für Metrikkategorien des **Advanced-Tarifs**.
1. **Wählen Sie „Kostenloses Kontingent“, um kostenlose Messwerte einzubeziehen, die auf Bucket-Ebene aggregiert wurden 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 Präfixaggregation, CloudWatch Amazon-Veröffentlichung 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 oder geben Sie ein **Präfix-Trennzeichen** 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) Aktualisieren Sie Ihre Metrikaggregation**
1. Aktualisieren Sie unter **Aggregation zusätzlicher Metriken**, welche Metriken Sie aggregieren möchten, indem Sie eine der folgenden Optionen auswählen:
+ Präfixzusammenfassung
+ Aggregation von Storage-Lens-Gruppen
1. Wenn Sie die **Präfixaggregation** aktiviert haben, geben Sie den **Präfix-Mindestschwellenwert** für Ihr Dashboard und die **Präfixtiefe** an. Wählen Sie dann **Weiter**, um zu speichern und fortzufahren.
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) Aktualisieren 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 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 den **Allzweck-Bucket oder die Zieleinstellungen** für den **Tabellen-Bucket**.
**Anmerkung**
Der **Standardmetrikbericht** enthält nur Präfixe innerhalb des in den Präfixaggregationseinstellungen festgelegten Schwellenwerts und der Tiefe. Wenn Ihre Präfixaggregation noch nicht konfiguriert ist, umfasst der Schwellenwert bis zu 100 der größten Präfixe nach Größe.
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. (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 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 den **Allzweck-Bucket oder die Zieleinstellungen** für den **Tabellen-Bucket**.
**Anmerkung**
Der **Bericht mit den Metriken für erweiterte Präfixe** enthält Präfixe in allen Buckets, 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.
**Schritt 6: Überprüfen und aktualisieren Sie Ihre Dashboard-Konfiguration**
1. Überprüfen Sie im Bereich **Allgemein** Ihre Einstellungen. Wählen Sie **Bearbeiten**, um Änderungen vorzunehmen.
1. Überprüfen Sie im Bereich **Dashboard-Umfang** 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 aktualisieren.
Nachdem Sie Ihr neues Storage Lens-Dashboard erfolgreich aktualisiert haben, können Sie Ihre aktualisierte Dashboard-Konfiguration auf Ihrer Storage **Lens-Dashboard-Seite** einsehen.
## Verwenden Sie AWS CLI
**Example**
Der folgende Beispielbefehl aktualisiert eine Konfiguration des Amazon-S3-Storage-Lens-Dashboards. 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
```
## Verwenden des AWS SDK for Java
**Example – Aktualisieren einer Konfiguration von Amazon S3 Storage Lens mit erweiterten Metriken und Empfehlungen**
In den folgenden Beispielen wird gezeigt, wie Sie die Standardkonfiguration von S3 Storage Lens mit erweiterten Metriken und Empfehlungen im SDK für Java aktualisieren.
```
package aws.example.s3control;
import com.amazonaws.AmazonServiceException;
import com.amazonaws.SdkClientException;
import com.amazonaws.auth.profile.ProfileCredentialsProvider;
import com.amazonaws.services.s3control.AWSS3Control;
import com.amazonaws.services.s3control.AWSS3ControlClient;
import com.amazonaws.services.s3control.model.AccountLevel;
import com.amazonaws.services.s3control.model.ActivityMetrics;
import com.amazonaws.services.s3control.model.BucketLevel;
import com.amazonaws.services.s3control.model.Format;
import com.amazonaws.services.s3control.model.Include;
import com.amazonaws.services.s3control.model.OutputSchemaVersion;
import com.amazonaws.services.s3control.model.PrefixLevel;
import com.amazonaws.services.s3control.model.PrefixLevelStorageMetrics;
import com.amazonaws.services.s3control.model.PutStorageLensConfigurationRequest;
import com.amazonaws.services.s3control.model.S3BucketDestination;
import com.amazonaws.services.s3control.model.SSES3;
import com.amazonaws.services.s3control.model.SelectionCriteria;
import com.amazonaws.services.s3control.model.StorageLensAwsOrg;
import com.amazonaws.services.s3control.model.StorageLensConfiguration;
import com.amazonaws.services.s3control.model.StorageLensDataExport;
import com.amazonaws.services.s3control.model.StorageLensDataExportEncryption;
import com.amazonaws.services.s3control.model.StorageLensTag;
import java.util.Arrays;
import java.util.List;
import static com.amazonaws.regions.Regions.US_WEST_2;
public class UpdateDefaultConfigWithPaidFeatures {
public static void main(String[] args) {
String configurationId = "default-account-dashboard"; // This configuration ID cannot be modified.
String sourceAccountId = "111122223333";
try {
SelectionCriteria selectionCriteria = new SelectionCriteria()
.withDelimiter("/")
.withMaxDepth(5)
.withMinStorageBytesPercentage(10.0);
PrefixLevelStorageMetrics prefixStorageMetrics = new PrefixLevelStorageMetrics()
.withIsEnabled(true)
.withSelectionCriteria(selectionCriteria);
BucketLevel bucketLevel = new BucketLevel()
.withActivityMetrics(new ActivityMetrics().withIsEnabled(true))
.withPrefixLevel(new PrefixLevel().withStorageMetrics(prefixStorageMetrics));
AccountLevel accountLevel = new AccountLevel()
.withActivityMetrics(new ActivityMetrics().withIsEnabled(true))
.withBucketLevel(bucketLevel);
StorageLensConfiguration configuration = new StorageLensConfiguration()
.withId(configurationId)
.withAccountLevel(accountLevel)
.withIsEnabled(true);
AWSS3Control s3ControlClient = AWSS3ControlClient.builder()
.withCredentials(new ProfileCredentialsProvider())
.withRegion(US_WEST_2)
.build();
s3ControlClient.putStorageLensConfiguration(new PutStorageLensConfigurationRequest()
.withAccountId(sourceAccountId)
.withConfigId(configurationId)
.withStorageLensConfiguration(configuration)
);
} catch (AmazonServiceException 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).
# Deaktivieren eines Amazon-S3-Storage-Lens-Dashboards
Sie können ein Amazon S3-Storage-Lens-Dashboard in der Amazon-S3-Konsole deaktivieren. Durch das Deaktivieren eines Dashboards wird verhindert, dass es weitere Metriken generiert. Ein deaktiviertes Dashboard behält seine Konfigurationsinformationen, sodass es bei erneuter Aktivierung einfach wieder genutzt werden kann. Ein deaktiviertes Dashboard behält seine Verlaufsdaten bei, bis es nicht mehr für Abfragen verfügbar ist.
# Verwenden der S3-Konsole
Verwenden Sie die folgenden Schritte, um ein Amazon-S3-Storage-Lens-Dashboard in der Amazon-S3-Konsole zu deaktivieren.
**So deaktivieren Sie ein Amazon-S3-Storage-Lens-Dashboard**
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 im linken Navigationsbereich **Storage Lens** und dann **Dashboards** aus.
1. Wählen Sie in der Liste **Dashboards** das Dashboard aus, das Sie deaktivieren möchten, und gehen Sie dann oben in der Liste auf **Deaktivieren**.
1. Bestätigen Sie auf der Bestätigungsseite, dass Sie das Dashboard deaktivieren möchten, indem Sie den Namen des Dashboards in das Textfeld eingeben und dann **Bestätigen** auswählen.
# Löschen eines Amazon-S3-Storage-Lens-Dashboards
Das Standard-Dashboard können Sie nicht löschen. Eine Deaktivierung ist jedoch möglich. Bevor Sie ein selbst erstelltes Dashboard löschen, sollten Sie Folgendes beachten:
+ Als Alternative zum Löschen können Sie das Dashboard *deaktivieren*, damit es in Zukunft wieder aktiviert werden kann. Weitere Informationen finden Sie unter [Verwenden der S3-Konsole](storage_lens_console_disabling.md).
+ Durch das Löschen eines Dashboards werden alle damit verbundenen Konfigurationseinstellungen gelöscht.
+ Sobald Sie ein Dashboard löschen, können die historischen Metrikdaten nicht mehr abgerufen werden. Diese historischen Daten werden weiterhin für eine Dauer von 15 Monaten aufbewahrt. Wenn Sie wieder auf diese Daten zugreifen möchten, müssen Sie ein neues Dashboard mit dem gleichen Namen erstellen, dass sich in derselben Heimatregion befindet wie das gelöschte Dashboard.
# Verwenden der S3-Konsole
Sie können ein Amazon-S3-Storage-Lens-Dashboard in der Amazon-S3-Konsole löschen. Durch das Löschen eines Dashboards wird jedoch verhindert, dass es weitere Metriken generiert.
**Löschen eines Amazon S3-Storage-Lens-Dashboards**
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 im linken Navigationsbereich **Storage Lens** und dann **Dashboards** aus.
1. Wählen Sie in der Liste **Dashboards** das Dashboard aus, das Sie löschen möchten, und gehen Sie dann oben in der Liste auf **Löschen**.
1. Bestätigen Sie auf der Seite **Dashboards löschen**, dass Sie das Dashboard löschen möchten, indem Sie den Namen des Dashboards in das Textfeld eingeben. Wählen Sie dann **Confirm** (Bestätigen) aus.
# Verwenden Sie den AWS CLI
**Example**
Das folgende Beispiel löscht eine S3-Storage-Lens-Konfiguration. Wenn Sie diese Beispiele verwenden möchten, ersetzen Sie die `user input placeholders` durch Ihre Informationen.
```
aws s3control delete-storage-lens-configuration --account-id=222222222222 --region=us-east-1 --config-id=your-configuration-id
```
## Verwenden des AWS SDK for Java
**Example – Löschen der Konfiguration eines Amazon-S3-Storage-Lens-Dashboards**
Das folgende Beispiel zeigt, wie Sie eine S3-Storage-Lens-Konfiguration mit SDK für Java löschen:
```
package aws.example.s3control;
import com.amazonaws.AmazonServiceException;
import com.amazonaws.SdkClientException;
import com.amazonaws.auth.profile.ProfileCredentialsProvider;
import com.amazonaws.services.s3control.AWSS3Control;
import com.amazonaws.services.s3control.AWSS3ControlClient;
import com.amazonaws.services.s3control.model.DeleteStorageLensConfigurationRequest;
import static com.amazonaws.regions.Regions.US_WEST_2;
public class DeleteDashboard {
public static void main(String[] args) {
String configurationId = "ConfigurationId";
String sourceAccountId = "111122223333";
try {
AWSS3Control s3ControlClient = AWSS3ControlClient.builder()
.withCredentials(new ProfileCredentialsProvider())
.withRegion(US_WEST_2)
.build();
s3ControlClient.deleteStorageLensConfiguration(new DeleteStorageLensConfigurationRequest()
.withAccountId(sourceAccountId)
.withConfigId(configurationId)
);
} catch (AmazonServiceException 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();
}
}
}
```
# Auflisten von Amazon-S3-Storage-Lens-Dashboards
# Verwenden der S3-Konsole
**So listen Sie ein S3-Storage-Lens-Dashboard auf**
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. Navigieren Sie im linken Navigationsbereich zu **Storage Lens**.
1. Wählen Sie **Dashboards** aus. Sie können jetzt die Dashboards in Ihrem AWS-Konto anzeigen.
## Mit dem AWS CLI
**Example**
Der folgende Beispielbefehl listet die S3 Storage Lens-Dashboards in Ihrem AWS-Konto auf. Wenn Sie diese Beispiele verwenden möchten, ersetzen Sie die `user input placeholders` durch Ihre Informationen.
```
aws s3control list-storage-lens-configurations --account-id=222222222222 --region=us-east-1 --next-token=abcdefghij1234
```
**Example**
Das folgende Beispiel listet S3-Storage-Lens-Konfigurationen ohne das nächste Token auf. Wenn Sie diese Beispiele verwenden möchten, ersetzen Sie die `user input placeholders` durch Ihre Informationen.
```
aws s3control list-storage-lens-configurations --account-id=222222222222 --region=us-east-1
```
## Verwenden des AWS SDK for Java
**Example – Auflisten von Konfigurationen des S3-Storage-Lens-Dashboards**
In den folgenden Beispielen wird gezeigt, wie S3-Storage-Lens-Konfigurationen im SDK für Java aufgelistet werden. Wenn Sie dieses Beispiel verwenden möchten, ersetzen Sie `user input placeholders` durch Ihre Informationen.“ zu jeder Beispielbeschreibung.
```
package aws.example.s3control;
import com.amazonaws.AmazonServiceException;
import com.amazonaws.SdkClientException;
import com.amazonaws.auth.profile.ProfileCredentialsProvider;
import com.amazonaws.services.s3control.AWSS3Control;
import com.amazonaws.services.s3control.AWSS3ControlClient;
import com.amazonaws.services.s3control.model.ListStorageLensConfigurationEntry;
import com.amazonaws.services.s3control.model.ListStorageLensConfigurationsRequest;
import java.util.List;
import static com.amazonaws.regions.Regions.US_WEST_2;
public class ListDashboard {
public static void main(String[] args) {
String sourceAccountId = "111122223333";
String nextToken = "nextToken";
try {
AWSS3Control s3ControlClient = AWSS3ControlClient.builder()
.withCredentials(new ProfileCredentialsProvider())
.withRegion(US_WEST_2)
.build();
final List configurations =
s3ControlClient.listStorageLensConfigurations(new ListStorageLensConfigurationsRequest()
.withAccountId(sourceAccountId)
.withNextToken(nextToken)
).getStorageLensConfigurationList();
System.out.println(configurations.toString());
} catch (AmazonServiceException 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();
}
}
}
```
# Ansehen von Konfigurationsdetails von Amazon-S3-Storage-Lens-Dashboards
Sie können ein Amazon S3 Storage Lens-Dashboard über die Amazon S3 S3-Konsole und das SDK for Java aufrufen. AWS CLI
# Verwenden der S3-Konsole
**So sehen Sie die Konfigurationsdetails eines S3-Storage-Lens-Dashboards an**
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. Klicken Sie im linken Navigationsbereich auf **Storage Lens**.
1. Wählen Sie **Dashboards** aus.
1. Klicken Sie in der Liste **Dashboards** auf das Dashboard, das Sie ansehen möchten. Jetzt können Sie die Details Ihres Storage-Lens-Dashboards ansehen.
## Verwenden Sie den AWS CLI
**Example**
Im folgenden Beispiel wird eine S3-Storage-Lens-Konfiguration abgerufen, sodass Sie die Konfigurationsdetails ansehen können. Wenn Sie diese Beispiele verwenden möchten, ersetzen Sie die `user input placeholders` durch Ihre Informationen.
```
aws s3control get-storage-lens-configuration --account-id=222222222222 --config-id=your-configuration-id --region=us-east-1
```
## Verwenden des AWS SDK for Java
**Example – Abrufen und Anzeigen einer S3-Storage-Lens-Konfiguration**
Das folgende Beispiel zeigt Ihnen, wie Sie eine S3-Storage-Lens-Konfiguration im SDK für Java abrufen, sodass Sie die Konfigurationsdetails ansehen können. Wenn Sie dieses Beispiel verwenden möchten, ersetzen Sie die `user input placeholders` (Platzhalter für Benutzereingaben) durch Ihre Informationen.
```
package aws.example.s3control;
import com.amazonaws.AmazonServiceException;
import com.amazonaws.SdkClientException;
import com.amazonaws.auth.profile.ProfileCredentialsProvider;
import com.amazonaws.services.s3control.AWSS3Control;
import com.amazonaws.services.s3control.AWSS3ControlClient;
import com.amazonaws.services.s3control.model.GetStorageLensConfigurationRequest;
import com.amazonaws.services.s3control.model.GetStorageLensConfigurationResult;
import com.amazonaws.services.s3control.model.StorageLensConfiguration;
import static com.amazonaws.regions.Regions.US_WEST_2;
public class GetDashboard {
public static void main(String[] args) {
String configurationId = "ConfigurationId";
String sourceAccountId = "111122223333";
try {
AWSS3Control s3ControlClient = AWSS3ControlClient.builder()
.withCredentials(new ProfileCredentialsProvider())
.withRegion(US_WEST_2)
.build();
final StorageLensConfiguration configuration =
s3ControlClient.getStorageLensConfiguration(new GetStorageLensConfigurationRequest()
.withAccountId(sourceAccountId)
.withConfigId(configurationId)
).getStorageLensConfiguration();
System.out.println(configuration.toString());
} catch (AmazonServiceException 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();
}
}
}
```
# Verwaltung von AWS Ressourcen-Tags mit S3 Storage Lens
Jedes Amazon S3 Storage Lens-Dashboard wird als AWS Ressource mit eigenem Amazon-Ressourcennamen (ARN) gezählt. Daher können Sie bei der Konfiguration Ihres Storage Lens-Dashboards optional AWS Ressourcen-Tags zum Dashboard hinzufügen. Sie können bis zu 50 Tags für jedes Storage-Lens-Dashboard hinzufügen. Um ein Storage-Lens-Dashboard mit Tags zu erstellen, müssen Sie über die folgenden [S3-Storage-Lens-Berechtigungen](https://docs.aws.amazon.com/AmazonS3/latest/userguide/storage_lens_iam_permissions.html) verfügen:
+ `s3:ListStorageLensConfigurations`
+ `s3:GetStorageLensConfiguration`
+ `s3:GetStorageLensConfigurationTagging`
+ `s3:PutStorageLensConfiguration`
+ ` s3:PutStorageLensConfigurationTagging`
Sie können AWS Ressourcen-Tags verwenden, um Ressourcen nach Abteilung, Geschäftsbereich oder Projekt zu kategorisieren. Dies ist nützlich, wenn Sie viele Ressourcen desselben Typs haben. Durch die Anwendung von Tags können Sie ein bestimmtes S3-Storage-Lens-Dashboard auf Grundlage der ihm zugewiesenen Tags schnell identifizieren. Sie können Tags auch verwenden, um Ihre Kosten zu kategorisieren und zu verfolgen.
Wenn Sie Ihrem Storage Lens-Dashboard ein AWS Ressourcen-Tag hinzufügen, aktivieren Sie außerdem die [attributebasierte Zugriffskontrolle](https://docs.aws.amazon.com/IAM/latest/UserGuide/introduction_attribute-based-access-control.html) (ABAC). ABAC ist eine Autorisierungsstrategie, die Berechtigungen basierend auf Attributen wie Tags definiert. [Sie können auch Bedingungen verwenden, die Ressourcen-Tags in Ihren IAM-Richtlinien angeben, um den Zugriff auf Ressourcen zu kontrollieren. AWS](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html#access_tags_control-resources)
Sie können Tag (Markierung)-Schlüssel und -Werte bearbeiten und Tags (Markierungen) jederzeit von einer Ressource entfernen. Beachten Sie folgende Einschränkungen:
+ Bei Tag-Schlüsseln und Tag-Werten muss die Groß- und Kleinschreibung beachtet werden.
+ Wenn Sie ein Tag (Markierung) mit demselben Schlüssel wie ein vorhandener Tag (Markierung) für die Ressource hinzufügen, wird der alte Wert mit dem neuen überschrieben.
+ Wenn Sie eine Ressource löschen, werden alle Tags (Markierungen) der Ressource ebenfalls gelöscht.
+ Nehmen Sie keine privaten oder sensiblen Daten in Ihre AWS Ressourcen-Tags auf.
+ System-Tags (mit Tag-Schlüsseln, die mit `aws:` beginnen) werden nicht unterstützt.
+ Die einzelnen Tag-Schlüssel dürfen maximal 128 Zeichen lang sein. Die einzelnen Tag-Werte dürfen maximal 256 Zeichen lang sein.
Die folgenden Beispiele zeigen, wie Sie AWS Ressourcen-Tags mit dem Storage Lens-Dashboard verwenden.
**Topics**
+ [
# Fügen Sie AWS Ressourcen-Tags zu einem Storage Lens-Dashboard hinzu
](storage-lens-add-tags.md)
+ [
# Rufen Sie AWS Ressourcen-Tags für ein Storage Lens-Dashboard ab
](storage-lens-get-tags.md)
+ [
# Aktualisieren von Storage-Lens-Dashboard-Tags
](storage-lens-update-tags.md)
+ [
# Löschen von AWS Ressourcen-Tags aus einem S3 Storage Lens-Dashboard
](storage-lens-dashboard-delete-tags.md)
# Fügen Sie AWS Ressourcen-Tags zu einem Storage Lens-Dashboard hinzu
Die folgenden Beispiele zeigen, wie Sie einem S3 Storage Lens-Dashboard AWS Ressourcen-Tags hinzufügen. Sie können Ressourcen-Tags mithilfe der Amazon S3 S3-Konsole hinzufügen, AWS Command Line Interface (AWS CLI) und AWS SDK für Java.
## Verwenden der S3-Konsole
**Um AWS Ressourcen-Tags zu einem Storage Lens-Dashboard hinzuzufügen**
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. Navigieren Sie im linken Navigationsbereich zu **Storage Lens**.
1. Wählen Sie **Dashboards** aus.
1. Aktivieren Sie das Optionsfeld für das Storage-Lens-Dashboard, das Sie aktualisieren möchten. Wählen Sie dann **Edit** (Bearbeiten) aus.
1. Wählen Sie unter **Allgemein** die Option **Tag hinzufügen** aus.
1. Fügen Sie auf der Seite **Tag hinzufügen** das neue Schlüssel-Wert-Paar hinzu.
**Anmerkung**
Wenn Sie ein neues Tag hinzufügen, dessen Schlüssel mit dem eines vorhandenen Tags identisch ist, wird der vorherige Tag-Wert überschrieben.
1. (Optional) Um mehrere neue Tags hinzuzufügen, wählen Sie erneut **Tag hinzufügen** aus und fügen Sie weiterhin neue Einträge hinzu. Sie können Ihrem Storage Lens-Dashboard bis zu 50 AWS Ressourcen-Tags hinzufügen.
1. (Optional) Wenn Sie einen neu hinzugefügten Eintrag entfernen möchten, wählen Sie neben dem zu entfernenden Tag **Entfernen** aus.
1. Wählen Sie **Änderungen speichern ** aus.
## Verwenden Sie den AWS CLI
**Example**
Der folgende Beispielbefehl fügt Tags zu einer Konfiguration eines S3-Storage-Lens-Dashboards hinzu. Wenn Sie diese Beispiele verwenden möchten, ersetzen Sie die `user input placeholders` durch Ihre Informationen.
```
aws s3control put-storage-lens-configuration-tagging --account-id=222222222222 --region=us-east-1 --config-id=your-configuration-id --tags=file://./tags.json
```
## Verwenden des AWS SDK for Java
Das folgende Beispiel fügt Tags zu einer Konfiguration von Amazon S3 Storage Lens im SDK für Java hinzu. Wenn Sie dieses Beispiel verwenden möchten, ersetzen Sie die `user input placeholders` (Platzhalter für Benutzereingaben) durch Ihre Informationen.
**Example – Hinzufügen von Tags zu einer Konfiguration von S3 Storage Lens**
```
package aws.example.s3control;
import com.amazonaws.AmazonServiceException;
import com.amazonaws.SdkClientException;
import com.amazonaws.auth.profile.ProfileCredentialsProvider;
import com.amazonaws.services.s3control.AWSS3Control;
import com.amazonaws.services.s3control.AWSS3ControlClient;
import com.amazonaws.services.s3control.model.PutStorageLensConfigurationTaggingRequest;
import com.amazonaws.services.s3control.model.StorageLensTag;
import java.util.Arrays;
import java.util.List;
import static com.amazonaws.regions.Regions.US_WEST_2;
public class PutDashboardTagging {
public static void main(String[] args) {
String configurationId = "ConfigurationId";
String sourceAccountId = "111122223333";
try {
List tags = Arrays.asList(
new StorageLensTag().withKey("key-1").withValue("value-1"),
new StorageLensTag().withKey("key-2").withValue("value-2")
);
AWSS3Control s3ControlClient = AWSS3ControlClient.builder()
.withCredentials(new ProfileCredentialsProvider())
.withRegion(US_WEST_2)
.build();
s3ControlClient.putStorageLensConfigurationTagging(new PutStorageLensConfigurationTaggingRequest()
.withAccountId(sourceAccountId)
.withConfigId(configurationId)
.withTags(tags)
);
} catch (AmazonServiceException 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();
}
}
}
```
# Rufen Sie AWS Ressourcen-Tags für ein Storage Lens-Dashboard ab
Die folgenden Beispiele zeigen, wie Sie AWS Ressourcen-Tags für ein S3 Storage Lens-Dashboard abrufen. Sie können Ressourcen-Tags mithilfe der Amazon S3 S3-Konsole AWS Command Line Interface (AWS CLI) und abrufen AWS SDK für Java.
# Verwenden der S3-Konsole
**Um die AWS Ressourcen-Tags für ein Storage Lens-Dashboard abzurufen**
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. Navigieren Sie im linken Navigationsbereich zu **Storage Lens**.
1. Wählen Sie **Dashboards** aus.
1. Aktivieren Sie das Optionsfeld für die Konfiguration des Storage-Lens-Dashboards, die Sie anzeigen möchten. Wählen Sie dann **Dashboard-Konfigurationen anzeigen** aus.
1. Überprüfen Sie unter **Tags** die mit dem Dashboard verknüpften Tags.
1. (Optional) Wenn Sie einen neuen Tag hinzufügen möchten, wählen Sie **Bearbeiten** aus. Wählen Sie dann **Tag hinzufügen** aus. Fügen Sie auf der Seite **Tag hinzufügen** das neue Schlüssel-Wert-Paar hinzu.
**Anmerkung**
Wenn Sie ein neues Tag hinzufügen, dessen Schlüssel mit dem eines vorhandenen Tags identisch ist, wird der vorherige Tag-Wert überschrieben.
1. (Optional) Wenn Sie einen neu hinzugefügten Eintrag entfernen möchten, wählen Sie neben dem zu entfernenden Tag **Entfernen** aus.
1. Wählen Sie **Änderungen speichern ** aus.
## Verwenden Sie den AWS CLI
**Example**
Der folgende Beispielbefehl ruft Tags für eine Konfiguration des S3-Storage-Lens-Dashboards ab. Wenn Sie diese Beispiele verwenden möchten, ersetzen Sie die `user input placeholders` durch Ihre Informationen.
```
aws s3control get-storage-lens-configuration-tagging --account-id=222222222222 --region=us-east-1 --config-id=your-configuration-id --tags=file://./tags.json
```
## Verwenden des AWS SDK for Java
**Example – Abrufen von Tags für eine Konfiguration des S3-Storage-Lens-Dashboards**
Das folgende Beispiel zeigt, wie Sie Tags für eine Konfiguration des S3-Storage-Lens-Dashboards im SDK für Java abrufen. Wenn Sie dieses Beispiel verwenden möchten, ersetzen Sie die `user input placeholders` (Platzhalter für Benutzereingaben) durch Ihre Informationen.
```
package aws.example.s3control;
import com.amazonaws.AmazonServiceException;
import com.amazonaws.SdkClientException;
import com.amazonaws.auth.profile.ProfileCredentialsProvider;
import com.amazonaws.services.s3control.AWSS3Control;
import com.amazonaws.services.s3control.AWSS3ControlClient;
import com.amazonaws.services.s3control.model.DeleteStorageLensConfigurationRequest;
import com.amazonaws.services.s3control.model.GetStorageLensConfigurationTaggingRequest;
import com.amazonaws.services.s3control.model.StorageLensTag;
import java.util.List;
import static com.amazonaws.regions.Regions.US_WEST_2;
public class GetDashboardTagging {
public static void main(String[] args) {
String configurationId = "ConfigurationId";
String sourceAccountId = "111122223333";
try {
AWSS3Control s3ControlClient = AWSS3ControlClient.builder()
.withCredentials(new ProfileCredentialsProvider())
.withRegion(US_WEST_2)
.build();
final List s3Tags = s3ControlClient
.getStorageLensConfigurationTagging(new GetStorageLensConfigurationTaggingRequest()
.withAccountId(sourceAccountId)
.withConfigId(configurationId)
).getTags();
System.out.println(s3Tags.toString());
} catch (AmazonServiceException 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();
}
}
}
```
# Aktualisieren von Storage-Lens-Dashboard-Tags
Die folgenden Beispiele zeigen, wie Sie die Dashboard-Tags von Storage Lens mithilfe der Amazon S3 S3-Konsole, AWS Command Line Interface (AWS CLI) und aktualisieren AWS SDK für Java.
## Verwenden der S3-Konsole
**Um ein AWS Ressourcen-Tag für ein Storage Lens-Dashboard zu aktualisieren**
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. Navigieren Sie im linken Navigationsbereich zu **Storage Lens**.
1. Wählen Sie **Dashboards** aus.
1. Aktivieren Sie das Optionsfeld für die Konfiguration des Storage-Lens-Dashboards, die Sie anzeigen möchten. Wählen Sie dann **Dashboard-Konfigurationen anzeigen** aus.
1. Überprüfen Sie unter **Tags** die mit dem Dashboard verknüpften Tags.
1. (Optional) Wenn Sie einen neuen Tag hinzufügen möchten, wählen Sie **Bearbeiten** aus. Wählen Sie dann **Tag hinzufügen** aus. Fügen Sie auf der Seite **Tag hinzufügen** das neue Schlüssel-Wert-Paar hinzu.
**Anmerkung**
Wenn Sie ein neues Tag hinzufügen, dessen Schlüssel mit dem eines vorhandenen Tags identisch ist, wird der vorherige Tag-Wert überschrieben.
1. (Optional) Wenn Sie einen neu hinzugefügten Eintrag entfernen möchten, wählen Sie neben dem zu entfernenden Tag **Entfernen** aus.
1. Wählen Sie **Änderungen speichern ** aus.
## Verwenden Sie den AWS CLI
**Example**
Der folgende Beispielbefehl fügt Tags zu einer vorhandenen Konfiguration des Amazon-S3-Storage Lens-Dashboards hinzu oder ersetzt sie. Wenn Sie diese Beispiele verwenden möchten, ersetzen Sie die `user input placeholders` durch Ihre Informationen.
```
aws s3control put-storage-lens-configuration-tagging --account-id=111122223333 --config-id=example-dashboard-configuration-id --region=us-east-1 --config-id=your-configuration-id
```
## Verwenden des AWS SDK for Java
Im folgenden AWS SDK für Java Beispiel werden die AWS Ressourcen-Tags in einem vorhandenen Storage Lens-Dashboard aktualisiert. Wenn Sie dieses Beispiel verwenden möchten, ersetzen Sie die `user input placeholders` (Platzhalter für Benutzereingaben) durch Ihre Informationen.
**Example – Aktualisieren von Tags in einer vorhandenen Storage Lens-Dashboard-Konfiguration**
```
package aws.example.s3control;
import com.amazonaws.AmazonServiceException;
import com.amazonaws.SdkClientException;
import com.amazonaws.auth.profile.ProfileCredentialsProvider;
import com.amazonaws.services.s3control.AWSS3Control;
import com.amazonaws.services.s3control.AWSS3ControlClient;
import com.amazonaws.services.s3control.model.PutStorageLensConfigurationTaggingRequest;
import com.amazonaws.services.s3control.model.StorageLensTag;
import java.util.Arrays;
import java.util.List;
import static com.amazonaws.regions.Regions.US_WEST_2;
public class PutDashboardTagging {
public static void main(String[] args) {
String configurationId = "ConfigurationId";
String sourceAccountId = "111122223333";
try {
List tags = Arrays.asList(
new StorageLensTag().withKey("key-1").withValue("value-1"),
new StorageLensTag().withKey("key-2").withValue("value-2")
);
AWSS3Control s3ControlClient = AWSS3ControlClient.builder()
.withCredentials(new ProfileCredentialsProvider())
.withRegion(US_WEST_2)
.build();
s3ControlClient.putStorageLensConfigurationTagging(new PutStorageLensConfigurationTaggingRequest()
.withAccountId(sourceAccountId)
.withConfigId(configurationId)
.withTags(tags)
);
} catch (AmazonServiceException 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();
}
}
}
```
# Löschen von AWS Ressourcen-Tags aus einem S3 Storage Lens-Dashboard
Die folgenden Beispiele zeigen, wie Sie AWS Ressourcen-Tags aus einem vorhandenen Storage Lens-Dashboard löschen. Sie können Tags mithilfe der Amazon S3 S3-Konsole AWS Command Line Interface (AWS CLI) und löschen AWS SDK für Java.
## Verwenden der S3-Konsole
**Um AWS Ressourcen-Tags aus einem vorhandenen Storage Lens-Dashboard zu löschen**
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. Navigieren Sie im linken Navigationsbereich zu **Storage Lens**.
1. Wählen Sie **Dashboards** aus.
1. Aktivieren Sie das Optionsfeld für die Konfiguration des Storage-Lens-Dashboards, die Sie anzeigen möchten. Wählen Sie dann **Dashboard-Konfigurationen anzeigen** aus.
1. Überprüfen Sie unter **Tags** die mit dem Dashboard verknüpften Tags.
1. Wählen Sie neben dem zu entfernenden Tag **Entfernen** aus.
1. Wählen Sie **Änderungen speichern ** aus.
## Verwenden Sie den AWS CLI
Mit dem folgenden AWS CLI Befehl werden AWS Ressourcen-Tags aus einem vorhandenen Storage Lens-Dashboard gelöscht. Wenn Sie diese Beispielbefehl verwenden möchten, ersetzen Sie `user input placeholders` durch Ihre Informationen.
**Example**
```
aws s3control delete-storage-lens-configuration-tagging --account-id=222222222222 --config-id=your-configuration-id --region=us-east-1
```
## Verwenden des AWS SDK for Java
Im folgenden AWS SDK für Java Beispiel wird mithilfe des AWS Amazon-Ressourcennamens (ARN), den Sie im Konto `111122223333` angeben, ein Ressourcen-Tag aus dem Storage Lens-Dashboard gelöscht. Wenn Sie dieses Beispiel verwenden möchten, ersetzen Sie die `user input placeholders` (Platzhalter für Benutzereingaben) durch Ihre Informationen.
**Example – Löschen von Tags für eine Konfiguration des S3-Storage-Lens-Dashboards**
```
package aws.example.s3control;
import com.amazonaws.AmazonServiceException;
import com.amazonaws.SdkClientException;
import com.amazonaws.auth.profile.ProfileCredentialsProvider;
import com.amazonaws.services.s3control.AWSS3Control;
import com.amazonaws.services.s3control.AWSS3ControlClient;
import com.amazonaws.services.s3control.model.DeleteStorageLensConfigurationTaggingRequest;
import static com.amazonaws.regions.Regions.US_WEST_2;
public class DeleteDashboardTagging {
public static void main(String[] args) {
String configurationId = "ConfigurationId";
String sourceAccountId = "111122223333";
try {
AWSS3Control s3ControlClient = AWSS3ControlClient.builder()
.withCredentials(new ProfileCredentialsProvider())
.withRegion(US_WEST_2)
.build();
s3ControlClient.deleteStorageLensConfigurationTagging(new DeleteStorageLensConfigurationTaggingRequest()
.withAccountId(sourceAccountId)
.withConfigId(configurationId)
);
} catch (AmazonServiceException 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();
}
}
}
```
# Hilfsdateien für die Verwendung von Amazon S3 Storage Lens
Verwenden Sie die folgenden JSON-Dateien und die zugehörigen wichtigen Eingaben für Ihre Beispiele.
## Beispiel für S3-Storage-Lens-Konfiguration in JSON
**Example `config.json`**
Die Datei `config.json` enthält Details einer S3-Storage-Lens-Konfiguration auf Organisationsebene mit *erweiterten Metriken und Empfehlungen*. Wenn Sie das folgende Beispiel verwenden möchten, ersetzen Sie die `user input placeholders` durch Ihre eigenen Informationen.
Für erweiterte Metriken und Empfehlungen fallen zusätzliche Gebühren an. Weitere Informationen finden Sie unter [Erweiterte Metriken und Empfehlungen](https://docs.aws.amazon.com/AmazonS3/latest/userguide/storage_lens_basics_metrics_recommendations.html#storage_lens_basics_metrics_selection).
```
{
"Id": "SampleS3StorageLensConfiguration", //Use this property to identify your S3 Storage Lens configuration.
"AwsOrg": { //Use this property when enabling S3 Storage Lens for AWS Organizations.
"Arn": "arn:aws:organizations::123456789012:organization/o-abcdefgh"
},
"AccountLevel": {
"ActivityMetrics": {
"IsEnabled":true
},
"AdvancedCostOptimizationMetrics": {
"IsEnabled":true
},
"AdvancedDataProtectionMetrics": {
"IsEnabled":true
},
"DetailedStatusCodesMetrics": {
"IsEnabled":true
},
"BucketLevel": {
"ActivityMetrics": {
"IsEnabled":true
},
"AdvancedDataProtectionMetrics": {
"IsEnabled":true
},
"AdvancedCostOptimizationMetrics": {
"IsEnabled":true
},
"DetailedStatusCodesMetrics": {
"IsEnabled":true
},
"PrefixLevel":{
"StorageMetrics":{
"IsEnabled":true,
"SelectionCriteria":{
"MaxDepth":5,
"MinStorageBytesPercentage":1.25,
"Delimiter":"/"
}
}
}
}
},
"Exclude": { //Replace with "Include" if you prefer to include Regions.
"Regions": [
"eu-west-1"
],
"Buckets": [ //This attribute is not supported for AWS Organizations-level configurations.
"arn:aws:s3:::amzn-s3-demo-source-bucket"
]
},
"IsEnabled": true, //Whether the configuration is enabled
"DataExport": { //Details about the metrics export
"S3BucketDestination": {
"OutputSchemaVersion": "V_1",
"Format": "CSV", //You can add "Parquet" if you prefer.
"AccountId": "111122223333",
"Arn": "arn:aws:s3:::
amzn-s3-demo-destination-bucket", // The destination bucket for your metrics export must be in the same Region as your S3 Storage Lens configuration.
"Prefix": "prefix-for-your-export-destination",
"Encryption": {
"SSES3": {}
}
},
"CloudWatchMetrics": {
"IsEnabled": true
}
}
}
```
## Beispiel für S3-Storage-Lens-Konfiguration mit Storage-Lens-Gruppen in JSON
**Example `config.json`**
Die Datei `config.json` enthält die Details, die Sie bei Verwendung von Storage-Lens-Gruppen auf die Storage-Lens-Konfiguration anwenden möchten. Wenn Sie dieses Beispiel verwenden möchten, ersetzen Sie die `user input placeholders` durch Ihre Informationen.
Um alle Storage-Lens-Gruppen an das Dashboard anzuhängen, aktualisieren Sie die Storage-Lens-Konfiguration mit der folgenden Syntax:
```
{
"Id": "ExampleS3StorageLensConfiguration",
"AccountLevel": {
"ActivityMetrics": {
"IsEnabled":true
},
"AdvancedCostOptimizationMetrics": {
"IsEnabled":true
},
"AdvancedDataProtectionMetrics": {
"IsEnabled":true
},
"BucketLevel": {
"ActivityMetrics": {
"IsEnabled":true
},
"StorageLensGroupLevel": {},
"IsEnabled": true
}
```
Um nur zwei Storage Lens-Gruppen in Ihre Storage Lens-Dashboard-Konfiguration (*slg-1*und*slg-2*) aufzunehmen, verwenden Sie die folgende Syntax:
```
{
"Id": "ExampleS3StorageLensConfiguration",
"AccountLevel": {
"ActivityMetrics": {
"IsEnabled":true
},
"AdvancedCostOptimizationMetrics": {
"IsEnabled":true
},
"AdvancedDataProtectionMetrics": {
"IsEnabled":true
},
"BucketLevel": {
"ActivityMetrics": {
"IsEnabled":true
},
"StorageLensGroupLevel": {
"SelectionCriteria": {
"Include": [
"arn:aws:s3:us-east-1:111122223333:storage-lens-group/slg-1",
"arn:aws:s3:us-east-1:444455556666:storage-lens-group/slg-2"
]
},
"IsEnabled": true
}
```
Verwenden Sie die folgende Syntax, um bestimmte Storage-Lens-Gruppen vom Anhängen an die Dashboard-Konfiguration auszuschließen:
```
{
"Id": "ExampleS3StorageLensConfiguration",
"AccountLevel": {
"ActivityMetrics": {
"IsEnabled":true
},
"AdvancedCostOptimizationMetrics": {
"IsEnabled":true
},
"AdvancedDataProtectionMetrics": {
"IsEnabled":true
},
"BucketLevel": {
"ActivityMetrics": {
"IsEnabled":true
},
"StorageLensGroupLevel": {
"SelectionCriteria": {
"Exclude": [
"arn:aws:s3:us-east-1:111122223333:storage-lens-group/slg-1",
"arn:aws:s3:us-east-1:444455556666:storage-lens-group/slg-2"
]
},
"IsEnabled": true
}
```
## Beispiel für S3-Storage-Lens-Konfiguration mit Tags in JSON
**Example `tags.json`**
Die Datei `tags.json` enthält die Tags, die Sie auf Ihre S3-Storage-Lens-Konfiguration anwenden möchten. Wenn Sie dieses Beispiel verwenden möchten, ersetzen Sie die `user input placeholders` (Platzhalter für Benutzereingaben) durch Ihre Informationen.
```
[
{
"Key": "key1",
"Value": "value1"
},
{
"Key": "key2",
"Value": "value2"
}
]
```
## Beispiel für S3-Storage-Lens-Konfiguration für IAM Berechtigungen
**Example `permissions.json` – Spezifischer Dashboard-Name**
Diese Beispielrichtlinie zeigt eine IAM-Datei `permissions.json` von S3 Storage Lens mit einem bestimmten Dashboard-Namen. Ersetzen Sie *`value1`*, `us-east-1`, `your-dashboard-name` und `example-account-id` durch Ihre eigenen Werte.
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"s3:GetStorageLensConfiguration",
"s3:DeleteStorageLensConfiguration",
"s3:PutStorageLensConfiguration"
],
"Condition": {
"StringEquals": {
"aws:ResourceTag/key1": "value1"
}
},
"Resource": "arn:aws:s3:us-east-1:111122223333:storage-lens/your-dashboard-name"
}
]
}
```
**Example `permissions.json` – Kein spezifischer Dashboard-Name**
Diese Beispielrichtlinie zeigt eine IAM-Datei `permissions.json` von S3 Storage Lens ohne einen bestimmten Dashboard-Namen. Ersetzen Sie *`value1`*, `us-east-1` und `example-account-id` durch Ihre eigenen Werte.
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"s3:GetStorageLensConfiguration",
"s3:DeleteStorageLensConfiguration",
"s3:PutStorageLensConfiguration"
],
"Condition": {
"StringEquals": {
"aws:ResourceTag/key1": "value1"
}
},
"Resource": "arn:aws:s3:us-east-1:111122223333:storage-lens/*"
}
]
}
```