Oracle Cloud Infrastructure-Dokumentation

Multipart-Upload ausführen

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

Bei mehrteiligen Uploads können einzelne Teile eines Objekts parallel hochgeladen werden, um den Zeitaufwand für das Hochladen 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 anhalten 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 10.000 sein. Sie müssen keine fortlaufenden Nummern zuweisen. Object Storage erstellt das Objekt jedoch, indem Teilenummern in aufsteigender Reihenfolge angeordnet werden.

API für Multipart-Upload

Vor der Verwendung der API für Multipart-Upload müssen Sie die hochzuladenden Teile erstellen. Object Storage bietet API-Vorgänge für die restlichen Schritte.

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

  1. Starten Sie einen Upload.

  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 mehrteiligen Upload über die CLI durchführen, müssen Sie das Objekt nicht aufteilen, wie dies bei der API erforderlich ist. Stattdessen geben Sie die Teilegröße Ihrer Wahl an, und Object Storage unterteilt das Objekt in Teile und führt den Upload aller Teile automatisch durch. Sie können die maximale Anzahl von Teilen festlegen, die parallel hochgeladen werden können. Standardmäßig begrenzt die CLI die Anzahl der Teile, die parallel hochgeladen werden können, auf drei. Wenn Sie die CLI verwenden, müssen Sie nach Abschluss des Uploads keinen Commit ausführen.

Sie können mit der CLI auch laufende Multipart-Uploads anzeigen 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, Kennzeichen und Optionen finden Sie in der Befehlszeilenreferenz.

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

    1. Upload wird gestartet.
    2. Objektteile hochladen.
    3. Upload festschreiben.

    Bevor Sie die API für Multipart-Upload verwenden, müssen Sie die hochzuladenden Teile erstellen. Object Storage bietet API-Vorgänge für die restlichen Schritte. 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 API für den Multipart-Upload finden Sie unter API für Multipart-Upload verwenden.

    Verwenden Sie den Vorgang PutObject, um ein Objekt in mehreren Teilen hochzuladen.

    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).