Documentation Oracle Cloud Infrastructure

Exécution d'un téléchargement vers le serveur multipart

Sur Compute Cloud@Customer, vous pouvez télécharger des objets en plusieurs parties.

Avec les téléchargements multipart, des parties distinctes d'un objet peuvent être téléchargées en parallèle pour réduire la durée de téléchargement.

Les téléchargements multipart prennent en charge les objets trop volumineux pour une seule opération de téléchargement. La taille des parties d'objet doit être inférieure à 50 Gio.

Vous pouvez mettre le téléchargement en pause entre les téléchargements de parties individuelles, puis le reprendre lorsque votre programmation et vos ressources le permettent.

Pièces d'objet

Avec le téléchargement multipart, vous fractionnez l'objet à télécharger en parties distinctes. Les parties individuelles peuvent avoir une taille maximale de 50 Gio. La taille maximale pour un objet téléchargé est de 10 Tio.

Déterminez le numéro de partie à utiliser pour chaque partie. Les numéros de partie peuvent aller de 1 à 10 000. Il n'est pas nécessaire d'affecter les numéros dans l'Ordre, mais Object Storage construit l'objet en ordonnant les numéros d'élément dans l'ordre croissant.

API de téléchargement multipart

Avant d'utiliser l'API de téléchargement multipart, vous devez créer les parties à télécharger. Object Storage fournit des opérations d'API pour les étapes restantes.

Un téléchargement multipart exécuté à l'aide de l'API comporte les étapes suivantes :

  1. Lancez un téléchargement.

  2. Téléchargez des parties d'objet.

  3. Validez le chargement.

Le service fournit également des opérations d'API permettant de répertorier les téléchargements multipart en cours, de répertorier les parties d'objet dans un téléchargement multipart en cours et d'abandonner les téléchargements multipart en cours lancés via l'API.

Interface de ligne de commande de téléchargement multipart

Lorsque vous effectuez un téléchargement multipart à l'aide de l'interface de lignede commande, vous n'avez plus besoin de fractionner l'objet en parties comme l'API l'exige. Indiquez à la place la taille de partie de votre choix. Object Storage divise l'objet en parties et effectue le téléchargement de toutes les parties automatiquement. Vous pouvez choisir de définir le nombre maximal de parties pouvant être téléchargées en parallèle. Par défaut, l'interface de ligne de commande limite le nombre de parties pouvant être téléchargées en parallèle à trois. Lorsque l'interface de ligne de commande est utilisée, vous n'avez plus besoin d'effectuer une validation lorsque le téléchargement est terminé.

Vous pouvez également utiliser l'interface de ligne de commande pour répertorier les téléchargements multipart en cours et pour annuler ceux lancés via l'API.

  • Cette tâche n'est pas disponible dans la console.

  • Utilisez la commande oci os object put et les paramètres requis pour télécharger un objet en plusieurs parties.

    Syntaxe :

    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]

    Exemple :

    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"
}

    Pour obtenir la liste complète des commandes, indicateurs et options de l'interface de ligne de commandes, reportez-vous à Référence de ligne de commandes.

  • Un téléchargement multipart exécuté à l'aide de l'API comporte les étapes suivantes :

    1. Démarrage d'un téléchargement.
    2. Téléchargement des parties d'objet en local.
    3. Validation du chargement.

    Avant d'utiliser l'API de téléchargement multipart, vous devez créer les parties à télécharger. Object Storage fournit des opérations d'API pour les étapes restantes. Le service fournit également des opérations d'API permettant de répertorier les téléchargements multipart en cours, de répertorier les parties d'objet dans un téléchargement multipart en cours et d'abandonner les téléchargements multipart en cours lancés via l'API.

    Remarque

    Ces exigences en matière d'API de téléchargement multipart ne s'appliquent pas à l'interface de ligne de commande.

    Pour plus d'informations sur l'utilisation de l'API de téléchargement multipartie, reportez-vous à Utilisation de l'API de téléchargement multipartie.

    Utilisez l'opération PutObject pour télécharger un objet en plusieurs parties.

    Pour plus d'informations sur l'utilisation de l'API et la signature des demandes, reportez-vous à API REST et à Informations d'identification de sécurité. Pour plus d'informations sur les kits SDK, reportez-vous à Kits SDK et interface de ligne de commande.