PutLifecycleConfiguration
이 작업을 사용하면 파일 시스템의 스토리지를 관리할 수 있습니다. LifecycleConfiguration
은 다음을 정의하는 하나 이상의 LifecyclePolicy
객체로 구성됩니다.
-
TransitionToIA
- 파일 시스템의 파일을 기본 스토리지(Standard 스토리지 클래스)에서 Inrequent Access(IA) 스토리지로 이동하는 시점입니다. -
TransitionToArchive
- 파일 시스템의 파일을 현재 스토리지 클래스(IA 또는 Standard 스토리지)에서 Archive 스토리지로 이동하는 시점입니다.IA 스토리지로 전환하기 전에는 파일 시스템을 Archive 스토리지로 전환할 수 없습니다. 따라서 TransitionToArchive는 설정되지 않았거나 TransitionToIA 이후여야 합니다.
참고
Archive 스토리지 클래스는 탄력적 처리량 모드 및 범용 성능 모드를 사용하는 파일 시스템에만 사용할 수 있습니다.
-
TransitionToPrimaryStorageClass
- IA 또는 Archive 스토리지에서 액세스된 후 파일 시스템의 파일을 기본 스토리지(Standard 스토리지 클래스)로 다시 이동할지 여부입니다.
자세한 내용은 파일 시스템 스토리지 관리 섹션을 참조하십시오.
각 Amazon EFS 파일 시스템은 파일 시스템의 모든 파일에 적용되는 하나의 수명 주기 구성을 지원합니다. 지정된 파일 시스템에 대한 LifecycleConfiguration
객체가 이미 존재하는 경우 PutLifecycleConfiguration
직접 호출을 통해 기존 구성이 수정됩니다. 요청 본문에 빈 LifecyclePolicies
배열을 PutLifecycleConfiguration
으로 직접 호출하면 기존 LifecycleConfiguration
이 모두 삭제됩니다. 요청에서 다음을 지정합니다.
-
수명 주기 관리를 활성화, 비활성화 또는 수정하려는 파일 시스템의 ID
-
파일을 IA 스토리지로, Archive 스토리지로, 다시 기본 스토리지로 이동하는 시점을 정의하는
LifecyclePolicy
객체의LifecyclePolicies
배열입니다.참고
Amazon EFS에서는 각
LifecyclePolicy
객체에 단일 전환만 포함해야 하므로LifecyclePolicies
배열을 별도의LifecyclePolicy
객체로 구성해야 합니다. 자세한 내용을 알아보려면 다음 섹션의 예제 요청을 참조하세요.
이 작업에는 elasticfilesystem:PutLifecycleConfiguration
작업에 대한 권한이 필요합니다.
암호화된 파일 시스템에 LifecycleConfiguration
객체를 적용하려면 암호화된 파일 시스템을 생성할 때와 동일한 AWS Key Management Service 권한이 필요합니다.
Request Syntax
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입니다.
Pattern:
^(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
- 파일 시스템의 파일을 기본 스토리지(Standard 스토리지 클래스)에서 Inrequent Access(IA) 스토리지로 이동하는 시점입니다. -
TransitionToArchive
- 파일 시스템의 파일을 현재 스토리지 클래스(IA 또는 Standard 스토리지)에서 Archive 스토리지로 이동하는 시점입니다.IA 스토리지로 전환하기 전에는 파일 시스템을 Archive 스토리지로 전환할 수 없습니다. 따라서 TransitionToArchive는 설정되지 않았거나 TransitionToIA 이후여야 합니다.
참고
Archive 스토리지 클래스는 탄력적 처리량 모드 및 범용 성능 모드를 사용하는 파일 시스템에만 사용할 수 있습니다.
-
TransitionToPrimaryStorageClass
- IA 또는 Archive 스토리지에서 액세스된 후 파일 시스템의 파일을 기본 스토리지(Standard 스토리지 클래스)로 다시 이동할지 여부입니다.
참고
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개입니다.
Errors
- BadRequest
-
요청이 잘못되었거나 잘못된 파라미터 값 또는 필수 파라미터 누락 등의 오류가 있는 경우 반환됩니다.
HTTP 상태 코드: 400
- FileSystemNotFound
-
지정된
FileSystemId
값이 요청자의 AWS 계정에 존재하지 않는 경우 반환됩니다.HTTP 상태 코드: 404
- IncorrectFileSystemLifeCycleState
-
파일 시스템의 수명 주기 상태가 “사용 가능”이 아닌 경우 반환됩니다.
HTTP 상태 코드: 409
- InternalServerError
-
서버 측에서 오류가 발생한 경우 반환됩니다.
HTTP 상태 코드: 500
예시
수명 주기 구성 생성
다음 예제에서는 PutLifecycleConfiguration
액션을 사용하여 LifecyclePolicy
객체를 만듭니다. 이 예시에서는 EFS에 다음을 수행하도록 지시하는 수명 주기 정책을 생성합니다.
-
Standard 스토리지에서 지난 30일 동안 액세스하지 않은 파일 시스템 내 파일을 모두 IA 스토리지로 이동합니다.
-
Standard 스토리지에서 지난 90일 동안 액세스하지 않은 파일 시스템 내 파일을 모두 Archive 스토리지로 이동합니다.
-
IA 또는 Archive 스토리지에서 액세스한 파일은 다시 Standard 스토리지로 이동합니다. Archive 스토리지 클래스는 탄력적 처리량 모드 및 범용 성능 모드를 사용하는 파일 시스템에만 사용할 수 있습니다.
자세한 내용은 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": [ ]
}
참고
언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오.