CreateReplicationConfiguration

새 EFS 파일 시스템 또는 기존 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입니다.

패턴: ^(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입니다.

패턴: ^(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

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

ErrorCode

오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.

Message

오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.

HTTP 상태 코드: 400

ConflictException

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

ErrorCode

오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.

Message

오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.

HTTP 상태 코드: 409

FileSystemLimitExceeded

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

ErrorCode

오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.

Message

오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.

HTTP 상태 코드: 403

FileSystemNotFound

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

ErrorCode

오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.

Message

오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.

HTTP 상태 코드: 404

IncorrectFileSystemLifeCycleState

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

ErrorCode

오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.

Message

오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.

HTTP 상태 코드: 409

InsufficientThroughputCapacity

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

ErrorCode

오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.

Message

오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.

HTTP 상태 코드: 503

InternalServerError

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

ErrorCode

오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.

Message

오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.

HTTP 상태 코드: 500

ReplicationNotFound

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

ErrorCode

ReplicationNotFound

Message

오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.

HTTP 상태 코드: 404

ThroughputLimitExceeded

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

ErrorCode

오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.

Message

오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.

HTTP 상태 코드: 400

UnsupportedAvailabilityZone

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

ErrorCode

오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.

Message

오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.

HTTP 상태 코드: 400

ValidationException

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

ErrorCode

오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.

Message

오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.

HTTP 상태 코드: 400

참고

언어별 AWS SDKs

• AWS Command Line Interface

• AWS SDK for .NET

• AWS SDK for C++

• AWS Go용 SDK v2

• AWS Java V2용 SDK

• AWS SDK for JavaScript V3

• AWS SDK for Kotlin

• AWS PHP V3용 SDK

• AWS Python용 SDK

• AWS SDK for Ruby V3