Object Storage Service:GetBucketInventory

注意事項

デフォルトでは、Alibaba Cloud アカウントはバケットの指定されたインベントリ設定を表示する権限があります。Resource Access Management (RAM) ユーザーとして、または Security Token Service (STS) を使用してこの API を呼び出すには、oss:GetBucketInventory アクセス許可が必要です。

リクエスト構文

GET /?inventory&inventoryId=inventoryId HTTP/1.1

リクエストパラメーター

レスポンス要素

次の表に、レスポンスに含まれる要素を示します。一部の要素は、特定のインベントリ設定にのみ適用されます。たとえば、DayOfMonth は Frequency が Monthly に設定されている場合にのみ適用され、AutoDelete は Frequency が Once に設定されている場合にのみ適用されます。増分インベントリに固有の要素については、次のサブセクションで説明します。

増分インベントリレコードのフィールド

増分インベントリファイルのレコードには、次のフィールドが含まれます：

• SequenceNumber： レコードのシリアル番号。各レコードの SequenceNumber は一意です。同じバケット内の同じオブジェクトのレコードは SequenceNumber でソートでき、ソートされたレコードは通常、時系列順になります。

• RecordType： イベントタイプ。有効な値：

  • CREATE： 選択したプレフィックス配下で発生するすべてのアップロード操作 (Put、Post、Append、MultipartUpload、Copy など)。

  • UPDATE_METADATA： 選択したプレフィックス配下でのすべてのメタデータ更新。

  • DELETE： 選択したプレフィックス配下でのオブジェクトのすべての削除操作 (DeleteObject や DeleteMultipleObjects など)、バージョニングが有効になった後の削除マーカーの生成、およびライフサイクルルールによる削除。削除には、削除マーカーの作成と完全な削除が含まれます。完全な削除の場合、レコードにはコアフィールドの Bucket、Key、SequenceNumber、RecordType、RecordTimestamp、VersionId のみが保持され、他のすべての列はnullになります。

• RecordTimestamp： レコードのタイムスタンプ。グリニッジ標準時 (GMT) で、ミリ秒単位の精度です。例： 2024-08-25 18:08:01.024。

• Requester： リクエスターの Alibaba Cloud ID またはプリンシパルID。

• RequestId： リクエストの一意の識別子。

• SourceIp： リクエスターのソース IP アドレス。

• Key： バケット内のオブジェクトの URL エンコードされた名前。

• VersionId： オブジェクトのバージョンID。このフィールドは、設定されたインベントリ ルールがすべてのバージョンをエクスポートする場合にのみ表示されます。

  • インベントリ ルールが設定されているバケットでバージョニングが有効になっていない場合、このフィールドは空になります。

  • インベントリ ルールが設定されているバケットでバージョニングが有効になっている場合、このフィールドにはオブジェクトの VersionId が表示されます。

• IsDeleteMarker： オブジェクトのバージョンが削除マーカーであるかどうかを指定します。このフィールドは、設定されたインベントリ ルールがすべてのバージョンをエクスポートする場合にのみ表示されます。

  • インベントリ ルールが設定されているバケットでバージョニングが有効になっていない場合、このフィールドのデフォルトは false です。

  • インベントリ ルールが設定されているバケットでバージョニングが有効になっている場合、オブジェクトが削除マーカーである場合はこのフィールドは true になり、オブジェクトが削除マーカーでない場合は false になります。

• Size： オブジェクトのサイズ。

• StorageClass： オブジェクトのストレージクラス。

• LastModifiedDate： オブジェクトの最終更新日時。

• ETag： オブジェクトの ETag。ETag はオブジェクトが生成されるときに作成され、オブジェクトのコンテンツを識別します。

  • PutObject API を使用して作成されたオブジェクトの場合、ETag はそのコンテンツのMD5ハッシュです。

  • 他のメソッドを使用して作成されたオブジェクトの場合、ETag は特定の計算ルールに基づいて生成された一意の値であり、そのコンテンツのMD5ハッシュではありません。

• IsMultipartUploaded： オブジェクトがマルチパートアップロードを使用してアップロードされたかどうかを指定します。

• ObjectType： オブジェクトのタイプ。

• ObjectAcl： オブジェクトのアクセスコントロールリスト。

• Crc64： オブジェクトの CRC-64 値。

• EncryptionStatus： オブジェクトが暗号化されているかどうかを指定します。

例

• リクエスト例

GET /?inventory&inventoryId=report1 HTTP/1.1

• レスポンス例

HTTP/1.1 200 OK
  x-oss-request-id: 56594298207FB304438516F9
  Date: Mon, 31 Oct 2016 12:00:00 GMT
  Server: AliyunOSS
  Content-Length: length

  <?xml version="1.0" encoding="UTF-8"?>
  <InventoryConfiguration>
     <Id>report1</Id>
     <IsEnabled>true</IsEnabled>
     <Destination>
        <OSSBucketDestination>
           <Format>CSV</Format>
           <AccountId>1000000000000000</AccountId>
           <RoleArn>acs:ram::1000000000000000:role/AliyunOSSRole</RoleArn>
           <Bucket>acs:oss:::bucket_0001</Bucket>
           <Prefix>prefix1</Prefix>
           <Encryption>
              <SSE-OSS/>
           </Encryption>
        </OSSBucketDestination>
     </Destination>
     <Schedule>
        <Frequency>Daily</Frequency>
     </Schedule>
     <Filter>
       <Prefix>myprefix/</Prefix>
     </Filter>
     <IncludedObjectVersions>All</IncludedObjectVersions>
     <OptionalFields>
        <Field>Size</Field>
        <Field>LastModifiedDate</Field>
        <Field>ETag</Field>
        <Field>StorageClass</Field>
        <Field>IsMultipartUploaded</Field>
        <Field>EncryptionStatus</Field>
     </OptionalFields>
  </InventoryConfiguration>

SDK

このAPIは、次のSDKでサポートされています：

• Java

• Python V2

• Go V2

• Node.js

• C++

• .NET

ossutil CLI

GetBucketInventory API に対応する ossutil コマンドの詳細は、「get-bucket-inventory」をご参照ください。