このトピックでは、statコマンドを実行してバケットまたはオブジェクトの情報を照会する方法について説明します。 たとえば、このコマンドを実行して、バケットのストレージクラスとオブジェクトのメタデータを照会できます。
このトピックのサンプルコマンドラインは、64ビットLinuxシステムに基づいています。 他のシステムの場合は、を交換します。対応するバイナリ名を持つコマンドの /ossutil64。 詳細については、「ossutilの使用を開始する」をご参照ください。
oss:GetObject、oss:GetObjectAcl、およびoss:GetBucketInfo権限が付与されているバケット所有者とResource Access Management (RAM) ユーザーのみが、このコマンドを実行してオブジェクトメタデータを表示できます。
コマンド構文
. /ossutil64 stat oss:// bucketname[/objectname]
[-- encoding-type <value>]
[-- payer <value>]
[-- version-id <value>] 次の表に、このコマンドを実行するときに設定できるパラメーターを示します。
パラメーター | 説明 |
bucketname | 情報を照会するバケットの名前。 |
オブジェクト名 | 情報を照会するオブジェクトの名前。 |
-- encoding-type | オブジェクト名をエンコードするメソッド。 有効値: url このオプションを指定しない場合、オブジェクト名はエンコードされません。 |
-- 支払人 | コマンドの実行時に発生したトラフィックとリクエスト料金の支払人。 指定されたパスのリソースにアクセスするリクエスタが、クエリ中に発生したトラフィックとリクエスト料金の支払いを行う場合は、このパラメーターをrequesterに設定します。 |
-- version-id | オブジェクトのバージョンのID。 このパラメーターは、バージョン管理が有効または一時停止されているバケット内のオブジェクトにのみ適用されます。 |
例
examplebucketバケットの情報を照会します。
. /ossutil64 stat oss:// examplebucket同様の出力が表示された場合、examplebucketバケットの情報が取得されます。これには、このバケットのリージョン、作成時刻、およびアクセス制御リスト (ACL) が含まれます。
名: examplebucket 場所: oss-cn-hangzhou CreationDate : 2021-06-30 16:04:41 + 0800 CST ExtranetEndpoint : oss-cn-hangzhou.aliyuncs.com IntranetEndpoint : oss-cn-hangzhou-internal.aliyuncs.com ACL: プライベート 所有者: 148562088256 **** StorageClass: 標準 RedundancyType : LRS AccessMonitor: 有効 0.132413経過examplebucketバケットに格納されているexampleobject.jpgオブジェクトの情報を照会します。
. /ossutil64 stat oss:/// examplebucket/exampleobject.jpg同様の出力が表示されると、examplebucketオブジェクトの情報が取得されます。これには、ETag値、最終変更時刻、ACLやContend-Typeなどのメタデータが含まれます。
ACL: デフォルト Accept-Ranges: バイト コンテンツ-長さ: 8746 Content-Md5 : cvc5wcklut76CVoEi2UW **** コンテンツタイプ: image/jpeg Etag : 72F739C1C925BADEFA095A048B65 **** 最終変更: 2021-07-27 09:53:03 + 0800 CST 所有者: 148562088256 **** X-Oss-Hash-Crc64ecma : 56037670485008 **** X-Oss-オブジェクト型: Normal X-Oss-ストレージクラス: 標準 0.194739経過名前に特殊文字が含まれ、examplebucketバケットに格納されているオブジェクトの情報を照会します。
たとえば、名前がexample txtで、examplebucketバケットに格納されているオブジェクトの情報を照会します。 ossutilは、オブジェクト名のURLエンコーディングのみをサポートします。 オブジェクト名に特殊文字が含まれている場合は、コマンドでオブジェクト名を使用する前に、これらの特殊文字をエンコードできます。
. /ossutil64 stat oss:// examplebucket/%E7%A4%BA%E4%BE%8B.txt -- エンコーディングタイプのurl同様の出力が表示されると、ETag値、最終変更時刻、ACLやContend-Typeなどのメタデータを含む
example txtオブジェクトの情報が取得されます。ACL: デフォルト Accept-Ranges: バイト コンテンツ-長さ: 113089 Content-Md5 : mAYgHM5cSkZNBxKDDqqW **** コンテンツタイプ: image/jpeg Etag : 9806201CCE5C4A464D0712830EAA **** 最終変更: 2021-07-27 10:08:57 + 0800 CST 所有者: 148562088256 **** X-Oss-Hash-Crc64ecma : 1106061527435521 **** X-Oss-オブジェクト型: Normal X-Oss-ストレージクラス: 標準 0.168335経過examplebucketバケット内の指定されたバージョンのオブジェクトの情報を照会します。
. /ossutil64 stat oss:// examplebucket/test.jpg -- バージョンid CAEQFRiBgICw.YSX1xciIDNiNzc3ZTdmNTQzOTQ1OTM4MWUwOWI1Y2M1ZTgz ****オブジェクトのすべてのバージョンをクエリする方法の詳細については、「Is」をご参照ください。
同様の出力が表示されると、ETag値、最終変更時刻、バージョンID、ACLやContend-Typeなどのメタデータなど、指定されたバージョンのオブジェクトの情報が取得されます。
ACL: デフォルト Accept-Ranges: バイト コンテンツ-長さ: 190540 Content-Md5 : aJQnxHQ2b + zW6hh0c + 2y **** コンテンツタイプ: image/jpeg Etag : 689427C474366FECD6EA187473ED **** 最終変更: 2021-07-27 10:19:25 + 0800 CST 所有者: 148562088256 **** X-Oss-Hash-Crc64ecma : 1666171672179499 **** X-Oss-オブジェクト型: Normal X-Oss-ストレージクラス: 標準 X-Oss-バージョン-Id : CAEQFRiBgICw.YSX1xciIDNiNzc3ZTdmNTQzOTQ1OTM4MWUwOWI1Y2M1ZTgz **** 0.213528経過
一般的なオプション
ossutilを使用して別のリージョンにあるバケットに切り替える場合は、コマンドに -eオプションを追加して、指定したバケットがあるリージョンのエンドポイントを指定します。 ossutilを使用して別のAlibaba Cloudアカウントに属するバケットに切り替える場合、コマンドに -iオプションを追加して、指定されたアカウントのAccessKey IDを指定し、コマンドに -kオプションを追加して、指定されたアカウントのAccessKeyシークレットを指定します。
たとえば、次のコマンドを実行して、中国 (上海) リージョンにあり、別のAlibaba Cloudアカウントが所有するtestbucketバケットの情報を照会できます。
. /ossutil64 stat oss:// testbucket -e oss-cn-shanghai.aliyuncs.com -i LTAI4Fw2NbDUCV8zYUzA **** -k 67DLVBkH7EamOjy2W5RVAHUY9H ****同期コマンドに使用できるその他の一般的なオプションの詳細については、「オプションの表示」をご参照ください。