Supporto dell'API di compatibilità Amazon S3 dello storage degli oggetti

Sono supportate le seguenti API bucket:

• DeleteBucket
• GetLocation
• HeadBucket
• GetService (elencare tutti i bucket personali)
• ListObjects
• PutBucket

Sono supportate le seguenti API oggetto:

• BulkDelete
• DeleteObject
• GetObject
• HeadObject
• PutObject
• RestoreObjects

Sono supportate le seguenti API di caricamento multiparte:

• AbortMultipartUpload
• CompleteMultipartUpload
• InitiateMultipartUpload
• ListParts
• ListUploads
• UploadPart

Sono supportate le seguenti API di applicazione tag:

• DeleteBucketTagging
• GetBucketTagging
• PutBucketTagging

Utilizzando intestazioni API facoltative, puoi fornire la tua chiave di cifratura AES a 256 bit utilizzata per cifrare e decifrare gli oggetti caricati e scaricati dallo storage degli oggetti.

Per utilizzare le proprie chiavi per la cifratura lato server, specificare le tre intestazioni di richiesta riportate di seguito con le informazioni sulle chiavi di cifratura.

Lo storage degli oggetti dispone di API distinte per la copia di oggetti e parti. Amazon S3 utilizza la presenza delle seguenti intestazioni in PutObject e UploadPart per trovare le operazioni di copia. Per copiare un oggetto di origine cifrato con una chiave SSE-C, è necessario specificare queste tre intestazioni in modo che lo storage degli oggetti possa decifrare l'oggetto.

Tenere presente quanto riportato di seguito sulle funzioni API non supportate quando si utilizzano gli SDK e gli strumenti precedenti.

• La versione 2 della firma AWS (SigV2) non è supportata. Utilizzare invece il meccanismo di firma AWS Signature versione 4.

Utilizzando intestazioni API facoltative, puoi fornire la tua chiave di cifratura nel vault per cifrare gli oggetti caricati nello storage degli oggetti.

Per utilizzare le proprie chiavi nel vault per la cifratura lato server, specificare l'intestazione di richiesta seguente con l'OCID della chiave nel vault:

I client compatibili con S3 possono caricare gli oggetti utilizzando aws-chunked nell'intestazione Content-Encoding. Sono supportati sia i caricamenti in singola parte che le richieste UploadPart multiparte. Sono supportati i payload di streaming AWS SigV4, tra cui:

• STREAMING-AWS4-HMAC-SHA256-PAYLOAD
• STREAMING-AWS4-HMAC-SHA256-PAYLOAD-TRAILER
• STREAMING-UNSIGNED-PAYLOAD-TRAILER

I client possono inviare caricamenti aws-chunked con intestazioni HTTP Content-Length o Transfer-Encoding: chunked. I clienti devono fornire x-amz-decoded-content-length, che l'API di compatibilità Amazon S3 considera come la dimensione effettiva dell'oggetto o della parte. Le firme chunk vengono convalidate, pertanto i caricamenti con dati chunk manomessi o firme chunk non valide vengono rifiutati. Le firme del rimorchio vengono convalidate per i caricamenti firmati in modalità trailer, pertanto vengono rifiutati anche i blocchi di rimorchio manomessi. La convalida del checksum della chiusura è supportata per:

• CRC32
• CRC32C
• SHA256
• CRC64NVME

Mancate corrispondenze di checksum che causano l'errore del caricamento durante l'elaborazione della richiesta. I checksum dei trailer di SHA256 si integrano con il comportamento additional-checksum esistente, in modo che possano essere resi persistenti in modo coerente con la semantica dei checksum API di compatibilità Amazon S3 esistente. I checksum dei trailer CRC32, CRC32C e CRC64NVME sono di sola verifica, quindi vengono convalidati ma non resi persistenti come metadati dell'oggetto. Il comportamento di caricamento delle API di compatibilità Amazon S3 esistente per i caricamenti non sottoposti a tuning rimane invariato.

Le versioni più recenti dell'SDK AWS non aggiungono automaticamente l'intestazione Content-MD5 e sono invece passate a nuove intestazioni (ad esempio x-amz-checksum-crc32) come checksum predefinito. Il flusso DeleteObjects / BulkDelete nell'API di compatibilità Amazon S3 supporta x-amz-checksum-sha256 e x-amz-checksum-crc32c come alternative a Content-MD5 per convalidare il corpo della richiesta.

S3Client s3Client = S3Client.builder()
    .addPlugin(LegacyMd5Plugin.create())
    .endpointOverride(URI.create(endpoint))
    .credentialsProvider(StaticCredentialsProvider.create(
        AwsBasicCredentials.create(accessKey, secretKey)))
    .forcePathStyle(true)
    .build();

Puoi configurare varie applicazioni client per parlare con gli endpoint compatibili con Amazon S3 di Object Storage. Questo argomento fornisce alcuni esempi di configurazione per i client Amazon S3 supportati.