Objektspeicherobjekt in einen Bucket hochladen
Laden Sie ein Objekt in einen Bucket oder Ordner in Object Storage hoch.
Zum Hochladen von Objekten, die größer als 64 MiB sind, verwendet die Konsole Multipart-Uploads. Sie benötigen die Berechtigungen OBJECT_CREATE und OBJECT_OVERWRITE, um Multipart-Uploads auszuführen. Weitere Informationen finden Sie unter Multipart-Uploads für Object Storage und Details zu Object Storage, Archivspeicher und Data Transfer.
Mit der Präfixoption können Sie einem Objektnamen, den Sie in den Bucket hochladen, einen Präfixwert voranstellen. Mit dem Präfix können Sie den Bucket nur nach Objekten durchsuchen, deren Namen mit dem Präfix übereinstimmen. Beispiel: Wenn Sie das Präfix "test" während eines Objektuploads aufgenommen haben, werden allen eingeschlossenen Objektnamen dieser Präfixwert vorangestellt. Ein Objekt mit dem Namen "my-object.txt" wird als "testmy-object.txt" in den Bucket hochgeladen.
Weitere Informationen zum Erstellen von Präfixen für Objekte finden Sie unter Objektbenennung mit Präfixen und Hierarchien.
Weitere Informationen zum Suchen nach Objekten in einem Bucket mit der Präfixoption finden Sie unter Objekte in einem Bucket suchen.
Verwenden Sie den Befehl oci os object put und die erforderlichen Parameter, um ein Objekt in einen Bucket hochzuladen:
oci os object put --bucket-name bucket_name --file file_location [OPTIONS]wobei
file_locationder Quellverzeichnispfad des hochgeladenen Objekts ist, z.B.C:\workspace\Uploads\MyFile.txtoder/home/user/Documents/Uploads/MyFile.txt. Der Name des hochgeladenen Objekts enthält keine Pfadinformationen (Beispiel:C:\workspace\Uploads\), sondern nur den Dateinamen (MyFile.txt).Ein Objekt kann einzeln oder in mehreren Teilen hochgeladen werden. Verwenden Sie die Option
--no-multipart, um es einteilig hochzuladen. Ausführliche Informationen zu mehrteiligen Uploads finden Sie unter Multipart-Uploads für Object Storage.Weitere Informationen zu Attributen, die Sie beim Hochladen eines Objekts hinzufügen können, finden Sie unter Optionale Antwortheader und Metadaten.
Verwenden Sie die Option
--metadata, um benutzerdefinierte Metadaten-Schlüssel/Wert-Paare hinzuzufügen:oci os object put --bucket-name bucket_name --file file_location --name object_name --metadata json_formatted_key-value_pairs
wobeiJSON-formatted_key-value_pairein im gültigen JSON-Format eingegebenes Schlüssel/Wert-Paar ist. Weitere Informationen zur JSON-Formatierung finden Sie unter Komplexe Eingaben übergeben und JSON-Datei für komplexe Eingaben verwenden.Beispiel:
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==" }Eine vollständige Liste der Parameter und Werte für CLI-Befehle finden Sie in der CLI-Befehlsreferenz.
Storage Tier des hochgeladenen Objekts angeben
Nehmen Sie den Parameter
storage-tierauf, um dem hochzuladenden Objekt eine Storage Tier zuzuweisen.oci os object put --bucket-name bucket_name --file file_location --storage-tier [Archive | InfrequentAccess | Standard] [OPTIONS]Beispiel: Wenn Sie in einen auf der Standardebene konfigurierten Bucket hochladen und das Objekt der Storage Tier InfrequentAccess zuweisen möchten, nehmen Sie
--storage-tier InfrequentAccessin den Befehl auf: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==" }Weitere Informationen zur Funktionsweise von Storage Tiers finden Sie unter Object Storage-Tiers.
Wenn Sie im Befehl keine Storage Tier angeben, wird das Objekt automatisch zugewiesen und in die Standard-Storage-Tier des Bucket (Standard oder Archiv) hochgeladen.
Hochgeladenes Objekt benennen
Nehmen Sie den Parameter
nameauf, um das hochgeladene Objekt ohne den zugehörigen Pfad zu benennen. Dieser Parameter ist erforderlich, wenn das Objekt aus STDIN gelesen wird. Beispiel: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==" }Wenn Sie den Parameter
namenicht angeben, wird der Dateiname als Name des hochgeladenen Objekts verwendet (wenn er nicht aus STDIN gelesen wird)Führen Sie den Vorgang PutObject aus, um ein Objekt in einen Bucket hochzuladen.
Beim Erstellen einer URL zur Verwendung mit der API fügt Object Storage die Object Storage-Namespace-Zeichenfolge und den Bucket-Namen an:
/n/object_storage_namespace/b/bucket/o/object_nameDer Objektname umfasst alles nach dem
/o/, was Hierarchieebenen und Präfixzeichenfolgen beinhalten kann.