Object Storage Service:PutBucketInventory

注意事項

インベントリを使用して、バケット内のオブジェクトに関する情報（オブジェクトの数、サイズ、ストレージタイプ、暗号化ステータスなど）を取得できます。 バケットのインベントリを設定する際は、以下の点にご注意ください。

• バケットオーナー、または oss:PutBucketInventory 権限を持つユーザーのみが、PutBucketInventory リクエストを開始できます。 詳細については、「RAM ユーザーにカスタムポリシーをアタッチする」をご参照ください。

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

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

• インベントリを設定するソースバケットは、インベントリリストが保存されるデスティネーションバケットと同じリージョンにデプロイする必要があります。

リクエスト構文

  PUT /?inventory&inventoryId=report1 HTTP/1.1
  Host: BucketName.oss-cn-hangzhou.aliyuncs.com
  Date: Mon, 31 Oct 2016 12:00:00 GMT
  Authorization: authorization string
  Content-Length: length

  <?xml version="1.0" encoding="UTF-8"?>
    <InventoryConfiguration>
     <Id>report1</Id>
     <IsEnabled>true</IsEnabled>
     <Filter>
           <Prefix>filterPrefix/</Prefix>
           <LastModifyBeginTimeStamp>1637883649</LastModifyBeginTimeStamp>
           <LastModifyEndTimeStamp>1638347592</LastModifyEndTimeStamp>
           <LowerSizeBound>1024</LowerSizeBound>
           <UpperSizeBound>1048576</UpperSizeBound>
           <StorageClass>Standard,IA</StorageClass>
     </Filter>
     <Destination>
        <OSSBucketDestination>
           <Format>CSV</Format>
           <AccountId>1000000000000000</AccountId>
           <RoleArn>acs:ram::1000000000000000:role/AliyunOSSRole</RoleArn>
           <Bucket>acs:oss:::destination-bucket</Bucket>
           <Prefix>prefix1</Prefix>
           <Encryption>
              <SSE-KMS>
                 <KeyId>keyId</KeyId>
              </SSE-KMS>
           </Encryption>
        </OSSBucketDestination>
     </Destination>
     <Schedule>
        <Frequency>Daily</Frequency>
     </Schedule>
     <IncludedObjectVersions>All</IncludedObjectVersions>
     <OptionalFields>
        <Field>Size</Field>
        <Field>LastModifiedDate</Field>
        <Field>TransistionTime</Field>
        <Field>ETag</Field>
        <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
    Date: Mon, 31 Oct 2016 12:00:00 GMT
    Authorization: authorization string
    Content-Length: length
  
    <?xml version="1.0" encoding="UTF-8"?>
    <InventoryConfiguration>
       <Id>report1</Id>
       <IsEnabled>true</IsEnabled>
       <Filter>
           <Prefix>Pics/</Prefix>
           <LastModifyBeginTimeStamp>1637883649</LastModifyBeginTimeStamp>
           <LastModifyEndTimeStamp>1638347592</LastModifyEndTimeStamp>
           <LowerSizeBound>1024</LowerSizeBound>
           <UpperSizeBound>1048576</UpperSizeBound>
           <StorageClass>Standard,IA</StorageClass>
       </Filter>
       <Destination>
          <OSSBucketDestination>
            <Format>CSV</Format>
            <AccountId>100000000000000</AccountId>
            <RoleArn>acs:ram::100000000000000:role/AliyunOSSRole</RoleArn>
            <Bucket>acs:oss:::destbucket</Bucket>
            <Prefix>prefix1/</Prefix>
            <Encryption>
               <SSE-KMS>
                  <KeyId>keyId</KeyId>
               </SSE-KMS>
             </Encryption>
          </OSSBucketDestination>
       </Destination>
       <Schedule>
          <Frequency>Daily</Frequency>
       </Schedule>
       <IncludedObjectVersions>All</IncludedObjectVersions>
       <OptionalFields>
          <Field>Size</Field>
          <Field>LastModifiedDate</Field>
          <Field>TransistionTime</Field> 
          <Field>ETag</Field>
          <Field>StorageClass</Field>
          <Field>IsMultipartUploaded</Field>
          <Field>EncryptionStatus</Field>
       </OptionalFields>
    </InventoryConfiguration>

• レスポンスの例

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

OSS SDK

以下のプログラミング言語の OSS SDK を使用して、PutBucketInventory を呼び出すことができます。

• Java

• Python

• Go V2

• Node.js

• C++

• .NET

ossutil

PutBucketInventory 操作に対応する ossutil コマンドについては、「put-bucket-inventory」をご参照ください。

エラーコード