Utilizzo dei metadati degli oggetti

Puoi impostare i metadati degli oggetti in Amazon S3 al momento del caricamento dell'oggetto. I metadati dell'oggetto sono invece un set di coppie nome-valore Una volta caricato l'oggetto, non è possibile modificare i metadata corrispondenti. L'unico modo per modificarli è eseguire una copia dell'oggetto e impostare i metadata.

Quando si crea un oggetto, viene specificato anche il nome della chiave che lo identifica in modo univoco nel bucket. La chiave oggetto (o nome di chiave) identifica l'oggetto in modo univoco in un bucket Amazon S3. Per ulteriori informazioni, consulta Denominazione degli oggetti Amazon S3.

Esistono due tipi di metadati in Amazon S3: metadati definiti dal sistema e metadati definiti dall'utente. Le sezioni seguenti forniscono ulteriori informazioni sui metadati definiti dal sistema e definiti dall'utente. Per ulteriori informazioni sulla modifica dei metadati tramite la console di Amazon S3, consulta Modifica dei metadati degli oggetti nella console di Amazon S3.

Metadata di oggetti definiti dal sistema

Per ogni oggetto archiviato in un bucket, Amazon S3 mantiene un set di metadati di sistema. Questi metadati vengono elaborati da Amazon S3 in base alle necessità. Ad esempio, Amazon S3 mantiene i metadati sulla dimensione e sulla data di creazione degli oggetti e utilizza queste informazioni come parte della gestione degli oggetti.

Esistono due categorie di metadata di sistema:

• Controllati dal sistema: i metadati, come la data di creazione dell'oggetto, sono controllati dal sistema e il valore di questi metadati può essere modificato solo da Amazon S3.

• Controllati dall'utente: altri metadata di sistema, come la classe di storage configurata per l'oggetto e se la crittografia lato server è abilitata per l'oggetto, sono esempi di metadata di sistema, il cui valore viene controllato dall'utente. Se il tuo bucket è configurato come sito Web, a volte potresti voler reindirizzare una richiesta di pagina a un'altra pagina o a una pagina esterna. URL In questo caso, la pagina Web è un oggetto nel bucket. Amazon S3 archivia il valore di reindirizzamento della pagina come metadati di sistema, il cui valore può essere controllato dall'utente.

  Quando si creano oggetti, è possibile configurare i valori di questi metadata di sistema o aggiornarli in base alle esigenze. Per ulteriori informazioni sulle classi di storage, consulta Comprensione e gestione delle classi di storage Amazon S3.

  Amazon S3 utilizza AWS KMS le chiavi per crittografare gli oggetti Amazon S3. AWS KMS crittografa solo i dati dell'oggetto. Il checksum, insieme all'algoritmo specificato, vengono archiviati come parte dei metadati dell'oggetto. Se la crittografia lato server viene richiesta per l'oggetto, il checksum viene archiviato in formato crittografato. Per ulteriori informazioni sulla crittografia lato server, consulta Protezione dei dati con la crittografia.

Nota

L'intestazione della richiesta PUT è limitata a una dimensione di 8 KB. Nell'intestazione della richiesta PUT, la dimensione dei metadati definiti dal sistema è limitata a 2 KB. La dimensione dei metadati definiti dal sistema viene misurata sommando il numero di byte nella ASCII codifica US di ogni chiave e valore.

Nella tabella riportata di seguito viene fornito un elenco dei metadata definiti dal sistema e viene indicato se è possibile modificarli.

Nome	Descrizione	L'utente può modificare il valore?
Date	Data e ora correnti.	No
Cache-Control	Un campo di intestazione generico utilizzato per specificare i criteri di memorizzazione nella cache.	Sì
Content-Disposition	Informazioni relative alla modalità di presentazione dell'oggetto.	Sì
Content-Length	Dimensioni dell'oggetto in byte.	No
Content-Type	Il tipo di oggetto.	Sì
Last-Modified	Data di creazione dell'oggetto o data dell'ultima modifica, scegliendo la più recente delle due. Per i caricamenti in più parti, la data di creazione dell'oggetto è la data di inizio del caricamento in più parti.	No
ETag	Un tag di entità (ETag) che rappresenta una versione specifica di un oggetto. Per gli oggetti che non vengono caricati come caricamento multiparte e non sono crittografati o crittografati mediante crittografia lato server con chiavi gestite di Amazon S3 (SSE-S3), è un riepilogo dei dati. ETag MD5	No
x-amz-server-side-encryption	Un'intestazione che indica se la crittografia lato server è abilitata per l'oggetto e se tale crittografia utilizza le chiavi AWS Key Management Service (AWS KMS) (SSE-KMS) o le chiavi di crittografia gestite di Amazon S3 (-S3). SSE Per ulteriori informazioni, consulta Protezione dei dati con la crittografia lato server.	Sì
x-amz-checksum-crc32, x-amz-checksum-crc32c, x-amz-checksum-sha1, x-amz-checksum-sha256	Intestazioni che contengono il checksum o il digest dell'oggetto. Viene impostata al massimo una intestazione alla volta, a seconda dell'algoritmo di checksum che Amazon S3 deve utilizzare. Per ulteriori informazioni sulla scelta dell'algoritmo di checksum, consulta Verifica dell'integrità degli oggetti.	No
x-amz-version-id	Versione dell'oggetto. Quando abiliti il controllo delle versioni in un bucket, Amazon S3 assegna un ID versione agli oggetti aggiunti al bucket. Per ulteriori informazioni, consulta Conservazione di più versioni di oggetti con S3 Versioning.	No
x-amz-delete-marker	Contrassegno booleano che indica se l'oggetto è un contrassegno di eliminazione. Questo contrassegno viene utilizzato solo nei bucket in cui è abilitato il controllo delle versioni.	No
x-amz-storage-class	Classe di archiviazione utilizzata per l'archiviazione dell'oggetto. Per ulteriori informazioni, consulta Comprensione e gestione delle classi di storage Amazon S3.	Sì
x-amz-website-redirect-location	Un'intestazione che reindirizza le richieste per l'oggetto associato a un altro oggetto nello stesso bucket o a un oggetto esterno. URL Per ulteriori informazioni, consulta (Facoltativo) Configurazione del reindirizzamento di una pagina Web.	Sì
x-amz-server-side-encryption-aws-kms-key-id	Un'intestazione che indica l'ID della KMS chiave di crittografia AWS KMS simmetrica utilizzata per crittografare l'oggetto. Questa intestazione viene utilizzata solo quando è presente l'intestazione x-amz-server-side-encryption e ha il valore aws:kms.	Sì
x-amz-server-side-encryption-customer-algorithm	Un'intestazione che indica se la crittografia lato server con chiavi di crittografia fornite dal cliente (-C) è abilitata. SSE Per ulteriori informazioni, consulta Utilizzo della crittografia lato server con chiavi fornite dal cliente (-C) SSE.	Sì
x-amz-tagging	Il set di tag per l'oggetto. Il set di tag deve essere codificato come parametri di Query. URL	Sì

Metadati di oggetti definiti dall'utente

Quando si carica un oggetto, è anche possibile assegnare metadata a esso. Queste informazioni facoltative vengono fornite come coppia nome-valore (chiave-valore) quando si invia una richiesta PUT o POST per creare l'oggetto. Quando caricate oggetti utilizzando il RESTAPI, i nomi facoltativi dei metadati definiti dall'utente devono iniziare con x-amz-meta- per distinguerli dalle altre intestazioni. HTTP Quando recuperate l'oggetto utilizzando RESTAPI, viene restituito questo prefisso. Quando caricate oggetti utilizzando il SOAPAPI, il prefisso non è obbligatorio. Quando recuperate l'oggetto utilizzando il SOAPAPI, il prefisso viene rimosso, indipendentemente dal prefisso utilizzato per caricare l'oggetto. API

Nota

SOAPsupport over HTTP è obsoleto, ma SOAP è ancora disponibile su. HTTPS Le nuove funzionalità di Amazon S3 non sono supportate per. SOAP Invece di utilizzareSOAP, ti consigliamo di utilizzare il REST API o il AWS SDKs.

Quando i metadati vengono recuperati tramite RESTAPI, Amazon S3 combina le intestazioni con lo stesso nome (senza maiuscole e minuscole) in un elenco delimitato da virgole. I metadata contenenti caratteri non stampabili non vengono restituiti. Al contrario, viene restituita l'intestazione x-amz-missing-meta con il numero di voci di metadata non stampabili come valore. L'operazione HeadObject richiama i metadati da un oggetto senza restituire l'oggetto stesso. Questa operazione è utile se sei interessato solo ai metadati di un oggetto. Per utilizzare HEAD è necessario disporre dell'accesso READ all'oggetto. Per ulteriori informazioni, consulta HeadObjectAmazon Simple Storage Service API Reference.

I metadata definiti dall'utente sono un set di coppie chiave-valore. Amazon S3 archivia le chiavi dei metadati definiti dall'utente in caratteri minuscoli.

Amazon S3 consente caratteri Unicode arbitrari nei valori dei metadati.

Per evitare problemi relativi alla presentazione di questi valori di metadati, dovresti utilizzare i ASCII caratteri US- quando usi REST e UTF -8 quando usi SOAP o carichi tramite browser. POST

Quando si utilizzano ASCII caratteri diversi dagli Stati Uniti nei valori dei metadati, la stringa Unicode fornita viene esaminata alla ricerca di caratteri diversi dagli Stati Uniti. ASCII I valori di tali intestazioni vengono decodificati in base al 2047 prima della memorizzazione e codificati secondo il RFC2047 per renderli sicuri per la posta elettronica prima della restituzione. RFC Se la stringa contiene solo ASCII caratteri statunitensi, viene presentata così com'è.

Di seguito è riportato un esempio.

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

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

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

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

Nota

L'intestazione della richiesta PUT è limitata a una dimensione di 8 KB. Nell'intestazione della richiesta PUT, la dimensione dei metadata definiti dall'utente è limitata a 2 KB. La dimensione dei metadati definiti dall'utente viene misurata prendendo la somma del numero di byte nella codifica UTF -8 di ogni chiave e valore.

Per informazioni sulla modifica dei metadati dell'oggetto dopo il caricamento mediante la creazione di una copia dell'oggetto, la modifica e la sostituzione dell'oggetto precedente o la creazione di una nuova versione, consulta Modifica dei metadati degli oggetti nella console di Amazon S3.