PutSymlink で、OSS 上のオブジェクトをリンク先とした、シンボリックリンクを作成します。シンボリックリンクを使用してリンク先オブジェクトにアクセスすることができます。

リクエスト構文

  1. PUT /ObjectName? symlink HTTP/1.1Host: BucketName.oss-cn-hangzhou.aliyuncs.comDate: GMT DateAuthorization: SignatureValuex-oss-symlink-target: TargetObjectName

リクエストヘッダー

名前 説明
x-oss-symlink-target String シンボリックリンクのリンク先オブジェクト。

命名規則はオブジェクトの命名規則と同じです。

x-oss-storage-class String オブジェクトのストレージクラス。
指定可能な値:
  • Standard
  • IA
  • Archive

利用可能なインターフェイス:PutObject、InitMultipartUpload、AppendObject、PutObjectSymlink、および CopyObject

注意
  • StorageClass に無効な値が指定されている場合、エラー 400 が返されます。エラーコード:InvalidArgument
  • PutObjectSymlink のストレージクラスには、IA および Archive は指定しないよう推奨します (IA オブジェクトや Archive オブジェクトは 64 KB に満たないのにもかかわらず、64 KB として課金されるため)。
  • バケットにオブジェクトをアップロードする際に本パラメータを指定すると、バケットのストレージクラスとは関係なしに、本パラメータに指定されたストレージクラスのオブジェクトがアップロードされることになります。たとえば、IA ストレージクラスのバケットに、本パラメータを Standard に指定してオブジェクトをアップロードすると、IA ストレージクラスのバケットに Standard ストレージクラスのオブジェクトが格納されることになります。

詳細分析

  • ObjectName と同様に、TargetObjectName は URL エンコードされている必要があります。
  • シンボリックリンクのリンク先オブジェクトをシンボリックリンクにすることはできません。
  • シンボリックリンクの作成時には、下記は確認されません。
    • リンク先オブジェクトの有無
    • リンク先オブジェクトのストレージクラスが正当かどうか
    • ユーザーにリンク先オブジェクトへのアクセスが認可されているかどうか

    GetObject といった、リンク先オブジェクトにアクセスする API では、上記の確認があります。

  • 追加するオブジェクトが既に存在し、アクセスすることができれば、既存オブジェクトは新たに追加されたオブジェクトに上書きされ、200 OK ステータスコードが返されます。
  • PutSymlink リクエストに含まれる、x-oss-meta-location といった x-oss-meta- で始まるパラメータは、ユーザー定義のメタデータと見なされます。x-oss-meta- で始まるパラメータは複数指定できます。なお、ユーザー定義のメタデータは、合計 8 KB 以下である必要があります。

リクエスト例

  1. PUT /link-to-oss.jpg? symlink HTTP/1.1Host: oss-example.oss-cn-hangzhou.aliyuncs.comCache-control: no-cacheContent-Disposition: attachment;filename=oss_download.jpgDate: Tue, 08 Nov 2016 02:00:25 GMTAuthorization: OSS qn6qrrqxo2oawuk53otfjbyc:kZoYNv66bsmc10+dcGKw5x2PRrk= x-oss-symlink-target: oss.jpgx-oss-storage-class: Standard

レスポンス例

  1. HTTP/1.1 200 OKServer: AliyunOSSDate: Tue, 08 Nov 2016 02:00:25 GMTContent-Length: 0Connection: keep-alivex-oss-request-id: 582131B9109F4EE66CDE56A5ETag: 0A477B89B4602AA8DECB8E19BFD447B6