本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 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 />Ancestor： `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 />Ancestor： `Expiration`或 `Transition` | 是，如果 Days和 ExpiredObjectDeleteMarker 不存在 | 
|  Days  | 指定特定規則動作生效時，物件建立後的天數。物件的資格時間計算方式為建立時間 \+ 產生的時間四捨五入至隔天午夜 UTC 的天數。<br />類型：與 搭配使用時的非負整數`Transition`，與 搭配使用時為正整數`Expiration`。<br />Ancestor： `Transition`或 `Expiration` | 是，如果 Date和 ExpiredObjectDeleteMarker 不存在 | 
|  DaysAfterInitiation  | 指定必須完成分段上傳時，啟動分段上傳後的天數。如果未在指定的天數之前完成，則會符合中止操作的資格，且 Amazon S3 會取消未完成的分段上傳。<br />類型：正整數<br />Ancestor： `AbortIncompleteMultipartUpload` | 是，如果 Date 不存在 | 
|  Expiration  | 此動作會指定物件生命週期內 Amazon S3 應採取適當過期動作的期間。過期動作只會發生在根據子項`Date`或`Days`元素中指定的期間符合資格的物件上。Amazon S3 採取的動作取決於儲存貯體是否已啟用版本控制。<br /> +  如果從未在儲存貯體上啟用版本控制，Amazon S3 會永久刪除物件的唯一複本。 <br />+  否則，如果您的儲存貯體已啟用版本控制 （或版本控制已暫停），則 動作僅適用於物件的目前版本。已啟用版本控制或暫停版本控制的儲存貯體可以有許多相同物件的版本：一個目前版本，以及零或多個非目前版本。 <br />Amazon S3 不會刪除目前版本，而是新增刪除標記做為新的目前版本，使其成為非目前版本。 <br />  如果儲存貯體的狀態已暫停版本控制，Amazon S3 會建立版本 ID 為 的刪除標記`null`。如果您有版本 ID 為 的版本`null`，則 Amazon S3 會覆寫該版本。  <br />  若要設定非目前物件的過期，您必須使用 `NoncurrentVersionExpiration`動作。  <br />類型：容器<br />子系：天或日期<br />Ancestor：規則 | 是，如果指定父標籤 | 
|  ID  | 規則的唯一識別碼。該值不可超過 255 個字元。<br />類型：字串<br />Ancestor：規則 | 否 | 
| LifecycleConfiguration  | 生命週期規則的容器。最多可以新增 1000 個規則。<br />類型：容器<br />子系：規則<br />Ancestor：無 | 是 | 
| 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 值，但為無操作，如果值為 false，Amazon S3 不會採取動作）<br />Ancestor： `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 />Ancestor： `NoncurrentVersionExpiration`或 `NoncurrentVersionTransition` | 是，只有在上階存在時 | 
| NoncurrentVersionExpiration  | 指定非目前物件版本的到期時間。過期時，Amazon S3 會永久刪除非目前的物件版本。<br />在已啟用 （或暫停） 版本控制的儲存貯體上設定此生命週期組態動作，以請求 Amazon S3 在物件生命週期內的特定期間內刪除非目前物件版本。<br />類型：容器<br />子系：NoncurrentDays <br />Ancestor：規則 | 是，如果 中不存在其他動作 Rule | 
| NoncurrentVersionTransition | 轉換規則的容器，描述非目前物件何時轉換至 `STANDARD_IA`、 `ONEZONE_IA`或 儲存體方案。<br />如果您的儲存貯體已啟用版本控制 （或版本控制已暫停），您可以設定此動作，請求 Amazon S3 在物件生命週期的特定期間，將非目前物件版本轉換為儲存類別。<br />類型：容器<br />子系：NoncurrentDays 和 StorageClass<br />Ancestor：規則 | 是，如果 中不存在其他動作 Rule | 
|  Prefix  | 物件金鑰字首，識別套用規則的一或多個物件。<br />類型：字串<br />Ancestor：規則 | 是 | 
| Rule  | 生命週期規則的容器。<br />類型：容器<br />Ancestor：LifecycleConfiguration | 是 | 
|  Status  | 如果已啟用，Amazon S3 會依排程執行規則。如果停用，Amazon S3 會忽略規則。<br />類型：字串<br />Ancestor：規則<br />有效值：啟用或停用 | 是 | 
|  StorageClass  | 指定您要轉換物件的 Amazon S3 儲存體方案。<br />類型：字串<br />Ancestor：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 />子系：天或日期，以及 StorageClass<br />Ancestor：規則 | 是，如果 中不存在其他動作 Rule | 

## 特殊錯誤
<a name="v1-rel-RESTBucketGETlifecycle-special-errors"></a>


| 錯誤程式碼 | 說明 | HTTP 狀態碼 | SOAP 故障碼字首 | 
| --- | --- | --- | --- | 
| NoSuchLifecycleConfiguration | 生命週期組態不存在。 | 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)