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

類型：容器

Ancestor： Rule

 是，如果沒有為規則指定其他動作
Date

您希望 Amazon S3 採取動作的日期。如需詳細資訊，請參閱《Amazon Simple Storage Service 使用者指南》中的生命週期規則：根據特定日期。

日期值必須符合 ISO 8601 格式。時間一律是午夜 UTC。

類型：字串

Ancestor： Expiration或 Transition

 是，如果 Days和 ExpiredObjectDeleteMarker 不存在
Days

指定特定規則動作生效時，物件建立後的天數。物件的資格時間計算方式為建立時間 + 產生的時間四捨五入至隔天午夜 UTC 的天數。

類型：與 搭配使用時的非負整數Transition，與 搭配使用時為正整數Expiration。

Ancestor： Transition或 Expiration

 是，如果 Date和 ExpiredObjectDeleteMarker 不存在
DaysAfterInitiation

指定必須完成分段上傳時，啟動分段上傳後的天數。如果未在指定的天數之前完成，則會符合中止操作的資格，且 Amazon S3 會取消未完成的分段上傳。

類型：正整數

Ancestor： AbortIncompleteMultipartUpload

 是，如果 Date 不存在
Expiration

此動作會指定物件生命週期內 Amazon S3 應採取適當過期動作的期間。過期動作只會發生在根據子項Date或Days元素中指定的期間符合資格的物件上。Amazon S3 採取的動作取決於儲存貯體是否已啟用版本控制。

  • 如果從未在儲存貯體上啟用版本控制，Amazon S3 會永久刪除物件的唯一複本。

  • 否則，如果您的儲存貯體已啟用版本控制 （或版本控制已暫停），則 動作僅適用於物件的目前版本。已啟用版本控制或暫停版本控制的儲存貯體可以有許多相同物件的版本：一個目前版本，以及零或多個非目前版本。

    Amazon S3 不會刪除目前版本，而是新增刪除標記做為新的目前版本，使其成為非目前版本。

    重要

    如果儲存貯體的狀態已暫停版本控制，Amazon S3 會建立版本 ID 為 的刪除標記null。如果您有版本 ID 為 的版本null，則 Amazon S3 會覆寫該版本。

    注意

    若要設定非目前物件的過期，您必須使用 NoncurrentVersionExpiration動作。

類型：容器

子系：天或日期

Ancestor：規則

 是，如果指定父標籤
ID

規則的唯一識別碼。該值不可超過 255 個字元。

類型：字串

Ancestor：規則

 否
LifecycleConfiguration

生命週期規則的容器。最多可以新增 1000 個規則。

類型：容器

子系：規則

Ancestor：無

 是
ExpiredObjectDeleteMarker

在版本控制儲存貯體 （啟用版本控制或暫停版本控制儲存貯體） 上，此元素會指出 Amazon S3 是否會刪除儲存貯體中任何過期的物件刪除標記。如需範例，請參閱《Amazon Simple Storage Service 使用者指南》中的範例 8：指定過期動作以移除過期的物件刪除標記。

類型：字串

有效值：true | false （允許 false 值，但為無操作，如果值為 false，Amazon S3 不會採取動作）

Ancestor： Expiration

 是，如果 Date和 Days 不存在
NoncurrentDays

指定 物件在 Amazon S3 可以執行關聯動作之前為非最新版本的天數。如需計算非目前天數的資訊，請參閱《Amazon Simple Storage Service 使用者指南》中的以天數為基礎的生命週期規則。

類型：與 搭配使用時的非負整數NoncurrentVersionTransition，與 搭配使用時為正整數 NoncurrentVersionExpiration

Ancestor： NoncurrentVersionExpiration或 NoncurrentVersionTransition

 是，只有在上階存在時
NoncurrentVersionExpiration

指定非目前物件版本的到期時間。過期時，Amazon S3 會永久刪除非目前的物件版本。

在已啟用 （或暫停） 版本控制的儲存貯體上設定此生命週期組態動作，以請求 Amazon S3 在物件生命週期內的特定期間內刪除非目前物件版本。

類型：容器

子系：NoncurrentDays

Ancestor：規則

 是，如果 中不存在其他動作 Rule
NoncurrentVersionTransition

轉換規則的容器，描述非目前物件何時轉換至 STANDARD_IA、 ONEZONE_IA或 儲存體方案。

如果您的儲存貯體已啟用版本控制 （或版本控制已暫停），您可以設定此動作，請求 Amazon S3 在物件生命週期的特定期間，將非目前物件版本轉換為儲存類別。

類型：容器

子系：NoncurrentDays 和 StorageClass

Ancestor：規則

 是，如果 中不存在其他動作 Rule
Prefix

物件金鑰字首，識別套用規則的一或多個物件。

類型：字串

Ancestor：規則

 是
Rule

生命週期規則的容器。

類型：容器

Ancestor：LifecycleConfiguration

 是
Status

如果已啟用，Amazon S3 會依排程執行規則。如果停用，Amazon S3 會忽略規則。

類型：字串

Ancestor：規則

有效值：啟用或停用

 是
StorageClass

指定您要轉換物件的 Amazon S3 儲存體方案。

類型：字串

Ancestor：Transition NoncurrentVersionTransition

有效值： STANDARD_IA | ONEZONE_IA |

是
Transition

此動作會指定物件生命週期內 Amazon S3 應將物件轉換為 STANDARD_IA、 ONEZONE_IA或 儲存類別的期間。當此動作生效時，Amazon S3 執行的操作取決於儲存貯體是否已啟用版本控制。

  • 如果從未在儲存貯體上啟用版本控制，Amazon S3 會將物件的唯一複本轉換為指定的儲存類別。

  • 當您的儲存貯體已啟用版本控制 （或暫停版本控制） 時，Amazon S3 只會轉換規則中識別之物件的目前版本。

    注意

    啟用版本控制或暫停版本控制的儲存貯體可以包含物件的許多版本。此動作不會影響非目前物件版本。若要轉換非目前物件，您必須使用 NoncurrentVersionTransition動作。

類型：容器

子系：天或日期，以及 StorageClass

Ancestor：規則

 是，如果 中不存在其他動作 Rule

特殊錯誤

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