CreateMountTarget - Amazon Elastic File System
Request SyntaxURI 요청 파라미터요청 본문응답 구문응답 요소오류예참고

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

CreateMountTarget

파일 시스템의 탑재 대상을 생성합니다. 그런 다음 탑재 대상을 사용하여 EC2 인스턴스에 파일 시스템을 탑재할 수 있습니다. 탑재 대상에 대한 자세한 내용은 탑재 대상 관리를 참조하세요.

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

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

파일 시스템의 탑재 대상은 하나의 VPC에서만 만들 수 있으며, 가용 영역당 탑재 대상은 하나씩만 있을 수 있습니다. 자세한 내용은 탑재 대상 생성을 참조하세요.

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

  • 지정된 서브넷에 새 탑재 대상을 생성합니다.

  • 서브넷에 다음과 같은 새 네트워크 인터페이스를 생성합니다.

    • fsmt-id 가 탑재 대상 ID이고가 인 Mount target fsmt-id for file system fs-id 설명 fs-id 입니다FileSystemId.

    • 네트워크 인터페이스의 requesterManaged 속성은 로, true requesterId 값은 로 설정됩니다EFS.

    각 탑재 대상에는 해당하는 요청자 관리형 EC2 네트워크 인터페이스가 하나씩 있습니다. 네트워크 인터페이스가 생성되면 Amazon EFS는 탑재 대상 설명의 NetworkInterfaceId 필드를 네트워크 인터페이스 ID로 설정하고 IP 주소를 해당 주소로 설정합니다. 네트워크 인터페이스 생성에 실패하면 전체 CreateMountTarget 작업이 실패합니다.

참고

네트워크 인터페이스를 생성한 후에만 CreateMountTarget 직접 호출이 반환되지만 탑재 대상 상태가 여전히 creating인 동안에는 DescribeMountTargets 작업을 직접 호출하여 탑재 대상 생성 상태를 확인할 수 있습니다. 이 경우 무엇보다도 탑재 대상 상태가 반환됩니다.

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

  • elasticfilesystem:CreateMountTarget

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

  • ec2:DescribeSubnets

  • ec2:DescribeNetworkInterfaces

  • ec2:CreateNetworkInterface

Request Syntax

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

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

URI 요청 파라미터

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

요청 본문

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

FileSystemId

탑재 대상을 생성할 파일 시스템의 ID입니다.

유형: 문자열

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

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

필수 여부: 예

IpAddress

탑재 대상IpAddressType의가 IPv4( IPV4_ONLY 또는 DUAL_STACK)인 경우 사용할 IPv4 주소를 지정합니다. 를 지정하지 않으면 IpAddressAmazon EFS는에 지정된 서브넷에서 미사용 IP 주소를 선택합니다SubnetId.

유형: 문자열

길이 제약: 최소 길이는 7입니다. 최대 길이는 15입니다.

패턴: ^[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}$

필수 여부: 아니요

IpAddressType

탑재 대상의 IP 주소 유형입니다. 가능한 값은 IPV4_ONLY (IPv4 주소만), IPV6_ONLY (IPv6 주소만) 및 DUAL_STACK (듀얼 스택, IPv4 및 IPv6 주소 모두)입니다. 를 지정하지 않으면 IpAddressTypeIPV4_ONLY가 사용됩니다.

참고

는 서브넷의 IP 유형과 일치해야 IPAddressType 합니다. 또한 IPAddressType 파라미터는 VPC의 서브넷에 대한 기본 IP 주소로 설정된 값을 재정의합니다. 예를 들어 IPAddressType가 IPV4_ONLY 이고 AssignIpv6AddressOnCreation가 true인 경우 IPv4가 탑재 대상에 사용됩니다. 자세한 내용은 서브넷의 IP 주소 지정 속성 수정을 참조하세요.

타입: 문자열

유효 값: IPV4_ONLY | IPV6_ONLY | DUAL_STACK

필수 여부: 아니요

Ipv6Address

탑재 대상IPAddressType의가 IPv6(IPV6_ONLY 또는 DUAL_STACK)인 경우 사용할 IPv6 주소를 지정합니다. 를 지정하지 않으면 Ipv6AddressAmazon EFS는에 지정된 서브넷에서 미사용 IP 주소를 선택합니다SubnetId.

유형: 문자열

길이 제약 조건: 최소 길이는 3입니다. 최대 길이는 39입니다.

필수 여부: 아니요

SecurityGroups

형식의 VPC 보안 그룹 IDssg-xxxxxxxx. 지정된 서브넷과 동일한 VPC에 대한 것이어야 합니다. 최대 보안 그룹 수는 계정 할당량에 따라 다릅니다. 자세한 내용은 Amazon VPC 사용 설명서의 Amazon VPC 할당량을 참조하세요(보안 그룹 테이블 참조). 보안 그룹을 지정하지 않으면 Amazon EFS는 서브넷의 VPC에 기본 보안 그룹을 사용합니다.

유형: 문자열 어레이

배열 멤버: 최대 항목 수는 100개입니다.

길이 제약: 최소 길이는 11입니다. 최대 길이는 43입니다.

패턴: ^sg-[0-9a-f]{8,40}

필수 여부: 아니요

SubnetId

탑재 대상을 추가할 서브넷의 ID입니다. One Zone 파일 시스템의 경우 파일 시스템의 가용 영역에 연결된 서브넷을 사용합니다. 서브넷 유형은와 동일한 유형이어야 합니다IpAddressType.

유형: 문자열

길이 제약: 최소 길이는 15입니다. 최대 길이는 47입니다.

패턴: ^subnet-[0-9a-f]{8,40}$

필수 여부: 예

응답 구문

HTTP/1.1 200
Content-type: application/json

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

응답 요소

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

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

AvailabilityZoneId

탑재 대상이 위치한 가용 영역의 고유하고 일관된 식별자입니다. 예를 들어 use1-az1는 us-east-1 리전의 AZ ID이며 모든에서 위치가 동일합니다 AWS 계정.

유형: 문자열

AvailabilityZoneName

탑재 대상이 위치한 가용 영역의 이름입니다. 가용 영역은 각 가용 영역의 이름에 독립적으로 매핑됩니다 AWS 계정. 예를 들어의 가용 영역은 다른의 가용 영역과 동일한 위치가 아닐 us-east-1a AWS 계정 수 us-east-1a 있습니다 AWS 계정.

유형: 문자열

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

패턴: .+

FileSystemId

탑재 대상으로 의도된 파일 시스템의 ID입니다.

유형: 문자열

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

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

IpAddress

탑재 대상의 IPv4 주소입니다.

유형: 문자열

길이 제약: 최소 길이는 7입니다. 최대 길이는 15입니다.

패턴: ^[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}$

Ipv6Address

탑재 대상의 IPv6 주소입니다.

유형: 문자열

길이 제약 조건: 최소 길이는 3입니다. 최대 길이는 39입니다.

LifeCycleState

탑재 대상의 생명 주기 상태입니다.

타입: 문자열

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

MountTargetId

시스템에서 할당한 탑재 대상 ID.

유형: 문자열

길이 제약: 최소 길이는 13입니다. 최대 길이는 45입니다.

패턴: ^fsmt-[0-9a-f]{8,40}$

NetworkInterfaceId

탑재 대상을 생성할 때 Amazon EFS가 생성한 네트워크 인터페이스의 ID입니다.

유형: 문자열

OwnerId

AWS 계정 리소스를 소유한 ID입니다.

유형: 문자열

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

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

SubnetId

탑재 대상의 서브넷의 ID입니다.

유형: 문자열

길이 제약: 최소 길이는 15입니다. 최대 길이는 47입니다.

패턴: ^subnet-[0-9a-f]{8,40}$

VpcId

탑재 대상이 구성된 Virtual Private Cloud(VPC) ID입니다.

유형: 문자열

오류

AvailabilityZonesMismatch

탑재 대상에 지정된 가용 영역이 파일 시스템의 가용 영역과 다른 경우 반환됩니다. 자세한 내용은 리전 및 One Zone 스토리지 중복성을 참조하세요.

HTTP 상태 코드: 400

BadRequest

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

HTTP 상태 코드: 400

FileSystemNotFound

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

HTTP 상태 코드: 404

IncorrectFileSystemLifeCycleState

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

HTTP 상태 코드: 409

InternalServerError

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

HTTP 상태 코드: 500

IpAddressInUse

요청이 서브넷에서 이미 사용 중인 IP 주소(IpAddress 또는 Ipv6Address)를 지정한 경우 반환됩니다.

HTTP 상태 코드: 409

MountTargetConflict

탑재 대상이 파일 시스템의 기존 탑재 대상을 기준으로 지정된 제한 사항 중 하나를 위반할 경우 반환됩니다.

HTTP 상태 코드: 409

NetworkInterfaceLimitExceeded

직접 호출 계정이 해당 AWS 리전의 탄력적 네트워크 인터페이스 한도에 도달했습니다. 일부 네트워크 인터페이스를 삭제하거나 계정 할당량 상향을 요청하세요. 자세한 내용은 Amazon VPC 사용 설명서의 Amazon VPC 할당량을 참조하세요(네트워크 인터페이스 표의 리전별 네트워크 인터페이스 항목 참조).

HTTP 상태 코드: 409

NoFreeAddressesInSubnet

요청에가 IpAddress 제공되지 않았거나가 반환Ipv6Address되었으며 지정된 서브넷에 사용 가능한 IP 주소가 없습니다.

HTTP 상태 코드: 409

SecurityGroupLimitExceeded

요청에 SecurityGroups 지정된 수가 계정 할당량을 기반으로 하는 한도보다 큰 경우 반환됩니다. 일부 보안 그룹을 삭제하거나 계정 할당량을 늘리도록 요청합니다. 자세한 내용은 Amazon VPC 사용 설명서의 Amazon VPC 할당량을 참조하세요(보안 그룹 표 참조).

HTTP 상태 코드: 400

SecurityGroupNotFound

지정된 보안 그룹 중 하나가 서브넷의 Virtual Private Cloud(VPC)에 존재하지 않는 경우 반환됩니다.

HTTP 상태 코드: 400

SubnetNotFound

요청에 ID SubnetId가 제공된 서브넷이 없는 경우 반환됩니다.

HTTP 상태 코드: 400

UnsupportedAvailabilityZone

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

HTTP 상태 코드: 400

예

서브넷의 사용 가능한 IPv4 주소에서 탑재 대상 생성

다음 요청은 탑재 대상에 대한 파일 시스템과 서브넷만 지정합니다. 대상은 VPC와 연결된 기본 보안 그룹을 사용하여 지정된 서브넷의 사용 가능한 IPv4 주소에서 생성됩니다.

샘플 요청

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

{
    "OwnerId": "231243201240", 
    "MountTargetId": "fsmt-55a4413c",
    "FileSystemId": "fs-01234567",
    "SubnetId": "subnet-01234567",
    "LifeCycleState": "available",
    "IpAddress": "172.31.22.183"
    "NetworkInterfaceId":"eni-1bcb7772"
    "AvailabilityZoneId": "eus1-az2",
    "AvailabilityZoneName": "eu-south-1b",
    "VpcId": "vpc-08d45b31fa009a15e"
}

특정 IPv4 주소에서 탑재 대상 생성

다음 요청은 탑재 대상에 사용할 파일 시스템, 서브넷, 보안 그룹 및 IPv4 주소를 지정합니다.

샘플 요청

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"
   "AvailabilityZoneId": "eus1-az2",
   "AvailabilityZoneName": "eu-south-1b",
   "VpcId": "vpc-08d45b31fa009a15e"
}

특정 IPv6 주소에서 탑재 대상 생성

다음 요청은 탑재 대상에 사용할 파일 시스템, 서브넷, 보안 그룹 및 IPv6 주소를 지정합니다.

샘플 요청

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",
   "Ipv6Address":"2001:0db8:85a3:0000:0000:8a2e:0370:7334",
   "IpAddressType": "IPV6_ONLY",
   "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",
   "Ipv6Address":"2001:0db8:85a3:0000:0000:8a2e:0370:7334",
   "NetworkInterfaceId":"eni-1bcb7772"
   "AvailabilityZoneId": "eus1-az2",
   "AvailabilityZoneName": "eu-south-1b",
   "VpcId": "vpc-08d45b31fa009a15e"
}

듀얼 스택 서브넷에서 사용 가능한 IPv4 주소에 탑재 대상 생성

다음 요청은 탑재 대상의 파일 시스템, 서브넷 및 주소 유형을 지정합니다. 대상은 VPC와 연결된 기본 보안 그룹을 사용하여 지정된 듀얼 스택 서브넷의 사용 가능한 IPv4 주소에서 생성됩니다.

샘플 요청

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

{
    "OwnerId": "251839141158",
    "MountTargetId": "fsmt-55a4413c",
    "FileSystemId": "fs-01234567",
    "SubnetId":"subnet-fd04ff94",
    "LifeCycleState": "available",
    "IpAddress": "172.31.22.183"
    "Ipv6Address": "2a05:d01a:419:8611:3e57:75ab:5719:b238",
    "NetworkInterfaceId": "eni-01234567",
    "AvailabilityZoneId": "eus1-az2",
    "AvailabilityZoneName": "eu-south-1b",
    "VpcId": "vpc-08d45b31fa009a15e"
}

듀얼 스택 서브넷의 특정 Ipv4 및 IPv6 주소에서 탑재 대상 생성

다음 요청은 탑재 대상의 파일 시스템, 서브넷, 보안 그룹, IPv4 주소, IPv6 주소를 지정합니다. 대상은 듀얼 스택 서브넷의 지정된 IPv4 및 IPv6 주소에서 생성됩니다.

샘플 요청

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",
   "IpAddressType": "DUAL_STACK",
   "IpAddress": "10.0.1.25",
   "Ipv6Address":"2001:0db8:85a3:0000:0000:8a2e:0370:7334",
   "SecurityGroups":[
      "sg-01234567"
   ]
}

샘플 응답

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

{
    "OwnerId": "231243201240", 
    "MountTargetId": "fsmt-55a4413c",
    "FileSystemId": "fs-01234567",
    "SubnetId": "subnet-01234567",
    "LifeCycleState": "available",
    "IpAddress": "10.0.1.25",
    "Ipv6Address":"2001:0db8:85a3:0000:0000:8a2e:0370:7334",
    "NetworkInterfaceId": "eni-01234567",
    "AvailabilityZoneId": "eus1-az2",
    "AvailabilityZoneName": "eu-south-1b",
    "VpcId": "vpc-08d45b31fa009a15e"
}

참고

언어별 AWS SDKs