Arbeiten mit Objekt-Metadaten

Sie können Objekt-Metadaten in Amazon S3 zum Zeitpunkt des Hochladens des Objekts festlegen. Objekt-Metadaten bestehen aus Name/Wert-Paaren. Nachdem Sie das Objekt hochgeladen haben, können Sie Objekt-Metadaten nicht mehr ändern. Die einzige Methode, wie Sie Objekt-Metadaten ändern können, ist es, eine Kopie des Objekts anzulegen und die Metadaten festzulegen.

Wenn Sie ein Objekt erstellen, geben Sie auch den Schlüsselnamen an, der das Objekt in dem Bucket eindeutig identifiziert. Der Objektschlüssel (oder Schlüsselname) identifiziert das Objekt in einem Amazon-S3-Bucket eindeutig. Weitere Informationen finden Sie unter Erstellen von Objektschlüsselnamen.

Es gibt zweierlei Arten von Metadaten in Amazon S3: systemdefinierte und benutzerdefinierte Metadaten. In den folgenden Abschnitten finden Sie weitere Informationen zu systemdefinierten und benutzerdefinierten Metadaten. Weitere Informationen zum Bearbeiten von Metadaten mit der Amazon-S3-Konsole finden Sie unter Bearbeiten von Objektmetadaten in der Amazon-S3-Konsole.

Systemdefinierte Objektmetadaten

Amazon S3 verwaltet für jedes in einem Bucket gespeicherte Objekt einen Satz Systemmetadaten. Amazon S3 verarbeitet diese Systemmetadaten nach Bedarf. Beispielsweise verwaltet Amazon S3 das Erstellungsdatum eines Objekts und seine Größe als Metadaten und verwendet dies Information für die Objektverwaltung.

Es gibt zwei Kategorien von Systemmetadaten:

• Systemdefiniert – Metadaten wie beispielsweise das Erstellungsdatum eines Objekts werden vom System definiert. Dies bedeutet, dass nur Amazon S3 den Wert ändern kann.

• Benutzerdefiniert – Andere Systemmetadaten, wie beispielsweise die für das Objekt konfigurierte Speicherklasse und die Angabe, ob für das Objekt eine serverseitige Verschlüsselung aktiviert ist, sind Beispiele für Metadaten, deren Werte Sie definieren können. Wenn Ihr Bucket als Website konfiguriert ist, möchten Sie manchmal eine Seitenanfrage auf eine andere oder externe URL Seite umleiten. In diesem Fall ist eine Webseite ein Objekt in Ihrem Bucket. Amazon S3 speichert den Wert für die Seitenumleitung als Systemmetadaten, deren Wert Sie steuern können.

  Wenn Sie Objekte erstellen, können Sie die Werte dieser Systemmetadaten konfigurieren oder sie nach Bedarf aktualisieren. Weitere Informationen über Speicherklassen finden Sie unter Verwenden von Amazon-S3-Speicherklassen.

  Amazon S3 verwendet AWS KMS Schlüssel, um Ihre Amazon S3 S3-Objekte zu verschlüsseln. AWS KMS verschlüsselt nur die Objektdaten. Die Prüfsumme wird zusammen mit dem angegebenen Algorithmus als Teil der Metadaten des Objekts gespeichert. Wenn für das Objekt eine serverseitige Verschlüsselung angefordert wird, wird die Prüfsumme in verschlüsselter Form gespeichert. Weitere Informationen zur serverseitigen Verschlüsselung finden Sie unter Datenschutz durch Verschlüsselung.

Anmerkung

Der PUT-Anforderungs-Header ist auf eine Größe von 8 KB begrenzt. Innerhalb des PUT-Anforderungs-Headers sind die systemdefinierten Metadaten auf eine Größe von 2 KB begrenzt. Die Größe systemdefinierter Metadaten wird anhand der Summe der Anzahl der Byte in der ASCII US-Kodierung jedes Schlüssels und Werts gemessen.

Die folgenden Tabelle enthält eine Liste der vom System definierten Metadaten, und gibt an, ob Sie sie aktualisieren können.

Name	Beschreibung	Kann der Benutzer den Wert ändern?
Date	Aktuelles Datum und Uhrzeit	Nein
Cache-Control	Ein allgemeines Header-Feld zum Angeben von Caching-Richtlinien.	Ja
Content-Disposition	Darstellungsinformationen zum Objekt.	Ja
Content-Length	Die Objektgröße in Bytes	Nein
Content-Type	Der Typ des Objekts.	Ja
Last-Modified	Das Datum, an dem das Objekt erstellt wurde, oder das letzte Änderungsdatum, je nachdem, welcher Wert aktueller ist Bei mehrteiligen Uploads entspricht das Objekterstellungsdatum dem Startdatum des mehrteiligen Uploads.	Nein
ETag	Ein Entity-Tag (ETag), das eine bestimmte Version eines Objekts darstellt. Bei Objekten, die nicht als mehrteiliger Upload hochgeladen werden und entweder unverschlüsselt oder durch serverseitige Verschlüsselung mit verwalteten Amazon S3 S3-Schlüsseln (SSE-S3) verschlüsselt sind, ETag handelt es sich um eine MD5 Zusammenfassung der Daten.	Nein
x-amz-server-side-encryption	Ein Header, der angibt, ob die serverseitige Verschlüsselung für das Objekt aktiviert ist und ob diese Verschlüsselung die AWS Key Management Service (AWS KMS) -Schlüssel (SSE-KMS) oder die von Amazon S3 verwalteten Verschlüsselungsschlüssel (SSE-S3) verwendet. Weitere Informationen finden Sie unter Schützen von Daten mit serverseitiger Verschlüsselung.	Ja
x-amz-checksum-crc32, x-amz-checksum-crc32c, x-amz-checksum-sha1, x-amz-checksum-sha256	Header, die die Prüfsumme oder den Digest des Objekts enthalten. Je nach Prüfsummenalgorithmus, den Amazon S3 verwenden soll, wird höchstens jeweils einer dieser Header festgelegt. Weitere Informationen zur Auswahl des Prüfsummenalgorithmus finden Sie unter Überprüfung der Objektintegrität.	Nein
x-amz-version-id	Die Objekt-Versionsverwaltung. Wenn Sie die Versionsverwaltung für einen Bucket aktivieren, weist Amazon S3 allen Objekten, die dem Bucket hinzugefügt werden, eine Versions-ID zu. Weitere Informationen finden Sie unter Verwenden der Versioning in S3-Buckets.	Nein
x-amz-delete-marker	Ein boolesches Kennzeichen, das angibt, ob das Objekt eine Löschmarkierung ist. Dieses Kennzeichen wird nur in Buckets verwendet, für die die Versionsverwaltung aktiviert ist.	Nein
x-amz-storage-class	Die Speicherklasse, für die Speicherung des Objekts verwendet wird. Weitere Informationen finden Sie unter Verwenden von Amazon-S3-Speicherklassen.	Ja
x-amz-website-redirect-location	Ein Header, der Anfragen für das zugehörige Objekt an ein anderes Objekt im selben Bucket oder an ein externes Objekt weiterleitet. URL Weitere Informationen finden Sie unter (Optional) Konfigurieren einer Webseitenumleitung.	Ja
x-amz-server-side-encryption-aws-kms-key-id	Ein Header, der die ID des AWS KMS symmetrischen KMS Verschlüsselungsschlüssels angibt, der zur Verschlüsselung des Objekts verwendet wurde. Dieser Header wird nur verwendet, wenn der Header x-amz-server-side-encryption vorhanden ist und den Wert aws:kms aufweist.	Ja
x-amz-server-side-encryption-customer-algorithm	Ein Header, der angibt, ob die serverseitige Verschlüsselung mit vom Kunden bereitgestellten Verschlüsselungsschlüsseln (SSE-C) aktiviert ist. Weitere Informationen finden Sie unter Verwenden Sie serverseitige Verschlüsselung mit vom Kunden bereitgestellten Schlüsseln (-C) SSE.	Ja
x-amz-tagging	Das Tag-Set für das Objekt. Das Tag-Set muss als Abfrageparameter codiert werden. URL	Ja

Benutzerdefinierte Objektmetadaten

Wenn Sie ein Objekt hochladen, können Sie ihm Metadaten zuweisen. Sie geben diese optionalen Informationen als Name-Wert-Paar (Schlüssel-Wert) an, wenn Sie eine PUT- oder POST-Anforderung senden, um das Objekt zu erstellen. Wenn Sie Objekte mithilfe von hochladen RESTAPI, müssen die optionalen benutzerdefinierten Metadatennamen mit beginnen, um sie von anderen x-amz-meta- Headern zu unterscheiden. HTTP Wenn Sie das Objekt mithilfe von abrufen RESTAPI, wird dieses Präfix zurückgegeben. Wenn Sie Objekte mit dem hochladen SOAPAPI, ist das Präfix nicht erforderlich. Wenn Sie das Objekt mithilfe von abrufen SOAPAPI, wird das Präfix entfernt, unabhängig davon, welches API Sie zum Hochladen des Objekts verwendet haben.

Anmerkung

SOAPSupport Over HTTP ist veraltet, SOAP ist aber weiterhin über verfügbar. HTTPS Neue Amazon S3 S3-Funktionen werden nicht unterstütztSOAP. Anstatt zu verwendenSOAP, empfehlen wir, entweder den REST API oder den zu verwenden AWS SDKs.

Wenn Metadaten über die abgerufen werden RESTAPI, fasst Amazon S3 Header mit demselben Namen (ohne Berücksichtigung der Groß- und Kleinschreibung) zu einer kommagetrennten Liste zusammen. Wenn einige Metadaten nicht darstellbare Zeichen enthalten, werden sie nicht zurückgegeben. Stattdessen wird der x-amz-missing-meta-Header mit der Anzahl der nicht darstellbaren Metadateneinträge als Wert zurückgegeben. Die HeadObject-Aktion ruft Metadaten von einem Objekt ab, ohne das Objekt selbst zurückzugeben. Dieser Vorgang ist nützlich, wenn Sie nur an den Metadaten eines Objekts interessiert sind. Um HEAD verwenden zu können, müssen Sie READ-Zugriff auf das Objekt haben. Weitere Informationen finden Sie HeadObjectin der Amazon Simple Storage Service API Reference.

Benutzerdefinierte Metadaten sind Schlüssel/Wert-Paare. Amazon S3 speichert benutzerdefinierte Metadatenschlüssel in Kleinbuchstaben.

Amazon S3 erlaubt beliebige Unicode-Zeichen in Ihren Metadatenwerten.

Um Probleme bei der Darstellung dieser Metadatenwerte zu vermeiden, sollten Sie bei der Verwendung von ASCII US-Zeichen REST und bei der Verwendung von -8 bei der Verwendung von SOAP oder browserbasierten Uploads über die Zeichen UTF -8 einhalten. POST

Wenn Sie in Ihren Metadatenwerten ASCII Nicht-US-Zeichen verwenden, wird die bereitgestellte Unicode-Zeichenfolge auf Nicht-US-Zeichen untersucht. ASCII Die Werte solcher Header werden vor dem Speichern gemäß 2047 dekodiert und gemäß RFC2047 codiert, um sie vor der Rückgabe mailsicher zu machen. RFC Wenn die Zeichenfolge nur ASCII US-Zeichen enthält, wird sie unverändert dargestellt.

Im Folgenden wird ein Beispiel gezeigt.

PUT /Key HTTP/1.1
Host: amzn-s3-demo-bucket1.s3.amazonaws.com
x-amz-meta-nonascii: ÄMÄZÕÑ S3

HEAD /Key HTTP/1.1
Host: amzn-s3-demo-bucket1.s3.amazonaws.com
x-amz-meta-nonascii: =?UTF-8?B?w4PChE3Dg8KEWsODwpXDg8KRIFMz?=

PUT /Key HTTP/1.1
Host: amzn-s3-demo-bucket1.s3.amazonaws.com
x-amz-meta-ascii: AMAZONS3

HEAD /Key HTTP/1.1
Host: amzn-s3-demo-bucket1.s3.amazonaws.com
x-amz-meta-ascii: AMAZONS3
		

Anmerkung

Der PUT-Anforderungs-Header ist auf eine Größe von 8 KB begrenzt. Innerhalb des PUT-Anforderungs-Headers sind die benutzerdefinierten Metadaten auf eine Größe von 2 KB begrenzt. Die Größe benutzerdefinierter Metadaten wird anhand der Summe der Byteanzahl in der UTF -8-Kodierung jedes Schlüssels und Werts gemessen.

Informationen zum Ändern der Metadaten Ihres Objekts, nachdem das Objekt hochgeladen wurde, indem eine Kopie des Objekts erstellt und geändert und das alte Objekt ersetzt wurde oder indem eine neue Version erstellt wurde, finden Sie unter Bearbeiten von Objektmetadaten in der Amazon-S3-Konsole.