DescribeLifecycleConfiguration - Amazon Elastic File System
請求語法URI請求參數請求主體回應語法回應元素錯誤範例另請參閱

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

DescribeLifecycleConfiguration

傳回指LifecycleConfiguration定 Amazon EFS 檔案系統的目前物件。生命週期管理使用 LifecycleConfiguration 物件來識別在儲存類別之間移動檔案的時間。對於沒有 LifecycleConfiguration 物件的檔案系統，呼叫會在回應中傳回空陣列。

這項操作需要 elasticfilesystem:DescribeLifecycleConfiguration 動作許可。

請求語法

GET /2015-02-01/file-systems/FileSystemId/lifecycle-configuration HTTP/1.1

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})$

必要：是

請求主體

請求沒有請求主體。

回應語法

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狀態碼:

InternalServerError

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

HTTP狀態碼:5

範例

擷取檔案系統的生命週期組態

下列請求會擷取指定檔案系統的 LifecycleConfiguration 物件。

請求範例

GET /2015-02-01/file-systems/fs-01234567/lifecycle-configuration HTTP/1.1
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20181120T221118Z
Authorization: <...>

回應範例

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

另請參閱

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