CreateReplicationConfiguration
기존 EFS 파일 시스템을 새로운 읽기 전용 파일 시스템에 복제하는 복제 구성을 생성합니다. 자세한 내용을 알아보려면 Amazon EFS 사용 설명서의 Amazon EFS 복제를 참조하세요. 다음 복제 구성은 다음을 지정합니다.
-
소스 파일 시스템 - 복제하려는 EFS 파일 시스템입니다. 소스 파일 시스템은 기존 복제 구성의 대상 파일 시스템이 될 수 없습니다.
-
AWS 리전 - 대상 파일 시스템이 생성되는 AWS 리전입니다. Amazon EFS 복제는 EFS를 사용할 수 있는 모든 AWS 리전에서 사용할 수 있습니다. 리전을 활성화해야 합니다. 자세한 내용은 AWS 일반 참조 안내서의 AWS 리전 관리 섹션을 참조하십시오.
-
대상 파일 시스템 구성 - 소스 파일 시스템이 복제될 대상 파일 시스템의 구성입니다. 복제 구성에는 대상 파일 시스템이 하나만 있을 수 있습니다.
복제 구성 파라미터는 다음과 같습니다.
-
파일 시스템 ID - 복제를 위한 대상 파일 시스템의 ID입니다. ID가 제공되지 않은 경우 EFS는 기본 설정으로 새 파일 시스템을 생성합니다. 기존 파일 시스템의 경우 파일 시스템의 복제 덮어쓰기 보호를 비활성화해야 합니다. 자세한 내용은 기존 파일 시스템으로 복제 섹션을 참조하십시오.
-
가용 영역 - 대상 파일 시스템에서 One Zone 스토리지를 사용하려면 파일 시스템을 생성할 가용 영역을 지정해야 합니다. 자세한 내용은 Amazon EFS 사용 설명서의 EFS 파일 시스템 유형 섹션을 참조하십시오.
-
암호화 - 모든 대상 파일 시스템은 저장 중 암호화가 활성화된 상태로 생성됩니다. 대상 파일 시스템을 암호화하는 데 사용되는 AWS Key Management Service(AWS KMS) 키를 지정할 수 있습니다. KMS 키를 지정하지 않으면 Amazon EFS의 서비스 관리형 KMS 키가 사용됩니다.
참고
파일 시스템이 생성된 후에는 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})$필수 여부: 예
요청 본문
요청은 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"
}응답 요소
작업이 성공하면 서비스가 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 리전에서 AWS Backup 서비스를 사용할 수 없는 경우 반환됩니다.
HTTP 상태 코드: 400
참고
언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오.
