read-symlinkコマンドを実行してシンボリックリンクを照会します。 - Object Storage Service

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

使用上の注意

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

ossutil 1.6.16以降の場合、コマンドラインでossutilをバイナリ名として直接使用できます。オペレーティングシステムに基づいてバイナリ名を更新する必要はありません。 1.6.16より前のossutilの場合、オペレーティングシステムに基づいてバイナリ名を更新する必要があります。詳細は、「ossutilコマンドリファレンス」をご参照ください。
シンボリックリンクの詳細については、「シンボリックリンクの作成」をご参照ください。

コマンド構文

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

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

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

例

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

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

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

Etag                    : 938F26218CE422CBEEE0B6543A2B2D
Last-Modified           : 2021-04-21 18:00:13 +0800 CST
X-Oss-Symlink-Target    : example.jpg
0.217317(s) elapsed

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

一般的なオプション

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

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

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

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