기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

CreateFileSystem

빈 파일 시스템을 새로 생성합니다. 이 작업에는 Amazon이 idempotent 생성을 보장하기 위해 EFS 사용하는 요청에 생성 토큰이 필요합니다 (동일한 생성 토큰으로 작업을 호출해도 효과가 없음). 지정된 생성 토큰을 AWS 계정 가진 호출자 소유의 파일 시스템이 현재 존재하지 않는 경우 이 작업은 다음을 수행합니다.

그렇지 않으면 이 작업을 수행하면 기존 파일 시스템의 ID와 함께 FileSystemAlreadyExists 오류가 반환됩니다.

멱등성 작업을 사용하면 추가 파일 시스템을 만들 위험 없이 CreateFileSystem 직접 호출을 재시도할 수 있습니다. 이는 초기 직접 호출이 실패하여 파일 시스템이 실제로 생성되었는지 여부가 불확실할 때 발생할 수 있습니다. 전송 수준 제한 시간이 초과되었거나 연결이 재설정되는 경우를 예로 들 수 있습니다. 동일한 생성 토큰을 사용하는 한, 초기 직접 호출에서 파일 시스템 생성에 성공한 경우 클라이언트는 FileSystemAlreadyExists 오류를 통해 파일 시스템의 존재를 알 수 있습니다.

자세한 내용은 Amazon EFS 사용 설명서의 파일 시스템 생성을 참조하십시오.

이 작업은 파일 시스템에 대해 선택한 선택적 PerformanceMode 파라미터를 받아들입니다. 모든 파일 시스템에 generalPurpose PerformanceMode를 사용하는 것이 좋습니다. 이 maxIO 모드는 generalPurpose 모드보다 긴 지연 시간을 견딜 수 있는 고도로 병렬화된 워크로드용으로 설계된 이전 세대 성능 유형입니다. 탄력적 처리량을 사용하는 파일 시스템 또는 One Zone 파일 시스템에는 MaxIO 모드가 지원되지 않습니다.

파일 시스템을 만든 후에는 PerformanceMode를 변경할 수 없습니다. 자세한 내용은 Amazon EFS 성능 모드를 참조하십시오.

ThroughputMode 파라미터를 사용하여 파일 시스템에 대한 처리량 모드를 설정할 수 있습니다.

파일 시스템이 완전히 생성되면 Amazon은 수명 주기 상태를 로 EFS available 설정합니다. 이때 사용자는 파일 시스템에 탑재 대상을 하나 이상 생성할 수 있습니다VPC. 자세한 내용은 CreateMountTarget 단원을 참조하십시오. 탑재 대상을 VPC 사용하여 Amazon EFS 파일 시스템을 EC2 인스턴스에 탑재합니다. 자세한 내용은 AmazonEFS: 작동 방식을 참조하십시오.

이 작업에는 elasticfilesystem:CreateFileSystem 액션에 대한 권한이 필요합니다.

파일 시스템은 생성 시 태그를 지정할 수 있습니다. 생성 작업에서 태그가 지정된 경우 작업에 대한 추가 인증을 IAM 수행하여 사용자에게 태그를 생성할 권한이 있는지 확인합니다. elasticfilesystem:TagResource 따라서 사용자는 elasticfilesystem:TagResource 작업을 사용할 명시적 권한도 가지고 있어야 합니다. 자세한 내용은 생성 시 리소스 태그 지정에 대한 권한 부여를 참조하세요.

Request Syntax

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

{
   "AvailabilityZoneName": "string",
   "Backup": boolean,
   "CreationToken": "string",
   "Encrypted": boolean,
   "KmsKeyId": "string",
   "PerformanceMode": "string",
   "ProvisionedThroughputInMibps": number,
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ],
   "ThroughputMode": "string"
}

URI요청 파라미터

요청에는 어떤 URI 매개변수도 사용하지 않습니다.

요청 본문

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

응답 구문

HTTP/1.1 201
Content-type: application/json

{
   "AvailabilityZoneId": "string",
   "AvailabilityZoneName": "string",
   "CreationTime": number,
   "CreationToken": "string",
   "Encrypted": boolean,
   "FileSystemArn": "string",
   "FileSystemId": "string",
   "FileSystemProtection": { 
      "ReplicationOverwriteProtection": "string"
   },
   "KmsKeyId": "string",
   "LifeCycleState": "string",
   "Name": "string",
   "NumberOfMountTargets": number,
   "OwnerId": "string",
   "PerformanceMode": "string",
   "ProvisionedThroughputInMibps": number,
   "SizeInBytes": { 
      "Timestamp": number,
      "Value": number,
      "ValueInArchive": number,
      "ValueInIA": number,
      "ValueInStandard": number
   },
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ],
   "ThroughputMode": "string"
}

Response Elements

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

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

Errors

예

암호화된 EFS 파일 시스템 생성

다음 예시는 자동 백업이 활성화된 us-west-2 리전에 파일 시스템을 POST 생성하라는 요청을 보냅니다. 요청은 myFileSystem1을 멱등성을 위한 생성 토큰으로 지정합니다.

샘플 요청

POST /2015-02-01/file-systems HTTP/1.1
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20140620T215117Z
Authorization: <...>
Content-Type: application/json
Content-Length: 42

{
  "CreationToken" : "myFileSystem1",
  "PerformanceMode" : "generalPurpose",
  "Backup": true,
  "Encrypted": true,
  "Tags":[
      {
         "Key": "Name",
         "Value": "Test Group1"
      }
   ]
}

샘플 응답

HTTP/1.1 201 Created
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef
Content-Type: application/json
Content-Length: 319

{
   "ownerId":"251839141158",
   "CreationToken":"myFileSystem1",
   "Encrypted": true,
   "PerformanceMode" : "generalPurpose",
   "fileSystemId":"fs-01234567",
   "CreationTime":"1403301078",
   "LifeCycleState":"creating",
   "numberOfMountTargets":0,
   "SizeInBytes":{
       "Timestamp": 1403301078,
       "Value": 29313618372,
       "ValueInArchive": 201156,
       "ValueInIA": 675432,
       "ValueInStandard": 29312741784
   },
   "Tags":[
      {
        "Key": "Name",
        "Value": "Test Group1"
      }
   ],
   "ThroughputMode": "elastic"
}

One Zone 가용성을 갖춘 암호화된 EFS 파일 시스템을 만드세요.

다음 예시는 자동 백업이 활성화된 us-west-2 리전에 파일 시스템을 POST 생성하라는 요청을 보냅니다. 파일 시스템은 us-west-2b 가용 영역에 One Zone 스토리지를 갖게 됩니다.

샘플 요청

POST /2015-02-01/file-systems HTTP/1.1
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20140620T215117Z
Authorization: <...>
Content-Type: application/json
Content-Length: 42

{
  "CreationToken" : "myFileSystem2",
  "PerformanceMode" : "generalPurpose",
  "Backup": true,
  "AvailabilityZoneName": "us-west-2b",
  "Encrypted": true,
  "ThroughputMode": "elastic",
  "Tags":[
      {
         "Key": "Name",
         "Value": "Test Group1"
      }
   ]
}

샘플 응답

HTTP/1.1 201 Created
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef
Content-Type: application/json
Content-Length: 319

{
   "ownerId":"251839141158",
   "CreationToken":"myFileSystem1",
   "Encrypted": true,
   "AvailabilityZoneId": "usew2-az2", 
   "AvailabilityZoneName": "us-west-2b",
   "PerformanceMode" : "generalPurpose",
   "fileSystemId":"fs-01234567",
   "CreationTime":"1403301078",
   "LifeCycleState":"creating",
   "numberOfMountTargets":0,
   "SizeInBytes":{
       "Timestamp": 1403301078,
       "Value": 29313618372,
       "ValueInArchive": 201156,
       "ValueInIA": 675432,
       "ValueInStandard": 29312741784
   },
   "Tags":[
      {
        "Key": "Name",
        "Value": "Test Group1"
      }
   ],
   "ThroughputMode": "elastic"
}

참고

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