CreateReplicationConfiguration

기존 EFS 파일 시스템을 새 읽기 전용 파일 시스템에 복제하는 복제 구성을 생성합니다. 자세한 내용은 Amazon EFS사용 설명서의 Amazon EFS 복제를 참조하십시오. 다음 복제 구성은 다음을 지정합니다.

• 소스 파일 시스템 — 복제하려는 EFS 파일 시스템. 소스 파일 시스템은 기존 복제 구성의 대상 파일 시스템이 될 수 없습니다.

• AWS 리전 - 대상 AWS 리전 파일 시스템이 생성되는 위치입니다. Amazon EFS 복제는 가능한 모든 AWS 리전 곳에서 사용할 EFS 수 있습니다. 리전을 활성화해야 합니다. 자세한 내용은 AWS 일반 참조 안내서의 관리를 AWS 리전 참조하십시오.

• 대상 파일 시스템 구성 - 소스 파일 시스템이 복제될 대상 파일 시스템의 구성입니다. 복제 구성에는 대상 파일 시스템이 하나만 있을 수 있습니다.

  복제 구성 파라미터는 다음과 같습니다.

  • 파일 시스템 ID - 복제를 위한 대상 파일 시스템의 ID입니다. ID가 제공되지 않은 경우 기본 설정으로 새 파일 시스템을 EFS 만듭니다. 기존 파일 시스템의 경우 파일 시스템의 복제 덮어쓰기 보호를 비활성화해야 합니다. 자세한 내용은 기존 파일 시스템으로 복제 섹션을 참조하십시오.

  • 가용 영역 - 대상 파일 시스템에서 One Zone 스토리지를 사용하려면 파일 시스템을 생성할 가용 영역을 지정해야 합니다. 자세한 내용은 Amazon EFS 사용 설명서의 EFS 파일 시스템 유형을 참조하십시오.

  • 암호화 - 모든 대상 파일 시스템은 저장 중 암호화가 활성화된 상태로 생성됩니다. 대상 파일 시스템을 암호화하는 데 사용되는 AWS Key Management Service (AWS KMS) 키를 지정할 수 있습니다. KMS키를 지정하지 않으면 Amazon의 서비스 관리 KMS 키가 EFS 사용됩니다.

    참고

    파일 시스템이 생성된 후에는 키를 변경할 수 없습니다. KMS

새 대상 파일 시스템의 경우 기본적으로 다음 속성이 설정됩니다.

• 성능 모드 - 대상 파일 시스템이 EFS One Zone 스토리지를 사용하지 않는 한 대상 파일 시스템의 성능 모드는 소스 파일 시스템의 성능 모드와 일치합니다. 이 경우에는 범용 성능 모드가 사용됩니다. 성능 모드는 변경할 수 없습니다.

• 처리량 모드 - 대상 파일 시스템의 처리량 모드가 소스 파일 시스템의 처리량 모드와 일치합니다. 파일 시스템이 생성되면 처리량 모드를 수정할 수 있습니다.

• 수명 주기 관리 - 대상 파일 시스템에서는 수명 주기 관리를 사용할 수 없습니다. 대상 파일 시스템이 생성되면 Lifecycle Management를 활성화할 수 있습니다.

• 자동 백업 - 대상 파일 시스템에서 자동 일일 백업이 활성화됩니다. 파일 시스템이 생성되면 이 설정을 변경할 수 있습니다.

자세한 내용은 Amazon EFS사용 설명서의 Amazon EFS 복제를 참조하십시오.

Request Syntax

POST /2015-02-01/file-systems/SourceFileSystemId/replication-configuration HTTP/1.1
Content-type: application/json

{
   "Destinations": [ 
      { 
         "AvailabilityZoneName": "string",
         "FileSystemId": "string",
         "KmsKeyId": "string",
         "Region": "string"
      }
   ]
}

URI요청 파라미터

요청은 다음 URI 파라미터를 사용합니다.

SourceFileSystemId

복제하려는 Amazon EFS 파일 시스템을 지정합니다. 이 파일 시스템은 이미 다른 복제 구성의 소스 또는 대상 파일 시스템일 수 없습니다.

길이 제약: 최대 길이는 128입니다.

Pattern: ^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$

필수 여부: 예

Request Body

요청은 다음과 같은 JSON 형식의 데이터를 수락합니다.

Destinations

대상 구성 객체의 배열입니다. 대상 구성 객체는 하나만 지원됩니다.

유형: DestinationToCreate객체 어레이

필수 항목 여부: 예

응답 구문

HTTP/1.1 200
Content-type: application/json

{
   "CreationTime": number,
   "Destinations": [ 
      { 
         "FileSystemId": "string",
         "LastReplicatedTimestamp": number,
         "Region": "string",
         "Status": "string"
      }
   ],
   "OriginalSourceFileSystemArn": "string",
   "SourceFileSystemArn": "string",
   "SourceFileSystemId": "string",
   "SourceFileSystemRegion": "string"
}

Response Elements

작업이 성공하면 서비스는 HTTP 200개의 응답을 다시 보냅니다.

서비스는 다음 데이터를 JSON 형식으로 반환합니다.

CreationTime

복제 구성을 만든 시기를 설명합니다.

유형: 타임스탬프

Destinations

대상 객체의 배열입니다. 대상 개체는 하나만 지원됩니다.

유형: Destination객체 어레이

OriginalSourceFileSystemArn

복제 구성에 있는 원본 소스 EFS 파일 시스템의 Amazon 리소스 이름 (ARN)

타입: 문자열

SourceFileSystemArn

복제 구성에 있는 현재 소스 파일 시스템의 Amazon 리소스 이름 (ARN)

타입: 문자열

SourceFileSystemId

복제 중인 원본 Amazon EFS 파일 시스템의 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})$

SourceFileSystemRegion

소스 EFS 파일 시스템이 위치한 위치. AWS 리전

유형: 문자열

길이 제한: 최소 길이는 1. 최대 길이는 64.

패턴: ^[a-z]{2}-((iso[a-z]{0,1}-)|(gov-)){0,1}[a-z]+-{0,1}[0-9]{0,1}$

Errors

BadRequest

요청이 잘못되었거나 잘못된 파라미터 값 또는 필수 파라미터 누락 등의 오류가 있는 경우 반환됩니다.

HTTP상태 코드: 400

ConflictException

복제본의 소스 파일 시스템은 암호화되었지만 대상 파일 시스템은 암호화되지 않은 경우 반환됩니다.

HTTP상태 코드: 409

FileSystemLimitExceeded

계정당 허용되는 최대 파일 시스템 수를 AWS 계정 이미 생성한 경우 반환됩니다.

HTTP상태 코드: 403

FileSystemNotFound

지정된 FileSystemId 값이 요청자의 값에 존재하지 않는 경우 반환됩니다. AWS 계정

HTTP상태 코드: 404

IncorrectFileSystemLifeCycleState

파일 시스템의 수명 주기 상태가 “사용 가능”이 아닌 경우 반환됩니다.

HTTP상태 코드: 409

InsufficientThroughputCapacity

추가 처리량을 프로비저닝할 용량이 충분하지 않은 경우 반환됩니다. 프로비저닝된 처리량 모드에서 파일 시스템을 생성하려고 할 때, 기존 파일 시스템의 프로비저닝된 처리량을 늘리려고 할 때 또는 기존 파일 시스템을 버스팅 처리량에서 프로비저닝된 처리량 모드로 변경하려고 할 때 이 값이 반환될 수 있습니다. 나중에 다시 시도해 주십시오.

HTTP상태 코드: 503

InternalServerError

서버 측에서 오류가 발생한 경우 반환됩니다.

HTTP상태 코드: 500

ReplicationNotFound

지정된 파일 시스템에 복제 구성이 없는 경우 반환됩니다.

HTTP상태 코드: 404

ThroughputLimitExceeded

처리량 한도인 1024MiB/s에 도달하여 처리량 모드 또는 프로비저닝된 처리량을 변경할 수 없는 경우 반환됩니다.

HTTP상태 코드: 400

UnsupportedAvailabilityZone

요청된 Amazon EFS 기능을 지정된 가용 영역에서 사용할 수 없는 경우 반환됩니다.

HTTP상태 코드: 400

ValidationException

요청한 지역에서 AWS Backup 서비스를 이용할 수 없는 경우 반환됩니다. AWS 리전

HTTP상태 코드: 400

참고

언어별 사용 방법에 대한 자세한 내용은 AWS SDKs 다음을 참조하십시오. API

• AWS Command Line Interface

• AWS SDK에 대한. NET

• AWS SDKC++의 경우

• AWS SDKGo v2용

• AWS SDK자바 V2용

• AWS SDK JavaScript V3용

• AWS SDKV3의 경우 PHP

• AWS SDKPython용

• AWS SDK루비 V3용