stat コマンドを使用して、バケットまたはオブジェクトのメタデータをクエリします。このコマンドにより、ストレージクラス、アクセス制御リスト（ACL）、冗長性タイプ、オブジェクトサイズなどの情報を、コマンドラインから直接確認できます。
オブジェクトのメタデータを stat コマンドでクエリできるのは、バケットの所有者および oss:GetObject、oss:GetObjectAcl、oss:GetBucketInfo 権限を持つ RAM ユーザーのみです。
前提条件
開始する前に、以下の条件を満たしていることを確認してください。
ossutil がインストール済みであること。ossutil 1.6.16 以降では、バイナリ名として直接
ossutilを使用します。それより前のバージョンでは、オペレーティングシステムに応じてバイナリ名を更新してください。詳細については、「ossutil コマンド リファレンス」をご参照ください。バケットまたはオブジェクトをクエリするために必要な権限が付与済みであること
コマンド構文
ossutil stat oss://bucketname[/objectname]
[--encoding-type <value>]
[--payer <value>]
[--version-id <value>]パラメーターとオプション
| パラメーター／オプション | 必須 | 説明 |
|---|---|---|
bucketname | はい | バケット名。 |
objectname | いいえ | オブジェクト名。省略すると、バケットレベルの情報をクエリします。 |
--encoding-type | いいえ | オブジェクト名のエンコーディング形式。有効な値： url。指定しない場合、オブジェクト名はエンコードされません。 |
--payer | いいえ | この操作によって発生するトラフィック料金およびリクエスト料金をリクエスターが負担する場合は、requester を指定します。 |
--version-id | いいえ | オブジェクトのバージョン ID。バージョン管理が有効化されているバケット、またはバージョン管理が一時停止されているバケットにのみ適用されます。 |
実行例
バケット情報のクエリ
ossutil stat oss://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出力フィールド：
| フィールド | 説明 |
|---|---|
Name | バケット名。 |
Location | バケットが配置されているリージョン。 |
CreationDate | バケットの作成日時。 |
ExtranetEndpoint | インターネット経由でバケットにアクセスするためのパブリックエンドポイント。 |
IntranetEndpoint | Alibaba Cloud 内部ネットワーク内からバケットにアクセスするための内部エンドポイント。 |
ACL | バケットレベルのアクセス制御リスト（ACL）。 |
Owner | バケット所有者の Alibaba Cloud アカウント ID。 |
StorageClass | バケットのストレージクラス。 |
RedundancyType | データ冗長性タイプ。 |
AccessMonitor | バケットに対するアクセスモニタリングが有効かどうか。 |
オブジェクト情報のクエリ
ossutil stat oss://examplebucket/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出力フィールド：
| フィールド | 説明 |
|---|---|
ACL | オブジェクトレベルの ACL。default は、オブジェクトがバケットの ACL を継承することを意味します。 |
Accept-Ranges | サーバーが範囲リクエスト（bytes）をサポートしていることを示します。 |
Content-Length | オブジェクトサイズ（バイト単位）。 |
Content-Md5 | オブジェクトコンテンツの Base64 エンコード MD5 ハッシュ。データ整合性の検証に使用されます。 |
Content-Type | オブジェクトの MIME タイプ。 |
Etag | オブジェクトの特定バージョンを識別するエンティティタグ。オブジェクトのコンテンツが変更されると、この値も変更されます。 |
Last-Modified | オブジェクトが最後に変更された日時。 |
Owner | オブジェクト所有者の Alibaba Cloud アカウント ID。 |
X-Oss-Hash-Crc64ecma | オブジェクトの CRC64 チェックサム。エンドツーエンドのデータ整合性検証に使用されます。 |
X-Oss-Object-Type | オブジェクト作成時に使用されたアップロードタイプ。Normal は、標準（マルチパート以外）アップロードであることを示します。 |
X-Oss-Storage-Class | オブジェクトのストレージクラス。 |
特殊文字を含むオブジェクト名のクエリ
ossutil では、オブジェクト名のエンコーディングとして URL エンコーディングのみがサポートされています。特殊文字を含むオブジェクト名をクエリするには、事前にその名前を URL セーフな文字列にエンコードする必要があります。
たとえば、示例.txt というオブジェクトをクエリする場合：
ossutil stat oss://examplebucket/%E7%A4%BA%E4%BE%8B.txt --encoding-type url実行結果の例：
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特定のオブジェクトバージョンのクエリ
ossutil stat oss://examplebucket/test.jpg --version-id CAEQFRiBgICw.YSX1xciIDNiNzc3ZTdmNTQzOTQ1OTM4MWUwOWI1Y2M1ZTgz****実行結果の例：
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出力には、標準のオブジェクトフィールドに加えて X-Oss-Version-Id も含まれます。バージョン ID を事前に確認するには、「ls」をご参照ください。
クロスアカウントおよびクロスリージョンでのクエリ
別のリージョンにあるバケットや、別の Alibaba Cloud アカウントが所有するバケットをクエリするには、-e、-i、-k オプションを追加し、それぞれエンドポイント、AccessKey ID、AccessKey Secret を指定します。
ossutil stat oss://testbucket \
-e oss-cn-shanghai.aliyuncs.com \
-i yourAccessKeyID \
-k yourAccessKeySecret詳細については、「共通オプション」をご参照ください。