ListBucketInventory - Object Storage Service - Alibaba Cloud ドキュメントセンター

この操作を呼び出して、バケットに設定されているすべてのインベントリタスクを照会できます。

説明

リクエストを送信することで、最大100のインベントリ設定を照会できます。 100を超えるインベントリ設定をクエリするには、複数のリクエストを送信し、各リクエストのトークンを保持して、次のリクエストのパラメーターとして使用する必要があります。
この操作を呼び出すには、バケットのインベントリタスクで操作を実行する権限があることを確認します。デフォルトでは、バケット所有者にはこの操作を実行する権限があります。権限がない場合は、バケット所有者から権限を申請してください。

リクエスト構文

継続トークン

を含むリクエストGET /? inventory&continuation-token=xxx HTTP/1.1

継続トークン

を含まないリクエストGET /? インベントリHTTP/1.1

レスポンス要素

要素	データ型	説明
InventoryConfiguration	Container	インベントリ設定を格納するコンテナ。
IsTruncated	Boolean	バケットに設定されているすべてのインベントリタスクを一覧表示するかどうかを指定します。有効な値: trueとfalse falseの値は、バケットに設定されたすべてのインベントリタスクがリストされていることを示します。 trueの値は、バケットに設定されているすべてのインベントリタスクがリストされていないことを示します。インベントリ設定の次のページを一覧表示するには、次のリクエストのcontinuation-tokenパラメーターを、現在のリクエストに対するレスポンスのNextContinuationTokenヘッダーの値に設定します。
NextContinuationToken	String	レスポンスのIsTruncatedの値がtrueで、このヘッダーの値がnullでない場合は、次のリクエストのcontinuation-tokenパラメーターをこのヘッダーの値に設定します。
Id	String	指定されたインベントリリスト名。バケット内でグローバルに一意である必要があります。
IsEnabled	Boolean	インベントリ機能が有効かどうかを示します。有効な値: trueとfalse trueの値は、インベントリ機能が有効になっていることを示します。 falseの値は、在庫リストが生成されないことを示します。
フィルター	Container	インベントリリスト内のオブジェクトをフィルタリングするために使用されるプレフィックスを格納するコンテナー。指定されたプレフィックスを持つオブジェクトのみがインベントリリストに含まれます。
プレフィックス	String	インベントリルールで指定されたプレフィックス。親ノード: フィルター
目的地	Container	エクスポートされたインベントリリストを格納するバケットに関する情報を格納するために使用されるコンテナー。
OSSBucketDestination	Container	エクスポートされたインベントリリストを格納するバケットに関する情報。親ノード: 宛先
Format	String	エクスポートされた在庫リストの形式。有効値: CSV 親ノード: OSSBucketDestination
AccountId	String	バケット所有者によって付与されたアカウントID。親ノード: OSSBucketDestination
RoleArn	String	バケット所有者が権限を付与するロールの名前。形式: acs:ram::uid:role/rolename 親ノード: OSSBucketDestination
Bucket	String	エクスポートされた在庫リストを格納するバケット。親ノード: OSSBucketDestination
プレフィックス	String	エクスポートされた在庫リストのパス。親ノード: OSSBucketDestination
暗号化	Container	インベントリリストの暗号化方法を格納するコンテナ。有効な値: SSE-OSS、SSE-KMS、およびNull 親ノード: OSSBucketDestination
SSE-OSS	Container	SSE-OSS暗号化方式に関する情報を格納するコンテナー。親ノード: 暗号化
SSE-KMS	Container	SSE-KMS暗号化方式で使用されるCMKを格納するコンテナー。親ノード: 暗号化
KeyId	String	SSE-KMS暗号化方式で使用されるCMK。親ノード: SSE-KMS
スケジュール	Container	在庫リストがエクスポートされる頻度を格納するコンテナ。
周波数	String	インベントリリストがエクスポートされる頻度。有効な値: DailyとWeekly 親ノード: スケジュール
含まれるObjectVersions	String	オブジェクトに関するバージョン管理情報をインベントリリストに含めるかどうかを指定します。有効な値: すべてと現在 Allの値は、オブジェクトのすべてのバージョンがエクスポートされることを示します。 Currentの値は、オブジェクトの現在のバージョンのみがエクスポートされることを示します。
OptionalFields	Container	インベントリリストに含まれる構成フィールドを格納するコンテナ。
フィールド	Container	インベントリリストに含まれる設定フィールド。有効な値: Size、LastModifiedDate、ETag、StorageClass、IsMultipartUploaded、およびEncryptionStatus 親ノード: OptionalFields

例

サンプルリクエスト

GET /? インベントリHTTP/1.1
  Host: BucketName.oss.aliyuncs.com
  Date: Fri, 24 Feb 2012 03:55:00 GMT
  権限付与: 権限付与文字列
  Content-Type: text/plain

HTTP/1.1 200のサンプル応答

OK
  x-oss-request-id: 56594298207FB304438516F9
  日付: 4月30日 (土) 2016 23:29:37 GMT
  Content-Type: application/xml
  コンテンツ-長さ: 長さ
  Connection: close
  Server: AliyunOSS

  <? xml version="1.0" encoding="UTF-8"? >
  <ListInventoryConfigurationsResult>
     <InventoryConfiguration>
        <Id> レポート1</Id>
        <IsEnabled>true</IsEnabled>
        <宛先>
           <OSSBucketDestination>
              <フォーマット> CSV</フォーマット>
              <AccountId>1000000000000000</AccountId>
              <RoleArn>acs:ram::1000000000000000:role/AliyunOSSRole</RoleArn>
              <Bucket>acs:oss ::: destination-bucket</Bucket>
              <Prefix>prefix1</Prefix>
           </OSSBucketDestination>
        </宛先>
        <スケジュール>
           <Frequency> デイリー </Frequency>
        </スケジュール>
        <フィルター>
           <Prefix>prefix/One</Prefix>
        </フィルター>
        <IncludedObjectVersions> すべての </IncludedObjectVersions>
        <OptionalFields>
           <フィールド> サイズ </フィールド>
           <フィールド> LastModifiedDate</フィールド>
           <フィールド> ETag</フィールド>
           <Field>StorageClass</Field>
           <Field>IsMultipartUploaded</Field>
           <Field>EncryptionStatus</Field>
        </OptionalFields>
     </InventoryConfiguration>
     <InventoryConfiguration>
        <Id>report2</Id>
        <IsEnabled>true</IsEnabled>
        <宛先>
           <OSSBucketDestination>
              <フォーマット> CSV</フォーマット>
              <AccountId>1000000000000000</AccountId>
              <RoleArn>acs:ram::1000000000000000:role/AliyunOSSRole</RoleArn>
              <Bucket>acs:oss ::: destination-bucket</Bucket>
              <Prefix>prefix2</Prefix>
           </OSSBucketDestination>
        </宛先>
        <スケジュール>
           <Frequency> デイリー </Frequency>
        </スケジュール>
        <フィルター>
           <Prefix>prefix/Two</Prefix>
        </フィルター>
        <IncludedObjectVersions> すべての </IncludedObjectVersions>
        <OptionalFields>
           <フィールド> サイズ </フィールド>
           <フィールド> LastModifiedDate</フィールド>
           <フィールド> ETag</フィールド>
           <Field>StorageClass</Field>
           <Field>IsMultipartUploaded</Field>
           <Field>EncryptionStatus</Field>
        </OptionalFields>
     </InventoryConfiguration>
     <InventoryConfiguration>
        <Id>report3</Id>
        <IsEnabled>true</IsEnabled>
        <宛先>
           <OSSBucketDestination>
              <フォーマット> CSV</フォーマット>
              <AccountId>1000000000000000</AccountId>
              <RoleArn>acs:ram::1000000000000000:role/AliyunOSSRole</RoleArn>
              <Bucket>acs:oss ::: destination-bucket</Bucket>
              <Prefix>prefix3</Prefix>
           </OSSBucketDestination>
        </宛先>
        <スケジュール>
           <Frequency> デイリー </Frequency>
        </スケジュール>
        <フィルター>
           <Prefix>prefix/Three</Prefix>
        </フィルター>
        <IncludedObjectVersions> すべての </IncludedObjectVersions>
        <OptionalFields>
           <フィールド> サイズ </フィールド>
           <フィールド> LastModifiedDate</フィールド>
           <フィールド> ETag</フィールド>
           <Field>StorageClass</Field>
           <Field>IsMultipartUploaded</Field>
           <Field>EncryptionStatus</Field>
        </OptionalFields>
     </InventoryConfiguration>
      ...
     <IsTruncated>true</IsTruncated>
     <NextContinuationToken>... </NextContinuationToken> 
  </ListInventoryConfigurationsResult>