PutBucketLifecycleConfiguration

Prev Next

最新のコンテンツが反映されていません。早急にアップデート内容をご提供できるよう努めております。最新のコンテンツ内容は韓国語ページをご参照ください。

Classic/VPC環境で利用できます。

Ncloud Storageバケットにライフサイクルの新規ルールを登録したり、既存のライフサイクルルールを上書きしたりします。

参考

オブジェクト削除作業(現在のバージョンの削除、以前のバージョンの削除、有効期限切れの削除マーカーの削除)の安定した運用のため、一時的に無効になりました。既存のルールによる期限切れ作業は実行されません。機能再開時に改めてご案内いたします。

リクエスト

リクエスト形式を説明します。リクエスト形式は次の通りです。

メソッド URL
PUT -

リクエストヘッダ

Ncloud Storage APIで共通して使用されるヘッダの詳細は、Ncloud Storageのリクエストヘッダをご参照ください。

リクエストボディ

リクエストボディの説明は次の通りです。

フィールド タイプ 必須の有無 説明
Rule List Required ルールリスト
  • 最大1,000個まで
Rule.ID String Optional ルール名
  • 最大255文字まで入力可能
Rule.Filter List Optional ルールを適用する objectを区別するフィルタ
Rule.Filter.Prefix String Optional ルールを適用する objectの接頭辞、現在は接頭辞で絞り込みのみ可能
Rule.Expiration List Optional 有効期間ルール
Rule.Expiration.Days Integer Optional オブジェクトが作成された後に削除される日数、0より大きい正の整数であること
Rule.Transition List Optional ストレージクラス移行ルール
Rule.Transition.Days Integer Optional オブジェクトが作成された後に指定のストレージクラスに移行される日数、正の整数であること
Rule.Transition.StorageClass String Optional 移行先のストレージクラス
  • DEEP_ARCHIVE: Archive Class
Rule.NoncurrentVersionExpiration List Optional 非現行オブジェクトバージョンの有効期間ルール
Rule.NoncurrentVersionExpiration.NewerNoncurrentVersions Integer Optional 保管する非現行バージョン数
  • 最大100個まで
Rule.NoncurrentVersionExpiration.NoncurrentDays Integer Optional オブジェクトが非現行状態で保持される日数
  • 0より大きい正の整数
Rule.NoncurrentVersionTransition List Optional 非現行オブジェクトバージョンのストレージクラス移行ルール
Rule.NoncurrentVersionTransition.NewerNoncurrentVersions Integer Optional オブジェクトを移行する前に、同じストレージクラスに保管する非現行バージョン数
  • 最大100個まで
Rule.NoncurrentVersionTransition.NoncurrentDays Integer Optional オブジェクトが非現行状態で保持される日数
  • 正の整数
Rule.NoncurrentVersionTransition.StorageClass String Optional 移行先のストレージクラス
  • DEEP_ARCHIVE: Archive Class
参考

Dateフィールドはサポートしていません。

リクエスト例

リクエストのサンプルコードは次の通りです。

バケットバージョンが有効化していない場合

Transitionルールに従い、「logs/」の接頭辞を持つ objectを180日経過後に DEEP_ARCHIVEストレージクラスに移行するリクエストのサンプルコードは次の通りです。

PUT /?lifecycle HTTP/1.1
Host: bucket.kr.ncloudstorage.com
<LifecycleConfiguration xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
   <Rule>
      <ID>id1</ID>
      <Filter>
         <Prefix>logs/</Prefix>
      </Filter>
      <Status>Enabled</Status>
      <Transition>
         <Days>180</Days>
         <StorageClass>DEEP_ARCHIVE</StorageClass>
      </Transition>
   </Rule>
</LifecycleConfiguration>

バケットバージョンが有効化している場合

NoncurrentVersionTransitionルールに従い、「logs/」の接頭辞を持つオブジェクトの、最も新しい5つの以前バージョンを除く残りのバージョンを、以前の状態になってから180日経過後に自動的に DEEP_ARCHIVEストレージクラスに移行するリクエストのサンプルコードは次の通りです。

PUT /?lifecycle HTTP/1.1
Host: bucket.kr.ncloudstorage.com
<LifecycleConfiguration xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
   <Rule>
      <ID>id2</ID>
      <Filter>
         <Prefix>logs/</Prefix>
      </Filter>
      <Status>Enabled</Status>
      <NoncurrentVersionTransition>
         <NewerNoncurrentVersions>5</NewerNoncurrentVersions>
         <NoncurrentDays>180</NoncurrentDays>
         <StorageClass>DEEP_ARCHIVE</StorageClass>
      </NoncurrentVersionTransition>
   </Rule>
</LifecycleConfiguration>

レスポンス

レスポンス形式を説明します。

レスポンスヘッダ

Ncloud Storage APIで共通して使用されるヘッダの詳細は、Ncloud Storageのレスポンスヘッダをご参照ください。

レスポンスステータスコード

Ncloud Storage APIで共通して使用されるレスポンスステータスコードの詳細は、Ncloud Storageのレスポンスステータスコードをご参照ください。

レスポンス例

レスポンスのサンプルコードは次の通りです。

HTTP/1.1 200 OK