Object Storage Service:Téléchargement par ajout (SDK Node.js)

Remarques sur l'utilisation

• Cette rubrique utilise le point de terminaison public de la région Chine (Hangzhou). Pour accéder à OSS depuis d'autres services Alibaba Cloud dans la même région, utilisez un point de terminaison interne. Pour plus de détails sur les régions et points de terminaison pris en charge, consultez Régions et points de terminaison.

• Dans cette rubrique, les identifiants d'accès sont obtenus à partir des variables d'environnement. Pour plus d'informations, consultez Configuration des identifiants d'accès.

• Cette rubrique explique comment créer une instance OSSClient avec un endpoint OSS. Pour d'autres configurations, telles que l'utilisation d'un domaine personnalisé ou l'authentification avec des identifiants issus du Security Token Service (STS), consultez Configuration du client.

• Si l'objet cible n'existe pas, l'opération AppendObject crée un objet de type « appendable ».

• Si l'objet cible existe :

  • Si l'objet est de type « appendable » et que la position de départ spécifiée correspond à la taille actuelle de l'objet, les données sont ajoutées à la fin de l'objet.

  • Si l'objet est de type « appendable » mais que la position de départ spécifiée ne correspond pas à la taille actuelle de l'objet, l'erreur PositionNotEqualToLength est renvoyée.

  • Si l'objet n'est pas de type « appendable », l'erreur ObjectNotAppendable est renvoyée.

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'opération via des politiques RAM ou une Bucket Policy.

Exemple de code

Le code suivant montre comment effectuer un téléchargement par ajout :

const OSS = require('ali-oss')

const client = new OSS({
  // Set region to the region where the bucket is located. For example, if the bucket is in the China (Hangzhou) region, set region to oss-cn-hangzhou.
  region: 'yourRegion',
  // Obtain access credentials from environment variables. Before you run the sample code, make sure that the OSS_ACCESS_KEY_ID and OSS_ACCESS_KEY_SECRET environment variables are configured.
  accessKeyId: process.env.OSS_ACCESS_KEY_ID,
  accessKeySecret: process.env.OSS_ACCESS_KEY_SECRET,
  authorizationV4: true,
  // Specify the bucket name. Example: examplebucket.
  bucket: 'examplebucket',
});

const headers = {    
  // Specify the access permissions of the object.
  'x-oss-object-acl': 'private',
  // Specify the storage class of the object.
  'x-oss-storage-class': 'Standard',  
  // Specify the server-side encryption method. In this example, server-side encryption with OSS-managed keys (SSE-OSS) is used.
  'x-oss-server-side-encryption': 'AES256',  
};

async function append () {
  // Perform the first append upload. The return value indicates the position for the next append operation.
  // objectName specifies the full path of the object without the bucket name. Example: destfolder/examplefile.txt.
  // localFile specifies the full path of the local file, including the file extension. Example: /users/local/examplefile.txt.
  let result = await client.append('objectName', 'localFile'
  // Custom headers and metadata.
  //,{headers} 
  )

  // Perform the second append upload. The position for the next append operation is the length of the object before this append operation (Content-Length).
  result = await client.append('objectName', 'localFile', {
    position: result.nextAppendPosition
  })
}

append();

Références

Pour plus d'informations sur l'opération d'API AppendObject, consultez AppendObject.