Object Storage Service:GetSymlink

Versionamento

A operação GetSymlink retorna a versão atual do link simbólico de destino por padrão. Especifique o versionId na requisição para obter uma versão específica do link simbólico. Se a versão atual do link simbólico de destino for um marcador de exclusão, o OSS retornará o erro 404 Not Found e incluirá x-oss-delete-marker = true e x-oss-version-id no cabeçalho da resposta. Um marcador de exclusão não contém dados. Portanto, a resposta não inclui informações sobre o objeto de destino apontado pelo link simbólico.

Sintaxe

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

Cabeçalhos da requisição

Todos os cabeçalhos em uma requisição GetSymlink são cabeçalhos comuns de requisição. Para mais informações, consulte Cabeçalhos comuns de requisição.

Cabeçalhos da resposta

Exemplos

• Exemplo de requisiçã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 requisição com versionId especificado para obter uma versão específica do 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

Use os SDKs do OSS nas 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 correspondente à operação GetSymlink, consulte get-symlink.

Códigos de erro