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 caricamenti multiparte sono necessarie le autorizzazioni OBJECT_CREATE e OBJECT_OVERWRITE. Per i dettagli, consulta Caricamenti multiparte dello storage degli oggetti e Dettagli per lo storage degli oggetti, lo storage di archivio e il trasferimento dei 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 di prefisso, ad esempio Ricerca di oggetti in un bucket.

1. Nella pagina della lista Bucket selezionare il bucket di storage degli oggetti che si desidera utilizzare. Se è necessaria assistenza per trovare la pagina della lista o il bucket, vedere Elenca bucket.
2. Nella pagina dei dettagli del bucket selezionare Oggetti.
  Viene visualizzata la scheda Oggetti. Tutti gli oggetti nel bucket selezionato vengono visualizzati in una tabella.
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, consulta la sezione relativa ai livelli di storage degli oggetti.
  Nota
  
  I bucket di 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 del livello viene modificata.
5. Selezionare gli oggetti che si desidera 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 Intestazioni di risposta e metadati facoltativi per specificare i valori per le intestazioni di risposta e i metadati facoltativi da visualizzare nella finestra di dialogo Dettagli oggetto.
  
  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.
  
  Per aggiungere un altro attributo, selezionare Aggiungi altre intestazioni o metadati. Per eliminare un attributi, 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 caricato, 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 del file effettivo (MyFile.txt).

Un oggetto può essere caricato come 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 di un 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=="
}
```
Per un elenco completo dei parametri e dei valori per i comandi CLI, consultare il manuale CLI Command Reference.
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 caricando 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, consulta la sezione relativa ai 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)
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.

Documentazione di Oracle Cloud Infrastructure

Caricamento di un oggetto di storage degli oggetti in un bucket

Specifica del livello di storage dell'oggetto caricato

Denominazione dell'oggetto caricato