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=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218eExemple 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
versionIdspé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=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218eExemple 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. |