PutBucketLifecycle
최신 업데이트：2025-08-18 15:50:10
PutBucketLifecycle는 공간(버킷)에 대해 라이프사이클을 생성하거나 기존 라이프사이클 규칙을 대체할 때 사용합니다. IAM wos:PutBucketLifecycle 권한이 필요합니다.
요청 문법
PUT /?lifecycle HTTP/1.1
Host: Bucket.Endpoint
<?xml version="1.0" encoding="UTF-8"?>
<LifecycleConfiguration xmlns="https://www.wangsu.com/document ">
<Rule>
<Expiration>
<Days>integer</Days>
</Expiration>
<Filter>
<Prefix>string</Prefix>
</Filter>
<ID>string</ID>
<Transition>
<Date>timestamp</Date>
<StorageClass>string</StorageClass>
</Transition>
</Rule>
...
</LifecycleConfiguration>
URI 요청 파라미터
없음
요청 헤더
Common Request Headers 만 사용하세요.
요청 본문
요청 본문은 아래와 같은 XML 정보입니다.
| 요소명 | 요소 설명 |
|---|---|
| LifecycleConfiguration | 라이프사이클 구성 리스트를 정의합니다. 타입: XML 자식 노드: Rule 부모 노드: 없음 |
| Rule | 특정 라이프사이클 규칙의 상세 구성을 정의합니다. 타입: XML 부모 노드: LifecycleConfiguration 자식 노드: Filter |
| ID | 각 규칙의 고유 식별자를 정의합니다. 타입: String 부모 노드: Rule |
| Filter | 라이프사이클 규칙에 해당하는 객체 하위 집합을 정의합니다. 현재는 객체명 prefix 기반만 지원합니다. 정의하지 않으면(<Filter></Filter>), 해당 라이프사이클 규칙이 공간 내 모든 객체에 적용됩니다. 타입: XML 자식 노드: Prefix 부모 노드: Rule |
| Prefix | 라이프사이클 구성에 대한 필터 조건을 정의합니다. 지정한 prefix에 부합하는 객체에만 라이프사이클이 적용됩니다. 타입: String 부모 노드: Filter |
| Expiration | Filter에 일치하는 객체의 만료 규칙을 정의합니다. 타입: XML 자식 노드: Days |
| Days (Expiration 하위) | 객체의 상대 만료 일수를 정의합니다. 예: 값이 3이면, 마지막 수정 시간 기준 3일 후 삭제됨을 의미합니다. 타입: 양의 정수 부모 노드: Expiration |
| Transition | 스토리지 클래스 전환 규칙을 정의합니다. 타입: XML 자식 노드: Days |
| Days (Transition 하위) | 전환이 발생하는 일수. 타입: 양의 정수 부모 노드: Transition |
| StorageClass | 전환 타입(IA-저빈도, Archive-아카이브). 타입: String 부모 노드: Transition |
응답 문법
HTTP/1.1 200 OK
x-wos-request-id: request id
Content-Type: type
Date: date
Content-Length: length
Server: WS-web-server
응답 헤더
Common Response Headers 만 사용하세요.
응답 요소
없음
예시
30일 후 저빈도, 60일 후 아카이브, 365일 후 삭제 규칙을 생성하는 예시
PUT /?lifecycle HTTP/1.1
Host: bucket.s3-cn-east-1.wcsapi.com
x-amz-date: Sun, 14 May 2017 02:11:21 GMT
Content-MD5: q6yJDlIkcBaGGfb3QLY69A==
Authorization: authorization string
Content-Length: 105
<LifecycleConfiguration>
<Rule>
<ID>id1</ID>
<Filter>
<Prefix>logs/</Prefix>
</Filter>
<Status>Enabled</Status>
<Expiration>
<Days>365</Days>
</Expiration>
<Transition>
<Days>30</Days>
<StorageClass>IA</StorageClass>
</Transition>
<Transition>
<Days>60</Days>
<StorageClass>Archive</StorageClass>
</Transition>
</Rule>
</LifecycleConfiguration>
HTTP/1.1 200 OK
x-wos-request-id: 9E26D08072A8EF9E
Date: Sun, 14 May 2017 02:11:22 GMT
Content-Length: 0
Server: WCS-Web-Server
이 문서의 내용이 도움이 되었습니까?
예
아니오