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. # Organisieren, Auflisten und Arbeiten mit Ihren Objekten In Amazon S3 können Sie Präfixe verwenden, um Ihren Speicher zu organisieren. Ein Präfix ist eine logische Gruppierung der Objekte in einem Bucket. Der Präfixwert ist mit einem Verzeichnisnamen vergleichbar, der Ihnen ermöglicht, ähnliche Daten in demselben Verzeichnis eines Buckets zu speichern. Wenn Sie Objekte programmgesteuert hochladen, können Sie Präfixe verwenden, um Ihre Daten zu organisieren. In der Amazon-S3-Konsole werden Präfixe als Ordner bezeichnet. Sie können alle Ihre Objekte und Ordner in der S3-Konsole anzeigen, indem Sie zu einem Bucket navigieren. Sie können auch Informationen zu jedem Objekt anzeigen, einschließlich Objekteigenschaften. Weitere Informationen zum Auflisten und Organisieren Ihrer Daten in Amazon S3 finden Sie in den folgenden Themen. **Topics** + [Organisieren von Objekten mit Präfixen](using-prefixes.md) + [Programmgesteuertes Auflisten von Objektschlüsseln](ListingKeysUsingAPIs.md) + [Organisieren von Objekten in der Amazon S3-Konsole mithilfe von Ordnern](using-folders.md) + [Anzeigen von Objekteigenschaften in der Amazon-S3-Konsole](view-object-properties.md) + [Kategorisierung Ihrer Objekte mit Hilfe von Tags](object-tagging.md) # Organisieren von Objekten mit Präfixen Sie können Präfixe verwenden, um die Daten zu organisieren, die Sie in Amazon-S3-Buckets speichern. Ein Präfix ist eine Zeichenfolge am Anfang des Objektschlüsselnamens. Ein Präfix kann eine beliebige Länge haben, abhängig von der maximalen Länge des Objektschlüsselnamens (1.024 Byte). Sie können sich Präfixe als eine Möglichkeit vorstellen, Ihre Daten ähnlich wie Verzeichnisse zu organisieren. Präfixe sind jedoch keine Verzeichnisse. Die Suche nach Präfix begrenzt die Ergebnisse auf die Schlüssel, die mit dem angegebenen Präfix beginnen. Das Trennzeichen veranlasst Listenoperationen, alle Schlüssel mit gemeinsamem Präfix in einer Zusammenfassungsliste als Ergebnis bereitzustellen. Zweck der Präfix- und Trennzeichen-Parameter ist es, Ihnen dabei zu helfen, Ihre Schlüssel hierarchisch zu organisieren und dann zu durchsuchen. Dazu wählen Sie zuerst ein Trennzeichen für Ihren Bucket aus, wie beispielsweise einen Schrägstrich (/), das in Ihren Schlüsselnamen voraussichtlich nicht vorkommt. Sie können ein anderes Zeichen als Trennzeichen verwenden. Der Schrägstrich (/) hat keine besonderen Eigenschaften, wird aber sehr häufig als Präfix-Trennzeichen verwendet. Anschließend konstruieren Sie Ihre Schlüsselnamen, indem Sie alle Ebenen der Hierarchie verknüpfen und jede Ebene mit dem Trennzeichen abtrennen. Wenn Sie beispielsweise Informationen über Städte speichern, könnten Sie diese natürlich nach dem Kontinent, dann nach dem Land und dann nach der Provinz oder dem Staat anordnen. Diese Namen enthalten normalerweise keine Interpunktionszeichen, deshalb könnten Sie den Schrägstrich (/) als Trennzeichen verwenden. Die folgenden Beispiele verwenden einen Schrägstrich (/) als Trennzeichen. + Europe/France/Nouvelle-Aquitaine/Bordeaux + Norden America/Canada/Quebec/Montreal + Norden America/USA/Washington/Bellevue + Norden America/USA/Washington/Seattle Wenn Sie auf diese Weise Daten für jede Stadt in der Welt gespeichert haben, ist es relativ mühsam, einen flachen Schlüssel-Namespace zu verwalten. Durch Verwendung von `Prefix` und `Delimiter` für die Listenvorgänge können Sie die Hierarchie verwenden, die Sie zum Auflisten Ihrer Daten erstellt haben. Um beispielsweise alle Staaten der USA aufzulisten, legen Sie `Delimiter='/'` und `Prefix='North America/USA/'` fest. Um alle Provinzen in Kanada aufzulisten, für die Sie Daten haben, legen Sie `Delimiter='/'` und `Prefix='North America/Canada/'` fest. Weitere Informationen zu Trennzeichen, Präfixen und verschachtelten Ordnern finden Sie unter [Unterschied zwischen Präfixen und verschachtelten Ordnern](https://repost.aws/knowledge-center/s3-prefix-nested-folders-difference). ## Auflisten von Objekten mit Präfixen und Trennzeichen Wenn Sie eine Listenanforderung mit einem Trennzeichen ausgeben, können Sie Ihre Hierarchie nur auf einer Ebene durchsuchen und die (möglicherweise Millionen von) Schlüsseln, die auf tieferen Ebenen verschachtelt sind, überspringen und zusammenfassen. Angenommen, Sie haben einen Bucket (*amzn-s3-demo-bucket*) mit den folgenden Schlüsseln: `sample.jpg` `photos/2006/January/sample.jpg` `photos/2006/February/sample2.jpg` `photos/2006/February/sample3.jpg` `photos/2006/February/sample4.jpg` Der Beispiel-Bucket hat nur das `sample.jpg`-Objekt auf der Root-Ebene. Um nur die Objekte auf Root-Ebene im Bucket aufzulisten, senden Sie eine GET-Anforderung mit dem Trennzeichen (`/`) an den Bucket. In der Antwort gibt Amazon S3 den `sample.jpg`-Objektschlüssel zurück, weil er das Trennzeichen `/` nicht enthält. Alle anderen Schlüssel enthalten das Trennzeichen. Amazon S3 gruppiert diese Schlüssel und gibt ein einziges `CommonPrefixes`-Element mit dem Präfix-Wert `photos/` zurück, eine Unterzeichenfolge vom Anfang dieser Schlüssel bis zum Auftreten des angegebenen Trennzeichens. **Example** ``` 1. 2. amzn-s3-demo-bucket 3. 4. 5. 1000 6. / 7. false 8. 9. sample.jpg 10. 2011-07-24T19:39:30.000Z 11. "d1a7fb5eab1c16cb4f7cf341cf188c3d" 12. 6 13. 14. 75cc57f09aa0c8caeab4f8c24e99d10f8e7faeebf76c078efc7c6caea54ba06a 15. 16. STANDARD 17. 18. 19. photos/ 20. 21. ``` Weitere Hinweise zum programmgesteuerten Auflisten von Objektschlüsseln finden Sie unter [Programmgesteuertes Auflisten von Objektschlüsseln](ListingKeysUsingAPIs.md). # Programmgesteuertes Auflisten von Objektschlüsseln In Amazon S3 können Schlüssel nach Präfix aufgelistet werden. Sie können ein allgemeines Präfix für die Namen verwandter Schlüssel wählen und diese Schlüssel mit einem Sonderzeichen markieren, das die Hierarchie begrenzt. Sie können dann die Listenoperation verwenden, um Schlüssel hierarchisch auszuwählen und zu durchsuchen. In ähnlicher Weise werden Dateien in einem Dateisystem in Ordnern gespeichert. Amazon S3 stellt eine Listenoperation bereit, die Ihnen ermöglicht, die in einem Bucket enthaltenen Schlüssel aufzulisten. Schlüssel werden nach Bucket und Präfix für die Auflistung ausgewählt. Angenommen, wir haben einen Bucket namens "`dictionary`", der einen Schlüssel für jedes englische Wort enthält. Sie können einen Aufruf ausführen, um alle Schlüssel in dem Bucket aufzulisten, die mit dem Buchstaben "q" beginnen. Listenergebnisse werden immer in binärer UTF-8-Reihenfolge zurückgegeben. Sowohl SOAP- als auch REST-Listenvorgänge geben ein XML-Dokument zurück, das die Namen übereinstimmender Schlüssel sowie Informationen über das von jedem Schlüssel identifizierte Objekt enthält. **Anmerkung** SOAP APIs für Amazon S3 ist für Neukunden nicht verfügbar und nähert sich dem Ende des Lebenszyklus (EOL) am 31. August 2025. Wir empfehlen, dass Sie entweder die REST-API oder die AWS SDKs verwenden. Gruppen von Schlüsseln, die ein gemeinsames Präfix haben, abgeschlossen mit einem speziellen Trennzeichen, können in einer Auflistung nach diesem gemeinsamen Präfix ausgegeben werden. Auf diese Weise können Anwendungen ihre Schlüssel hierarchisch organisieren und durchsuchen, ähnlich wie bei der Organisation Ihrer Dateien in Verzeichnissen in einem Dateisystem. Um beispielsweise den dictionary-Bucket zu erweitern, um mehr als nur englische Wörter aufzunehmen, könnten Sie Schlüssel bilden, indem Sie jedem Wort ein Präfix für seine Sprache und ein Trennzeichen voranstellen, wie beispielsweise "`French/logical`". Mit Hilfe dieses Namensschemas und der Funktion zur hierarchischen Auflistung könnten Sie eine Liste nur mit französischen Wörtern abrufen. Sie könnten auch auf oberster Ebene eine Liste verfügbarer Sprachen durchsuchen, ohne alle lexikographischen Schlüssel durchlaufen zu müssen. Weitere Informationen über diesen Aspekt der Auflistung finden Sie unter [Organisieren von Objekten mit Präfixen](using-prefixes.md). **REST-API** Falls in Ihrer Anwendung erforderlich, können Sie REST-Anforderungen auch direkt senden. Sie können eine GET-Anforderung senden, um alle oder einen Teil der Objekte in einem Bucket zurückzugeben, oder Auswahlkriterien anwenden, um eine Untermenge der Objekte in einem Bucket zurückzugeben. Weitere Informationen finden Sie unter [GET-Bucket(List Objects)-Version-2](https://docs.aws.amazon.com/AmazonS3/latest/API/v2-RESTBucketGET.html) in *Amazon Simple Storage Service – API-Referenz*. **Effiziente Implementierung von Listen** Die Listenleistung wird von der Gesamtzahl der Schlüssel in Ihrem Bucket nicht wesentlich beeinflusst. Es ist auch nicht von der Anwesenheit oder Abwesenheit der Argumente `prefix`, `marker`, `maxkeys` oder `delimiter` betroffen. **Durchlaufen mehrseitiger Ergebnisse** Buckets können nahezu unbegrenzt viele Schlüssel enthalten, die vollständigen Ergebnisse einer Listenabfrage können deshalb extrem umfangreich sein. Um große Ergebnismengen zu verwalten, unterstützt die Amazon-S3-API eine Paginierung, um sie in mehrere Antworten aufzuteilen. Jede Antwort für Listenschlüssel gibt eine Seite mit bis zu 1000 Schlüsseln zurück, mit einer Angabe, ob die Antwort gekürzt wurde. Sie senden eine Reihe von Anfragen mit Listenschlüsseln, bis Sie alle Schlüssel erhalten haben. AWS SDK-Wrapper-Bibliotheken bieten dieselbe Paginierung. ## Beispiele Sollen alle Objekte im Bucket aufgelistet werden, müssen Sie über die Berechtigung `s3:ListBucket` verfügen. ------ #### [ CLI ] **list-objects** Im folgenden Beispiel wird der Befehl `list-objects` verwendet, um die Namen aller Objekte im angegebenen Bucket anzuzeigen: ``` aws s3api list-objects --bucket text-content --query 'Contents[].{Key: Key, Size: Size}' ``` Im Beispiel wird das Argument `--query` verwendet, um die Ausgabe von `list-objects` nach Schlüsselwert und Größe für jedes Objekt zu filtern Weitere Informationen über Objekte finden Sie unter [Arbeiten mit Objekten in Amazon S3](uploading-downloading-objects.md). + Einzelheiten zur API finden Sie [ListObjects](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3api/list-objects.html)in der *AWS CLI Befehlsreferenz*. **LS** Im folgenden Beispiel werden alle Objekte und Präfixe in einem Bucket mit dem `ls`-Befehl aufgelistet. Wenn Sie diesen Beispielbefehl verwenden möchten, ersetzen Sie **amzn-s3-demo-bucket** durch den Namen des Buckets. ``` $ aws s3 ls s3://amzn-s3-demo-bucket ``` + Weitere Informationen zum High-Level-Befehl `ls` finden Sie unter [Auflisten von Buckets und Objekten](https://docs.aws.amazon.com/cli/latest/userguide/cli-services-s3-commands.html#using-s3-commands-listing-buckets) im *AWS Command Line Interface -Benutzerhandbuch*. ------ #### [ PowerShell ] **Tools für PowerShell V4** **Beispiel 1: Dieser Befehl ruft die Informationen über alle Elemente im Bucket „test-files“ ab.** ``` Get-S3Object -BucketName amzn-s3-demo-bucket ``` **Beispiel 2: Dieser Befehl ruft die Informationen über das Objekt „sample.txt“ aus dem Bucket „test-files“ ab.** ``` Get-S3Object -BucketName amzn-s3-demo-bucket -Key sample.txt ``` **Beispiel 3: Dieser Befehl ruft die Informationen über alle Elemente mit dem Präfix „sample“ aus dem Bucket „test-files“ ab.** ``` Get-S3Object -BucketName amzn-s3-demo-bucket -KeyPrefix sample ``` + Einzelheiten zur API finden Sie unter [ListObjects AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v4/reference)*Cmdlet-Referenz (V4).* **Tools für V5 PowerShell ** **Beispiel 1: Dieser Befehl ruft die Informationen über alle Elemente im Bucket „test-files“ ab.** ``` Get-S3Object -BucketName amzn-s3-demo-bucket ``` **Beispiel 2: Dieser Befehl ruft die Informationen über das Objekt „sample.txt“ aus dem Bucket „test-files“ ab.** ``` Get-S3Object -BucketName amzn-s3-demo-bucket -Key sample.txt ``` **Beispiel 3: Dieser Befehl ruft die Informationen über alle Elemente mit dem Präfix „sample“ aus dem Bucket „test-files“ ab.** ``` Get-S3Object -BucketName amzn-s3-demo-bucket -KeyPrefix sample ``` + Einzelheiten zur API finden Sie unter [ListObjects AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet-Referenz (*V5). ------ # Organisieren von Objekten in der Amazon S3-Konsole mithilfe von Ordnern In Amazon S3-Allzweck-Buckets sind Objekte die primären Ressourcen, und Objekte werden in Buckets gespeichert. Amazon S3-Allzweck-Buckets haben eine flache Struktur anstelle einer Hierarchie, wie Sie sie in einem Dateisystem sehen würden. Um eine möglichst einfache Organisation zu ermöglichen, unterstützt die Amazon-S3-Konsole jedoch das *Ordner*-Konzept, um Objekte gruppieren zu können. Die Konsole verwendet dazu ein gemeinsames *Namenspräfix* für die gruppierten Objekte. Mit anderen Worten, die gruppierten Objekte haben Namen, die mit einer bestimmten Zeichenfolge beginnen. Diese gemeinsame Zeichenfolge oder das gemeinsame Präfix ist der Ordnername. Objektnamen werden auch als *Schlüsselnamen* bezeichnet. Sie können zum Beispiel einen Ordner in einem Allzweck-Bucket in der Konsole mit dem Namen `photos` erstellen und darin ein Objekt mit dem Namen `myphoto.jpg` speichern. Das Objekt wird dann mit dem Schlüsselnamen `photos/myphoto.jpg` gespeichert, wobei `photos/` das Präfix ist. Nachfolgend zwei weitere Beispiele: + Wenn Sie drei Objekte in Ihrem Allzweck-Bucket haben – `logs/date1.txt`, `logs/date2.txt`und `logs/date3.txt` – zeigt die Konsole einen Ordner namens `logs` an. Wenn Sie den Ordner in der Konsole öffnen, sehen Sie drei Objekte: `date1.txt`, `date2.txt` und `date3.txt`. + Wenn Sie ein Objekt mit dem Namen `photos/2017/example.jpg`haben, zeigt Ihnen die Konsole einen Ordner mit dem Namen `photos`, der den Ordner `2017`enthält. Der Ordner `2017` enthält das Objekt `example.jpg`. Sie können Ordner innerhalb von Ordnern anlegen, aber keine Buckets innerhalb von Buckets. Sie können Objekte direkt in einen Ordner hochladen und kopieren. Ordner können erstellt, gelöscht und veröffentlicht werden, aber sie können nicht umbenannt werden. Objekte können von einem Ordner in einen anderen kopiert werden. **Wichtig** Wenn Sie einen Ordner in der Amazon-S3-Konsole anlegen, erstellt S3 ein 0-Byte-Objekt. Dieser Objektschlüssel wird auf den von Ihnen angegebenen Ordnernamen plus einen nachgestellten Schrägstrich (`/`) gesetzt. Wenn Sie zum Beispiel in der Amazon-S3-Konsole einen Ordner mit dem Namen `photos` in Ihrem Bucket erstellen, erstellt die Amazon-S3-Konsole ein 0-Byte-Objekt mit dem Schlüssel `photos/`. Die Konsole erstellt dieses Objekt, um das Ordnerkonzept zu unterstützen. Außerdem wird jedes bereits vorhandene Objekt, das mit einem nachgestellten Schrägstrich benannt ist (`/`), in der Amazon-S3-Konsole als Ordner angezeigt. Beispielsweise wird ein Objekt mit dem Schlüsselnamen als Ordner in der Amazon-S3-Konsole und nicht als Objekt `examplekeyname/` angezeigt. Andernfalls verhält es sich wie jedes andere Objekt und kann über die AWS Command Line Interface (AWS CLI), oder REST-API angezeigt und bearbeitet werden. AWS SDKs Außerdem können Sie über die Amazon-S3-Konsole kein Objekt hochladen, dessen Schlüsselname einen nachgestellten Schrägstrich enthält (`/`). Sie können jedoch Objekte hochladen, die mit einem abschließenden Schrägstrich () benannt sind, indem Sie die (`/`AWS CLI) AWS SDKs, oder die AWS Command Line Interface REST-API verwenden. Außerdem zeigt die Amazon-S3-Konsole den Inhalt und die Metadaten von Ordnerobjekten nicht an, wie dies bei anderen Objekten der Fall ist. Wenn Sie die Konsole zum Kopieren eines Objekts mit einem nachgestellten Schrägstrich (`/`) verwenden, wird am Zielort ein neuer Ordner erstellt, die Daten und Metadaten des Objekts werden jedoch nicht kopiert. Außerdem kann ein Schrägstrich (`/`) in Objektschlüsselnamen eine besondere Behandlung erfordern. Weitere Informationen finden Sie unter [Markieren von Amazon-S3-Objekten](object-keys.md). Um Ordner in Verzeichnis-Buckets zu erstellen, laden Sie einen Ordner hoch. Weitere Informationen finden Sie unter [Hochladen von Objekten zu einem Verzeichnis-Bucket](directory-buckets-objects-upload.md). **Topics** + [Erstellen eines Ordners](#create-folder) + [Veröffentlichen von Ordnern](#public-folders) + [Berechnen der Ordnergröße](#calculate-folder) + [Löschen von Ordnern](#delete-folders) ## Erstellen eines Ordners In diesem Abschnitt wird beschrieben, wie Sie mit der Amazon-S3-Konsole einen Ordner erstellen. **Wichtig** Wenn Ihre Bucket-Richtlinie das Hochladen von Objekten in diesen Bucket ohne Markierungen, Metadaten oder Zugriffssteuerungsliste (ACL)-Berechtigungsempfänger verhindert, können Sie mit der folgenden Vorgehensweise keinen Ordner erstellen. Laden Sie stattdessen einen leeren Ordner hoch und geben Sie die folgenden Einstellungen in der Upload-Konfiguration an. **So erstellen Sie einen Ordner** 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 **Allzweck-Buckets** aus. 1. Wählen Sie in der Bucket-Liste den Namen des Buckets, in dem Sie einen Ordner erstellen möchten. 1. Wählen Sie auf der Registerkarte **Objekte** **Ordner erstellen**. 1. Geben Sie einen Namen für den Ordner ein (z. B. **favorite-pics**). **Anmerkung** Ordnernamen unterliegen bestimmten Einschränkungen und Richtlinien und werden als Teil des Objektschlüsselnamens eines Objekts betrachtet, der auf 1.024 Byte begrenzt ist. Weitere Informationen finden Sie unter [Markieren von Amazon-S3-Objekten](object-keys.md). 1. (Optional) Wenn Ihre Bucket-Richtlinie vorschreibt, dass Objekte mit einem bestimmten Verschlüsselungsschlüssel verschlüsselt werden müssen, müssen Sie unter **Serverseitige Verschlüsselung** die Option **Verschlüsselungsschlüssel angeben** auswählen und denselben Verschlüsselungsschlüssel angeben, wenn Sie einen Ordner erstellen. Andernfalls schlägt die Ordnererstellung fehl. 1. Wählen Sie **Create folder**. ## Veröffentlichen von Ordnern Wir empfehlen, jeden öffentlichen Zugriff auf Ihre Amazon-S3-Ordner und Buckets zu blockieren, sofern Sie nicht speziell einen öffentlichen Ordner oder Bucket benötigen. Wenn Sie einen Ordner öffentlich machen, kann jeder Benutzer im Internet alle im Ordner gruppierten Objekte Anzeigen. In der Amazon-S3-Konsole können Sie einen Ordner öffentlich machen. Außerdem können Sie einen Ordner öffentlich machen, indem Sie eine Bucket-Richtlinie erstellen, die den Datenzugriff durch ein Präfix einschränkt. Weitere Informationen finden Sie unter [Identitäts- und Zugriffsverwaltung für Amazon S3](security-iam.md). **Warnung** Nachdem Sie einen Ordner in der Amazon-S3-Konsole öffentlich gemacht haben, kann er nicht mehr auf privat gesetzt werden. Stattdessen müssen Sie Berechtigungen für jedes einzelne Objekt im öffentlichen Ordner festlegen, damit die Objekte keinen öffentlichen Zugriff haben. Weitere Informationen finden Sie unter [Konfiguration ACLs](managing-acls.md). **Topics** + [Erstellen eines Ordners](#create-folder) + [Veröffentlichen von Ordnern](#public-folders) + [Berechnen der Ordnergröße](#calculate-folder) + [Löschen von Ordnern](#delete-folders) ## Berechnen der Ordnergröße In diesem Abschnitt wird beschrieben, wie Sie mit der Amazon-S3-Konsole die Größe eines Ordners berechnen. **So berechnen Sie die Größe eines Ordners** 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 **Allzweck-Buckets** aus. 1. Wählen Sie in der Liste **Allzweck-Buckets** den Namen des Buckets, in dem Ihr Ordner gespeichert ist. 1. Aktivieren Sie in der Liste **Objekte** das Kontrollkästchen neben dem Namen des Ordners. 1. Wählen Sie **Actions** (Aktionen) und dann **Calculate total size** (Gesamtgröße berechnen) aus. **Anmerkung** Wenn Sie die Seite verlassen, sind die Ordnerinformationen (einschließlich der Gesamtgröße) nicht mehr verfügbar. Sie müssen die Gesamtgröße erneut berechnen, wenn Sie sie erneut sehen möchten. **Wichtig** Wenn Sie die Aktion **Calculate total size** (Gesamtgröße berechnen) für bestimmte Objekte oder Ordner in Ihrem Bucket verwenden, berechnet Amazon S3 die Gesamtzahl der Objekte und die Gesamtspeichergröße. Unvollständige oder in Bearbeitung befindliche mehrteilige Uploads und vorherige oder nicht aktuelle Versionen werden jedoch nicht auf die Gesamtzahl der Objekte oder die Gesamtgröße angerechnet. Diese Aktion berechnet nur die Gesamtzahl der Objekte und die Gesamtgröße für die aktuelle oder neueste Version jedes Objekts, das im Bucket gespeichert ist. Wenn es beispielsweise zwei Versionen eines Objekts in Ihrem Bucket gibt, zählt der Speicherrechner in Amazon S3 diese nur als ein Objekt. Daher kann die Gesamtzahl der Objekte, die in der Amazon S3-Konsole berechnet wird, von der in S3 Storage Lens angezeigten Metrik **Objektanzahl** und von der in der CloudWatch Amazon-Metrik, gemeldeten Anzahl abweichen`NumberOfObjects`. Ebenso kann die Gesamtspeichergröße auch von der Metrik „**Gesamtspeicher**“ in S3 Storage Lens und von der in angezeigten `BucketSizeBytes` Metrik abweichen CloudWatch. ## Löschen von Ordnern In diesem Abschnitt erfahren Sie, wie Sie mit der Amazon-S3-Konsole Ordner aus einem S3-Bucket löschen. Informationen zu den Funktionen und Preisen von Amazon S3 finden Sie unter [Amazon S3](https://aws.amazon.com/s3/). **Ordner aus einem S3-Bucket 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. Wählen Sie im linken Navigationsbereich **Allzweck-Buckets** aus. 1. Wählen Sie in der Liste **Allzweck-Bucket** den Namen des Buckets, aus dem Sie Ordner löschen möchten. 1. Aktivieren Sie in der Liste **Objekte** die Kontrollkästchen neben den Ordnern und Objekten, die Sie löschen möchten. 1. Wählen Sie **Löschen** aus. 1. Überprüfen Sie auf der Seite **Objekte löschen**, ob die Namen der Ordner und Objekte, die Sie zum Löschen ausgewählt haben, unter **Angegebene Objekte** aufgeführt sind. 1. Geben Sie im Feld **Delete objects (Objekte löschen)** ein **delete**, und wählen Sie **Delete objects (Objekte löschen)** aus. **Warnung** Diese Aktion löscht alle angegebenen Objekte. Warten Sie beim Löschen von Ordnern, bis die Löschaktion abgeschlossen ist, bevor Sie dem Ordner neue Objekte hinzufügen. Andernfalls könnten auch neue Objekte gelöscht werden. # Anzeigen von Objekteigenschaften in der Amazon-S3-Konsole Sie können die Amazon-S3-Konsole verwenden, um die Eigenschaften eines Objekts anzuzeigen, einschließlich Speicherklasse, Verschlüsselungs-Einstellungen, Markierungen und Metadaten. **Die Eigenschaften für ein Objekt anzeigen** 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 **Allzweck-Buckets** oder **Verzeichnis-Buckets** aus. 1. Wählen Sie in der Bucket-Liste den Namen des Buckets aus, der das Objekt enthält. 1. Wählen Sie in der Liste **Objects (Objekte)** den Namen des Objekts aus, dessen Eigenschaften Sie anzeigen wollen. Die **Object overview (Objektübersicht)** für Ihr Objekt wird geöffnet. Sie können nach unten scrollen, um die Objekteigenschaften anzuzeigen. 1. Auf der Seite **Objektübersicht** können Sie die folgenden Eigenschaften für das Objekt anzeigen oder konfigurieren. **Anmerkung** Wenn Sie die Eigenschaften **Storage Class (Speicherklasse)**, **Encryption (Verschlüsselung)** oder **Metadata (Metadaten)** ändern, wird ein neues Objekt erstellt, um das alte zu ersetzen. Wenn S3-Versioning aktiviert ist, wird eine neue Version des Objekts erstellt, und das vorhandene Objekt wird zu einer älteren Version. Die Rolle, die die Eigenschaft ändert, wird auch Besitzer des neuen Objekts (oder der neuen Objektversion). Wenn Sie die Eigenschaften **Speicherklasse**, **Verschlüsselung**oder **Metadaten** für ein Objekt mit benutzerdefinierten Tags ändern, müssen Sie die Berechtigung `s3:GetObjectTagging` haben. Wenn Sie diese Eigenschaften für ein Objekt ändern, das keine benutzerdefinierten Tags hat, aber größer als 16 MB ist, benötigen Sie auch die entsprechende `s3:GetObjectTagging`-Berechtigung. Wenn die Ziel-Bucket-Richtlinie die `s3:GetObjectTagging`-Aktion ablehnt, werden diese Eigenschaften für das Objekt aktualisiert, aber die benutzerdefinierten Tags werden aus dem Objekt entfernt und Sie erhalten eine Fehlermeldung. 1. **Storage class (Speicherklasse)** – Jedem Objekt in Amazon S3 ist eine Speicherklasse zugeordnet. Welche Speicherklasse Sie wählen, ist davon abhängig, wie häufig Sie auf das Objekt zugreifen. Die Standardspeicherklasse für S3-Objekte in Allzweck-Buckets ist STANDARD. Die Standardspeicherklasse für S3-Objekte in Verzeichnis-Buckets ist S3 Express One Zone. Sie wählen, welche Speicherlasse verwendet werden soll, wenn Sie ein Objekt hochladen. Weitere Informationen über Speicherklassen finden Sie unter [Verstehen und Verwalten von Amazon-S3-Speicherklassen](storage-class-intro.md). Um die Speicherklasse zu ändern, nachdem Sie ein Objekt in einen Allzweck-Bucket hochgeladen haben, wählen Sie **Speicherklasse**. Wählen Sie die gewünschte Speicherklasse aus, und wählen Sie dann **Save (Speichern)**. **Anmerkung** Die Speicherklasse von Objekten in einem Verzeichnis-Bucket kann nicht geändert werden. 1. **Serverseitige Verschlüsselungseinstellungen** — Sie können serverseitige Verschlüsselung verwenden, um Ihre S3-Objekte zu verschlüsseln. Für weitere Informationen siehe [Angabe der serverseitigen Verschlüsselung mit AWS KMS (SSE-KMS)](specifying-kms-encryption.md) oder [Angeben serverseitiger Verschlüsselung mit von Amazon S3 verwalteten Schlüsseln (SSE-S3)](specifying-s3-encryption.md). 1. **Metadata (Metadaten)** – Jedes Objekt in Amazon S3 weist eine Gruppe von Namen-Wert-Paaren auf, die seine Metadaten repräsentieren. Weitere Informationen zum Hinzufügen von Metadaten zu einem S3-Objekt finden Sie unter [Bearbeiten von Objektmetadaten in der Amazon-S3-Konsole](add-object-metadata.md). 1. **Tags** - Sie kategorisieren den Speicher, indem Sie einem S3-Objekt in einem Allzweck-Bucket Tags hinzufügen. Weitere Informationen finden Sie unter [Kategorisierung Ihrer Objekte mit Hilfe von Tags](object-tagging.md). 1. **Rechtliche Aufbewahrungspflicht für und Aufbewahrung von Object Lock** – Sie können verhindern, dass ein Objekt in einem Allzweck-Bucket gelöscht wird. Weitere Informationen finden Sie unter [Sperren von Objekten mit Object Lock](object-lock.md). # Kategorisierung Ihrer Objekte mit Hilfe von Tags Markieren Sie Objekte, um Speicher zu kategorisieren. Jeder Tag ist ein Schlüssel/Wert-Paar. Sie können neuen Objekten Markierungen hinzufügen, wenn Sie sie hochladen, Sie können Markierungen aber auch vorhandenen Objekten hinzufügen. + Sie können einem Objekt bis zu 10 Tags zuordnen. Einem Objekt zugeordnete Markierungen müssen eindeutige Tag-Schlüssel haben. + Ein Tag-Schlüssel kann bis zu 128 Unicode-Zeichen lang sein, und Tag-Werte können bis zu 256 Unicode-Zeichen lang sein. Amazon-S3-Objekt-Tags werden intern in UTF-16 dargestellt. Beachten Sie, dass Zeichen in UTF-16 entweder 1 oder 2 Zeichenpositionen einnehmen. + Bei Schlüsseln und Werten wird die Groß-/Kleinschreibung berücksichtigt. + Weitere Informationen zu Tag-Beschränkungen finden Sie unter [Einschränkungen für benutzerdefinierte Tags](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/custom-tags.html#allocation-tag-restrictions) im *Benutzerhandbuch für AWS Billing and Cost Management*. Für grundlegende Tag-Beschränkungen siehe [Tag-Beschränkungen](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/Using_Tags.html#tag-restrictions) im *Amazon-EC2-Benutzerhandbuch*. **Beispiele** Betrachten Sie die folgenden Beispiele für die Markierung: **Example PHI-Informationen** Angenommen, ein Objekt enthält PHI-Daten (Protected Health Information, geschützte Gesundheitsdaten). Sie könnten das Objekt unter Verwendung des folgenden-Schlüssel-Wert-Paares markieren: ``` PHI=True ``` oder ``` Classification=PHI ``` **Example Projektdateien** Angenommen, Sie speichern Projektdateien in Ihrem S3-Bucket. Sie könnten diese Objekte mit einem Schlüssel namens `Project` und einem Wert markieren, wie nachfolgend gezeigt: ``` Project=Blue ``` **Example Mehrere Markierungen** Sie können einem Objekt mehrere Markierungen hinzufügen, wie nachfolgend gezeigt: ``` Project=x Classification=confidential ``` **Schlüsselnamen-Präfixe und -Markierungen** Mit Schlüsselnamenpräfixe können Sie auch Speicher kategorisieren. Allerdings sind Präfix-basierte Kategorisierungen eindimensional. Sehen Sie sich die folgenden Objektschlüsselnamen an: ``` photos/photo1.jpg project/projectx/document.pdf project/projecty/document2.pdf ``` Dieses Schlüsselnamen haben die Präfixe `photos/`, `project/projectx/` und `project/projecty/`. Diese Präfixe unterstützen eine eindimensionale Kategorisierung. Das bedeutet, alles unter einem Präfix ist eine Kategorie. Beispielsweise identifiziert das Präfix `project/projectx` alle Dokumente, die zu Projekt X gehören. Mit der Markierung erhalten Sie jetzt eine weitere Dimension. Wenn Sie photo1 in der Kategorie project x anlegen wollen, können Sie das Objekt entsprechend markieren. **Zusätzliche Vorteile** Neben der Datenklassifizierung bietet die Markierung auch noch weitere Vorteile. + Objekt-Markierungen bieten eine differenzierte Zugriffskontrolle für Berechtigungen. Sie könnten z. B. einem Benutzer Berechtigungen erteilen, nur Objekte mit bestimmten Markierungen zu lesen. + Objekt-Markierungen unterstützen ein differenziertes Objektlebenszyklusmanagement, bei dem Sie in einer Lebenszyklusregel zusätzlich zum Schlüsselnamenpräfix einen auf Markierungen basierenden Filter angeben können. + Wenn Sie Amazon-S3-Analysen verwenden, können Sie Filter konfigurieren, um Objekte für die Analyse nach Objekt-Markierungen, nach Schlüsselnamen-Präfix oder nach Präfix und Markierungen zu gruppieren. + Sie können CloudWatch Amazon-Metriken auch so anpassen, dass Informationen anhand bestimmter Tag-Filter angezeigt werden. Die folgenden Abschnitte stellen Details bereit. **Wichtig** Es ist akzeptabel, Markierungen zu verwenden, um Objekte mit vertraulichen Daten zu markieren (z. B. personenbezogene Informationen (PII) oder geschützte Gesundheitsinformationen (PHI)). Diese Markierungen sollten jedoch selbst keine vertraulichen Daten enthalten. **Hinzufügen von Objekt-Tag-Sätzen zu mehreren Amazon-S3-Objekten mit einer einzigen Anfrage** Zum Hinzufügen von Objekt-Tag-Mengen zu mehr als einem Amazon-S3-Objekt mit einer einzelnen Anforderung können Sie S3-Batchoperationen verwenden. Sie stellen S3 Batch Operations eine Liste von Objekten zur Verfügung, für die Vorgänge ausgeführt werden sollen. S3-Batchoperationen rufen die entsprechende API-Operation auf, um die angegebene Operation auszuführen. Ein einzelner Batch-Operations-Auftrag kann die angegebene Operation für Milliarden von Objekten ausführen, die Exabytes von Daten enthalten. Die Funktion „S3-Batchoperationen“ verfolgt den Fortschritt, versendet Benachrichtigungen und speichert einen detaillierten Abschlussbericht zu allen Aktionen. Sie profitieren von einer vollständig verwalteten, prüfbaren und serverlosen Umgebung. Sie können S3 Batch Operations über die Amazon S3 S3-Konsole, AWS CLI AWS SDKs, oder die REST-API verwenden. Weitere Informationen finden Sie unter [Grundlagen von S3-BatchVorgänge](batch-ops.md#batch-ops-basics). Weitere Informationen über Objekt-Markierungen finden Sie unter [Verwalten von Objekt-Markierungen](tagging-managing.md). ## API-Operationen für die Objektmarkierung Amazon S3 unterstützt die folgenden API-Operationen, die spezifisch für das Objekt-Tagging sind: **Objekt-API-Operationen** + [PUT Object tagging](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectPUTtagging.html) – Ersetzt Markierungen auf einem Objekt. Sie geben die Markierungen im Anfragerumpf an. Es gibt zwei unterschiedliche Szenarien der Objekt-Tag-Verwaltung unter Verwendung dieser API. + Objekt hat keine Markierungen – Mit Hilfe dieser API können Sie einem Objekt verschiedene Markierungen hinzufügen (das Objekt hat keine vorherigen Markierungen). + Das Objekt hat eine Menge vorhandener Markierungen – Um die vorhandene Tag-Menge zu ändern, müssen Sie zuerst die vorhandene Tag-Menge abrufen, sie auf der Client-Seite ändern und diese API dann verwenden, um die Tag-Menge zu ersetzen. **Anmerkung** Wenn Sie diese Anforderung mit einer leeren Tag-Menge senden, löscht Amazon S3 die vorhandene Tag-Menge für das Objekt. Wenn Sie diese Methode verwenden, wird eine Tier 1-Anforderung (PUT) berechnet. Weitere Informationen finden Sie unter [Amazon S3 – Preise](https://d0.awsstatic.com/whitepapers/aws_pricing_overview.pdf). Die Anforderung [DELETE Object tagging](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectDELETEtagging.html) wird empfohlen, weil sie das gleiche Ergebnis liefert, aber keine Kosten verursacht. + [GET Object tagging](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectGETtagging.html) – Gibt die einem Objekt zugeordnete Tag-Menge zurück. Amazon S3 gibt die Objekt-Markierungen im Antworttext zurück. + [DELETE Object tagging](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectDELETEtagging.html) – Löscht die mit einem Tag verbundenen Tag-Menge. **Andere API-Operationen, die Markieren unterstützen** + [PUT Object](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectPUT.html) und [Initiate Multipart Upload](https://docs.aws.amazon.com/AmazonS3/latest/API/mpUploadInitiate.html)– Sie können beim Erstellen von Objekten Markierungen angeben. Sie geben Markierungen unter Verwendung des Anfrage-Headers `x-amz-tagging` an. + [GET Object](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectGET.html) – Statt die Tag-Menge zurückzugeben, gibt Amazon S3 den Objekt-Tag-Zähler im `x-amz-tag-count`-Header zurück (nur dann, wenn der Auftraggeber die Berechtigung hat, Markierungen zu lesen), weil die Header-Antwortgröße auf 8 KB begrenzt ist. Wenn Sie die Markierungen anzeigen möchten, erstellen Sie eine weitere Anfrage für die API-Operation [GET Object tagging](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectGETtagging.html). + [POST Object](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectPOST.html) – Sie können Markierungen in Ihrer POST-Anfrage angeben. So lange die von Ihnen geforderten Markierungen die 8-KB-Größenbeschränkung der HTTP-Anfrageheader nicht überschreitet, können Sie die `PUT Object `-API verwenden, um Objekte mit Markierungen zu erstellen. Wenn die von Ihnen angegebenen Markierungen die Größenbeschränkung des Headers überschreiten, können Sie diese POST-Methode verwenden, wobei Sie die Markierungen in den Rumpf aufnehmen. [PUT Object - Copy](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectCOPY.html) – Sie können die `x-amz-tagging-directive` in Ihre Anfrage aufnehmen, um Amazon S3 anzuweisen, die Markierungen zu kopieren (Standardverhalten) oder durch eine neue, in der Anfrage angegebene Tag-Menge zu ersetzen. Beachten Sie Folgendes: + Die S3-Objektmarkierung ist hochgradig konsistent. Weitere Informationen finden Sie unter [Amazon S3-Datenkonsistenzmodell](Welcome.md#ConsistencyModel). ## Zusätzliche Konfigurationen Dieser Abschnitt erklärt, was die Objektmarkierung für andere Konfigurationen bedeutet. ### Objektmarkierung und Lebenszyklusverwaltung In der Bucket-Lebenszyklus-Konfiguration können Sie einen Filter angeben, um eine Untermenge von Objekten auszuwählen, auf die die Regel anzuwenden ist. Sie können einen Filter basierend auf den Schlüsselnamenpräfixen, Objekt-Markierungen oder beidem angeben. Angenommen, Sie speichern Fotos (Rohdaten und im fertigen Format) in Ihrem Amazon-S3-Bucket. Sie könnten diese Objekte wie folgt markieren: ``` phototype=raw or phototype=finished ``` Sie sollten in Erwägung ziehen, die Rohfotos nach ihrer Erstellung auf Amazon Glacier zu archivieren. Sie können eine Lebenszyklusregel mit einem Filter konfigurieren, der die Untermenge der Objekte mit dem Schlüsselnamenpräfix (`photos/`) identifiziert, die ein spezifisches Tag (`phototype=raw`) haben. Weitere Informationen finden Sie unter [Verwalten des Lebenszyklus von Objekten](object-lifecycle-mgmt.md). ### Objektmarkierung und -replikation Wenn Sie auf Ihrem Bucket die Replikation konfiguriert haben, repliziert Amazon S3 Markierungen, sofern Sie Amazon S3 die Berechtigung zum Lesen der Markierungen erteilt haben. Weitere Informationen finden Sie unter [Einrichten einer Live-Replikation – Überblick](replication-how-setup.md). ### Ereignisbenachrichtigungen einer Objektmarkierung Sie können eine Amazon-S3-Ereignisbenachrichtigung einrichten, um benachrichtigt zu werden, wenn eine Objektmarkierung hinzugefügt oder aus einem Objekt gelöscht wird. Der `s3:ObjectTagging:Put`-Ereignistyp benachrichtigt Sie, wenn ein Tag auf einem Objekt PUTiert wird oder wenn ein vorhandener Tag aktualisiert wird. Der `s3:ObjectTagging:Delete`-Ereignistyp benachrichtigt Sie, wenn ein Tag aus einem Objekt entfernt wird. Weitere Informationen finden Sie unter [Aktivieren von Ereignisbenachrichtigungen](https://docs.aws.amazon.com/AmazonS3/latest/userguide/how-to-enable-disable-notification-intro.html). Weitere Informationen über die Objektmarkierung finden Sie in den folgenden Themen: **Topics** + [API-Operationen für die Objektmarkierung](#tagging-apis) + [Zusätzliche Konfigurationen](#tagging-other-configs) + [Markierungs- und Zugriffskontrollrichtlinien](tagging-and-policies.md) + [Verwalten von Objekt-Markierungen](tagging-managing.md) # Markierungs- und Zugriffskontrollrichtlinien Sie können außerdem Berechtigungsrichtlinien (Bucket- und Benutzerrichtlinien) verwenden, um Berechtigungen für das Objekt-Tagging zu verwalten. Informationen über Richtlinienaktionen finden Sie in den folgenden Themen: + [Objektoperationen](security_iam_service-with-iam.md#using-with-s3-actions-related-to-objects) + [Bucket-Operationen](security_iam_service-with-iam.md#using-with-s3-actions-related-to-buckets) Objekt-Markierungen bieten eine differenzierte Zugriffskontrolle für die Verwaltung von Berechtigungen. Sie können bedingte Berechtigungen basierend auf Objekt-Markierungen erteilen. Amazon S3 unterstützt die folgenden Bedingungsschlüssel, die Sie verwenden können, um bedingte Berechtigungen basierend auf Objekt-Markierungen zu erteilen. + `s3:ExistingObjectTag/` – Verwenden Sie diesen Bedingungsschlüssel, um zu überprüfen, ob ein vorhandenes Objekt-Tag den spezifischen Tag-Schlüssel und -Wert besitzt. **Anmerkung** Wenn Sie Berechtigungen für die `PUT Object`- und `DELETE Object`-Operationen erteilen, wird dieser Bedingungsschlüssel nicht unterstützt. Dies bedeutet, dass Sie keine Richtlinie erstellen können, um einem Benutzer zu gestatten, ein Objekt basierend auf seinen vorhandenen Markierungen zu löschen oder zu überschreiben. + `s3:RequestObjectTagKeys` – Verwenden Sie diesen Bedingungsschlüssel, um die Tag-Schlüssel einzuschränken, die Sie für Objekte zulassen wollen. Dies ist nützlich, wenn Sie Objekten mithilfe der Objektanforderungen PutObjectTagging PutObject AND und POST Tags hinzufügen. + `s3:RequestObjectTag/` – Verwenden Sie diesen Bedingungsschlüssel, um die Tag-Schlüssel und -Werte einzuschränken, die Sie für Objekte zulassen wollen. Dies ist nützlich, wenn Sie Objekten mithilfe der Bucket-Anfragen PutObjectTagging PutObject AND und POST Tags hinzufügen. Eine vollständige Liste der für den Amazon-S3-Service spezifischen Bedingungsschlüssel finden Sie unter [Beispiele für Bucket-Richtlinien mit Bedingungsschlüsseln](amazon-s3-policy-keys.md). Die folgenden Berechtigungsrichtlinien zeigen, wie die Objektmarkierung eine differenzierte Zugriffsberechtigungsverwaltung ermöglicht. **Example 1: Einem Benutzer nur das Lesen von Objekten gestatten, die einen bestimmten Tag-Schlüssel und -Wert besitzen** Die folgende Berechtigungsrichtlinie beschränkt einen Benutzer darauf, nur Objekte zu lesen, die den Tag-Schlüssel und -Wert `environment: production` haben. Diese Richtlinie verwendet den `s3:ExistingObjectTag`-Bedingungsschlüssel, um den Tag-Schlüssel und -Wert anzugeben. **** ``` { "Version":"2012-10-17", "Statement": [ { "Principal": { "AWS": [ "arn:aws:iam::111122223333:role/JohnDoe" ] }, "Effect": "Allow", "Action": ["s3:GetObject", "s3:GetObjectVersion"], "Resource": "arn:aws:s3:::amzn-s3-demo-bucket/*", "Condition": { "StringEquals": {"s3:ExistingObjectTag/environment": "production"} } } ] } ``` **Example 2: Einschränken, welche Objekt-Tag-Schlüssel Benutzer hinzufügen können** Die folgende Berechtigungsrichtlinie erteilt einem Benutzer die Berechtigungen, die `s3:PutObjectTagging`-Aktion auszuführen, die dem Benutzer gestattet, einem vorhandenen Objekt Markierungen hinzuzufügen. Die Bedingung verwendet den Bedingungsschlüssel `s3:RequestObjectTagKeys`, um die zulässigen Tag-Schlüssel zu spezifizieren, z. B. `Owner` oder `CreationDate`. Weitere Informationen finden Sie unter [Erstellen einer Bedingung, die mehrere Schlüsselwerte testet](https://docs.aws.amazon.com//IAM/latest/UserGuide/reference_policies_multi-value-conditions.html) im *IAM-Benutzerhandbuch*. Die Richtlinie stellt sicher, dass jeder in der Anfrage angegebene Tag-Schlüssel ein autorisierter Tag-Schlüssel ist. Der `ForAnyValue`-Qualifizierer in der Bedingung stellt sicher, dass mindestens einer der spezifizierten Schlüssel in der Anfrage enthalten ist. **** ``` { "Version":"2012-10-17", "Statement": [ {"Principal":{"AWS":[ "arn:aws:iam::111122223333:role/JohnDoe" ] }, "Effect": "Allow", "Action": [ "s3:PutObjectTagging" ], "Resource": [ "arn:aws:s3:::amzn-s3-demo-bucket/*" ], "Condition": {"ForAnyValue:StringEquals": {"s3:RequestObjectTagKeys": [ "Owner", "CreationDate" ] } } } ] } ``` **Example 3: Einen spezifischen Tag-Schlüssel und -Wert verlangen, wenn Benutzern erlaubt wird, Objekt-Tags hinzuzufügen** Die folgende Beispielrichtlinie erteilt einem Benutzer die Berechtigungen, die `s3:PutObjectTagging`-Aktion auszuführen, die dem Benutzer gestattet, einem vorhandenen Objekt Markierungen hinzuzufügen. Die Bedingung verlangt, dass der Benutzer einen spezifischen Tag-Schlüssel (z. B. `Project`) mit dem Wert `X` angibt. **** ``` { "Version":"2012-10-17", "Statement": [ {"Principal":{"AWS":[ "arn:aws:iam::111122223333:user/JohnDoe" ] }, "Effect": "Allow", "Action": [ "s3:PutObjectTagging" ], "Resource": [ "arn:aws:s3:::amzn-s3-demo-bucket/*" ], "Condition": {"StringEquals": {"s3:RequestObjectTag/Project": "X" } } } ] } ``` # Verwalten von Objekt-Markierungen In diesem Abschnitt wird erklärt, wie Sie Objekt-Tags mit der AWS SDKs for Java- und .NET- oder der Amazon S3 S3-Konsole verwalten können. Mit Hilfe der Objektkennzeichnung können Sie den Speicher in Allzweck-Buckets kategorisieren. Jedes Tag ist ein Schlüssel-Wert-Paar, für das folgende Regeln gelten: + Sie können einem Objekt bis zu 10 Tags zuordnen. Einem Objekt zugeordnete Markierungen müssen eindeutige Tag-Schlüssel haben. + Ein Tag-Schlüssel kann bis zu 128 Unicode-Zeichen lang sein, und Tag-Werte können bis zu 256 Unicode-Zeichen lang sein. Amazon-S3-Objekt-Tags werden intern in UTF-16 dargestellt. Beachten Sie, dass Zeichen in UTF-16 entweder 1 oder 2 Zeichenpositionen einnehmen. + Bei Schlüsseln und Werten wird die Groß-/Kleinschreibung berücksichtigt. Weitere Informationen über Objekt-Markierungen finden Sie unter [Kategorisierung Ihrer Objekte mit Hilfe von Tags](object-tagging.md). Weitere Informationen zu Tag-Einschränkungen finden Sie unter [Einschränkungen benutzerdefinierter Tags](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/allocation-tag-restrictions.html) im *AWS Fakturierung und Kostenmanagement -Benutzerhandbuch*. ## Verwenden der S3-Konsole **Hinzufügen von Markern zu einem Objekt** 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 **Allzweck-Buckets** aus. 1. Wählen Sie in der Bucket-Liste den Namen des Buckets aus, der das Objekt enthält. 1. Markieren Sie das Kontrollkästchen links neben den Namen der Objekte, die Sie ändern möchten. 1. Wählen Sie im Menü **Aktionen** die Option **Markierungen bearbeiten**. 1. Überprüfen Sie die aufgelisteten Objekte und wählen Sie **Markierungen hinzufügen**. 1. Jedes Objekt-Tag ist ein Schlüssel-Wert-Paar. Geben Sie einen **Key (Schlüssel)** und einen **Value (Wert)** ein. Um ein weiteres Tag hinzuzufügen, wählen Sie **Add Tag (Tag hinzufügen)**. Sie können bis zu 10 Marker für ein Objekt eingeben. 1. Wählen Sie **Save Changes (Änderungen speichern)**. Amazon S3 fügt die Markierungen zu den angegebenen Objekten hinzu. Weitere Informationen finden Sie auch unter [Anzeigen von Objekteigenschaften in der Amazon-S3-Konsole](view-object-properties.md) und [Objekte hochladen](upload-objects.md) in diesem Handbuch. ## Verwenden Sie den AWS SDKs ------ #### [ Java ] Um Objekt-Tags mit dem AWS SDK for Java zu verwalten, können Sie Tags für ein neues Objekt festlegen und Tags für ein vorhandenes Objekt abrufen oder ersetzen. Weitere Informationen über das Markieren von Objekten finden Sie unter [Kategorisierung Ihrer Objekte mit Hilfe von Tags](object-tagging.md). Laden Sie ein Objekt mit einem S3Client in einen Bucket hoch und legen Sie Tags fest. Beispiele finden Sie unter [Ein Objekt in einen Bucket hochladen](https://docs.aws.amazon.com/AmazonS3/latest/API/s3_example_s3_PutObject_section.html) in der *Amazon S3 API Referenz*. ------ #### [ .NET ] Das folgende Beispiel zeigt, wie Sie mithilfe von AWS SDK für .NET die Tags für ein neues Objekt festlegen und die Tags für ein vorhandenes Objekt abrufen oder ersetzen können. Weitere Informationen über das Markieren von Objekten finden Sie unter [Kategorisierung Ihrer Objekte mit Hilfe von Tags](object-tagging.md). Informationen zum Einrichten und Ausführen der Codebeispiele finden Sie unter [Getting Started with the AWS SDK for .NET](https://docs.aws.amazon.com/sdk-for-net/latest/developer-guide/net-dg-setup.html) im *AWS SDK for .NET Developer Guide*. ``` using Amazon; using Amazon.S3; using Amazon.S3.Model; using System; using System.Collections.Generic; using System.Threading.Tasks; namespace Amazon.DocSamples.S3 { public class ObjectTagsTest { private const string bucketName = "*** bucket name ***"; private const string keyName = "*** key name for the new object ***"; private const string filePath = @"*** file path ***"; // Specify your bucket region (an example region is shown). private static readonly RegionEndpoint bucketRegion = RegionEndpoint.USWest2; private static IAmazonS3 client; public static void Main() { client = new AmazonS3Client(bucketRegion); PutObjectWithTagsTestAsync().Wait(); } static async Task PutObjectWithTagsTestAsync() { try { // 1. Put an object with tags. var putRequest = new PutObjectRequest { BucketName = bucketName, Key = keyName, FilePath = filePath, TagSet = new List{ new Tag { Key = "Keyx1", Value = "Value1"}, new Tag { Key = "Keyx2", Value = "Value2" } } }; PutObjectResponse response = await client.PutObjectAsync(putRequest); // 2. Retrieve the object's tags. GetObjectTaggingRequest getTagsRequest = new GetObjectTaggingRequest { BucketName = bucketName, Key = keyName }; GetObjectTaggingResponse objectTags = await client.GetObjectTaggingAsync(getTagsRequest); for (int i = 0; i < objectTags.Tagging.Count; i++) Console.WriteLine("Key: {0}, Value: {1}", objectTags.Tagging[i].Key, objectTags.Tagging[i].Value); // 3. Replace the tagset. Tagging newTagSet = new Tagging(); newTagSet.TagSet = new List{ new Tag { Key = "Key3", Value = "Value3"}, new Tag { Key = "Key4", Value = "Value4" } }; PutObjectTaggingRequest putObjTagsRequest = new PutObjectTaggingRequest() { BucketName = bucketName, Key = keyName, Tagging = newTagSet }; PutObjectTaggingResponse response2 = await client.PutObjectTaggingAsync(putObjTagsRequest); // 4. Retrieve the object's tags. GetObjectTaggingRequest getTagsRequest2 = new GetObjectTaggingRequest(); getTagsRequest2.BucketName = bucketName; getTagsRequest2.Key = keyName; GetObjectTaggingResponse objectTags2 = await client.GetObjectTaggingAsync(getTagsRequest2); for (int i = 0; i < objectTags2.Tagging.Count; i++) Console.WriteLine("Key: {0}, Value: {1}", objectTags2.Tagging[i].Key, objectTags2.Tagging[i].Value); } catch (AmazonS3Exception e) { Console.WriteLine( "Error encountered ***. Message:'{0}' when writing an object" , e.Message); } catch (Exception e) { Console.WriteLine( "Encountered an error. Message:'{0}' when writing an object" , e.Message); } } } } ``` ------