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à.

Caricamento e copia di oggetti utilizzando il caricamento in più parti

Il caricamento in più parti consente di caricare un singolo oggetto come un insieme di parti. Ciascuna parte è una parte contigua dei dati dell'oggetto. È possibile caricare queste parti dell'oggetto in modo indipendente e in qualsiasi ordine. Se la trasmissione di una parte non riesce, è possibile ritrasmettere tale parte senza influire sulle altre. Una volta caricate tutte le parti dell'oggetto, Amazon S3 le assembla e crea l'oggetto. In generale, quando la dimensione dell'oggetto raggiunge i 100 MB, si consiglia di valutare la possibilità di eseguire caricamenti in più parti anziché caricare l'oggetto in una singola operazione.

Il caricamento in più parti comporta i vantaggi riportati di seguito.

È consigliabile utilizzare il caricamento in più parti come indicato di seguito:

Processo di caricamento in più parti

Il caricamento in più parti è un processo in tre fasi: avvio del caricamento, caricamento delle parti dell'oggetto e, una volta completato il caricamento di tutte le parti, completamento del caricamento in più parti. Quando riceve la conferma di completamento del caricamento in più parti, Amazon S3 crea l'oggetto dalle singole parti caricate. È quindi possibile accedere all'oggetto così come avviene con qualsiasi altro oggetto nel bucket.

È possibile elencare tutti i caricamenti in più parti in corso oppure ottenere un elenco delle parti caricate per un caricamento in più parti specifico. Ognuna di queste operazioni viene descritta in questa sezione.

Avvio del caricamento in più parti

Quando invii una richiesta di avvio di un caricamento in più parti, Amazon S3 restituisce una risposta con un ID di caricamento, che è un identificativo univoco per il caricamento in più parti. È necessario includere questo ID di caricamento ogni volta che si caricano o si elencano le parti oppure ogni volta che si completa o si interrompe un caricamento. Se si desidera fornire metadata che descrivano l'oggetto in fase di caricamento, è necessario specificarli nella richiesta di avvio del caricamento in più parti.

Caricamento delle parti

Quando si carica una parte, oltre all'ID di caricamento è necessario specificare il numero della parte. È possibile scegliere qualsiasi numero compreso tra 1 e 10.000. Il numero della parte identifica in modo univoco una parte e la relativa posizione nell'oggetto che si sta caricando. Il numero della parte scelto non deve essere in sequenza (ad esempio può essere 1, 5 e 14). Se si carica una nuova parte che utilizza lo stesso numero di una parte caricata in precedenza, quest'ultima viene sovrascritta.

Quando carichi una parte, Amazon S3 restituisce un tag di entità (ETag) per la parte come intestazione nella risposta. Per ogni caricamento di una parte, devi registrare il numero e il valore della ETag parte. Occorre includere questi valori nella successiva richiesta di complemento del caricamento in più parti. Ogni parte avrà il suo ETag al momento del caricamento. Tuttavia, una volta completato il caricamento in più parti e consolidate tutte le parti, tutte le parti saranno riunite in un'unica sezione sotto ETag forma di checksum.

Completamento del caricamento in più parti

Una volta completato un caricamento in più parti, Amazon S3 crea un oggetto concatenando le parti in ordine crescente in base al numero della parte. Se nella richiesta di avvio del caricamento in più parti sono stati forniti i metadati dell'oggetto, Amazon S3 li associa all'oggetto. Una volta completata la richiesta, le parti non esisteranno più.

La richiesta di caricamento multiparte completa deve includere l'ID di caricamento e un elenco dei numeri di parte e dei valori corrispondenti. ETag La risposta di Amazon S3 include un codice ETag che identifica in modo univoco i dati combinati dell'oggetto. Questo non ETag è necessariamente un MD5 hash dei dati dell'oggetto.

Chiamate di caricamento in più parti di esempio

Per questo esempio, si supponga di generare un caricamento in più parti di un file da 100 GB. In questo caso, avresti le seguenti API chiamate per l'intero processo. Ci sarebbero un totale di 1002 API chiamate.

Elenchi dei caricamenti in più parti

È possibile elencare le parti di un caricamento in più parti specifico o tutti i caricamenti in più parti in corso. L'operazione di creazione dell'elenco delle parti restituisce informazioni sulle parti coinvolte in un caricamento in più parti specifico. Per ogni richiesta di elenco delle parti, Amazon S3 restituisce informazioni sulle parti per il caricamento in più parti specificato, fino a un massimo di 1000 parti. Se nel caricamento sono presenti più di 1000 parti, è necessario inviare una serie di richieste di elenco delle parti per recuperare tutte le parti. Tieni presente che l'elenco di parti restituito non include le parti per le quali non è stato completato il caricamento. L'operazione list multipart uploads (elenco dei caricamenti in più parti) consente di ottenere l'elenco dei caricamenti in più parti in corso.

Un caricamento in più parti in corso è un caricamento avviato, ma non ancora completato o annullato. Ogni richiesta restituisce al massimo 1.000 caricamenti in più parti. Se sono in corso più di 1.000 caricamenti in più parti, è necessario inviare richieste aggiuntive per recuperare i caricamenti rimanenti. Utilizza l'elenco restituito solo per la verifica. Non utilizzarlo per inviare la richiesta complete multipart upload (completamento del caricamento in più parti). Gestisci invece il tuo elenco dei codici articolo che hai specificato durante il caricamento delle parti e i ETag valori corrispondenti restituiti da Amazon S3.

Checksum con operazioni di caricamento in più parti

Quando carichi un oggetto in Amazon S3 puoi specificare un algoritmo di checksum che Amazon S3 deve utilizzare. Amazon S3 utilizza per impostazione MD5 predefinita la verifica dell'integrità dei dati; tuttavia, puoi specificare un algoritmo di checksum aggiuntivo da utilizzare. Quando viene utilizzatoMD5, Amazon S3 calcola il checksum dell'intero oggetto multiparte dopo il completamento del caricamento. Questo checksum non è un checksum dell'intero oggetto, ma il checksum dei checksum di ogni singola parte.

Quando chiedi ad Amazon S3 di utilizzare checksum aggiuntivi, Amazon S3 calcola il valore del checksum per ogni parte e archivia i valori. Puoi usare API o SDK per recuperare il valore del checksum per le singole parti utilizzando o. GetObject HeadObject Se desideri recuperare i valori di checksum per singole parti di caricamenti in più parti ancora in corso, puoi utilizzare ListParts.

Per ulteriori informazioni su come funzionano i checksum con oggetti di caricamento in più parti, consulta. Verifica dell'integrità degli oggetti

Per una end-to-end procedura sul caricamento di un oggetto con caricamento in più parti con un checksum aggiuntivo, consulta. Tutorial: carica un oggetto tramite caricamento in più parti e verifica l'integrità dei dati

Operazioni simultanee di caricamento in più parti

In un ambiente di sviluppo distribuito è possibile che l'applicazione avvii più aggiornamenti sullo stesso oggetto contemporaneamente. L'applicazione potrebbe avviare vari caricamenti in più parti utilizzando la stessa chiave dell'oggetto. Per ciascuno di questi caricamenti, l'applicazione può quindi caricare le parti e inviare una richiesta di completamento del caricamento ad Amazon S3 per creare l'oggetto. Se per i bucket è abilitato il controllo delle versioni S3, il completamento di un caricamento in più parti crea sempre una nuova versione. Quando avviate più caricamenti in più parti che utilizzano la stessa chiave oggetto in un bucket abilitato al controllo delle versioni, la versione corrente dell'oggetto viene determinata in base a quale caricamento è iniziato più di recente (). createdDate Ad esempio, supponete di iniziare una richiesta per un CreateMultipartUpload oggetto alle 10:00. Quindi inviate una seconda CreateMultipartUpload richiesta per lo stesso oggetto alle 11:00. Poiché la seconda richiesta è stata inviata più di recente, l'oggetto caricato dalla richiesta delle 11:00 sarà la versione corrente, anche se il primo caricamento viene completato dopo il secondo. Per i bucket per i quali non è abilitata la funzione Controllo delle versioni, è possibile che altre richieste ricevute nel periodo di tempo compreso tra l'avvio e il completamento di un caricamento in più parti abbiano la precedenza.

Impedite il caricamento di oggetti con nomi chiave identici durante il caricamento in più parti

Puoi verificare l'esistenza di un oggetto nel tuo bucket prima di crearlo utilizzando operazioni condizionali di scrittura durante il caricamento. Questo può impedire la sovrascrittura dei dati esistenti. Le scritture condizionali verificheranno che nel bucket non è già presente alcun oggetto con lo stesso nome chiave durante il caricamento.

Puoi usare le scritture condizionali per PutObjecto CompleteMultipartUploadrichieste.

Per ulteriori informazioni sulle richieste condizionali, vedere,Aggiungi precondizioni alle operazioni S3 con richieste condizionali.

Caricamento in più parti e prezzi

Una volta avviato un caricamento in più parti, Amazon S3 mantiene tutte le parti finché il caricamento non viene completato o interrotto. Per tutta la durata del processo, all'utente vengono fatturati i costi per lo storage, la larghezza di banda e le richieste per questo tipo di caricamento e per le parti associate.

Queste parti vengono addebitate in base alla classe di archiviazione specificata al momento del caricamento delle parti. Restrizioni di parti caricate in S3 Glacier Flexible Retrieval o di S3 Glacier Deep Archive. Le parti multiparte in corso per la classe di storage S3 Glacier Flexible PUT Retrieval vengono fatturate come S3 Glacier Flexible Retrieval Staging Storage alle tariffe di storage S3 Standard fino al completamento del caricamento. Inoltre, entrambi vengono fatturati alle tariffe S3 Standard. CreateMultipartUpload UploadPart Solo la CompleteMultipartUpload richiesta viene fatturata alla tariffa S3 Glacier Flexible Retrieval. Analogamente, le parti multiparte in corso per una classe di storage superiore PUT a S3 Glacier Deep Archive vengono fatturate come S3 Glacier Flexible Retrieval Staging Storage alle tariffe di storage S3 Standard fino al completamento del caricamento, con solo la richiesta addebitata alle tariffe di S3 Glacier Deep Archive. CompleteMultipartUpload

Se interrompi il caricamento in più parti, Amazon S3 elimina i manufatti del caricamento e le parti caricate e all'utente non viene più addebitato alcun costo. Non sono previsti costi di cancellazione anticipata per l'eliminazione di caricamenti incompleti in più parti indipendentemente dalla classe di archiviazione specificata. Per ulteriori informazioni sui prezzi, consulta la sezione Prezzi di Amazon S3.

Supporto API per il caricamento in più parti

Queste librerie forniscono un'astrazione di alto livello che semplifica il caricamento di oggetti di caricamento in più parti. Tuttavia, se l'applicazione lo richiede, è possibile utilizzarli direttamente. REST API Le seguenti sezioni di Amazon Simple Storage Service API Reference descrivono REST API il caricamento in più parti.

Per una procedura dettagliata di caricamento in più parti che utilizza le funzioni AWS Lambda, consulta Caricamento di oggetti di grandi dimensioni su Amazon S3 utilizzando l'accelerazione di caricamento e trasferimento in più parti.

AWS Command Line Interface supporto per il caricamento in più parti

Gli argomenti seguenti AWS Command Line Interface descrivono le operazioni per il caricamento in più parti.

Supporto AWS SDK per il caricamento in più parti

È possibile utilizzare an AWS SDKs per caricare un oggetto in più parti. Per un elenco delle API azioni AWS SDKs supportate, consulta:

Caricamento API e autorizzazioni in più parti

Per eseguire le operazioni di caricamento in più parti, devi disporre delle autorizzazioni necessarie. È possibile utilizzare gli elenchi di controllo degli accessi (ACLs), la policy bucket o la policy utente per concedere alle persone le autorizzazioni necessarie per eseguire queste operazioni. La tabella seguente elenca le autorizzazioni richieste per varie operazioni di caricamento in più parti quando si utilizza ACLs una policy bucket o una policy utente.

Per informazioni sulla relazione tra ACL autorizzazioni e autorizzazioni nelle politiche di accesso, consulta. Mappatura delle autorizzazioni e delle ACL autorizzazioni relative alle politiche di accesso Per informazioni su IAM utenti, ruoli e procedure consigliate, consulta IAMle identità (utenti, gruppi di utenti e ruoli) nella Guida per l'IAMutente.