Documentazione di Oracle Cloud Infrastructure

API di compatibilità Amazon S3 di storage degli oggetti

Scopri come utilizzare l'API di compatibilità Amazon S3 di Oracle Cloud Infrastructure, dove puoi utilizzare gli strumenti Amazon S3 esistenti per lavorare con lo storage degli oggetti.

Utilizzando l'API di compatibilità Amazon S3, i clienti possono continuare a utilizzare gli strumenti Amazon S3 esistenti (ad esempio, i client SDK) e apportare modifiche minime alle loro applicazioni per utilizzare lo storage degli oggetti. I set di dati dell'API di compatibilità Amazon S3 e dello storage degli oggetti sono congruenti. Se i dati sono scritti in storage degli oggetti mediante l'API di compatibilità Amazon S3, sarà possibile leggerli usando l'API di memorizzazione degli oggetti nativa e viceversa.

Per informazioni su come lo storage degli oggetti supporta l'API di compatibilità Amazon S3, consulta il supporto per le API di compatibilità Amazon S3.

Per informazioni sul supporto API dello storage degli oggetti sia per l'API di compatibilità Amazon S3 che per l'API Swift, vedere i compartimenti per la compatibilità Amazon S3 e le API Swift

Differenze tra l'API di storage degli oggetti e l'API di compatibilità Amazon S3

Il servizio di storage degli oggetti fornito da Oracle Cloud Infrastructure e Amazon S3 utilizza concetti e terminologie simili. In entrambi i casi, i dati vengono memorizzati come oggetti nei bucket. Le differenze sono nell'implementazione di funzioni e strumenti per lavorare con gli oggetti.

Di seguito sono riportate le differenze tra le due tecnologie di storage:

  • Compartimenti

    Amazon S3 non utilizza compartimenti. Per impostazione predefinita, i bucket creati mediante l'API di compatibilità Amazon S3 o l'API Swift vengono creati nel compartimento radice della tenancy Oracle Cloud Infrastructure. In alternativa, è possibile designare un compartimento diverso per l'API di compatibilità Amazon S3 o l'API Swift per creare bucket.

  • Spazio di nomi bucket globale

    Lo storage degli oggetti non utilizza uno spazio di nomi bucket globale. Lo spazio di nomi dello storage degli oggetti funge da contenitore di livello superiore per tutti i bucket e gli oggetti. In fase di creazione dell'account, a ogni tenant di Oracle Cloud Infrastructure viene assegnato un nome di spazio di nomi univoco e immutabile, generato da sistema. Lo spazio dei nomi comprende tutti i compartimenti all'interno di un'area. È possibile controllare i nomi dei bucket, ma tali nomi devono essere univoci all'interno di uno spazio dei nomi. Mentre lo spazio dei nomi è specifico dell'area, il nome dello spazio dei nomi è lo stesso in tutte le aree. È possibile avere un bucket denominato MyBucket nell'area occidentale degli Stati Uniti (Phoenix) e un bucket denominato MyBucket nella zona centrale della Germania (Francoforte). È possibile modificare l'ambito del bucket per applicare l'univocità regionale oltre all'univocità dello spazio di nomi impostando l'ambito del bucket su REGION.

  • Cifratura

    Per impostazione predefinita, il servizio di storage degli oggetti cifra tutti i dati in archivio. Impossibile attivare o disattivare la cifratura mediante l'API.

  • ACL (Object Level Access Control List)

    Oracle Cloud Infrastructure non utilizza le ACL per gli oggetti. Un amministratore deve invece impostare gruppi , compartimenti e criteri che controllano gli utenti che possono accedere a quali servizi, a quali risorse e al tipo di accesso. Ad esempio, i criteri controllano chi può creare utenti e gruppi, creare bucket, scaricare oggetti e gestire criteri e regole correlati allo storage degli oggetti.

Per ulteriori informazioni, vedere Panoramica.

Prerequisiti per l'API di compatibilità Amazon S3

Per abilitare l'accesso alle applicazioni da Amazon S3 allo storage degli oggetti, è necessario impostare l'accesso a Oracle Cloud Infrastructure e modificare l'applicazione come descritto nelle seguenti sezioni.

Impostazione dell'accesso a Oracle Cloud Infrastructure

  1. Iscriviti a Oracle Cloud Infrastructure e ottieni uno spazio di nomi univoco.
  2. Qualsiasi utente dell'API di compatibilità Amazon S3 con lo storage degli oggetti deve disporre dell'autorizzazione per utilizzare il servizio. Se non si è certi di disporre dell'autorizzazione, contattare l'amministratore. Per informazioni di base sui criteri, vedere Funzionamento dei criteri. Per i criteri che consentono l'uso dello storage degli oggetti, vedere Criteri comuni e il riferimento per i criteri.
  3. Utilizzare una chiave esistente o creare una chiave segreta del cliente. Una chiave segreta cliente è costituita da una coppia chiave di accesso/chiave segreta. Per informazioni dettagliate, vedere Utilizzo delle chiavi segrete del cliente. Per utilizzare o creare la coppia di chiavi:
    • Per utilizzare una chiave segreta cliente esistente, è necessario già conoscere la chiave segreta. Per motivi di sicurezza, non è possibile recuperare una chiave segreta dopo la generazione. Per mostrare o copiare il tasto di scelta rapida: nel menu di navigazione selezionare il menu Profilo Icona menu Profilo, quindi selezionare Impostazioni utente. Sul lato sinistro della pagina, selezionare Chiavi segrete cliente. Passare il puntatore del mouse sulla chiave di accesso associata al nome di una determinata chiave segreta del cliente, quindi selezionare Copia.
    • Per creare una chiave segreta del cliente mediante la console, vedere Per creare una chiave segreta del cliente.
    • Per creare una chiave segreta del cliente utilizzando l'interfaccia CLI, vedere oci iam customer-secret-key create.

Modifica della richiesta

  1. Configurare un nuovo endpoint per l'applicazione che includa il nome dello spazio di nomi e l'identificativo area.
    È supportata la seguente sintassi:
    • URL stile ospitato in modo virtuale: https://vhcompat.objectstorage.<region>.oci.customer-oci.com
    • Accesso stile percorso: https://<namespace>.compat.objectstorage.<region>.oci.customer-oci.com
  2. Imposta l'area di destinazione come una delle aree di Oracle Cloud Infrastructure.
    Importante

    Se l'applicazione non supporta l'impostazione dell'identificativo dell'area sull'identificativo corretto di Oracle Cloud Infrastructure, è necessario impostare l'area su us-east-1 o lasciarla vuota. Utilizzando questa configurazione, puoi utilizzare l'API di compatibilità Amazon S3 solo nella tua area d'origine Oracle Cloud Infrastructure. Se puoi impostare manualmente l'area, puoi utilizzare l'applicazione su qualsiasi area di Oracle Cloud Infrastructure.
  3. Configurare l'applicazione in modo che utilizzi la chiave segreta del cliente.
    La chiave segreta del cliente è costituita da una chiave di accesso e da una chiave segreta. Entrambe queste chiavi devono essere fornite all'applicazione.
  4. L'applicazione può utilizzare URL di stile path-style o virtual-hosted. È supportata la sintassi seguente:
    È supportata la seguente sintassi:
    • URL di stile ospitato in modo virtuale: https://<bucket_name>.vhcompat.objectstorage.<region>.oci.customer-oci.com/<object_name>
    • Accesso stile percorso: https://<namespace>.compat.objectstorage.<region>.oci.customer-oci.com/<bucket_name>/<object_name>
Nota

AWS Signature Version 2 (SigV2) non è supportato:

Ora puoi utilizzare l'API di compatibilità Amazon S3 per accedere allo storage degli oggetti in Oracle Cloud Infrastructure.