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 du 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 GiB.

Vous pouvez effectuer une pause entre les téléchargements de parties individuelles et reprendre le téléchargement lorsque votre programmation et vos ressources le permettent.

Parties d'objet

Avec le téléchargement multipart, vous fractionnez l'objet à télécharger en parties distinctes. La taille des parties peut atteindre 50 GiB. La taille maximale pour un objet téléchargé est de 10 TiB.

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, mais Object Storage construit l'objet en organisant les numéros de partie 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. Démarrer un chargement.

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

  3. Validez le chargement.

Le service fournit également des opérations d'API permettant de dresser la liste des téléchargements multipart en cours, de dresser la liste des parties d'objet dans un téléchargement multipart en cours et d'abandonner ces derniers lancés via l'API.

CLI de téléchargement multipart

Lorsque vous effectuez un téléchargement multipart à l'aide de l'interface de ligne de commande, vous n'avez pas besoin de fractionner l'objet en parties comme vous devez le faire avec l'API. 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'CLI limite le nombre de parties pouvant être téléchargées en parallèle à trois. Lorsque vous utilisez l'interface de ligne de commande, vous n'avez pas besoin d'effectuer une validation lorsque le téléchargement est terminé.

Vous pouvez également utiliser l'interface de ligne de commande pour afficher la liste des téléchargements multipart en cours et 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, des indicateurs et des options d'interface de ligne de commande, reportez-vous à Référence de ligne de commande.

  • 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.
    3. Validation du télé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 dresser la liste des téléchargements multipart en cours, de dresser la liste des parties d'objet dans un téléchargement multipart en cours et d'abandonner ces derniers 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 multipart, reportez-vous à Utilisation de l'API de téléchargement multipart.

    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.