本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
DescribeLifecycleConfiguration
返回指定 Amazon EFS 文件系统的当前 LifecycleConfiguration 对象。生命周期管理使用 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 状态代码：400
- FileSystemNotFound
-
如果请求者的指定
FileSystemId值不存在，则返回。 Amazon Web Services 账户HTTP 状态代码：404
- InternalServerError
-
如果服务器端发生错误，则返回此内容。
HTTP 状态代码：500
示例
检索文件系统的生命周期配置
以下请求检索指定文件系统的 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"
}
]
}
另请参阅
有关在特定语言的 Amazon SDK 中使用此 API 的更多信息，请参阅以下内容：