Object Storage Service:PutBucketInventory

使用上の注意

インベントリを使用して、オブジェクトの数量、サイズ、ストレージクラス、暗号化ステータスなど、バケット内のオブジェクトに関する情報を取得できます。 バケットのインベントリを設定するときは、次の項目に注意してください。

• PutBucketInventory権限を持つバケット所有者またはユーザーのみがPutBucketInventoryリクエストを開始できます。

• バケットのインベントリを設定する前に、RAMロールを作成する必要があります。 RAMロールには、ソースバケットからすべてのオブジェクトを読み取り、ターゲットバケットにオブジェクトを書き込む権限が必要です。 初めてバケットインベントリ機能を使用する場合は、Object Storage Service (OSS) コンソールでインベントリを設定することを推奨します。 インベントリを設定すると、OSSリソースに対するすべての操作を実行する権限を持つRAMロールを取得できます。 詳細については、「バケットインベントリ」をご参照ください。

• バケットには最大1,000のインベントリを設定できます。

• インベントリを構成するソースバケットは、インベントリリストが保存されているターゲットバケットと同じリージョンにデプロイする必要があります。

リクエスト構文

PUT /?inventory&inventoryId=report1 HTTP/1.1
  Host: BucketName.oss-cn-hangzhou.aliyuncs.com
  日付: 10月31日月曜日2016 12:00:00 GMT
  権限付与: 権限付与文字列
  コンテンツ-長さ: 長さ

  <?xml version="1.0" encoding="UTF-8"?>
    <InventoryConfiguration>
     <Id> レポート1</Id>
     <IsEnabled>true</IsEnabled>
     <フィルター>
           <Prefix>filterPrefix/</Prefix>
           <LastModifyBeginTimeStamp>1637883649</LastModifyBeginTimeStamp>
           <LastModifyEndTimeStamp>1638347592</LastModifyEndTimeStamp>
           <LowerSizeBound>1024</LowerSizeBound>
           <UpperSizeBound>1048576</UpperSizeBound>
           <StorageClass> 標準、IA</StorageClass>
     </フィルター>
     <宛先>
        <OSSBucketDestination>
           <フォーマット> CSV</フォーマット>
           <AccountId>1000000000000000</AccountId>
           <RoleArn>acs:ram::1000000000000000:role/AliyunOSSRole</RoleArn>
           <Bucket>acs:oss ::: destination-bucket</Bucket>
           <Prefix>prefix1</Prefix>
           <暗号化>
              <SSE-KMS>
                 <KeyId>keyId</KeyId>
              </SSE-KMS>
           </暗号化>
        </OSSBucketDestination>
     </宛先>
     <スケジュール>
        <Frequency> デイリー </Frequency>
     </スケジュール>
     <IncludedObjectVersions> すべての </IncludedObjectVersions>
     <OptionalFields>
        <フィールド> サイズ </フィールド>
        <フィールド> LastModifiedDate</フィールド>
        <フィールド> ETag</フィールド>
        <Field>StorageClass</Field>
        <Field>IsMultipartUploaded</Field>
        <Field>EncryptionStatus</Field>
     </OptionalFields>
  </InventoryConfiguration> 

リクエスト要素

レスポンスヘッダー

PutBucketInventoryリクエストに対するレスポンスのすべてのヘッダーは、Content-LengthやDateなどの共通のレスポンスヘッダーです。 詳細については、「共通レスポンスヘッダー」をご参照ください。

例

• リクエストの例

  PUT /?inventory&inventoryId=report1 HTTP/1.1
    Host: oss-example.oss-cn-hangzhou.aliyuncs.com
    日付: 10月31日月曜日2016 12:00:00 GMT
    権限付与: 権限付与文字列
    コンテンツ-長さ: 長さ
  
    <?xml version="1.0" encoding="UTF-8"?>
    <InventoryConfiguration>
       <Id> レポート1</Id>
       <IsEnabled>true</IsEnabled>
       <フィルター>
           <Prefix>Pics/</Prefix>
           <LastModifyBeginTimeStamp>1637883649</LastModifyBeginTimeStamp>
           <LastModifyEndTimeStamp>1638347592</LastModifyEndTimeStamp>
           <LowerSizeBound>1024</LowerSizeBound>
           <UpperSizeBound>1048576</UpperSizeBound>
           <StorageClass> 標準、IA</StorageClass>
       </フィルター>
       <宛先>
          <OSSBucketDestination>
            <フォーマット> CSV</フォーマット>
            <AccountId>100000000000000</AccountId>
            <RoleArn>acs:ram::100000000000000:role/AliyunOSSRole</RoleArn>
            <Bucket>acs:oss :: destbucket</Bucket>
            <Prefix>prefix1/</Prefix>
            <暗号化>
               <SSE-KMS>
                  <KeyId>keyId</KeyId>
               </SSE-KMS>
             </暗号化>
          </OSSBucketDestination>
       </宛先>
       <スケジュール>
          <Frequency> デイリー </Frequency>
       </スケジュール>
       <IncludedObjectVersions> すべての </IncludedObjectVersions>
       <OptionalFields>
          <フィールド> サイズ </フィールド>
          <フィールド> LastModifiedDate</フィールド>
          <フィールド> ETag</フィールド>
          <Field>StorageClass</Field>
          <Field>IsMultipartUploaded</Field>
          <Field>EncryptionStatus</Field>
       </OptionalFields>
    </InventoryConfiguration> 

• レスポンスの例

  HTTP/1.1 200 OK
    x-oss-request-id: 56594298207FB3044385 ****
    日付: 10月31日月曜日2016 12:00:00 GMT
    Content-Length: 0
    サーバー: AliyunOSS 

エラーコード