CreateMountTarget

파일 시스템의 탑재 대상을 생성합니다. 그런 다음 탑재 대상을 사용하여 EC2 인스턴스에 파일 시스템을 탑재할 수 있습니다.

VPC의 각 가용 영역에 탑재 대상을 하나씩 만들 수 있습니다. 특정 가용 영역 내 VPC의 모든 EC2 인스턴스는 지정된 파일 시스템에 대한 단일 탑재 대상을 공유합니다. 가용 영역에 서브넷이 여러 개 있는 경우 여러 서브넷 중 하나에만 탑재 대상을 만듭니다. EC2 인스턴스는 탑재 대상과 동일한 서브넷에 있지 않아도 파일 시스템에 액세스할 수 있습니다.

One Zone 파일 시스템에 대해 탑재 대상을 하나만 생성할 수 있습니다. 파일 시스템이 위치한 동일한 가용 영역에 탑재 대상을 생성해야 합니다. 이 정보를 가져오려면 DescribeFileSystems 응답 개체의 AvailabilityZoneName 및 AvailabiltyZoneId 속성을 사용하세요. 탑재 대상을 만들 때 파일 시스템의 가용 영역과 관련된 subnetId를 사용하세요.

자세한 내용은 Amazon EFS: 작동 방식을 참조하세요.

파일 시스템에 대해 탑재 대상을 생성하려면 파일 시스템의 수명 주기 상태가 available이어야 합니다. 자세한 내용은 DescribeFileSystems 단원을 참조하십시오.

요청 시 다음 정보를 제공합니다.

탑재 대상을 생성한 후 Amazon EFS는, MountTargetId 및 IpAddress가 포함된 응답을 반환합니다. EC2 인스턴스에 파일 시스템을 탑재할 때 이 IP 주소를 사용합니다. 파일 시스템을 탑재할 때 탑재 대상의 DNS 이름을 사용할 수도 있습니다. 탑재 대상을 사용하여 파일 시스템을 탑재한 EC2 인스턴스에서는 탑재 대상의 IP 주소에 대해 탑재 대상의 DNS 이름을 확인합니다. 자세한 내용은 작동 방식: 구현 개요를 참조하세요.

파일 시스템의 탑재 대상은 하나의 VPC에서만 만들 수 있으며, 가용 영역당 탑재 대상은 하나씩만 있을 수 있습니다. 즉, 파일 시스템에 이미 탑재 대상이 하나 이상 생성되어 있는 경우, 다른 탑재 대상을 추가하기 위한 요청에 지정된 서브넷은 다음 요구 사항을 충족해야 합니다.

요청이 요구 사항을 충족하는 경우 Amazon EFS는 다음을 수행합니다.

각 가용 영역에서는 탑재 대상 한 개를 만드는 것이 좋습니다. 다른 가용 영역에서 만든 탑재 대상을 통해 가용 영역에서 파일 시스템을 사용하기 위해서는 비용과 관련된 고려 사항이 있습니다. 자세한 내용은 Amazon EFS를 참조하세요. 또한 항상 인스턴스의 가용 영역에 로컬로 배치된 탑재 대상을 사용하여 부분적인 장애 가능성을 없앱니다. 탑재 대상의 가용 영역이 다운되면 해당 탑재 대상을 통해 파일 시스템에 액세스할 수 없습니다.

이 작업에는 파일 시스템에서 다음 작업에 대한 권한이 필요합니다.

이 작업을 수행하려면 다음과 같은 Amazon EC2 작업에 대한 권한도 필요합니다.

Request Syntax

POST /2015-02-01/mount-targets HTTP/1.1
Content-type: application/json

{
   "FileSystemId": "string",
   "IpAddress": "string",
   "SecurityGroups": [ "string" ],
   "SubnetId": "string"
}

URI 요청 파라미터

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

요청 본문

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

응답 구문

HTTP/1.1 200
Content-type: application/json

{
   "AvailabilityZoneId": "string",
   "AvailabilityZoneName": "string",
   "FileSystemId": "string",
   "IpAddress": "string",
   "LifeCycleState": "string",
   "MountTargetId": "string",
   "NetworkInterfaceId": "string",
   "OwnerId": "string",
   "SubnetId": "string",
   "VpcId": "string"
}

응답 요소

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

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

Errors

예

탑재 대상을 파일 시스템에 추가

다음 요청은 파일 시스템에 대해 탑재 대상을 생성합니다. 요청은 필수 FileSystemId 및 SubnetId 파라미터의 값만 지정합니다. 요청은 선택적 IpAddress 및 SecurityGroups 파라미터를 제공하지 않습니다. IpAddress의 경우 작업에는 지정된 서브넷의 사용 가능한 IP 주소 중 하나가 사용됩니다. 또한 작업에는 SecurityGroups용 VPC와 연결된 기본 보안 그룹이 사용됩니다.

샘플 요청

POST /2015-02-01/mount-targets HTTP/1.1 
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20140620T221118Z
Authorization: <...>
Content-Type: application/json
Content-Length: 160

{"SubnetId": "subnet-748c5d03", "FileSystemId": "fs-01234567"}

샘플 응답

HTTP/1.1 200 OK
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef
Content-Type: application/json
Content-Length: 252

{
    "MountTargetId": "fsmt-55a4413c",
    "NetworkInterfaceId": "eni-01234567",
    "FileSystemId": "fs-01234567",
    "LifeCycleState": "available",
    "SubnetId": "subnet-01234567",
    "OwnerId": "231243201240",
    "IpAddress": "172.31.22.183"
}

탑재 대상을 파일 시스템에 추가

다음 요청은 탑재 대상을 만들기 위한 모든 요청 파라미터를 지정합니다.

샘플 요청

POST /2015-02-01/mount-targets HTTP/1.1 
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20140620T221118Z
Authorization: <...>
Content-Type: application/json
Content-Length: 160

{
   "FileSystemId":"fs-01234567",
   "SubnetId":"subnet-01234567",
   "IpAddress":"10.0.2.42",
   "SecurityGroups":[
      "sg-01234567"
   ]
}

샘플 응답

HTTP/1.1 200 OK
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef
Content-Type: application/json
Content-Length: 252

{
   "OwnerId":"251839141158",
   "MountTargetId":"fsmt-9a13661e",
   "FileSystemId":"fs-01234567",
   "SubnetId":"subnet-fd04ff94",
   "LifeCycleState":"available",
   "IpAddress":"10.0.2.42",
   "NetworkInterfaceId":"eni-1bcb7772"
}

참고

언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오.