PutLifecycleConfiguration - Amazon Elastic File System

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를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오.