このトピックでは、statコマンドを実行してバケットまたはオブジェクトの情報を照会する方法について説明します。 たとえば、このコマンドを使用して、バケットのストレージクラスとオブジェクトのメタデータを照会できます。
ossutil 1.6.16以降の場合、コマンドラインでossutilをバイナリ名として直接使用できます。 オペレーティングシステムに基づいてバイナリ名を更新する必要はありません。 1.6.16より前のossutilの場合、オペレーティングシステムに基づいてバイナリ名を更新する必要があります。 詳細は、「ossutilコマンドリファレンス」をご参照ください。
oss:GetObject
、oss:GetObjectAcl
、およびoss:GetBucketInfo
権限を持つバケット所有者とRAMユーザーのみが、statコマンドを使用してオブジェクトメタデータを照会できます。
コマンド構文
ossutil stat oss://bucketname[/objectname]
[--encoding-type <value>]
[--payer <value>]
[--version-id <value>]
次の表に、コマンド構文のパラメーターとオプションを示します。
パラメータ /オプション | 説明 |
bucketname | バケットの名前です。 |
オブジェクト名 | 情報を照会するオブジェクトの名前。 |
-- encoding-type | オブジェクト名のエンコーディング。 有効値: url このオプションを指定しない場合、オブジェクト名はエンコードされません。 |
-- 支払人 | 操作によって生成される料金の支払人。 指定されたパスのリソースにアクセスするリクエスタが、トラフィックやリクエスト料金など、操作によって発生する料金を支払うようにする場合は、このパラメーターをrequesterに設定します。 |
-- version-id | オブジェクトのバージョンID。 このパラメーターは、バージョン管理が有効なバケットまたはバージョン管理が一時停止されたバケットにのみ適用されます。 |
例
examplebucketバケットの情報を照会します。
ossutil stat oss:// examplebucket
次のサンプル出力は、コマンドがバケット名、リージョン、作成時間、アクセス制御リスト (ACL) などのexamplebucketバケットに関する情報を取得したことを示しています。
Name : examplebucket Location : 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 : private Owner : 148562088256**** StorageClass : Standard RedundancyType : LRS AccessMonitor : Enabled 0.132413(s) elapsed
examplebucketバケット内のexampleobject.jpgオブジェクトの情報を照会します。
ossutil stat oss://examplebucket/exampleobject.jpg
次のサンプル出力は、コマンドがACL、Content-Type、ETag、最終変更時刻などのexampleobject.jpgオブジェクトに関する情報を取得したことを示しています。
ACL : default Accept-Ranges : bytes Content-Length : 8746 Content-Md5 : cvc5wcklut76CVoEi2UW**** Content-Type : image/jpeg Etag : 72F739C1C925BADEFA095A048B65**** Last-Modified : 2021-07-27 09:53:03 +0800 CST Owner : 148562088256**** X-Oss-Hash-Crc64ecma : 56037670485008**** X-Oss-Object-Type : Normal X-Oss-Storage-Class : Standard 0.194739(s) elapsed
examplebucketバケットのオブジェクト名に特殊文字が含まれているオブジェクトの情報を照会します。
たとえば、examplebucketバケット内の表示例.txtオブジェクトの情報を照会します。 ossutilは、オブジェクト名のURLエンコーディングのみをサポートします。 オブジェクト名に特殊文字が含まれている場合は、コマンドでオブジェクト名を使用する前に、これらの特殊文字をURLセーフ文字にエンコードする必要があります。
ossutil stat oss://examplebucket/%E7%A4%BA%E4%BE%8B.txt --encoding-type url
次のサンプル出力は、コマンドが、ACL、Content-Type、ETag、最終変更時刻などの、
等の、等. txt
オブジェクトに関する情報を取得したことを示しています。ACL : default Accept-Ranges : bytes Content-Length : 113089 Content-Md5 : mAYgHM5cSkZNBxKDDqqW**** Content-Type : image/jpeg Etag : 9806201CCE5C4A464D0712830EAA**** Last-Modified : 2021-07-27 10:08:57 +0800 CST Owner : 148562088256**** X-Oss-Hash-Crc64ecma : 1106061527435521**** X-Oss-Object-Type : Normal X-Oss-Storage-Class : Standard 0.168335(s) elapsed
examplebucketバケット内の指定されたバージョンのオブジェクトの情報を照会します。
ossutil stat oss://examplebucket/test.jpg --version-id CAEQFRiBgICw.YSX1xciIDNiNzc3ZTdmNTQzOTQ1OTM4MWUwOWI1Y2M1ZTgz****
オブジェクトのバージョンを照会する方法の詳細については、「Is」をご参照ください。
次のサンプル出力は、コマンドがACL、Content-Type、ETag、最終変更時刻、バージョンIDなどのオブジェクトに関する情報を取得したことを示しています。
ACL : default Accept-Ranges : bytes Content-Length : 190540 Content-Md5 : aJQnxHQ2b+zW6hh0c+2y**** Content-Type : image/jpeg Etag : 689427C474366FECD6EA187473ED**** Last-Modified : 2021-07-27 10:19:25 +0800 CST Owner : 148562088256**** X-Oss-Hash-Crc64ecma : 1666171672179499**** X-Oss-Object-Type : Normal X-Oss-Storage-Class : Standard X-Oss-Version-Id : CAEQFRiBgICw.YSX1xciIDNiNzc3ZTdmNTQzOTQ1OTM4MWUwOWI1Y2M1ZTgz**** 0.213528(s) elapsed
一般的なオプション
ossutilを使用して別のリージョンにあるバケットに切り替える場合は、-eオプションを追加して、バケットが配置されているリージョンのエンドポイントを指定します。 ossutilを使用して別のAlibaba Cloudアカウントに属するバケットに切り替える場合、-iオプションを追加して指定されたアカウントのAccessKey IDを指定し、-kオプションを追加して指定されたアカウントのAccessKey secretを指定します。
たとえば、次のコマンドを実行して、中国 (上海) リージョンにあり、別のAlibaba Cloudアカウントが所有するtestbucketバケットの情報を照会できます。
ossutil stat oss://testbucket -e oss-cn-shanghai.aliyuncs.com -i LTAI4Fw2NbDUCV8zYUzA**** -k 67DLVBkH7EamOjy2W5RVAHUY9H****
共通オプションの詳細については、「共通オプション」をご参照ください。