View a markdown version of this page

GET 버킷 수명 주기(사용되지 않음) - Amazon Simple Storage Service
설명요청응답특수 오류예제관련 리소스

GET 버킷 수명 주기(사용되지 않음)

설명

중요

이 API의 업데이트된 버전은 GetBucketLifecycleConfiguration을 참조하세요. <filter> 요소를 사용하여 버킷 수명 주기를 구성한 경우 이 항목의 업데이트된 버전이 표시됩니다. 이 항목은 이전 버전과의 호환성을 위해 제공됩니다.

버킷에 설정된 lifecycle 구성 정보를 반환합니다. 수명 주기 구성에 대한 자세한 내용은 Amazon Simple Storage Service 사용 설명서의 객체 수명 주기 관리를 참조하세요.

이 작업을 사용하려면 s3:GetLifecycleConfiguration 작업을 수행할 수 있는 권한이 있어야 합니다. 버킷 소유자는 기본적으로 이 권한을 보유합니다. 버킷 소유자는 이 권한을 다른 사용자에게 부여할 수 있습니다. 권한에 대한 자세한 내용은 Amazon Simple Storage Service 사용 설명서의 Amazon S3 리소스에 대한 액세스 권한 관리를 참조하세요.

요청

구문

GET /?lifecycle HTTP/1.1
Host: bucketname.s3.amazonaws.com
Date: date
Authorization: authorization string (see 요청 인증(AWS 서명 버전 4))

요청 파라미터

이 작업 구현에서는 요청 파라미터를 사용하지 않습니다.

요청 헤더

이 작업의 구현에서는 모든 작업에 공통되는 요청 헤더만 사용합니다. 자세한 내용은 공통 요청 헤더를 참조하세요.

요청 요소

이 작업의 구현에서는 요청 요소를 사용하지 않습니다.

응답

응답 헤더

이 작업의 구현에서는 대부분의 응답에 공통되는 응답 헤더만 사용합니다. 자세한 내용은 공통 응답 헤더를 참조하세요.

응답 요소

이 GET의 구현은 다음 응답 요소를 반환합니다.

이름 설명 필수
AbortIncompleteMultipartUpload 미완료 멀티파트 업로드가 중단 작업의 대상이 되는 시점을 지정하기 위한 컨테이너입니다.

하위: DaysAfterInitiation

유형: 컨테이너

상위 항목: Rule

 규칙에 다른 작업이 지정되지 않은 경우, 예
Date

Amazon S3가 작업을 수행할 날짜입니다. 자세한 내용은 Amazon Simple Storage Service 사용 설명서의 수명 주기 규칙: 지정된 날짜 기반을 참조하세요.

날짜 값은 ISO 8601 형식을 준수해야 합니다. 시간은 항상 자정(UTC)입니다.

유형: 문자열

상위 항목: Expiration 또는 Transition

 Days 및 ExpiredObjectDeleteMarker가 없는 경우, 예
Days

객체 생성 후 특정 규칙 작업이 적용되기까지의 일수를 지정합니다. 객체의 자격 시간은 생성 시간 + 일수로 계산됩니다(결과 시간은 익일 자정 UTC로 올림됨).

유형: Transition과 함께 사용할 경우 음이 아닌 정수, Expiration과 함께 사용할 경우 양의 정수.

상위 항목: Transition 또는 Expiration

 Date 및 ExpiredObjectDeleteMarker가 없는 경우, 예
DaysAfterInitiation

멀티파트 업로드를 시작한 후 해당 멀티파트 업로드가 완료되어야 하는 시점까지의 일수를 지정합니다. 지정된 일수까지 완료되지 않으면 중단 작업을 수행할 수 있으며 Amazon S3는 미완료 멀티파트 업로드를 취소합니다.

유형: 양의 정수

상위 항목: AbortIncompleteMultipartUpload

 Date가 없는 경우, 예
Expiration

이 작업은 Amazon S3가 객체 수명에서 적절한 만료 작업을 수행해야 하는 기간을 지정합니다. 만료 작업은 하위 Date 또는 Days 요소에 지정된 기간에 따라 자격을 충족한 객체에서만 발생합니다. Amazon S3가 수행하는 작업은 버킷에서 버전 관리가 활성화되었는지 여부에 따라 달라집니다.

  • 버킷에서 버전 관리가 활성화되지 않은 경우 Amazon S3는 객체의 유일한 복사본을 영구적으로 삭제합니다.

  • 버킷에서 버전 관리가 활성화(또는 일시 중지)된 경우 해당 작업은 객체의 현재 버전에만 적용됩니다. 버전 관리가 활성화 또는 일시 중지된 버킷은 동일 객체에 대해 여러 버전을 가질 수 있습니다. 즉, 1개의 현재 버전과 0개 이상의 비 현재 버전이 존재할 수 있습니다.

    Amazon S3는 현재 객체 버전을 삭제하는 대신 새로운 현재 버전으로 삭제 마커를 추가하여 현재 버전을 비 현재 버전으로 전환합니다.

    중요

    버킷의 상태가 버전 관리 일시 중지인 경우 Amazon S3는 버전 ID가 null인 삭제 마커를 생성합니다. 버전 ID가 null인 버전이 있는 경우 Amazon S3는 해당 버전을 덮어씁니다.

    참고

    최신이 아닌 객체의 만료를 설정하려면 NoncurrentVersionExpiration 작업을 사용해야 합니다.

유형: 컨테이너

하위 항목: Days 또는 Date

상위 항목: Rule

 상위 태그가 지정된 경우, 예
ID

규칙의 고유 식별자입니다. 값은 255자보다 길 수 없습니다.

유형: 문자열

상위 항목: Rule

 아니요
LifecycleConfiguration

수명 주기 규칙을 위한 컨테이너입니다. 규칙을 최대 1,000개까지 추가할 수 있습니다.

유형: 컨테이너

하위 항목: Rule

상위 항목: 없음

 예
ExpiredObjectDeleteMarker

버전이 지정된 버킷(버전 관리가 활성화된 버킷 또는 버전 관리가 일시 중지된 버킷)에서 이 요소는 Amazon S3가 버킷에서 만료된 객체 삭제 마커를 삭제할지 여부를 나타냅니다. 예제는 Amazon Simple Storage Service 사용 설명서의 예제 8: 만료된 객체 삭제 마커를 제거하기 위한 만료 작업 지정을 참조하세요.

유형: 문자열

유효한 값: true | false(값 false는 허용되지만 no-op이며, Amazon S3는 값이 false인 경우 조치를 취하지 않음)

상위 항목: Expiration

 Date 및 Days가 없는 경우, 예
NoncurrentDays

Amazon S3가 관련 작업을 수행하기 전에 객체가 최신이 아닌 상태를 유지하는 기간(일수)을 지정합니다. 최신이 아닌 일수 계산에 대한 자세한 내용은 Amazon Simple Storage Service 사용 설명서의 일수 기반 수명 주기 규칙을 참조하세요.

유형: NoncurrentVersionTransition과 함께 사용할 경우 음이 아닌 정수, NoncurrentVersionExpiration과 함께 사용할 경우 양의 정수

상위 항목: NoncurrentVersionExpiration 또는 NoncurrentVersionTransition

 상위 항목이 있는 경우에만 예
NoncurrentVersionExpiration

최신이 아닌 객체 버전이 만료되는 시기를 지정합니다. 만료 시 Amazon S3는 최신이 아닌 객체 버전을 영구적으로 삭제합니다.

버전 관리가 활성화(또는 일시 중단)된 버킷에서 이 수명 주기 구성 작업을 설정하여 객체 수명의 특정 기간에 최신이 아닌 객체 버전을 삭제하도록 Amazon S3에 지시합니다.

유형: 컨테이너

하위 항목: NoncurrentDays

상위 항목: Rule

 Rule에 다른 작업이 없는 경우, 예
NoncurrentVersionTransition

최신이 아닌 객체가 STANDARD_IA, ONEZONE_IA 또는 스토리지 클래스로 전환되는 시기를 설명하는 전환 규칙을 위한 컨테이너입니다.

버킷에서 버전 관리가 활성화(또는 일시 중지)된 경우, 이 작업을 설정하여 객체 수명의 특정 기간에 최신이 아닌 객체 버전을 스토리지 클래스로 전환하도록 Amazon S3에 지시할 수 있습니다.

유형: 컨테이너

하위 항목: NoncurrentDays 및 StorageClass

상위 항목: Rule

 Rule에 다른 작업이 없는 경우, 예
Prefix

규칙이 적용되는 하나 이상의 객체를 식별하는 객체 키 접두사입니다.

유형: 문자열

상위 항목: Rule

 예
Rule

수명 주기 규칙을 위한 컨테이너입니다.

유형: 컨테이너

상위 항목: LifecycleConfiguration

 예
Status

활성화된 경우 Amazon S3는 예약된 대로 규칙을 실행합니다. 비활성화된 경우 Amazon S3는 규칙을 무시합니다.

유형: 문자열

상위 항목: Rule

유효한 값: Enabled 또는 Disabled

 예
StorageClass

객체를 전환하려는 Amazon S3 스토리지 클래스를 지정합니다.

유형: 문자열

상위 항목: Transition 및 NoncurrentVersionTransition

유효한 값: STANDARD_IA | ONEZONE_IA |

예
Transition

이 작업은 Amazon S3가 객체 수명에서 객체를 STANDARD_IA, ONEZONE_IA 또는 스토리지 클래스로 전환해야 하는 기간을 지정합니다. 이 작업이 적용되면 Amazon S3가 수행하는 작업은 버킷의 버전 관리 활성화 여부에 따라 달라집니다.

  • 버킷에서 버전 관리가 활성화된 적이 없는 경우 Amazon S3는 객체의 유일한 복사본을 지정된 스토리지 클래스로 전환합니다.

  • 버킷에 버전 관리가 활성화(또는 일시 중지)된 경우, Amazon S3는 규칙에서 식별된 객체의 현재 버전만 전환합니다.

    참고

    버전 관리가 활성화 또는 일시 중지된 버킷에는 동일 객체의 여러 버전이 포함될 수 있습니다. 이 작업은 최신이 아닌 객체 버전에는 영향을 주지 않습니다. 최신이 아닌 객체를 전환하려면 NoncurrentVersionTransition 작업을 사용해야 합니다.

유형: 컨테이너

하위 항목: Days 또는 Date, StorageClass

상위 항목: Rule

 Rule에 다른 작업이 없는 경우, 예

특수 오류

오류 코드 설명 HTTP 상태 코드 SOAP 오류 코드 접두사
NoSuchLifecycleConfiguration 수명 주기 구성이 없습니다. 404 Not Found(404 찾을 수 없음) 클라이언트

일반적인 Amazon S3 오류에 대한 자세한 내용 및 오류 코드 목록은 오류 응답 섹션을 참조하세요.

예제

예제 1: 수명 주기 하위 리소스 검색

이 예제는 지정된 버킷에서 lifecycle 하위 리소스를 검색하기 위한 GET 요청 및 반환된 수명 주기 구성이 포함된 예시 응답입니다.

샘플 요청

GET /?lifecycle HTTP/1.1
Host: examplebucket.s3.amazonaws.com
x-amz-date: Thu, 15 Nov 2012 00:17:21 GMT
Authorization: signatureValue

샘플 응답

HTTP/1.1 200 OK
x-amz-id-2: ITnGT1y4RyTmXa3rPi4hklTXouTf0hccUjo0iCPjz6FnfIutBj3M7fPGlWO2SEWp
x-amz-request-id: 51991C342C575321
Date: Thu, 15 Nov 2012 00:17:23 GMT
Server: AmazonS3
Content-Length: 358

<?xml version="1.0" encoding="UTF-8"?>
<LifecycleConfiguration xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
    <Rule>
        <ID>Archive and then delete rule</ID>
        <Prefix>projectdocs/</Prefix>
        <Status>Enabled</Status>
       <Transition>
           <Days>30</Days>
           <StorageClass>STANDARD_IA</StorageClass>
        </Transition>
        <Transition>
           <Days>365</Days>
           <StorageClass>GLACIER</StorageClass>
        </Transition>
        <Expiration>
           <Days>3650</Days>
        </Expiration>
    </Rule>
</LifecycleConfiguration>