read-symlinkコマンドを実行して、クエリのシンボリックリンクを読み取る - Object Storage Service

read-symlinkコマンドを実行して、ETagや最終変更時刻などのシンボリックリンクに関する情報を照会できます。このコマンドを実行してシンボリックリンクに関する情報を照会するには、シンボリックリンクに対する読み取り権限が必要です。

使用上の注意

シンボリックリンクをクエリするには、oss:GetObject権限が必要です。詳細については、「RAMユーザーへのカスタムポリシーのアタッチ」をご参照ください。

このトピックでは、64ビットLinuxシステムに基づくサンプルコマンドラインを提供します。他のシステムのために、取り替えて下さい./ossutil64対応するバイナリ名を持つコマンドで詳細は、「ossutilコマンドリファレンス」をご参照ください。
シンボリックリンクの詳細については、「シンボリックリンクの作成」をご参照ください。

コマンド構文

./ossutil64 read-symlink oss:// bucketname/objectname [-- encoding-type <value>] [-- payer <value>]

次の表に、構文のパラメーターとオプションを示します。

パラメータ /オプション	説明
bucketname	バケットの名前です。
オブジェクト名	照会するシンボリックリンクの名前。
-- encoding-type	シンボリックリンクの名前をエンコードするために使用されるメソッド。有効値: url このオプションを指定しない場合、名前はエンコードされません。
-- 支払人	トラフィックとリクエスト料金の支払人。指定したパスのリソースにアクセスするリクエスタにトラフィックとリクエスト料金を支払う場合は、このオプションをrequesterに設定します。

例

次のコマンドは、examplebucketという名前のバケット内のtest.jpgという名前のシンボリックリンクに関する情報を照会します。

./ossutil64 read-symlink oss:// examplebucket/test.jpg

次の出力は、ETag値、最終変更時刻、シンボリックリンクが指すオブジェクトなど、test.jpgに関する情報が取得されたことを示します。出力によると、test.jpgはexample.jpgという名前のオブジェクトを指します。

Etag : 938F26218CE422CBEEE0B6543A2B2D
最後の変更: 2021-04-21 18:00:13 + 0800 CST
X-Oss-Symlink-ターゲット: example.jpg
0.217317経過

コマンドを実行してシンボリックリンクではないオブジェクトを照会すると、NotSymlinkが返されます。

一般的なオプション

ossutilを使用して別のリージョンにあるバケットに切り替える場合は、コマンドに -eオプションを追加して、指定したバケットがあるリージョンのエンドポイントを指定します。 ossutilを使用して別のAlibaba Cloudアカウントに属するバケットに切り替える場合、コマンドに -iオプションを追加して、指定されたアカウントのAccessKey IDを指定し、コマンドに -kオプションを追加して、指定されたアカウントのAccessKey secretを指定します。

たとえば、次のコマンドを実行して、中国 (上海) リージョンにあり、別のAlibaba Cloudアカウントが所有するtestbucketバケット内のtestobject.pngという名前のシンボリックリンクに関する情報を照会できます。

./ossutil64 read-symlink oss:// testbucket/testobject.png -e oss-cn-shanghai.aliyuncs.com -i LTAI4Fw2NbDUCV8zYUzA **** -k 67DLVBkH7EamOjy2W5RVAHUY9H ****

共通オプションの詳細については、「共通オプション」をご参照ください。