Tous les produits
Search
Centre de documentation

Object Storage Service:GetSymlink

Dernière mise à jour :Aug 18, 2026

Pour obtenir un lien symbolique via l'opération GetSymlink, vous devez disposer de l'autorisation de lecture sur ce lien.

Versioning

Par défaut, GetSymlink récupère la version actuelle du lien symbolique cible. Spécifiez le paramètre versionId dans la requête pour obtenir une version spécifique d'un lien symbolique. Si la version actuelle du lien symbolique cible est un marqueur de suppression, OSS renvoie l'erreur 404 Not Found et inclut les en-têtes x-oss-delete-marker = true et x-oss-version-id dans la réponse. Un marqueur de suppression ne contenant aucune donnée, les informations relatives à l'objet cible vers lequel pointe le lien symbolique ne figurent pas dans la réponse.

Syntaxe

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

En-têtes de requête

Tous les en-têtes d'une requête GetSymlink sont des en-têtes de requête courants. Pour plus d'informations, consultez la section En-têtes de requête courants.

En-têtes de réponse

En-tête

Type

Exemple

Description

x-oss-symlink-target

String

example.jpg

Indique l'objet cible vers lequel pointe le lien symbolique.

Exemples

  • Exemple de requête normale :

    GET /link-to-oss.jpg?symlink HTTP/1.1
    Host: oss-example.oss-cn-hangzhou.aliyuncs.com
    Date: Fri, 24 Feb 2012 06:38:30 GMT
    Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

    Exemple de réponse :

    HTTP/1.1 200 OK
    Server: AliyunOSS
    Date: Fri, 24 Feb 2012 06:38:30 GMT
    Last-Modified: Fri, 24 Feb 2012 06:07:48 GMT
    Content-Length: 0
    Connection: keep-alive
    x-oss-request-id: 5650BD72207FB30443962F9A
    x-oss-symlink-target: example.jpg
    ETag: "A797938C31D59EDD08D86188F6D5****"
  • Exemple de requête avec un versionId spécifié pour obtenir une version particulière d'un lien symbolique :

    GET /link-to-oss.jpg?symlink&versionId=CAEQNRiBgMClj7qD0BYiIDQ5Y2QyMjc3NGZkODRlMTU5M2VkY2U3MWRiNGRh**** 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

    Exemple de réponse :

    HTTP/1.1 200 OK
    Server: AliyunOSS
    Date: Tue, 09 Apr 2019 06:50:48 GMT
    Last-Modified: Tue, 09 Apr 2019 06:50:48 GMT
    Content-Length: 0
    Connection: keep-alive
    x-oss-version-id: CAEQNRiBgMClj7qD0BYiIDQ5Y2QyMjc3NGZkODRlMTU5M2VkY2U3MWRiNGRh****
    x-oss-request-id: 5CAC40C8B7AEADE01700064D
    x-oss-symlink-target: example.jpg
    ETag: "40CF4D450730DCCD1A78566FAE35****"

SDK OSS

Utilisez les SDK OSS pour les langages de programmation suivants afin d'appeler l'opération GetSymlink :

ossutil

Pour plus d'informations sur la commande ossutil correspondant à l'opération GetSymlink, consultez la section get-symlink.

Codes d'erreur

Code d'erreur

Code d'état HTTP

Description

NoSuchKey

404

L'objet demandé n'existe pas.

NotSymlink

400

Le lien symbolique demandé n'existe pas.