Utilizzo dei metadati degli oggetti - Amazon Simple Storage Service

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Utilizzo dei metadati degli oggetti

In Amazon S3 esistono due tipi di metadati degli oggetti: metadati definiti dal sistema e metadati definiti dall'utente. I metadati definiti dal sistema includono metadati quali la data di creazione dell'oggetto, la dimensione e la classe di storage. I metadati definiti dall'utente sono metadati che si può scegliere di impostare al momento del caricamento di un oggetto. Questi metadati definiti dall'utente sono un insieme di coppie nome-valore. Per ulteriori informazioni, consulta Metadata di oggetti definiti dal sistema e Metadati di oggetti definiti dall'utente.

Quando si crea un oggetto, si specifica la chiave dell'oggetto (o nome della chiave), che identifica in modo univoco l'oggetto in un bucket Amazon S3. Per ulteriori informazioni, consulta Denominazione di oggetti Amazon S3. È anche possibile impostare metadati definiti dall'utente in Amazon S3 al momento del caricamento dell'oggetto.

Dopo aver caricato l'oggetto, non è possibile modificare i metadati definiti dall'utente. L'unico modo per modificare questi metadati è fare una copia dell'oggetto e impostare i metadati. Per ulteriori informazioni sulla modifica dei metadati tramite la console Amazon S3, consulta Modifica dei metadati degli oggetti nella console di Amazon S3.

Interroga i metadati e accelera la scoperta dei dati con S3 Metadata

Per trovare, memorizzare e interrogare facilmente i metadati degli oggetti S3, è possibile utilizzare S3 Metadata. Con S3 Metadata, è possibile preparare rapidamente i dati per l'utilizzo nelle analisi aziendali, nel recupero dei contenuti, nell'addestramento di modelli di intelligenza artificiale e machine learning (AI/ML) e altro ancora.

S3 Metadata accelera la scoperta dei dati acquisendo automaticamente i metadati per gli oggetti nei bucket generici e archiviandoli in modalità di sola lettura, completamente gestita Apache Iceberg tabelle su cui è possibile interrogare. Queste tabelle di sola lettura sono chiamate tabelle di metadati. Quando gli oggetti vengono aggiunti, aggiornati e rimossi dai bucket per uso generico, S3 Metadata aggiorna automaticamente le tabelle di metadati corrispondenti per riflettere le ultime modifiche.

Per impostazione predefinita, S3 Metadata fornisce metadati degli oggetti definiti dal sistema, come l'ora di creazione e la classe di storage di un oggetto, e metadati personalizzati, come i tag e i metadati definiti dall'utente che sono stati inclusi durante il caricamento dell'oggetto. S3 Metadata fornisce anche i metadati degli eventi, ad esempio quando un oggetto viene aggiornato o eliminato, e il mittente della Account AWS richiesta.

Le tabelle di metadati sono archiviate in bucket di tabelle S3, che forniscono uno storage ottimizzato per i dati tabellari. Per interrogare i metadati, puoi integrare il tuo table bucket con servizi di AWS analisi come Amazon Athena, Amazon Redshift e Amazon. QuickSight

Per ulteriori informazioni su S3 Metadata, consulta Accelerazione della scoperta dei dati con S3 Metadata.

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 conserva i metadati relativi alla data di creazione e alla dimensione degli oggetti, utilizzando queste informazioni come parte della gestione degli oggetti.

Esistono due categorie di metadata di sistema:

  • Controllati dal sistema - Metadati come la data di creazione dell'oggetto sono controllati dal sistema, il che significa che solo Amazon S3 può modificare il valore della data.

  • 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 bucket è configurato come un sito web, a volte si potrebbe voler reindirizzare una richiesta di pagina a un'altra pagina o a un URL esterno. In questo caso, la pagina Web è un oggetto nel bucket. Amazon S3 memorizza il valore di reindirizzamento della pagina come metadati di sistema, che è possibile controllare.

    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 e l'algoritmo specificato sono memorizzati 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 calcolata sommando il numero di byte della codifica US-ASCII 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.
Content-Disposition Informazioni relative alla modalità di presentazione dell'oggetto.
Content-Length Dimensioni dell'oggetto in byte. No
Content-Type Il tipo di oggetto.
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), si tratta di 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 utilizza le chiavi di crittografia gestite di Amazon S3 (SSE-S3). Per ulteriori informazioni, consulta Protezione dei dati con la crittografia lato server.
x-amz-checksum-crc64nvme, 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 in Amazon S3. No
x-amz-checksum-type Il tipo di checksum, che determina il modo in cui i checksum a livello di parte vengono combinati per creare un checksum a livello di oggetto per gli oggetti multiparte.
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 degli oggetti con Controllo delle versioni S3. 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.
x-amz-website-redirect-location Intestazione che reindirizza le richieste per l'oggetto associato a un altro oggetto nello stesso bucket o a un URL esterno. Per ulteriori informazioni, consulta (Facoltativo) Configurazione del reindirizzamento di una pagina Web.
x-amz-server-side-encryption-aws-kms-key-id Un'intestazione che indica l'ID della chiave KMS 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.
x-amz-server-side-encryption-customer-algorithm Intestazione che indica se è abilitata la crittografia lato server con le chiavi di crittografia fornite dal cliente (SSE-C). Per ulteriori informazioni, consulta Utilizzo della crittografia lato server con chiavi fornite dal cliente (SSE-C).
x-amz-tagging Il set di tag per l'oggetto. Il set di tag deve essere codificato sotto forma di parametri della URL Query.

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 si caricano gli oggetti utilizzando la REST API, i nomi facoltativi dei metadati definiti dall'utente devono iniziare con x-amz-meta- per distinguerli dalle altre intestazioni HTTP. Quando si recupera l'oggetto utilizzando REST API, questo prefisso viene restituito. Quando si caricano gli oggetti utilizzando l'API SOAP, il prefisso non è necessario. Quando si recupera l'oggetto mediante l'API SOAP, il prefisso viene rimosso, indipendentemente dall'API utilizzata per caricare l'oggetto.

Nota

Il supporto di SOAP su HTTP non viene più utilizzato ma è ancora disponibile su HTTPS. Le nuove funzioni di Amazon S3 non sono supportate per SOAP. Invece di utilizzare SOAP, ti consigliamo di utilizzare l'API REST o la. AWS SDKs

Quando i metadati vengono recuperati tramite REST API, Amazon S3 riunisce le intestazioni con lo stesso nome (senza distinzione tra 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 il riferimento HeadObjectall'API di Amazon Simple Storage Service.

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 legati alla presentazione di questi valori di metadati, è necessario conformarsi all'uso di caratteri US-ASCII quando si usa REST e UTF-8 quando si usa SOAP o il caricamento via browser attraverso POST.

Quando usi non-US-ASCII caratteri nei valori dei metadati, la stringa Unicode fornita viene esaminata per non-US-ASCII individuare eventuali caratteri. I caratteri dei valori di tali header sono decodificati come da RFC 2047 prima di memorizzarli e codificarli come da RFC 2047 per renderli sicuri per la posta elettronica prima di restituirli. Se la stringa contiene solo caratteri US-ASCII, 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 metadata definiti dall'utente viene calcolata sommando il numero di byte della 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.