Tous les produits
Search
Centre de documentation

Object Storage Service:Télécharger des fichiers (SDK Python V2)

Dernière mise à jour :Aug 18, 2026

Le SDK OSS pour Python V2 propose diverses opérations de téléchargement de fichiers. Sélectionnez l'opération la mieux adaptée à votre scénario.

Type

Nom de l'opération

Description

Téléchargement simple (SDK Python V2)

client.put_object

  • Effectue un téléchargement simple. La taille maximale d'un objet téléchargeable est de 5 GiB.

  • Prend en charge la validation des données par contrôle de redondance cyclique 64 bits (CRC-64). Cette fonctionnalité est activée par défaut.

  • Affiche une barre de progression.

  • Le corps de la requête est de type io.Reader. Si le type io.Seeker est pris en charge, le SDK retente automatiquement le téléchargement en cas d'échec.

client.put_object_from_file

  • Offre les mêmes fonctionnalités que l'opération client.put_object.

  • Les données du corps de la requête proviennent d'un chemin de fichier.

Téléchargement par ajout (SDK Python V2)

client.append_object

  • Effectue un téléchargement par ajout. La taille maximale de l'objet final est de 5 GiB.

  • Prend en charge la validation des données CRC-64. Cette fonctionnalité est activée par défaut.

  • Affiche une barre de progression.

  • Le corps de la requête est de type BodyType. Le SDK retente automatiquement le téléchargement en cas d'échec. Cette opération n'étant pas idempotente, la nouvelle tentative peut échouer.

Opération AppendOnlyFile

AppendOnlyFile.write

AppendOnlyFile.write_from

  • Offre les mêmes fonctionnalités que l'opération client.append_object.

  • Optimise la tolérance aux pannes en cas d'échec de retransmission.

Téléchargement multipartie (SDK Python V2)

Opérations de téléchargement multipartie

client.initiate_multipart_upload

client.upload_part

client.complete_multipart_upload

  • Effectue un téléchargement multipartie. La taille maximale d'une partie est de 5 GiB. La taille maximale d'un objet est de 48,8 TiB.

  • L'opération upload_part prend en charge la validation CRC-64. Cette fonctionnalité est activée par défaut.

  • L'opération upload_part affiche une barre de progression.

  • Le corps de la requête pour l'opération upload_part est de type BodyType. Les types str, bytes, Iterable[bytes], IO[str] et IO[bytes] sont également pris en charge.

Téléchargement via formulaire (SDK Python V2)

/

  • Génère des informations telles qu'une signature Post et une politique Post, et appelle la méthode HTTP POST pour télécharger un fichier vers OSS.

Téléchargement à l'aide d'une URL signée (SDK Python V2)

client.presign

  • Génère une URL signée pour la méthode PUT avec une durée d'expiration. Cela permet à d'autres utilisateurs de télécharger temporairement des fichiers.

Gestionnaire de téléchargement de fichiers (SDK Python V2)

Uploader.upload_from

  • Encapsule les opérations de téléchargement simple et multipartie. La taille maximale d'un objet téléchargeable est de 48,8 TiB.

  • Prend en charge la validation des données CRC-64. Cette fonctionnalité est activée par défaut.

  • Affiche une barre de progression.

  • Le paramètre du corps de la requête est de type IO[bytes].

Uploader.upload_file

  • Offre les mêmes fonctionnalités que l'opération Uploader.upload_from.

  • Les données du corps de la requête proviennent d'un chemin de fichier.

  • Prend en charge le téléchargement avec reprise.