CreateAccessPoint

EFS 액세스 포인트를 생성합니다. 액세스 포인트는 운영 체제 사용자 및 그룹 및 파일 시스템 경로를 액세스 포인트를 통해 이루어지는 모든 파일 시스템 요청에 적용하는 EFS 파일 시스템에 대한 애플리케이션별 보기입니다. 운영 체제 사용자 및 그룹은 NFS 클라이언트에서 제공하는 모든 자격 증명 정보를 재정의합니다. 파일 시스템 경로는 액세스 포인트의 루트 디렉터리로 노출됩니다. 액세스 포인트를 사용하는 애플리케이션은 자체 디렉터리 및 해당 하위 디렉터리의 데이터에만 액세스할 수 있습니다. 자세한 내용을 알아보려면 EFS 액세스 지점을 사용하여 파일 시스템 탑재를 참조하세요.

참고

동일한 파일 시스템에 액세스 포인트를 생성하라는 여러 요청을 연속으로 빠르게 전송하고 파일 시스템이 액세스 포인트 한도인 1,000개에 가까워지면 이러한 요청에 대한 응답이 제한될 수 있습니다. 이는 파일 시스템이 명시된 액세스 포인트 제한을 초과하지 않도록 하기 위한 것입니다.

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

액세스 포인트를 만들 때 태그를 지정할 수 있습니다. 생성 작업에서 태그가 지정되면 IAM은 elasticfilesystem:TagResource 작업에서 추가 권한 부여를 수행해 사용자에게 태그를 생성할 권한이 있는지 확인합니다. 따라서 사용자는 elasticfilesystem:TagResource 작업을 사용할 명시적 권한도 가지고 있어야 합니다. 자세한 내용은 생성 시 리소스 태그 지정에 대한 권한 부여를 참조하세요.

Request Syntax

POST /2015-02-01/access-points HTTP/1.1
Content-type: application/json

{
   "ClientToken": "string",
   "FileSystemId": "string",
   "PosixUser": { 
      "Gid": number,
      "SecondaryGids": [ number ],
      "Uid": number
   },
   "RootDirectory": { 
      "CreationInfo": { 
         "OwnerGid": number,
         "OwnerUid": number,
         "Permissions": "string"
      },
      "Path": "string"
   },
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ]
}

URI 요청 파라미터

요청은 URI 파라미터를 사용하지 않습니다.

요청 본문

요청은 JSON 형식으로 다음 데이터를 받습니다.

ClientToken

Amazon EFS가 멱등성 생성을 보장하기 위해 사용하는 최대 64개의 ASCII 문자로 구성된 문자열입니다.

유형: 문자열

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

패턴: .+

필수 항목 여부: 예

FileSystemId

액세스 포인트가 액세스를 제공하는 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})$

필수 항목 여부: 예

PosixUser

액세스 포인트를 사용하여 이루어진 모든 파일 시스템 요청에 적용되는 운영 체제 사용자 및 그룹입니다.

유형: PosixUser객체

필수 항목 여부: 아니요

RootDirectory

액세스 포인트가 액세스 포인트를 사용하여 NFS 클라이언트에 사용자의 파일 시스템의 루트 디렉터리로 노출하는 EFS 파일 시스템의 디렉터리를 지정합니다. 액세스 포인트를 사용하는 클라이언트는 루트 디렉터리 및 해당 하위 디렉터리에 대한 액세스만 수행할 수 있습니다. 지정된 RootDirectory > Path가 없으면 클라이언트가 액세스 포인트에 연결할 때 Amazon EFS가 이를 생성하고 CreationInfo 설정을 적용합니다. RootDirectory를 지정할 때는 Path 및 CreationInfo를 제공해야 합니다.

Amazon EFS는 사용자가 CreationInfo(OwNuID, ownGID 및 디렉터리에 대한 권한)를 제공한 경우에만 루트 디렉터리를 생성합니다. 이 정보를 제공하지 않으면 Amazon EFS는 루트 디렉터리를 생성하지 않습니다. 루트 디렉토리가 없으면 액세스 포인트를 사용하는 탑재 시도가 실패합니다.

유형: RootDirectory객체

필수 항목 여부: 아니요

Tags

액세스 포인트와 연결된 태그를 생성합니다. 모든 태그는 키-값 페어이며, 각 키는 고유해야 합니다. 자세한 내용을 알아보려면 AWS 일반 참조 안내서의 AWS 리소스 태그 지정을 참조하세요.

타입: Tag객체 배열

필수: 아니요

응답 구문

HTTP/1.1 200
Content-type: application/json

{
   "AccessPointArn": "string",
   "AccessPointId": "string",
   "ClientToken": "string",
   "FileSystemId": "string",
   "LifeCycleState": "string",
   "Name": "string",
   "OwnerId": "string",
   "PosixUser": { 
      "Gid": number,
      "SecondaryGids": [ number ],
      "Uid": number
   },
   "RootDirectory": { 
      "CreationInfo": { 
         "OwnerGid": number,
         "OwnerUid": number,
         "Permissions": "string"
      },
      "Path": "string"
   },
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ]
}

응답 요소

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

AccessPointArn

액세스 포인트와 연결된 고유한 Amazon 리소스 이름(ARN)입니다.

유형: 문자열

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

패턴: ^arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:access-point/fsap-[0-9a-f]{8,40}$

AccessPointId

Amazon EFS에서 할당한 액세스 포인트의 ID입니다.

유형: 문자열

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

패턴: ^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:access-point/fsap-[0-9a-f]{8,40}|fsap-[0-9a-f]{8,40})$

ClientToken

멱등성 생성을 보장하기 위해 요청에 지정된 불투명한 문자열입니다.

유형: 문자열

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

패턴: .+

FileSystemId

액세스 포인트가 적용되는 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})$

LifeCycleState

액세스 포인트의 수명 주기 단계를 식별합니다.

유형: 문자열

유효 값: creating | available | updating | deleting | deleted | error

Name

이 액세스 포인트의 이름입니다. Name 태그의 값입니다.

유형: 문자열

OwnerId

액세스 포인트 리소스를 소유하는 AWS 계정을 식별합니다.

유형: 문자열

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

패턴: ^(\d{12})|(\d{4}-\d{4}-\d{4})$

PosixUser

액세스 포인트를 사용하여 NFS 클라이언트가 수행하는 모든 파일 작업에 사용되는 액세스 포인트에서 사용자 ID, 그룹 ID 및 보조 그룹 ID를 포함한 전체 POSIX ID입니다.

유형: PosixUser객체

RootDirectory

액세스 포인트가 액세스 포인트를 사용하는 NFS 클라이언트에 루트 디렉터리로 노출하는 EFS 파일 시스템의 디렉터리입니다.

유형: RootDirectory객체

Tags

액세스 포인트와 관련된 태그는 태그 객체의 배열로 표시됩니다.

타입: Tag 객체 배열

Errors

AccessPointAlreadyExists

생성하려는 액세스 포인트가 요청에서 제공한 생성 토큰과 함께 이미 존재하는 경우 반환됩니다.

HTTP Status Code: 409

AccessPointLimitExceeded

파일 시스템당 허용되는 최대 액세스 포인트 수를 AWS 계정이 이미 생성한 경우 반환됩니다. 자세한 내용은 https://docs.aws.amazon.com/efs/latest/ug/limits.html#limits-efs-resources-per-account-per-region 섹션을 참조하세요.

HTTP 상태 코드: 403

BadRequest

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

HTTP 상태 코드: 400

FileSystemNotFound

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

HTTP 상태 코드: 404

IncorrectFileSystemLifeCycleState

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

HTTP Status Code: 409

InternalServerError

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

HTTP Status Code: 500

ThrottlingException

CreateAccessPoint API 작업이 너무 빨리 호출되고 파일 시스템의 액세스 포인트 수가 120개 제한에 근접할 때 반환됩니다.

HTTP Status Code: 429

참고

이 API를 언어별 AWS SDK 중 하나로 사용하는 방법에 대한 자세한 설명은 다음을 참조하세요.

• AWS Command Line Interface

• AWS SDK for .NET

• AWS SDK for C++

• AWS SDK for Go

• AWS SDK for Java V2

• JavaScript V3용 AWS SDK

• AWS SDK for PHP V3

• AWS SDK for Python

• AWS SDK for Ruby V3