本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
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-configuration
CLI令或PutLifecycleConfiguration
API動作時,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 或「封存」儲存中后,再移回標準存儲。封存儲存體類別僅適用於使用彈性輸送量模式和一般目的效能模式的檔案系統。
請求範例
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,請參閱下列內容: