Oracle Cloud Infrastructure-Dokumentation

Multipart-Upload ausführen

Auf Compute Cloud@Customer können Sie Objekte in mehreren Teilen hochladen.

Bei Multipart-Uploads können einzelne Teile eines Objekts parallel hochgeladen werden, um den Zeitaufwand für den Upload zu reduzieren.

Multipart-Uploads sind für Objekte geeignet, die für einen einzelnen Uploadvorgang zu groß sind. Objektteile dürfen nicht größer als 50 GiB sein.

Sie können zwischen den Uploads einzelner Teile pausieren und den Upload fortsetzen, wenn Ihr Zeitplan und Ihre Ressourcen dies zulassen.

Objektteile

Beim Multipart-Upload teilen Sie das Objekt, das Sie hochladen möchten, in einzelne Teile auf. Einzelne Teile können bis zu 50 GiB umfassen. Die maximale Größe für ein hochgeladenes Objekt beträgt 10 TiB.

Entscheiden Sie, welche Teilenummer für jeden Teil verwendet werden soll. Teilenummern können im Bereich zwischen 1 und 10.000 liegen. Sie müssen keine fortlaufenden Nummern zuweisen. Object Storage erstellt das Objekt jedoch, indem Teilenummern in aufsteigender Reihenfolge angeordnet werden.

Multipart-Upload-API

Bevor Sie die API für Multipart-Upload verwenden, müssen Sie die hochzuladenden Teile erstellen. Object Storage stellt API-Vorgänge für die restlichen Schritte zur Verfügung.

Ein Multipart-Upload, der mit der API ausgeführt wird, besteht aus folgenden Schritten:

  1. Hochladen starten.

  2. Objektteile hochladen.

  3. Schreiben Sie den Upload fest.

Der Service bietet außerdem API-Vorgänge zum Auflisten von laufenden Multipart-Uploads, zum Auflisten der Objektteile in einem laufenden Multipart-Upload und zum Abbrechen von laufenden Multipart-Uploads, die über die API initiiert wurden.

Multipart-Upload-CLI

Wenn Sie einen Multipart-Upload über die CLI durchführen, müssen Sie das Objekt nicht in Teile aufteilen, wie dies bei der API erforderlich ist. Stattdessen geben Sie die Teilegröße Ihrer Wahl an, und Object Storage teilt das Objekt in Teile auf und führt den Upload aller Teile automatisch aus. Sie können festlegen, wie viele Teile maximal parallel hochgeladen werden können. Standardmäßig begrenzt die CLI die Anzahl der Teile, die parallel hochgeladen werden können, auf drei. Wenn die CLI verwendet wird, müssen Sie nach Abschluss des Uploads kein Commit ausführen.

Sie können mit der CLI auch laufende Multipart-Uploads auflisten und über die API initiierte Multipart-Uploads abbrechen.

  • Diese Aufgabe ist in der Konsole nicht verfügbar.

  • Verwenden Sie den Befehl oci os object put und die erforderlichen Parameter, um ein Objekt in mehreren Teilen hochzuladen.

    Syntax:

    oci os object put --namespace-name <object_storage_namespace> --bucket-name <bucket_name> --file <file_location> --parallel-upload-count <maximum_number_parallel_uploads> --part-size <upload_part_size_in_MB> --force [OPTIONS]

    Beispiel:

    oci os object put   \
--namespace-name examplenamespace  \
--file /boot/initramfs-0-rescue-e542c19f0fbf4e41a41428d933a7357f.img   \
--parallel-upload-count 5   \
--part-size 15   \
--force

Upload ID: a21bba2c-8922-4b9c-a98a-9ef3569c0138
Split file into 6 parts for upload.
Uploading object [####################################] 100%
{
  "etag": "0964effc8dc4394fd317f03a025ae5d0",
  "last-modified": "2021-05-11T21:35:19",
  "opc-multipart-md5": "UIVRhiwSHY6o0E4pi/yfGg==-6"
}

    Eine vollständige Liste der CLI-Befehle, Flags und Optionen finden Sie in der Befehlszeilenreferenz.

  • Ein Multipart-Upload, der mit der API ausgeführt wird, besteht aus folgenden Schritten:

    1. Upload wird gestartet.
    2. Objektteile werden hochgeladen.
    3. Hochladen wird festgeschrieben

    Bevor Sie die API für Multipart-Upload verwenden, sind Sie für die Erstellung der hochzuladenden Teile verantwortlich. Object Storage stellt API-Vorgänge für die restlichen Schritte zur Verfügung. Der Service bietet außerdem API-Vorgänge zum Auflisten von laufenden Multipart-Uploads, zum Auflisten der Objektteile in einem laufenden Multipart-Upload und zum Abbrechen von laufenden Multipart-Uploads, die über die API initiiert wurden.

    Hinweis

    Diese Multipart-Upload-API-Anforderungen gelten nicht für die CLI.

    Weitere Informationen zur Verwendung der Multipart-Upload-API finden Sie unter Multipart-Upload-API verwenden.

    Mit dem Vorgang PutObject können Sie ein Objekt in mehreren Teilen hochladen.

    Informationen zur Verwendung der API und zu Signieranforderungen finden Sie unter REST-APIs und Sicherheitszugangsdaten. Informationen zu SDKs finden Sie unter Software Development Kits und Befehlszeilenschnittstelle (CLI).