PutLifecycleConfiguration - Amazon Elastic File System

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

PutLifecycleConfiguration

使用此動作可管理檔案系統的儲存空間。LifecycleConfiguration 由定義下列項目的一或多個 LifecyclePolicy 物件組成:

  • TransitionToIA:何時將檔案系統中的檔案從主要儲存 (標準儲存類別) 移至 Infrequent Access (IA) 儲存類別。

  • TransitionToArchive:何時將檔案系統中的檔案從目前主要儲存類別 (IA 或標準儲存) 移至「封存」儲存。

    檔案系統在轉移至 IA 儲存之前,無法轉移至「封存」儲存。因此,不 TransitionToArchive 得設定或必須晚於 TransitionTo IA。

    注意

    封存儲存體類別僅適用於使用彈性輸送量模式和一般目的效能模式的檔案系統。

  • TransitionToPrimaryStorageClass:在檔案系統中的檔案存取到 IA 或「封存」儲存后,是否將其移回主要存儲 (標準存儲類別)。

如需詳細資訊,請參閱管理檔案系統儲存

每個 Amazon EFS 檔案系統都支援一個生命週期組態,適用於檔案系統中的所有檔案。如果指定的檔案系統已存在 LifecycleConfiguration 物件,則 PutLifecycleConfiguration 呼叫會修改現有組態。請求主體中含有空 LifecyclePolicies 陣列的 PutLifecycleConfiguration 呼叫會刪除任何現有的 LifecycleConfiguration。在請求中,指定下列項目:

  • 您要啟用、停用或修改生命週期管理之檔案系統的 ID。

  • LifecyclePolicy 物件的 LifecyclePolicies 陣列用於定義將檔案移至 IA 儲存、「封存」儲存,以及移回主要儲存的時間。

    注意

    Amazon EFS 要求每個LifecyclePolicy對象只有一個轉換,因此LifecyclePolicies數組需要使用單獨的對LifecyclePolicy象進行構造。如需詳細資訊,請參閱下文中的請求範例。

這項操作需要 elasticfilesystem:PutLifecycleConfiguration 操作許可。

若要將LifecycleConfiguration物件套用至加密的檔案系統,您需要與建立加密檔案系統時相同的 AWS Key Management Service 權限。

請求語法

PUT /2015-02-01/file-systems/FileSystemId/lifecycle-configuration HTTP/1.1 Content-type: application/json { "LifecyclePolicies": [ { "TransitionToArchive": "string", "TransitionToIA": "string", "TransitionToPrimaryStorageClass": "string" } ] }

URI請求參數

請求使用下列URI參數。

FileSystemId

正在建立 LifecycleConfiguration 物件的檔案系統 ID (字串)。

長度限制:長度上限為 128。

模式:^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$

必要:是

請求主體

請求接受以下JSON格式的數據。

LifecyclePolicies

用於定義檔案系統 LifecycleConfiguration 物件的 LifecyclePolicy 物件陣列。LifecycleConfiguration物件會通知下列事項的生命週期管理:

  • TransitionToIA:何時將檔案系統中的檔案從主要儲存 (標準儲存類別) 移至 Infrequent Access (IA) 儲存類別。

  • TransitionToArchive:何時將檔案系統中的檔案從目前主要儲存類別 (IA 或標準儲存) 移至「封存」儲存。

    檔案系統在轉移至 IA 儲存之前,無法轉移至「封存」儲存。因此,不 TransitionToArchive 得設定或必須晚於 TransitionTo IA。

    注意

    封存儲存體類別僅適用於使用彈性輸送量模式和一般目的效能模式的檔案系統。

  • TransitionToPrimaryStorageClass:在檔案系統中的檔案存取到 IA 或「封存」儲存后,是否將其移回主要存儲 (標準存儲類別)。

注意

使用命put-lifecycle-configurationCLI令或PutLifecycleConfigurationAPI動作時,Amazon EFS 要求每個LifecyclePolicy物件只有一個轉換。這意味著在請求內文中,LifecyclePolicies 必須結構化為 LifecyclePolicy 物件陣列,每次儲存轉移對應一個物件。如需詳細資訊,請參閱下文中的請求範例。

類型:LifecyclePolicy 物件陣列

陣列成員:最多 3 個項目。

必要:是

回應語法

HTTP/1.1 200 Content-type: application/json { "LifecyclePolicies": [ { "TransitionToArchive": "string", "TransitionToIA": "string", "TransitionToPrimaryStorageClass": "string" } ] }

回應元素

如果動作成功,服務會傳回 HTTP 200 回應。

服務會以JSON格式傳回下列資料。

LifecyclePolicies

生命週期管理政策陣列。EFS每個檔案系統最多支援一個策略。

類型:LifecyclePolicy 物件陣列

陣列成員:最多 3 個項目。

錯誤

BadRequest

如果請求格式錯誤或包含錯誤,例如無效的參數值或缺少必要參數,則傳回。

HTTP狀態碼:

FileSystemNotFound

如果請求者中不存在指定的FileSystemId AWS 帳戶值,則返回。

HTTP狀態碼:

IncorrectFileSystemLifeCycleState

如果檔案系統的生命週期狀態不是「可用」,則傳回。

HTTP狀態碼:4

InternalServerError

如果伺服器端發生錯誤,則傳回。

HTTP狀態碼:5

範例

建立生命週期組態

下列範例會使用 PutLifecycleConfiguration 動作建立 LifecyclePolicy 物件。此範例會建立生命週期原則,指示執EFS行下列動作:

  • 將過去 30 天內未在標準儲存中存取過的檔案系統中的所有檔案移至封存儲存。

  • 將過去 90 天內未在標準儲存中存取過的檔案系統中的所有檔案移至封存儲存。

  • 檔案儲存到 IA 或「封存」儲存中后,再移回標準存儲。封存儲存體類別僅適用於使用彈性輸送量模式和一般目的效能模式的檔案系統。

如需詳細資訊,請參閱EFS儲存區類別管理檔案系統儲存

請求範例

PUT /2015-02-01/file-systems/fs-0123456789abcdefb/lifecycle-configuration HTTP/1.1 Host: elasticfilesystem.us-west-2.amazonaws.com x-amz-date: 20181122T232908Z Authorization: <...> Content-type: application/json Content-Length: 86 { "LifecyclePolicies": [ { "TransitionToArchive": "AFTER_90_DAYS" }, { "TransitionToIA": "AFTER_30_DAYS" }, { "TransitionToPrimaryStorage": "AFTER_1_ACCESS" } ] }

回應範例

HTTP/1.1 200 OK x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef Content-type: application/json Content-Length: 86 { "LifecyclePolicies": [ { "TransitionToArchive": "AFTER_90_DAYS" }, { "TransitionToIA": "AFTER_30_DAYS" }, { "TransitionToPrimaryStorage": "AFTER_1_ACCESS" } ] }

put-lifecycle-configuration CLI請求示例

此範例說明的一種用法 PutLifecycleConfiguration。

請求範例

aws efs put-lifecycle-configuration \ --file-system-id fs-0123456789abcdefb \ --lifecycle-policies "[{"TransitionToArchive":"AFTER_90_DAYS"}, {"TransitionToIA":"AFTER_30_DAYS"}, {"TransitionToPrimaryStorageClass":"AFTER_1_ACCESS"}] --region us-west-2 \ --profile adminuser

回應範例

{ "LifecyclePolicies": [ { "TransitionToArchive": "AFTER_90_DAYS" }, { "TransitionToIA": "AFTER_30_DAYS" }, { "TransitionToPrimaryStorageClass": "AFTER_1_ACCESS" } ] }

停用生命週期管理

下列範例會停用指定檔案系統的生命週期管理。

請求範例

PUT /2015-02-01/file-systems/fs-01234567/lifecycle-configuration HTTP/1.1 Host: elasticfilesystem.us-west-2.amazonaws.com x-amz-date: 20181122T232908Z Authorization: <...> Content-type: application/json Content-Length: 86 { "LifecyclePolicies": [ ] }

回應範例

HTTP/1.1 200 OK x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef Content-type: application/json Content-Length: 86 { "LifecyclePolicies": [ ] }

另請參閱

如需有關API在其中一種特定語言中使用此功能的詳細資訊 AWS SDKs,請參閱下列內容: