기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
CreateReplicationConfiguration
새 또는 기존 EFS 파일 시스템에 대한 복제 구성을 생성합니다. 자세한 내용을 알아보려면 Amazon EFS 사용 설명서의 Amazon EFS 복제를 참조하세요. 다음 복제 구성은 다음을 지정합니다.
-
소스 파일 시스템 - 복제하려는 EFS 파일 시스템입니다.
-
대상 파일 시스템 - 소스 파일 시스템이 복제되는 대상 파일 시스템입니다. 복제 구성에는 대상 파일 시스템이 하나만 있을 수 있습니다.
참고
파일 시스템은 하나의 복제 구성에만 포함될 수 있습니다.
복제 구성의 대상 파라미터는 새 파일 시스템 또는 기존 파일 시스템으로 복제하는지 여부와 복제하는지에 따라 달라집니다 AWS 계정. 자세한 내용은 DestinationToCreate 섹션을 참조하세요.
이 작업에는 elasticfilesystem:CreateReplicationConfiguration 액션에 대한 권한이 필요합니다. 또한 파일 시스템을 복제하는 방식에 따라 다른 권한이 필요합니다. 자세한 내용은 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",
"RoleArn": "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,
"OwnerId": "string",
"Region": "string",
"RoleArn": "string",
"Status": "string",
"StatusMessage": "string"
}
],
"OriginalSourceFileSystemArn": "string",
"SourceFileSystemArn": "string",
"SourceFileSystemId": "string",
"SourceFileSystemOwnerId": "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})$ - SourceFileSystemOwnerId
-
소스 파일 시스템이 있는 AWS 계정 의 ID입니다.
유형: 문자열
길이 제약 조건: 최대 길이는 14입니다.
패턴:
^(\d{12})|(\d{4}-\d{4}-\d{4})$ - SourceFileSystemRegion
-
소스 EFS 파일 시스템이 있는 AWS 리전 입니다.
유형: 문자열
길이 제한: 최소 길이는 1. 최대 길이는 64.
패턴:
^[a-z]{2}-((iso[a-z]{0,1}-)|(gov-)){0,1}[a-z]+-{0,1}[0-9]{0,1}$
오류
- 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 SDKs
