Aggiunta di dati agli oggetti nei bucket della directory

È possibile aggiungere dati alla fine di oggetti esistenti memorizzati nella classe di storage S3 Express One Zone in bucket di directory. Si consiglia di utilizzare la possibilità di aggiungere dati a un oggetto se i dati vengono scritti continuamente per un certo periodo di tempo o se è necessario leggere l'oggetto mentre si sta scrivendo sull'oggetto. L'aggiunta di dati agli oggetti è comune per casi d'uso quali l'aggiunta di nuove voci di log ai file di log o l'aggiunta di nuovi segmenti video ai file video durante la transcodifica e lo streaming. Aggiungendo dati agli oggetti, è possibile semplificare le applicazioni che in precedenza combinavano i dati nell'archiviazione locale prima di copiare l'oggetto finale su Amazon S3.

Non esiste un requisito di dimensione minima per i dati che si possono aggiungere a un oggetto. Tuttavia, la dimensione massima dei dati che si possono aggiungere a un oggetto in una singola richiesta è di 5 GB. Questo è lo stesso limite della dimensione massima della richiesta quando si caricano dati utilizzando qualsiasi API Amazon S3.

Con ogni operazione di aggiunta riuscita, si crea una parte dell'oggetto e ogni oggetto può avere fino a 10.000 parti. Ciò significa che è possibile aggiungere dati a un oggetto fino a 10.000 volte. Se un oggetto viene creato utilizzando il caricamento multiparte S3, ogni parte caricata viene conteggiata nel limite massimo totale di 10.000 parti. Ad esempio, è possibile aggiungere fino a 9.000 volte a un oggetto creato con un caricamento multiparte composto da 1.000 parti.

Nota

Se raggiungi il limite di parti, riceverai un TooManyPartserrore. È possibile utilizzare l'API CopyObject per azzerare il conteggio.

Se si desidera caricare parti di un oggetto in parallelo e non è necessario leggere le parti mentre vengono caricate, si consiglia di utilizzare il caricamento multiparte di Amazon S3. Per ulteriori informazioni, consulta Utilizzo del caricamento multiparte.

L'aggiunta di dati agli oggetti è supportata solo per gli oggetti nei bucket della directory archiviati nella classe di storage S3 Express One Zone. Per ulteriori informazioni su S3 Express One Zone, consulta Introduzione a S3 Express One Zone.

Per iniziare ad aggiungere dati agli oggetti nei bucket di directory, puoi utilizzare la AWS SDKs AWS CLI e l'API. PutObject Quando si effettua una richiesta PutObject, si imposta l'intestazione x-amz-write-offset-bytes sulla dimensione dell'oggetto a cui si sta aggiungendo. Per utilizzare l'operazione API PutObject, è necessario utilizzare l'API CreateSession per stabilire credenziali di sicurezza temporanee per accedere agli oggetti nei bucket della directory. Per ulteriori informazioni, consulta PutObject e CreateSession nella documentazione di riferimento delle API di Amazon S3.

Ogni operazione di aggiunta andata a buon fine viene conteggiata come una richiesta di PutObject. Per saperne di più sui prezzi, consulta Amazon S3 pricing.

Nota

A partire dalla versione 1.12, Mountpoint per Amazon S3 supporta l'aggiunta di dati agli oggetti memorizzati in S3 Express One Zone. Per iniziare, è necessario effettuare l'opt-in impostando il flag --incremental-upload . Per ulteriori informazioni su Mountpoint, consulta Operazioni con Mountpoint.

Se si utilizza un algoritmo CRC (Cyclic Redundancy Check) durante il caricamento dei dati aggiunti, è possibile recuperare le checksum complete dell'oggetto basate sul CRC utilizzando le richieste HeadObject o GetObject. Se utilizzi l'algoritmo SHA-1 o SHA-256 durante il caricamento dei dati aggiunti, puoi recuperare un checksum delle parti aggiunte e verificarne l'integrità utilizzando i checksum SHA restituiti nelle risposte precedenti. PutObject Per ulteriori informazioni, consulta Protezione dei dati e crittografia.

Aggiungere dati agli oggetti utilizzando la AWS CLI e l'API AWS SDKs REST

Puoi aggiungere dati ai tuoi oggetti utilizzando AWS Command Line Interface (AWS CLI) AWS SDKs e l'API REST.

Utilizzo della AWS CLI

Il comando di put-object esempio seguente mostra come utilizzare la AWS CLI per aggiungere dati a un oggetto. Per eseguire questo comando, sostituiscilo user input placeholders con le tue informazioni

aws s3api put-object --bucket amzn-s3-demo-bucket--azid--x-s3 --key sampleinput/file001.bin --body bucket-seed/file001.bin --write-offset-bytes size-of-sampleinput/file001.bin

Utilizzo della AWS CLI

Il comando di put-object esempio seguente mostra come utilizzare la AWS CLI per aggiungere dati a un oggetto. Per eseguire questo comando, sostituiscilo user input placeholders con le tue informazioni

aws s3api put-object --bucket amzn-s3-demo-bucket--azid--x-s3 --key sampleinput/file001.bin --body bucket-seed/file001.bin --write-offset-bytes size-of-sampleinput/file001.bin

Utilizzando il AWS SDKs

SDK for Java

È possibile utilizzare il AWS SDK for Java per aggiungere dati agli oggetti.

var putObjectRequestBuilder = PutObjectRequest.builder()
                                              .key(key)
                                              .bucket(bucketName)
                                              .writeOffsetBytes(9);
var response = s3Client.putObject(putObjectRequestBuilder.build());

SDK for Python

s3.put_object(Bucket='amzn-s3-demo-bucket--use2-az2--x-s3', Key='2024-11-05-sdk-test', Body=b'123456789', WriteOffsetBytes=9)

Utilizzando il AWS SDKs

SDK for Java

È possibile utilizzare il AWS SDK for Java per aggiungere dati agli oggetti.

var putObjectRequestBuilder = PutObjectRequest.builder()
                                              .key(key)
                                              .bucket(bucketName)
                                              .writeOffsetBytes(9);
var response = s3Client.putObject(putObjectRequestBuilder.build());

SDK for Python

s3.put_object(Bucket='amzn-s3-demo-bucket--use2-az2--x-s3', Key='2024-11-05-sdk-test', Body=b'123456789', WriteOffsetBytes=9)

Utilizzo della REST API

È possibile inviare richieste REST per aggiungere dati a un oggetto. Per ulteriori informazioni, consulta PutObject.

Utilizzo della REST API

È possibile inviare richieste REST per aggiungere dati a un oggetto. Per ulteriori informazioni, consulta PutObject.