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à.
Copiare, spostare e rinominare oggetti
L'CopyObject
operazione crea una copia di un oggetto già archiviato in Amazon S3.
Puoi creare una copia di un oggetto fino a 5 GB in una singola operazione atomica. Tuttavia, per copiare un oggetto di dimensioni superiori a 5 GB, è necessario utilizzare un caricamento in più parti. Per ulteriori informazioni, consulta Copia di un oggetto utilizzando il caricamento in più parti.
L'operazione CopyObject
consente di effettuare le seguenti operazioni:
-
Create copie aggiuntive degli oggetti.
-
Rinomina gli oggetti copiandoli ed eliminando quelli originali.
-
Copia o sposta gli oggetti da un bucket all'altro, anche trasversalmente Regioni AWS (ad esempio, da a).
us-west-1
eu-west-2
Quando sposti un oggetto, Amazon S3 copia l'oggetto nella destinazione specificata e quindi elimina l'oggetto di origine.Nota
La copia o lo spostamento di oggetti da una parte all'altra Regioni AWS comporta costi di larghezza di banda. Per ulteriori informazioni, consulta Prezzi di Amazon S3
. -
Modifica i metadati degli oggetti. Ogni oggetto Amazon S3 ha metadati. Questi metadati sono un insieme di coppie nome-valore. È possibile impostare i metadati degli oggetti al momento del caricamento di un oggetto. Dopo aver caricato l'oggetto, non è possibile modificare i metadati dell'oggetto. L'unico modo per modificarli è eseguire una copia dell'oggetto e impostare i metadata. A tale scopo, nell'operazione di copia, impostate lo stesso oggetto come origine e destinazione.
Alcuni metadati degli oggetti sono metadati di sistema, mentre altri sono definiti dall'utente. È possibile controllare alcuni metadati di sistema. Ad esempio, è possibile controllare la classe di archiviazione e il tipo di crittografia lato server da utilizzare per l'oggetto. Quando si copia un oggetto, vengono copiati anche i metadata di sistema controllati dall'utente e i metadata definiti dall'utente. Amazon S3 reimposta i metadati controllati dal sistema. Ad esempio, quando copi un oggetto, Amazon S3 reimposta la data di creazione dell'oggetto copiato. Non è necessario impostare nessuno di questi valori di metadati controllati dal sistema nella richiesta di copia.
Quando si copia un oggetto, si potrebbe decidere di aggiornare alcuni dei valori dei metadata. Ad esempio, se l'oggetto di origine è configurato per utilizzare l'archiviazione S3 Standard, puoi scegliere di utilizzare S3 Intelligent-Tiering per la copia dell'oggetto. È anche possibile decidere di modificare alcuni dei valori dei metadata definiti dall'utente presenti nell'oggetto di origine. Se scegli di aggiornare uno qualsiasi dei metadati configurabili dall'utente (metadati di sistema o definiti dall'utente) dell'oggetto durante la copia, devi specificare in modo esplicito nella richiesta tutti i metadati configurabili dall'utente presenti nell'oggetto di origine, anche se stai modificando solo uno dei valori dei metadati.
Per ulteriori informazioni sui metadata degli oggetti, consulta Utilizzo dei metadati degli oggetti.
Copia di oggetti archiviati e ripristinati
Se l'oggetto di origine viene archiviato in Recupero flessibile Amazon S3 Glacier o Deep Archive Amazon S3 Glacier, è necessario ripristinare una copia temporanea prima di poter copiare l'oggetto in un altro bucket. Per ulteriori informazioni sull'archiviazione degli oggetti, consulta la sezione Trasferimento nelle classi di archiviazione S3 Glacier Flexible Retrieval e S3 Glacier Deep Archive (archiviazione di oggetti).
L'operazione Copy nella console Amazon S3 non è supportata per gli oggetti ripristinati nelle classi di storage S3 Glacier Flexible Retrieval o S3 Glacier Deep Archive. Per copiare questi oggetti ripristinati, usa AWS Command Line Interface (AWS CLI), gli AWS SDK o l'API REST di Amazon S3.
Copiare oggetti crittografati
Amazon S3 esegue automaticamente la crittografa di tutti i nuovi oggetti copiati in un bucket S3. Se non si specificano le informazioni di crittografia nella richiesta di copia, la crittografia dell'oggetto di destinazione viene impostata sulla configurazione di crittografia predefinita del bucket di destinazione. Per impostazione predefinita, tutti i bucket hanno un livello di crittografia di base che utilizza la crittografia lato server con chiavi gestite da Amazon S3 (SSE-S3). Se il bucket di destinazione ha una configurazione di crittografia predefinita che utilizza la crittografia lato server con una chiave AWS Key Management Service (AWS KMS) (SSE-KMS) o una chiave di crittografia fornita dal cliente (SSE-C), Amazon S3 utilizza la chiave KMS corrispondente o una chiave fornita dal cliente per crittografare la copia dell'oggetto di destinazione.
Quando copi un oggetto, se desideri utilizzare un tipo diverso di impostazione di crittografia per l'oggetto di destinazione, puoi richiedere che Amazon S3 crittografi l'oggetto di destinazione con una chiave KMS, una chiave gestita Amazon S3 o una chiave fornita dal cliente. Se l'impostazione di crittografia nella richiesta è diversa dalla configurazione di crittografia predefinita del bucket di destinazione, l'impostazione di crittografia nella richiesta ha la priorità. Se l'oggetto di origine della copia è crittografato con SSE-C, devi fornire le informazioni di crittografia necessarie nella richiesta in modo che Amazon S3 possa decrittografare l'oggetto per la copia. Per ulteriori informazioni, consulta Protezione dei dati con la crittografia.
Utilizzo dei checksum per la copia di oggetti
Durante la copia di oggetti puoi scegliere di utilizzare un algoritmo di checksum diverso per l'oggetto. Sia che si scelga di utilizzare lo stesso algoritmo o uno nuovo, Amazon S3 calcola un nuovo valore di checksum dopo la copia dell'oggetto. Amazon S3 non copia direttamente il valore del checksum. Il valore del checksum degli oggetti che sono stati caricati utilizzando caricamenti in più parti potrebbe cambiare. Per ulteriori informazioni sul calcolo del checksum, consulta Utilizzo di checksum a livello di parte per caricamenti in più parti.
Copiare più oggetti in un'unica richiesta
Per copiare più di un oggetto Amazon S3 con una singola richiesta, puoi anche utilizzare S3 Batch Operations. Fornisci alle operazioni in batch S3 un elenco di oggetti su cui operare. Le operazioni in batch S3 richiamano la rispettiva API per eseguire l'operazione specificata. Un solo processo di operazioni in batch può eseguire l'operazione specificata su miliardi di oggetti contenenti esabyte di dati.
La funzionalità S3 Batch Operations tiene traccia dell'avanzamento, invia notifiche e archivia un report di completamento dettagliato di tutte le operazioni, offrendo un'esperienza serverless revisionabile completamente gestita. Puoi utilizzare S3 Batch Operations tramite la console Amazon S3 AWS CLI AWS , gli SDK o l'API REST. Per ulteriori informazioni, consulta Nozioni di base sulle operazioni in batch S3.
Copiare oggetti in bucket di directory
Per informazioni sulla copia di un oggetto in un bucket di directory, vedere. Copia di un oggetto in un bucket di directory Per informazioni sull'utilizzo della classe di storage Amazon S3 Express One Zone con bucket di directory, consulta e. Che cos'è S3 Express One Zone? Bucks di directory
Per copiare un oggetto
Per copiare un oggetto utilizza i metodi riportati di seguito.
Nota
-
Quando si copia un oggetto utilizzando la console Amazon S3, è necessario disporre
s3:ListAllMyBuckets
dell'autorizzazione. La console necessita di questa autorizzazione per convalidare l'operazione di copia. Ad esempio, le politiche che concedono questa autorizzazione, vediEsempi di policy basate sull'identità per Amazon S3.Se state copiando un oggetto con tag definiti dall'utente, dovete disporre anche dell'
s3:GetObjectTagging
autorizzazione. Se stai copiando un oggetto che non ha tag definiti dall'utente ma ha una dimensione superiore a 16 MB, devi disporre anche dell'autorizzazione s3:.GetObjectTagging
Se la policy del bucket di destinazione nega l'
s3:GetObjectTagging
azione, l'oggetto verrà copiato senza i tag definiti dall'utente e riceverai un errore. -
Gli oggetti crittografati con chiavi di crittografia fornite dal cliente (SSE-C) non possono essere copiati utilizzando la console S3. Per copiare oggetti crittografati con SSE-C, usa l' AWS CLI AWS SDK o l'API REST di Amazon S3.
-
La copia tra regioni di oggetti crittografati con SSE-KMS non è supportata dalla console Amazon S3. Per copiare oggetti crittografati con SSE-KMS tra regioni, usa l' AWS SDK o l' AWS CLI API REST di Amazon S3.
Per copiare un oggetto
-
Nel riquadro di navigazione a sinistra, scegli Bucket, quindi scegli la scheda Bucket per uso generico. Accedere al bucket o alla cartella Amazon S3 che contiene gli oggetti da copiare.
-
Selezionare la casella di controllo a sinistra dei nomi degli oggetti da copiare.
-
Nel menu Azioni, scegli Copia dall'elenco di opzioni visualizzato.
-
Selezionare il tipo di destinazione e l'account di destinazione. Per specificare il percorso di destinazione, scegliere Browse S3 (Sfoglia S3), passare alla destinazione e selezionare la casella di controllo a sinistra della destinazione. Seleziona Choose destination (Scegli destinazione) nell'angolo in basso a destra.
In alternativa, immettere il percorso di destinazione.
-
Se la funzione Controllo delle versioni del bucket non è abilitata, potrebbe essere richiesto di confermare se gli oggetti esistenti con lo stesso nome debbano essere sovrascritti. Per confermare questa opzione, selezionare la casella di controllo e continuare. Se si desidera mantenere tutte le versioni degli oggetti in questo bucket, selezionare Enable Bucket Versioning (Abilita funzione Controllo delle versioni del bucket). È anche possibile aggiornare le proprietà di default di crittografia e blocco degli oggetti S3.
-
In Additional checksums (Checksum aggiuntivi) scegli se copiare gli oggetti utilizzando la funzione di checksum esistente o sostituirla con una nuova. Al momento del caricamento degli oggetti hai la possibilità di specificare l'algoritmo di checksum utilizzato per verificare l'integrità dei dati. Quando effettui la copia dell'oggetto hai la possibilità di scegliere una nuova funzione. Se originariamente non hai specificato un checksum aggiuntivo puoi utilizzare questa sezione delle opzioni di copia per aggiungerne uno.
Nota
Anche se scegli di utilizzare la stessa funzione di checksum, il valore del checksum potrebbe cambiare se copi un oggetto che ha una dimensione superiore a 16 MB. Il valore del checksum potrebbe cambiare a causa del modo in cui vengono calcolati i checksum per i caricamenti in più parti. Per ulteriori informazioni su come potrebbe cambiare il checksum durante la copia dell'oggetto, consulta Utilizzo di checksum a livello di parte per caricamenti in più parti.
Per modificare la funzione di checksum, scegli Replace with a new checksum function (Sostituisci con una nuova funzione di checksum). Scegli la nuova funzione di checksum dalla casella. Quando l'oggetto viene copiato, il nuovo checksum viene calcolato e memorizzato utilizzando l'algoritmo specificato.
-
Scegli Copy (Copia) nell'angolo in basso a destra. Amazon S3 copia gli oggetti nella destinazione.
Gli esempi in questa sezione mostrano come copiare gli oggetti con dimensioni superiori a 5 GB in una singola operazione. Per copiare oggetti di dimensioni superiori a 5 GB, devi utilizzare un caricamento in più parti. Per ulteriori informazioni, consulta Copia di un oggetto utilizzando il caricamento in più parti.
Questo esempio descrive come copiare un oggetto utilizzando l'API REST di Amazon S3. Per ulteriori informazioni su REST API, consulta CopyObject.
In questo esempio viene copiato l'oggetto flotsam
dal bucket
all'oggetto example-s3-bucket1
jetsam
del bucket
conservandone i metadata.example-s3-bucket2
PUT /jetsam HTTP/1.1 Host:
example-s3-bucket2
.s3.amazonaws.com x-amz-copy-source: /example-s3-bucket1
/flotsam Authorization: AWS AKIAIOSFODNN7EXAMPLE:ENoSbxYByFA0UGLZUqJN5EUnLDg= Date: Wed, 20 Feb 2008 22:12:21 +0000
La firma viene generata dalle seguenti informazioni.
PUT\r\n \r\n \r\n Wed, 20 Feb 2008 22:12:21 +0000\r\n x-amz-copy-source:/
example-s3-bucket1
/flotsam\r\n /example-s3-bucket2
/jetsam
Amazon S3 restituisce la risposta riportata di seguito che specifica l'ETag dell'oggetto e la data dell'ultima modifica.
HTTP/1.1 200 OK x-amz-id-2: Vyaxt7qEbzv34BnSu5hctyyNSlHTYZFMWK4FtzO+iX8JQNyaLdTshL0KxatbaOZt x-amz-request-id: 6B13C3C5B34AF333 Date: Wed, 20 Feb 2008 22:13:01 +0000 Content-Type: application/xml Transfer-Encoding: chunked Connection: close Server: AmazonS3 <?xml version="1.0" encoding="UTF-8"?> <CopyObjectResult> <LastModified>2008-02-20T22:13:01</LastModified> <ETag>"7e9c608af58950deeb370c98608ed097"</ETag> </CopyObjectResult>
Puoi anche usare AWS Command Line Interface (AWS CLI) per copiare un oggetto S3. Per ulteriori informazioni, consulta la sezione copy-object
Per informazioni su AWS CLI, vedete What is the AWS Command Line Interface? nella Guida AWS Command Line Interface per l'utente.
Spostare un oggetto.
Per spostare un oggetto, utilizzate i seguenti metodi.
Nota
-
Se stai spostando un oggetto con tag definiti dall'utente, devi disporre dell'
s3:GetObjectTagging
autorizzazione. Se stai spostando un oggetto che non ha tag definiti dall'utente ma ha una dimensione superiore a 16 MB, devi avere anche l'autorizzazione s3:.GetObjectTagging
Se la policy del bucket di destinazione nega l'
s3:GetObjectTagging
azione, l'oggetto verrà spostato senza i tag definiti dall'utente e riceverai un errore. -
Gli oggetti crittografati con chiavi di crittografia fornite dal cliente (SSE-C) non possono essere spostati utilizzando la console Amazon S3. Per spostare oggetti crittografati con SSE-C, usa gli AWS SDK o l' AWS CLI API REST di Amazon S3.
-
Quando sposti le cartelle, attendi il completamento dell'operazione di spostamento prima di apportare ulteriori modifiche alle cartelle.
-
Non puoi utilizzare gli alias dei punti di accesso S3 come origine o destinazione per le operazioni Move nella console Amazon S3.
Spostare un oggetto.
-
Nel riquadro di navigazione a sinistra, scegli Bucket, quindi scegli la scheda Bucket per uso generico. Passare al bucket o alla cartella Amazon S3 che contiene gli oggetti che si desidera spostare.
-
Selezionare la casella di controllo a sinistra dei nomi degli oggetti che si desidera spostare.
-
Nel menu Azioni, scegli Sposta.
-
Per specificare il percorso di destinazione, scegliere Browse S3 (Sfoglia S3), passare alla destinazione e selezionare la casella di controllo a sinistra della destinazione. Seleziona Choose destination (Scegli destinazione) nell'angolo in basso a destra.
In alternativa, immettere il percorso di destinazione.
-
Se la funzione Controllo delle versioni del bucket non è abilitata, potrebbe essere richiesto di confermare se gli oggetti esistenti con lo stesso nome debbano essere sovrascritti. Per confermare questa opzione, selezionare la casella di controllo e continuare. Se si desidera mantenere tutte le versioni degli oggetti in questo bucket, selezionare Enable Bucket Versioning (Abilita funzione Controllo delle versioni del bucket). È anche possibile aggiornare le proprietà di default di crittografia e blocco degli oggetti.
-
Scegli Copy (Copia) nell'angolo in basso a destra. Amazon S3 sposta i tuoi oggetti nella destinazione.
Nota
-
Questa operazione crea una copia di tutti gli oggetti specificati con impostazioni aggiornate, aggiorna la data dell'ultima modifica nella posizione specificata e aggiunge un contrassegno di eliminazione all'oggetto originale.
-
Questa operazione aggiorna i metadati per la funzione Controllo versioni del bucket, la crittografia, le caratteristiche di blocco degli oggetti e gli oggetti archiviati.
Puoi anche usare il AWS Command Line Interface (AWS CLI) per spostare un oggetto S3. Per ulteriori informazioni, consulta la sezione mv
Per informazioni su AWS CLI, vedete What is the AWS Command Line Interface? nella Guida AWS Command Line Interface per l'utente.
Per rinominare un oggetto
Per rinominare un oggetto, utilizzare la procedura seguente.
Nota
-
La ridenominazione di un oggetto crea una copia dell'oggetto con una nuova data dell'ultima modifica, quindi aggiunge un indicatore di eliminazione all'oggetto originale.
-
Le impostazioni del bucket per la crittografia predefinita vengono applicate automaticamente a qualsiasi oggetto specificato non crittografato.
-
Non puoi utilizzare la console Amazon S3 per rinominare oggetti con chiavi di crittografia fornite dal cliente (SSE-C). Per rinominare oggetti crittografati con SSE-C, usa gli AWS CLI AWS SDK o l'API REST di Amazon S3 per copiare tali oggetti con nuovi nomi.
-
Se questo bucket utilizza l'impostazione imposta dal proprietario del bucket per S3 Object Ownership, le liste di controllo degli accessi agli oggetti (ACL) non verranno copiate.
-
Se stai rinominando un oggetto con tag definiti dall'utente, devi disporre dell'autorizzazione.
s3:GetObjectTagging
Se stai rinominando un oggetto che non ha tag definiti dall'utente ma ha una dimensione superiore a 16 MB, devi avere anche l'autorizzazione s3:.GetObjectTagging
Se la policy del bucket di destinazione nega l'
s3:GetObjectTagging
azione, l'oggetto verrà rinominato, ma i tag definiti dall'utente verranno rimossi dall'oggetto e verrà visualizzato un errore.
Per rinominare un oggetto
-
Nel riquadro di navigazione a sinistra, scegli Bucket, quindi scegli la scheda Bucket per uso generico. Accedi al bucket o alla cartella Amazon S3 che contiene l'oggetto che desideri rinominare.
-
Seleziona la casella di controllo a sinistra del nome dell'oggetto che desideri rinominare.
-
Nel menu Azioni, scegli Rinomina oggetto.
-
Nella casella Nuovo nome oggetto, inserite il nuovo nome per l'oggetto.
-
Scegli Salva modifiche nell'angolo in basso a destra. Amazon S3 rinomina il tuo oggetto.