DescribeLifecycleConfiguration - Amazon Elastic File System
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

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 的更多信息,请参阅以下内容: