Documentazione di Oracle Cloud Infrastructure

Caricamento di un oggetto di storage degli oggetti in un bucket

Caricare un oggetto in un bucket o in una cartella nello storage degli oggetti.

Per caricare oggetti di dimensioni superiori a 64 MiB, la console utilizza caricamenti multiparte. Per eseguire i caricamenti multiparte sono necessarie le autorizzazioni OBJECT_CREATE e OBJECT_OVERWRITE. Per i dettagli, consulta la sezione relativa ai carichi multiparte dello storage degli oggetti e ai dettagli relativi a storage degli oggetti, storage di archivio e trasferimento dati.

Utilizzare l'opzione Prefisso per anteporre un valore di prefisso al nome di qualsiasi oggetto caricato nel bucket. È possibile utilizzare il prefisso per cercare nel bucket solo gli oggetti i cui nomi corrispondono al prefisso. Ad esempio, se durante il caricamento di un oggetto è stato incluso il prefisso "test", tutti i nomi degli oggetti inclusi vengono anteposti al valore del prefisso. Un oggetto denominato "my-object.txt" viene caricato nel bucket come "testmy-object.txt".

Per ulteriori informazioni sulla creazione di prefissi per gli oggetti, vedere Denominazione degli oggetti mediante prefissi e gerarchie.

Per ulteriori informazioni su come cercare gli oggetti in un bucket utilizzando l'opzione Prefisso, vedere Ricerca di oggetti in un bucket.

    1. Nella pagina della lista Bucket, selezionare il bucket di storage degli oggetti con cui si desidera lavorare. Se hai bisogno di assistenza per trovare la pagina della lista o il bucket di storage degli oggetti, consulta la sezione relativa all'elenco dei bucket.
    2. Nella pagina dei dettagli selezionare Oggetti.
    3. Selezionare Carica. Per caricare oggetti in una cartella o in una sottocartella nella lista Oggetti, aprire la cartella e selezionare Carica.
    4. Immettere le informazioni riportate di seguito.

      • Prefisso nome oggetto: (facoltativo) se fornito, questo prefisso viene anteposto a ciascuno dei file caricati.

        • Prefisso stringhe con una barra ("/") delimitatore per simulare la gerarchia e creare cartelle o sottocartelle.

        • Prefisso stringhe senza delimitatore ai fini della corrispondenza per eseguire operazioni di massa consentite.

        Per ulteriori informazioni, vedere Denominazione degli oggetti mediante prefissi e gerarchie.

      • Livello di storage: specificare il tipo di livello di storage a cui appartiene l'oggetto caricato:

        • Livello standard

        • Accesso non frequente

        • Archivio

        Per una descrizione dei tipi di livello di storage, vedere Livelli di storage degli oggetti.

        Nota

        I bucket del livello di storage standard possono contenere una combinazione di oggetti con assegnazioni di livelli di storage diverse. Un oggetto rimane nel bucket standard anche se l'oggetto viene archiviato, ripristinato o se l'assegnazione dello scaglione viene modificata.

    5. Selezionare gli oggetti da caricare nella casella Scegli file dal computer utilizzando uno dei metodi riportati di seguito.

      • Trascinare uno o più file dal computer nella casella.

      • Selezionare il collegamento seleziona file per visualizzare una finestra di dialogo di selezione dei file in cui è possibile passare ai file che si desidera caricare.

      I file selezionati per il caricamento vengono visualizzati in un elenco. Per rimuovere un file selezionato dal caricamento, selezionare la X accanto al nome del file.

      Se i file selezionati per il caricamento sono già memorizzati nel bucket o nella cartella con lo stesso nome, la console visualizza messaggi che avvisano l'utente di una sovrascrittura.

    6. (Facoltativo) Selezionare Mostra intestazioni risposta e metadati facoltativi per specificare i valori per le intestazioni risposta e i metadati facoltativi da visualizzare nella finestra di dialogo Dettagli oggetto.

      1. Selezionare il tipo di attributo che si sta aggiungendo:

        • Per aggiungere un'intestazione di risposta, selezionare un valore nella lista Nome, quindi immettere un valore nella casella Valore.

        • Per aggiungere i metadati, immettere un valore nella casella Nome, quindi immettere un valore nella casella Valore.

      2. Per aggiungere un altro attributo, selezionare + Aggiungi altre intestazioni o metadati. Per eliminare un attributo, selezionare la X accanto all'attributo.

    7. Selezionare Carica. Gli oggetti selezionati vengono caricati e visualizzati nella lista degli oggetti nel bucket o nella cartella.

  • Utilizzare il comando oci os object put e i parametri richiesti per caricare un oggetto in un bucket:

    oci os object put --bucket-name bucket_name --file file_location [OPTIONS]

    dove file_location è il percorso della directory di origine dell'oggetto da caricare, ad esempio C:\workspace\Uploads\MyFile.txt o /home/user/Documents/Uploads/MyFile.txt. Il nome dell'oggetto caricato non include le informazioni sul percorso (ad esempio, C:\workspace\Uploads\), ma solo il nome file effettivo (MyFile.txt).

    Un oggetto può essere caricato come una singola parte o come più parti. Utilizzare l'opzione --no-multipart per eseguire il caricamento come singola parte. Per informazioni dettagliate sui caricamenti multiparte, vedere Caricamenti multiparte dello storage degli oggetti.

    Per ulteriori informazioni sugli attributi che è possibile aggiungere quando si carica un oggetto, vedere Intestazioni e metadati di risposta facoltativi.

    Per aggiungere coppie chiave-valore metadati personalizzate, utilizzare l'opzione --metadata:

    oci os object put --bucket-name bucket_name --file file_location --name object_name  --metadata json_formatted_key-value_pairs
    dove JSON-formatted_key-value_pair è un input di coppia chiave-valore come JSON formattato valido. Per ulteriori informazioni sulla formattazione JSON, vedere Passaggio dell'input complesso e Utilizzo di un file JSON per l'input complesso.

    Ad esempio:

    oci os object put --bucket-name MyBucket --file C:\workspace\MyFile.txt --metadata '{"Department": "Finance"}'
{
  "etag": "3504606b-8412-4b5d-924a-aeaeacf1df1e",
  "last-modified": "Wed, 20 Nov 2019 04:37:29 GMT",
  "opc-content-md5": "1B2M2Y8AsgTpgAmY7PhCfg=="
}

    Specifica del livello di storage dell'oggetto caricato

    Includere il parametro storage-tier per assegnare un livello di storage all'oggetto che si sta caricando.

    oci os object put --bucket-name bucket_name --file file_location --storage-tier [Archive | InfrequentAccess | Standard] [OPTIONS]

    Ad esempio, se si sta eseguendo il caricamento in un bucket con configurazione a livello Standard e si desidera assegnare l'oggetto al livello di storage InfrequentAccess, includere --storage-tier InfrequentAccess nel comando:

    oci os object put --bucket-name MyStandardBucket --file C:\workspace\Uploads\MyDocument.txt --storage-tier InfrequentAccess
{
	"etag": "6b292c1a-b01b-4f36-97c8-4567fb43d071",
	"last-modified": "Sat, 12 Dec 2020 12:58:01 GMT",
	"opc-content-md5": "9P61OSaYe4fXxaeK8siuDw=="
}
    Per ulteriori informazioni sul funzionamento dei livelli di storage, vedere Livelli di storage degli oggetti.

    Se non si specifica un livello di storage nel comando, l'oggetto viene assegnato e caricato automaticamente nel livello di storage predefinito del bucket (Standard o Archive).

    Denominazione dell'oggetto caricato

    Includere il parametro name per assegnare un nome all'oggetto caricato escludendone il percorso. Questo parametro è obbligatorio se l'oggetto viene letto da STDIN. Ad esempio:

    oci os object put --bucket-name MyBucket --file C:\workspace\Uploads\MyFile.txt --name AboutMyCompany
{
	"etag": "cadb9f8a-3292-45e6-a1e8-f075699fb619",
	"last-modified": "Fri, 11 Dec 2020 14:04:19 GMT",
	"opc-content-md5": "9P61OSaYe4fXxaeK8siuDw=="
}

    Se non si include il parametro name, il nome file viene utilizzato come nome dell'oggetto caricato (se non viene letto da STDIN)

    Per un elenco completo dei parametri e dei valori per i comandi della CLI, vedere il manuale CLI Command Reference.

  • Eseguire l'operazione PutObject per caricare un oggetto in un bucket.

    Lo storage degli oggetti antepone la stringa dello spazio di nomi e il nome del bucket dello storage degli oggetti al nome dell'oggetto quando si crea un URL da utilizzare con l'API:

    /n/object_storage_namespace/b/bucket/o/object_name

    Il nome dell'oggetto è tutto dopo /o/, che può includere livelli gerarchici e stringhe di prefisso.