Object Storage Service:GetSymlink

Versionamento

Por padrão, o GetSymlink obtém a versão atual do link simbólico de destino. especifique o versionId na solicitação para obter a versão específica de um link simbólico. Se a versão atual do link simbólico de destino for um marcador de exclua, o oss retornará o erro 404 Not Found e incluirá x-oss-delete-marker = true e x-oss-version-id no cabeçalho de resposta. Um marcador de exclua não contém dados. Portanto, a resposta não inclui informações sobre o objeto de destino para o qual o link simbólico aponta.

Sintaxe

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

Cabeçalhos de solicitação

Todos os cabeçalhos em uma solicitação GetSymlink são cabeçalhos de solicitação comuns. Para mais informações, consulte Common request headers.

Cabeçalhos de resposta

Exemplos

• Exemplo de solicitação normal:

  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

  Exemplo de resposta:

  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****"

• Exemplo de solicitação com um versionId especificado para obter a versão específica de um link simbólico:

  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

  Exemplo de resposta:

  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****"

SDKs do oss

É possível usar os SDKs do oss para as seguintes linguagens de programação para chamar a operação GetSymlink:

• Java

• Python V2

• PHP V2

• Go V2

• C

• C++

• .NET

• Android

• iOS

• Node.js

• Browser.js

ossutil

Para obter informações sobre o comando do ossutil que corresponde à operação GetSymlink, consulte get-symlink.

Códigos de erro