Object Storage Service:PutSymlink

使用上の注意

• PutSymlink 操作を呼び出してシンボリックリンクを作成する場合、Object Storage Service（OSS）は、宛先オブジェクトが存在するかどうか、宛先オブジェクトのストレージクラスが有効かどうか、または宛先オブジェクトにアクセスできるかどうかを確認しません。

• シンボリックリンクのアクセス制御リスト（ACL）と、シンボリックリンクが指す宛先オブジェクトの ACL は、GetObject などの API 操作が宛先オブジェクトへのアクセスに呼び出されたときにチェックされます。

• PutSymlink リクエストに、名前のプレフィックスが x-oss-meta- であるパラメーターが含まれている場合、そのパラメーターはシンボリックリンクのユーザーメタデータと見なされます。 例：x-oss-meta-location。 1 つのオブジェクトに複数のパラメーターを含めることができます。 ただし、オブジェクトのすべてのユーザーメタデータの合計サイズは 8 KB を超えることはできません。

• デフォルトでは、作成するオブジェクトがすでに存在し、既存のオブジェクトにアクセスする権限がある場合、新しいオブジェクトは既存のオブジェクトを上書きし、OSS は 200 OK を返します。

バージョン管理

宛先オブジェクトのシンボリックリンクを作成し、シンボリックリンクを宛先オブジェクトの現在のバージョンにポイントできます。

シンボリックリンクは複数のバージョンを持つことができます。 PutSymlink 操作を呼び出して、シンボリックリンクの各バージョンを異なるオブジェクトにポイントできます。 この場合、バージョンの ID は OSS によって生成され、x-oss-version-id ヘッダーとして応答で返されます。

権限

デフォルトでは、Alibaba Cloud アカウントにはフル権限があります。 Alibaba Cloud アカウントの RAM ユーザーまたは RAM ロールには、デフォルトでは権限がありません。 Alibaba Cloud アカウントまたはアカウント管理者は、RAM ポリシーまたは バケットポリシーを通じて操作権限を付与する必要があります。

リクエスト構文

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

リクエストヘッダー

Host や Date など、PutSymlink リクエストに含まれる一般的なリクエストヘッダーの詳細については、「一般的なリクエストヘッダー」をご参照ください。

レスポンスヘッダー

PutSymlink リクエストへのレスポンスには、一般的なレスポンスヘッダーのみが含まれています。 詳細については、「一般的なレスポンスヘッダー」をご参照ください。

例

• リクエストの例

  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

  成功レスポンスの例

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

• バージョン管理されたバケットのリクエストの例

  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

  成功レスポンスの例

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

OSS SDK

次のプログラミング言語の OSS SDK を使用して、PutSymlink 操作を呼び出すことができます。

• Java

• Go V2

• C

• C++

• .NET

• Android

• iOS

• Node.js

• Browser.js

ossutil

PutSymlink 操作に対応する ossutil コマンドについては、「put-symlink」をご参照ください。

エラーコード