Tous les produits
Search
Centre de documentation

Object Storage Service:Télécharger un fichier (SDK Node.js)

Dernière mise à jour :Sep 25, 2026

Par défaut, lorsque vous appelez l'opération GetObject sur un objet stocké dans un bucket pour lequel la gestion des versions est activée, seule la version actuelle de l'objet est renvoyée.

Informations générales

Lorsque vous appelez l'opération GetObject sur un bucket, l'un des cas suivants s'applique :

  • Si la version actuelle de l'objet est un marqueur de suppression, OSS renvoie le code d'erreur 404 Not Found.

  • Si vous spécifiez le paramètre versionId de l'objet dans la requête, la version correspondante est renvoyée. Si vous attribuez la valeur « null » au paramètre versionId, la version de l'objet dont l'ID de version est nul est renvoyée.

  • Si vous tentez de récupérer un marqueur de suppression en indiquant son versionId, OSS renvoie le code d'erreur 405 Method Not Allowed.

Autorisations

Par défaut, un compte Alibaba Cloud dispose de toutes les autorisations. Les utilisateurs RAM ou les rôles RAM associés à un compte Alibaba Cloud ne disposent d'aucune autorisation par défaut. Le compte Alibaba Cloud ou l'administrateur du compte doit accorder les autorisations d'exploitation via des politiques RAM ou une Bucket Policy.

API

Action

Description

GetObject

oss:GetObject

Télécharge un objet.

oss:GetObjectVersion

Cette autorisation est requise lors du téléchargement d'un objet si vous spécifiez la version de l'objet via le paramètre versionId.

kms:Decrypt

Cette autorisation est requise lors du téléchargement d'un objet si les métadonnées de l'objet contiennent l'en-tête X-Oss-Server-Side-Encryption: KMS.

Exemple de code

L'exemple de code suivant montre comment télécharger un fichier :

const OSS = require('ali-oss');

const client = new OSS({
  // Set yourregion to the region where the bucket is located. For example, for the China (Hangzhou) region, set Region to oss-cn-hangzhou.
  region: 'yourregion',
  // Obtain access credentials from environment variables. Before you run this code, ensure that the OSS_ACCESS_KEY_ID and OSS_ACCESS_KEY_SECRET environment variables are set.
  accessKeyId: process.env.OSS_ACCESS_KEY_ID,
  accessKeySecret: process.env.OSS_ACCESS_KEY_SECRET,
  authorizationV4: true,
  // Set yourbucketname to the name of the bucket.
  bucket: 'yourbucketname'
});

async function get() {
  // The name of the file.
  const result = await client.get('filename', {    
      // The version ID of the file to download.
      versionId: 'versionid',
  });
  console.log(result.content);
}
get();

Références

Pour plus d'informations sur l'opération API utilisée pour télécharger des fichiers, consultez la rubrique GetObject.