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