read-symlink コマンドを使用すると、OSS 内のシンボリックリンクに関するメタデータ（ETag、最終更新日時、および対象オブジェクト）を取得できます。
前提条件
実行前に、以下の条件を満たしていることを確認してください。
シンボリックリンクに対する
oss:GetObject権限が付与されていること。詳細については、「RAM ユーザーへのカスタムポリシーのアタッチ」をご参照ください。ossutil がインストール済みであること。ossutil 1.6.16 以降では、バイナリ名として直接
ossutilを使用します。それ以前のバージョンでは、オペレーティングシステムに応じてバイナリ名を更新してください。詳細については、「ossutil コマンド リファレンス」をご参照ください。
コマンド構文
ossutil read-symlink oss://bucketname/objectname [--encoding-type <value>] [--payer <value>]| パラメーター | 必須 | 説明 | 例 |
|---|---|---|---|
bucketname | はい | バケット名。 | examplebucket |
objectname | はい | シンボリックリンクの名前。 | test.jpg |
--encoding-type | いいえ | シンボリックリンク名のエンコーディング方式。有効な値： url。指定しない場合、名前はエンコードされません。 | url |
--payer | いいえ | リクエストの支払者。バケット所有者が、トラフィックおよびリクエスト料金をリクエスターに負担させたい場合は、requester を指定します。 | requester |
例
シンボリックリンクの照会
次のコマンドは、examplebucket の test.jpg という名前のシンボリックリンクのメタデータを取得します。
ossutil read-symlink oss://examplebucket/test.jpg正常終了時の応答には、ETag、最終更新日時、およびシンボリックリンクが指す対象オブジェクトが含まれます。
Etag : 938F26218CE422CBEEE0B6543A2B2D
Last-Modified : 2021-04-21 18:00:13 +0800 CST
X-Oss-Symlink-Target : example.jpg
0.217317(s) elapsedこの出力において、X-Oss-Symlink-Target: example.jpg は、test.jpg が example.jpg を指していることを示しています。
シンボリックリンクでないオブジェクトの照会
対象オブジェクトがシンボリックリンクでない場合、NotSymlink が返されます。
処理前に、オブジェクトがシンボリックリンクであるかどうかを確認する際にご利用ください。
共通オプション
他のリージョンにあるバケットにアクセスする場合は、-e オプションを追加して、バケットのエンドポイントを指定します。別の Alibaba Cloud アカウントの認証情報を使用する場合は、-i オプションで AccessKey ID を、-k オプションで AccessKey Secret を指定します。
次のコマンドは、中国 (上海) リージョンにあり、別のアカウントが所有する testbucket バケット内の testobject.png のメタデータを取得します。
ossutil read-symlink oss://testbucket/testobject.png -e oss-cn-shanghai.aliyuncs.com -i yourAccessKeyID -k yourAccessKeySecret共通オプションの完全な一覧については、「Common options」をご参照ください。
次のステップ
シンボリックリンクを作成するには、「シンボリックリンクの作成」をご参照ください。