すべてのプロダクト
Search

このプロダクト

    Object Storage Service:GetBucketInventory

    ドキュメントセンター

    Object Storage Service:GetBucketInventory

    最終更新日:Feb 22, 2024

    バケットの指定されたインベントリを照会します。

    使用上の注意

    デフォルトでは、Alibaba Cloudアカウントには、バケットの指定されたインベントリを照会する権限があります。 RAMユーザーまたはSTSを使用してバケットの指定されたインベントリを照会する場合は、oss:GetBucketInventory権限が必要です。

    リクエスト構文

    GET /?inventory&inventoryId=inventoryId HTTP/1.1

    リクエストパラメーター

    パラメーターデータ型必須説明
    inventoryIdString必須クエリするインベントリのID。

    レスポンスパラメーター

    パラメーターデータ型説明
    IdString指定されたインベントリ名。バケット内でグローバルに一意である必要があります。
    IsEnabledブール値インベントリ機能が有効かどうかを示します。
    有効な値: trueとfalse
    • 値がtrueの場合、インベントリ機能が有効になっていることを示します。
    • falseの値は、在庫リストが生成されないことを示します。
    フィルターContainerオブジェクトのフィルタリングに使用されるプレフィックスを格納するコンテナー。 指定されたプレフィックスを名前に含むオブジェクトのみがインベントリリストに含まれます。
    プレフィックスStringインベントリで指定されているプレフィックス。

    親ノード: フィルター

    目的地Containerエクスポートされた在庫リストに関する情報を格納するコンテナ。
    OSSBucketDestinationContainerエクスポートされたインベントリリストを格納するバケットに関する情報。

    親ノード: 宛先

    FormatStringエクスポートされた在庫リストの形式。

    有効値: CSV

    親ノード: OSSBucketDestination

    AccountIdStringバケット所有者によって付与されたアカウントID。

    親ノード: OSSBucketDestination

    RoleArnStringバケット所有者が権限を付与するロールの名前。

    形式: acs:ram::uid:role/rolename

    親ノード: OSSBucketDestination

    BucketStringエクスポートされたインベントリリストが保存されているバケット。

    親ノード: OSSBucketDestination

    プレフィックスStringエクスポートされたインベントリリストが格納されるパスに含まれるプレフィックス。

    親ノード: OSSBucketDestination

    暗号化Containerエクスポートされたインベントリリストの暗号化方法を格納するコンテナー。

    有効な値: SSE-OSS、SSE-KMS、およびNull

    親ノード: OSSBucketDestination

    SSE-OSSContainerSSE-OSS暗号化方式に関する情報を格納するコンテナー。

    親ノード: 暗号化

    SSE-KMSContainerSSE-KMS暗号化方式で使用される顧客マスターキー (CMK) を格納するコンテナー。

    親ノード: 暗号化

    KeyIdStringkey Management Service (KMS) によって管理されるキーのID。

    親ノード: SSE-KMS

    スケジュールContainer在庫リストがエクスポートされる頻度に関する情報を格納するコンテナ。
    周波数String在庫リストがエクスポートされる頻度。

    有効な値: DailyとWeekly

    親ノード: スケジュール

    含まれるObjectVersionsStringオブジェクトのバージョン情報をインベントリリストに含めるかどうかを示します。
    有効な値: すべてと現在
    • すべての値は、オブジェクトのすべてのバージョンがエクスポートされることを示します。
    • Currentの値は、オブジェクトの現在のバージョンのみがエクスポートされることを示します。
    OptionalFieldsContainerインベントリリストに含まれる構成フィールドを格納するコンテナ。
    フィールドStringインベントリリストに含まれる設定フィールド。

    有効な値: Size、LastModifiedDate、ETag、StorageClass、IsMultipartUploaded、およびEncryptionStatus

    親ノード: OptionalFields

    例

    • リクエストのサンプル
      GET /?inventory&inventoryId=list1 HTTP/1.1
    • HTTP/1.1 200のサンプル応答
      OK
  x-oss-request-id: 56594298207FB304438516F9
  日付: 10月31日月曜日2016 12:00:00 GMT
  Server: AliyunOSS
  コンテンツ-長さ: 長さ

  <?xml version="1.0" encoding="UTF-8"?>
  <InventoryConfiguration>
     <Id> レポート1</Id>
     <IsEnabled>true</IsEnabled>
     <宛先>
        <OSSBucketDestination>
           <フォーマット> CSV</フォーマット>
           <AccountId>1000000000000000</AccountId>
           <RoleArn>acs:ram::1000000000000000:role/AliyunOSSRole</RoleArn>
           <バケット> acs:oss :::bucket_0001</バケット>
           <Prefix>prefix1</Prefix>
           <暗号化>
              <SSE-OSS/>
           </暗号化>
        </OSSBucketDestination>
     </宛先>
     <スケジュール>
        <Frequency> デイリー </Frequency>
     </スケジュール>
     <フィルター>
       <Prefix>myprefix/</Prefix>
     </フィルター>
     <IncludedObjectVersions> すべての </IncludedObjectVersions>
     <OptionalFields>
        <フィールド> サイズ </フィールド>
        <フィールド> LastModifiedDate</フィールド>
        <フィールド> ETag</フィールド>
        <Field>StorageClass</Field>
        <Field>IsMultipartUploaded</Field>
        <Field>EncryptionStatus</Field>
     </OptionalFields>
  </InventoryConfiguration>