Aggiungere dati agli oggetti nei bucket di directory - 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à.

Aggiungere dati agli oggetti nei bucket di directory

È possibile aggiungere dati alla fine degli oggetti esistenti archiviati nella classe di archiviazione S3 Express One Zone nei bucket di directory. Si consiglia di utilizzare la possibilità di aggiungere dati a un oggetto se i dati vengono scritti continuamente per un periodo di tempo o se è necessario leggere l'oggetto mentre si scrive sull'oggetto. L'aggiunta di dati agli oggetti è comune in casi d'uso come l'aggiunta di nuove voci di registro ai file di registro o l'aggiunta di nuovi segmenti video ai file video man mano che vengono transcodificati e trasmessi in streaming. Aggiungendo dati agli oggetti, puoi semplificare le applicazioni che in precedenza combinavano i dati nello storage locale prima di copiare l'oggetto finale su Amazon S3.

Non esiste un requisito di dimensione minima per i dati che è possibile aggiungere a un oggetto. Tuttavia, la dimensione massima dei dati che è possibile 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 Amazon API 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 di S3, ogni parte caricata viene conteggiata per un massimo totale di 10.000 parti. Ad esempio, puoi aggiungere fino a 9.000 volte a un oggetto creato da un caricamento in più parti composto da 1.000 parti.

Nota

Se raggiungi il limite di parti, riceverai un errore. TooManyParts È possibile utilizzare il CopyObject API per reimpostare il conteggio.

Se desideri caricare parti su un oggetto in parallelo e non hai bisogno di leggerle mentre le parti vengono caricate, ti consigliamo di utilizzare il caricamento multiparte di Amazon S3. Per ulteriori informazioni, consulta Utilizzo del caricamento in più parti.

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

Per iniziare ad aggiungere dati agli oggetti nei bucket di directory, puoi usare i AWS SDKs, AWS CLI e. PutObject API Quando si effettua una PutObject richiesta, si imposta l'x-amz-write-offset-bytesintestazione sulla dimensione dell'oggetto a cui si sta aggiungendo. Per utilizzare l'PutObjectAPIoperazione, è necessario utilizzare CreateSession API per stabilire credenziali di sicurezza temporanee per accedere agli oggetti nei bucket di directory. Per ulteriori informazioni, CreateSessionPutObjectconsulta Amazon S3 API Reference.

Ogni operazione di aggiunta riuscita viene fatturata come richiesta. PutObject Per ulteriori informazioni sui prezzi, consulta. Amazon S3 pricing

A partire dalla versione 1.12, Mountpoint per Amazon S3 supporta l'aggiunta di dati agli oggetti archiviati in S3 Express One Zone. Per iniziare, devi effettuare il consenso impostando il. --incremental-upload Per ulteriori informazioni su Mountpoint, vedere Lavorare con Mountpoint.

Se si utilizza un algoritmo CRC (Cyclic Redundancy Check) durante il caricamento dei dati aggiunti, è possibile recuperare i checksum completi basati sugli oggetti utilizzando la richiesta or. CRC HeadObject GetObject Se utilizzate l'algoritmo SHA -1 o SHA -256 durante il caricamento dei dati aggiunti, potete recuperare un checksum delle parti aggiunte e verificarne l'integrità utilizzando i checksum restituiti nelle risposte precedenti. SHA PutObject Per ulteriori informazioni, consulta Protezione e crittografia dei dati.

Aggiungere dati agli oggetti utilizzando AWS CLI, AWS SDKs e REST API

È possibile aggiungere dati agli oggetti utilizzando AWS Command Line Interface (AWS CLI) e. AWS SDKs REST API

Il comando di put-object esempio seguente mostra come è possibile utilizzare AWS CLI per aggiungere dati a un oggetto. Per eseguire questo comando, sostituite il 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
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)

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