Tous les produits
Search

Ce produit

    Object Storage Service:PutSymlink

    Centre de documentation

    Object Storage Service:PutSymlink

    Dernière mise à jour :Aug 18, 2026

    Crée un lien symbolique (symlink) pointant vers un objet de destination dans OSS. Utilisez ce lien pour accéder à l'objet de destination.

    Notes d'utilisation

    • L'opération PutSymlink ne vérifie ni l'existence de l'objet de destination, ni la validité de sa classe de stockage, ni vos droits d'accès sur celui-ci.

    • Le système évalue la liste de contrôle d'accès (ACL) du lien symbolique et celle de l'objet de destination uniquement lors des opérations d'accès à l'objet de destination, telles que GetObject.

    • Les en-têtes de requête préfixés par x-oss-meta- sont stockés en tant que métadonnées utilisateur du lien symbolique (par exemple : x-oss-meta-location). Spécifiez plusieurs en-têtes de métadonnées si nécessaire, mais leur taille totale ne doit pas dépasser 8 Ko.

    • Par défaut, si un objet portant le même nom existe et que vous disposez des autorisations nécessaires, le nouvel objet écrase l'existant. OSS renvoie alors le code 200 OK.

    Gestion des versions

    Un lien symbolique pointe toujours vers la version actuelle de l'objet de destination.

    Un lien symbolique peut comporter plusieurs versions, chacune pointant vers un objet différent. OSS génère des ID de version et les renvoie dans l'en-tête de réponse x-oss-version-id.

    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 n'ont aucune autorisation par défaut. Le compte Alibaba Cloud ou l'administrateur du compte doit accorder les autorisations d'opération via les politiques RAM ou la politique de bucket.

    API

    Action

    Description

    PutSymlink

    oss:PutObject

    Crée un lien symbolique pour un objet.

    oss:PutObjectTagging

    Cette autorisation est requise lors de la création d'un lien symbolique si vous spécifiez des tags d'objet via x-oss-tagging.

    Syntaxe de la requête

    PUT /ObjectName?symlink HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue
x-oss-symlink-target: TargetObjectName

    En-têtes de requête

    En-tête

    Type

    Obligatoire

    Description

    x-oss-forbid-overwrite

    String

    Non

    Indique s'il faut empêcher l'écrasement d'un objet existant portant le même nom.

    • Non spécifié ou défini sur false : l'objet existant est écrasé.

    • Défini sur true : l'objet existant ne peut pas être écrasé.

    La spécification de cet en-tête peut dégrader les performances QPS. Si votre QPS dépasse 1 000, contactez le support technique.

    Remarque

    Cet en-tête n'a aucun effet lorsque la gestion des versions est activée ou suspendue pour le bucket. PutSymlink écrase l'objet dans tous les cas.

    x-oss-symlink-target

    String

    Oui

    L'objet de destination vers lequel pointe le lien symbolique.

    Suit les mêmes conventions de nommage que les objets.

    • TargetObjectName doit être encodé en URL, tout comme ObjectName.

    • L'objet de destination ne peut pas être un lien symbolique.

    x-oss-object-acl

    String

    Non

    L'ACL de l'objet. Valeur par défaut : default.

    Valeurs valides :

    • default : Hérite de l'ACL du bucket.

    • private : Seul le propriétaire et les utilisateurs autorisés peuvent lire et écrire l'objet.

    • public-read : Tous les utilisateurs peuvent lire l'objet. Seul le propriétaire et les utilisateurs autorisés peuvent écrire. À utiliser avec prudence.

    • public-read-write : Tous les utilisateurs peuvent lire et écrire l'objet. À utiliser avec prudence.

    Pour plus d'informations sur les ACL des objets, consultez ACL des objets.

    x-oss-storage-class

    String

    Non

    La classe de stockage de l'objet.

    Si elle est spécifiée, cette valeur remplace la classe de stockage par défaut du bucket. Par exemple, définir cette valeur sur Standard lors du chargement dans un bucket IA permet de stocker l'objet en tant que Standard.

    Valeurs valides :

    • Standard

    • IA

    • Archive

    Les objets IA et Archive ont une taille minimale facturée de 64 Ko. Évitez de définir la classe de stockage sur IA ou Archive pour les liens symboliques.

    Détails sur les classes de stockage : Présentation.

    Pour plus d'informations sur les en-têtes de requête courants inclus dans une requête PutSymlink, tels que Host et Date, consultez En-têtes de requête courants.

    En-têtes de réponse

    La réponse à une requête PutSymlink contient uniquement des en-têtes de réponse courants. Pour plus d'informations, consultez En-têtes de réponse courants.

    Exemples

    • Exemple de requête

      PUT /link-to-oss.jpg?symlink HTTP/1.1 
Host: oss-example.oss-cn-hangzhou.aliyuncs.com 
Cache-control: no-cache 
Content-Disposition: attachment;filename=oss_download.jpg 
Date: Tue, 08 Nov 2016 02:00:25 GMT 
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,AdditionalHeaders=content-disposition,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e 
x-oss-symlink-target: oss****
x-oss-storage-class: Standard

      Exemple de réponse réussie

      HTTP/1.1 200 OK
Server: AliyunOSS
Date: Tue, 08 Nov 2016 02:00:25 GMT
Content-Length: 0
Connection: keep-alive
x-oss-request-id: 582131B9109F4EE66CDE56A5
ETag: "0A477B89B4602AA8DECB8E19BFD4****"

    • Exemple de requête pour un bucket avec gestion des versions

      PUT /link-to-oss.jpg?symlink HTTP/1.1 
Host: oss-example.oss-cn-hangzhou.aliyuncs.com 
Date: Tue, 09 Apr 2019 06:50:48 GMT 
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e
x-oss-symlink-target: oss.jpg

      Exemple de réponse réussie

      HTTP/1.1 200 OK
Server: AliyunOSS
Date: Tue, 09 Apr 2019 06:50:48 GMT
Content-Length: 0
Connection: keep-alive
x-oss-version-id: CAEQNRiBgMClj7qD0BYiIDQ5Y2QyMjc3NGZkODRlMTU5M2VkY2U3MWRiNGRh****
x-oss-request-id: 5CAC40C8B7AEADE01700064B
ETag: "136A5E127272200EDAB170DD84DE****"

    SDK OSS

    Les SDK OSS suivants prennent en charge l'opération PutSymlink :

    ossutil

    Pour obtenir des informations sur la commande ossutil correspondant à l'opération PutSymlink, consultez put-symlink.

    Codes d'erreur

    Code d'erreur

    Code d'état HTTP

    Description

    InvalidArgument

    400

    La valeur StorageClass n'est pas valide.

    FileAlreadyExists

    409

    Un objet portant le même nom existe et x-oss-forbid-overwrite est défini sur true.

    FileImmutable

    409

    L'objet est protégé par une politique de rétention.