# GET 버킷 수명 주기(사용되지 않음)
<a name="v1-rel-RESTBucketGETlifecycle"></a>

## 설명
<a name="v1-rel-RESTBucketGETlifecycle_Description"></a>



 

**중요**  
이 API의 업데이트된 버전은 [GetBucketLifecycleConfiguration](https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketLifecycleConfiguration.html)을 참조하세요. <filter> 요소를 사용하여 버킷 수명 주기를 구성한 경우 이 항목의 업데이트된 버전이 표시됩니다. 이 항목은 이전 버전과의 호환성을 위해 제공됩니다.

버킷에 설정된 `lifecycle` 구성 정보를 반환합니다. 수명 주기 구성에 대한 자세한 내용은 *Amazon Simple Storage Service 사용 설명서*의 [객체 수명 주기 관리](https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-lifecycle-mgmt.html)를 참조하세요.

이 작업을 사용하려면 `s3:GetLifecycleConfiguration` 작업을 수행할 수 있는 권한이 있어야 합니다. 버킷 소유자는 기본적으로 이 권한을 보유합니다. 버킷 소유자는 이 권한을 다른 사용자에게 부여할 수 있습니다. 권한에 대한 자세한 내용은 *Amazon Simple Storage Service 사용 설명서*의 [Amazon S3 리소스에 대한 액세스 권한 관리](https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html)를 참조하세요.

## 요청
<a name="v1-rel-RESTBucketGETlifecycle-requests"></a>

### 구문
<a name="v1-rel-RESTBucketGETlifecycle-requests-syntax"></a>

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

### 요청 파라미터
<a name="v1-rel-RESTBucketGETlifecycle-requests-request-parameters"></a>

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

### 요청 헤더
<a name="v1-rel-RESTBucketGETlifecycle-requests-request-headers"></a>

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

### 요청 요소
<a name="v1-rel-RESTBucketGETlifecycle-requests-request-elements"></a>

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

## 응답
<a name="v1-rel-RESTBucketGETlifecycle-responses"></a>

### 응답 헤더
<a name="v1-rel-RESTBucketGETlifecycle-responses-response-headers"></a>

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

### 응답 요소
<a name="v1-rel-RESTBucketGETlifecycle-responses-response-elements"></a>

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


|  이름  |  설명  | 필수 | 
| --- | --- | --- | 
|  AbortIncompleteMultipartUpload  | 미완료 멀티파트 업로드가 중단 작업의 대상이 되는 시점을 지정하기 위한 컨테이너입니다.하위: `DaysAfterInitiation`<br />유형: 컨테이너<br />상위 항목: `Rule` | 규칙에 다른 작업이 지정되지 않은 경우, 예 | 
|  Date  | Amazon S3가 작업을 수행할 날짜입니다. 자세한 내용은 *Amazon Simple Storage Service 사용 설명서*의 [수명 주기 규칙: 지정된 날짜 기반](https://docs.aws.amazon.com/AmazonS3/latest/userguide/intro-lifecycle-rules.html#intro-lifecycle-rules-date)을 참조하세요.<br />날짜 값은 ISO 8601 형식을 준수해야 합니다. 시간은 항상 자정(UTC)입니다.<br />유형: 문자열<br />상위 항목: `Expiration` 또는 `Transition` | Days 및 ExpiredObjectDeleteMarker가 없는 경우, 예 | 
|  Days  | 객체 생성 후 특정 규칙 작업이 적용되기까지의 일수를 지정합니다. 객체의 자격 시간은 생성 시간 \+ 일수로 계산됩니다(결과 시간은 익일 자정 UTC로 올림됨).<br />유형: `Transition`과 함께 사용할 경우 음이 아닌 정수, `Expiration`과 함께 사용할 경우 양의 정수.<br />상위 항목: `Transition` 또는 `Expiration` | Date 및 ExpiredObjectDeleteMarker가 없는 경우, 예 | 
|  DaysAfterInitiation  | 멀티파트 업로드를 시작한 후 해당 멀티파트 업로드가 완료되어야 하는 시점까지의 일수를 지정합니다. 지정된 일수까지 완료되지 않으면 중단 작업을 수행할 수 있으며 Amazon S3는 미완료 멀티파트 업로드를 취소합니다.<br />유형: 양의 정수<br />상위 항목: `AbortIncompleteMultipartUpload` | Date가 없는 경우, 예 | 
|  Expiration  | 이 작업은 Amazon S3가 객체 수명에서 적절한 만료 작업을 수행해야 하는 기간을 지정합니다. 만료 작업은 하위 `Date` 또는 `Days` 요소에 지정된 기간에 따라 자격을 충족한 객체에서만 발생합니다. Amazon S3가 수행하는 작업은 버킷에서 버전 관리가 활성화되었는지 여부에 따라 달라집니다.<br /> +  버킷에서 버전 관리가 활성화되지 않은 경우 Amazon S3는 객체의 유일한 복사본을 영구적으로 삭제합니다. <br />+  버킷에서 버전 관리가 활성화(또는 일시 중지)된 경우 해당 작업은 객체의 현재 버전에만 적용됩니다. 버전 관리가 활성화 또는 일시 중지된 버킷은 동일 객체에 대해 여러 버전을 가질 수 있습니다. 즉, 1개의 현재 버전과 0개 이상의 비 현재 버전이 존재할 수 있습니다. <br />Amazon S3는 현재 객체 버전을 삭제하는 대신 새로운 현재 버전으로 삭제 마커를 추가하여 현재 버전을 비 현재 버전으로 전환합니다. <br />  버킷의 상태가 버전 관리 일시 중지인 경우 Amazon S3는 버전 ID가 `null`인 삭제 마커를 생성합니다. 버전 ID가 `null`인 버전이 있는 경우 Amazon S3는 해당 버전을 덮어씁니다.  <br />  최신이 아닌 객체의 만료를 설정하려면 `NoncurrentVersionExpiration` 작업을 사용해야 합니다.  <br />유형: 컨테이너<br />하위 항목: Days 또는 Date<br />상위 항목: Rule | 상위 태그가 지정된 경우, 예 | 
|  ID  | 규칙의 고유 식별자입니다. 값은 255자보다 길 수 없습니다.<br />유형: 문자열<br />상위 항목: Rule | 아니요 | 
| LifecycleConfiguration  | 수명 주기 규칙을 위한 컨테이너입니다. 규칙을 최대 1,000개까지 추가할 수 있습니다.<br />유형: 컨테이너<br />하위 항목: Rule<br />상위 항목: 없음 | 예 | 
| ExpiredObjectDeleteMarker | 버전이 지정된 버킷(버전 관리가 활성화된 버킷 또는 버전 관리가 일시 중지된 버킷)에서 이 요소는 Amazon S3가 버킷에서 만료된 객체 삭제 마커를 삭제할지 여부를 나타냅니다. 예제는 *Amazon Simple Storage Service 사용 설명서*의 [예제 8: 만료된 객체 삭제 마커를 제거하기 위한 만료 작업 지정](https://docs.aws.amazon.com/AmazonS3/latest/userguide/intro-lifecycle-rules.html#lifecycle-config-conceptual-ex8)을 참조하세요.<br />유형: 문자열 <br />유효한 값: true \| false(값 false는 허용되지만 no-op이며, Amazon S3는 값이 false인 경우 조치를 취하지 않음)<br />상위 항목: `Expiration` | Date 및 Days가 없는 경우, 예 | 
| NoncurrentDays  | Amazon S3가 관련 작업을 수행하기 전에 객체가 최신이 아닌 상태를 유지하는 기간(일수)을 지정합니다. 최신이 아닌 일수 계산에 대한 자세한 내용은 *Amazon Simple Storage Service 사용 설명서*의 [일수 기반 수명 주기 규칙](https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-lifecycle-mgmt.html#intro-lifecycle-actions-number-of-days)을 참조하세요.<br />유형: `NoncurrentVersionTransition`과 함께 사용할 경우 음이 아닌 정수, `NoncurrentVersionExpiration`과 함께 사용할 경우 양의 정수<br />상위 항목: `NoncurrentVersionExpiration` 또는 `NoncurrentVersionTransition` | 상위 항목이 있는 경우에만 예 | 
| NoncurrentVersionExpiration  | 최신이 아닌 객체 버전이 만료되는 시기를 지정합니다. 만료 시 Amazon S3는 최신이 아닌 객체 버전을 영구적으로 삭제합니다.<br />버전 관리가 활성화(또는 일시 중단)된 버킷에서 이 수명 주기 구성 작업을 설정하여 객체 수명의 특정 기간에 최신이 아닌 객체 버전을 삭제하도록 Amazon S3에 지시합니다.<br />유형: 컨테이너<br />하위 항목: NoncurrentDays <br />상위 항목: Rule | Rule에 다른 작업이 없는 경우, 예 | 
| NoncurrentVersionTransition | 최신이 아닌 객체가 `STANDARD_IA`, `ONEZONE_IA` 또는 스토리지 클래스로 전환되는 시기를 설명하는 전환 규칙을 위한 컨테이너입니다.<br />버킷에서 버전 관리가 활성화(또는 일시 중지)된 경우, 이 작업을 설정하여 객체 수명의 특정 기간에 최신이 아닌 객체 버전을 스토리지 클래스로 전환하도록 Amazon S3에 지시할 수 있습니다.<br />유형: 컨테이너<br />하위 항목: NoncurrentDays 및 StorageClass<br />상위 항목: Rule | Rule에 다른 작업이 없는 경우, 예 | 
|  Prefix  | 규칙이 적용되는 하나 이상의 객체를 식별하는 객체 키 접두사입니다.<br />유형: 문자열<br />상위 항목: Rule | 예 | 
| Rule  | 수명 주기 규칙을 위한 컨테이너입니다.<br />유형: 컨테이너<br />상위 항목: LifecycleConfiguration | 예 | 
|  Status  | 활성화된 경우 Amazon S3는 예약된 대로 규칙을 실행합니다. 비활성화된 경우 Amazon S3는 규칙을 무시합니다.<br />유형: 문자열<br />상위 항목: Rule<br />유효한 값: Enabled 또는 Disabled | 예 | 
|  StorageClass  | 객체를 전환하려는 Amazon S3 스토리지 클래스를 지정합니다.<br />유형: 문자열<br />상위 항목: Transition 및 NoncurrentVersionTransition<br />유효한 값: `STANDARD_IA` \| `ONEZONE_IA` \|  | 예 | 
|  Transition  | 이 작업은 Amazon S3가 객체 수명에서 객체를 `STANDARD_IA`, `ONEZONE_IA` 또는 스토리지 클래스로 전환해야 하는 기간을 지정합니다. 이 작업이 적용되면 Amazon S3가 수행하는 작업은 버킷의 버전 관리 활성화 여부에 따라 달라집니다.<br /> +  버킷에서 버전 관리가 활성화된 적이 없는 경우 Amazon S3는 객체의 유일한 복사본을 지정된 스토리지 클래스로 전환합니다. <br />+  버킷에 버전 관리가 활성화(또는 일시 중지)된 경우, Amazon S3는 규칙에서 식별된 객체의 현재 버전만 전환합니다. <br />  버전 관리가 활성화 또는 일시 중지된 버킷에는 동일 객체의 여러 버전이 포함될 수 있습니다. 이 작업은 최신이 아닌 객체 버전에는 영향을 주지 않습니다. 최신이 아닌 객체를 전환하려면 `NoncurrentVersionTransition` 작업을 사용해야 합니다.  <br />유형: 컨테이너<br />하위 항목: Days 또는 Date, StorageClass<br />상위 항목: Rule | Rule에 다른 작업이 없는 경우, 예 | 

## 특수 오류
<a name="v1-rel-RESTBucketGETlifecycle-special-errors"></a>


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

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

## 예제
<a name="v1-rel-RESTBucketGETlifecycle-examples"></a>

### 예제 1: 수명 주기 하위 리소스 검색
<a name="v1-rel-RESTBucketGETlifecycle-examples-example-1-retrieve-lifecycle-subresource-"></a>

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

#### 샘플 요청
<a name="v1-rel-RESTBucketGETlifecycle-examples-example-1-retrieve-lifecycle-subresource--sample-request"></a>

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

#### 샘플 응답
<a name="v1-rel-RESTBucketGETlifecycle-examples-example-1-retrieve-lifecycle-subresource--sample-response"></a>

```
 1. HTTP/1.1 200 OK
 2. x-amz-id-2: ITnGT1y4RyTmXa3rPi4hklTXouTf0hccUjo0iCPjz6FnfIutBj3M7fPGlWO2SEWp
 3. x-amz-request-id: 51991C342C575321
 4. Date: Thu, 15 Nov 2012 00:17:23 GMT
 5. Server: AmazonS3
 6. Content-Length: 358
 7. 
 8. <?xml version="1.0" encoding="UTF-8"?>
 9. <LifecycleConfiguration xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
10.     <Rule>
11.         <ID>Archive and then delete rule</ID>
12.         <Prefix>projectdocs/</Prefix>
13.         <Status>Enabled</Status>
14.        <Transition>
15.            <Days>30</Days>
16.            <StorageClass>STANDARD_IA</StorageClass>
17.         </Transition>
18.         <Transition>
19.            <Days>365</Days>
20.            <StorageClass>GLACIER</StorageClass>
21.         </Transition>
22.         <Expiration>
23.            <Days>3650</Days>
24.         </Expiration>
25.     </Rule>
26. </LifecycleConfiguration>
```

## 관련 리소스
<a name="v1-rel-RESTBucketGETlifecycle-related-resources"></a>
+ [PutBucketLifecycleConfiguration](https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketLifecycleConfiguration.html)
+ [DeleteBucketLifecycle](https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketLifecycle.html)