기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다. # CreateMountTarget 파일 시스템의 탑재 대상을 생성합니다. 그런 다음 탑재 대상을 사용하여 EC2 인스턴스에 파일 시스템을 탑재할 수 있습니다. 탑재 대상에 대한 자세한 내용은 [탑재 대상 관리](https://docs.aws.amazon.com/efs/latest/ug/accessing-fs.html)를 참조하세요. 파일 시스템에 대해 탑재 대상을 생성하려면 파일 시스템의 수명 주기 상태가 `available`이어야 합니다. 자세한 내용은 [DescribeFileSystems](API_DescribeFileSystems.md) 단원을 참조하십시오. 탑재 대상 생성 후 Amazon EFS는 `MountTargetId` 및 IP 주소(`IpAddress` 또는 `Ipv6Address`)를 포함한 응답을 반환합니다. EC2 인스턴스에 파일 시스템을 탑재할 때 이 IP 주소를 사용합니다. 파일 시스템을 탑재할 때 탑재 대상의 DNS 이름을 사용할 수도 있습니다. 탑재 대상을 사용하여 파일 시스템을 탑재한 EC2 인스턴스에서는 탑재 대상의 IP 주소에 대해 탑재 대상의 DNS 이름을 확인합니다. 자세한 내용은 [Amazon EFS 작동 방식](https://docs.aws.amazon.com/efs/latest/ug/how-it-works.html)을 참조하세요. 파일 시스템의 탑재 대상은 하나의 VPC에서만 만들 수 있으며, 가용 영역당 탑재 대상은 하나씩만 있을 수 있습니다. 자세한 내용은 [탑재 대상 생성](https://docs.aws.amazon.com/efs/latest/ug/manage-fs-access-create-delete-mount-targets.html)을 참조하세요. 요청이 요구 사항을 충족하는 경우 Amazon EFS는 다음을 수행합니다. + 지정된 서브넷에 새 탑재 대상을 생성합니다. + 서브넷에 다음과 같은 새 네트워크 인터페이스를 생성합니다. + 설명 `Mount target fsmt-id for file system fs-id ` 여기서 ` fsmt-id `는 탑재 대상 ID이며, ` fs-id `는 `FileSystemId`입니다. + 네트워크 인터페이스의 `requesterManaged` 속성은 `true`로 설정되고, `requesterId` 값은 `EFS`로 설정됩니다. 각 탑재 대상에는 해당하는 요청자 관리형 EC2 네트워크 인터페이스가 하나씩 있습니다. 네트워크 인터페이스가 생성되면 Amazon EFS는 탑재 대상 설명의 `NetworkInterfaceId` 필드를 네트워크 인터페이스 ID로 설정하고 IP 주소를 해당 주소로 설정합니다. 네트워크 인터페이스 생성에 실패하면 전체 `CreateMountTarget` 작업이 실패합니다. **참고** 네트워크 인터페이스를 생성한 후에만 `CreateMountTarget` 직접 호출이 반환되지만 탑재 대상 상태가 여전히 `creating`인 동안에는 [DescribeMountTargets](API_DescribeMountTargets.md) 작업을 직접 호출하여 탑재 대상 생성 상태를 확인할 수 있습니다. 이 경우 무엇보다도 탑재 대상 상태가 반환됩니다. 이 작업에는 파일 시스템에서 다음 작업에 대한 권한이 필요합니다. + `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](#API_CreateMountTarget_RequestSyntax) ** 탑재 대상을 생성할 파일 시스템의 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](#API_CreateMountTarget_RequestSyntax) ** 탑재 대상의 `IpAddressType`이 IPv4(`IPV4_ONLY` 또는 `DUAL_STACK`)인 경우 사용할 IPv4 주소를 지정합니다. `IpAddress`를 지정하지 않으면 Amazon EFS가 `SubnetId`로 지정된 서브넷에서 사용되지 않는 IP 주소를 선택합니다. 유형: 문자열 길이 제약: 최소 길이는 7입니다. 최대 길이는 15입니다. 패턴: `^[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}$` 필수 여부: 아니요 ** [IpAddressType](#API_CreateMountTarget_RequestSyntax) ** 탑재 대상의 IP 주소입니다. 가능한 값은 `IPV4_ONLY`(IPv4 주소만), `IPV6_ONLY`(IPv6 주소만), `DUAL_STACK`(듀얼 스택, IPv4 및 IPv6 주소 모두)입니다. `IpAddressType`를 지정하지 않으면 `IPV4_ONLY`가 사용됩니다. `IPAddressType`은 서브넷의 IP 유형과 일치해야 합니다. 또한 `IPAddressType` 파라미터는 VPC의 서브넷에 대한 기본 IP 주소로 설정된 값을 재정의합니다. 예를 들어 `IPAddressType`이 `IPV4_ONLY`이고 `AssignIpv6AddressOnCreation`이 `true`인 경우 탑재 대상에 IPv4가 사용됩니다. 자세한 내용은 [서브넷의 IP 주소 지정 속성 수정](https://docs.aws.amazon.com/vpc/latest/userguide/subnet-public-ip.html)을 참조하세요. 타입: 문자열 유효 값: `IPV4_ONLY | IPV6_ONLY | DUAL_STACK` 필수 여부: 아니요 ** [Ipv6Address](#API_CreateMountTarget_RequestSyntax) ** 탑재 대상의 `IPAddressType`이 IPv6(`IPV6_ONLY` 또는 `DUAL_STACK`)인 경우 사용할 IPv6 주소를 지정합니다. `Ipv6Address`를 지정하지 않으면 Amazon EFS가 `SubnetId`로 지정된 서브넷에서 사용되지 않는 IP 주소를 선택합니다. 유형: 문자열 길이 제약 조건: 최소 길이는 3입니다. 최대 길이는 39입니다. 필수 여부: 아니요 ** [SecurityGroups](#API_CreateMountTarget_RequestSyntax) ** VPC 보안 그룹 ID(`sg-xxxxxxxx` 형식)입니다. 이들은 지정된 서브넷과 동일한 VPC에 속해야 합니다. 보안 그룹의 최대 개수는 계정 할당량에 따라 다릅니다. 자세한 내용은 *Amazon VPC 사용 설명서*의 [Amazon VPC 할당량](https://docs.aws.amazon.com/vpc/latest/userguide/amazon-vpc-limits.html)을 참조하세요(**보안 그룹** 테이블 참조). 보안 그룹을 지정하지 않으면 Amazon EFS는 해당 서브넷 VPC의 기본 보안 그룹을 사용합니다 유형: 문자열 어레이 배열 멤버: 최대 항목 수는 100개입니다. 길이 제약: 최소 길이는 11입니다. 최대 길이는 43입니다. 패턴: `^sg-[0-9a-f]{8,40}` 필수 여부: 아니요 ** [SubnetId](#API_CreateMountTarget_RequestSyntax) ** 탑재 대상을 추가할 서브넷의 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](#API_CreateMountTarget_ResponseSyntax) ** 탑재 대상이 위치한 가용 영역의 고유하고 일관된 식별자입니다. 예를 들어 `use1-az1`는 us-east-1 리전의 AZ ID이며 모든에서 위치가 동일합니다 AWS 계정. 유형: 문자열 ** [AvailabilityZoneName](#API_CreateMountTarget_ResponseSyntax) ** 탑재 대상이 위치한 가용 영역의 이름입니다. 가용 영역은 각 가용 영역의 이름에 독립적으로 매핑됩니다 AWS 계정. 예를 들어의 가용 영역은 다른의 가용 영역과 동일한 위치가 아닐 `us-east-1a` AWS 계정 수 `us-east-1a` 있습니다 AWS 계정. 유형: 문자열 길이 제한: 최소 길이는 1. 최대 길이는 64. 패턴: `.+` ** [FileSystemId](#API_CreateMountTarget_ResponseSyntax) ** 탑재 대상으로 의도된 파일 시스템의 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](#API_CreateMountTarget_ResponseSyntax) ** 탑재 대상의 IPv4 주소입니다. 유형: 문자열 길이 제약: 최소 길이는 7입니다. 최대 길이는 15입니다. 패턴: `^[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}$` ** [Ipv6Address](#API_CreateMountTarget_ResponseSyntax) ** 탑재 대상의 IPv6 주소입니다. 유형: 문자열 길이 제약 조건: 최소 길이는 3입니다. 최대 길이는 39입니다. ** [LifeCycleState](#API_CreateMountTarget_ResponseSyntax) ** 탑재 대상의 생명 주기 상태입니다. 타입: 문자열 유효 값: `creating | available | updating | deleting | deleted | error` ** [MountTargetId](#API_CreateMountTarget_ResponseSyntax) ** 시스템에서 할당한 탑재 대상 ID. 유형: 문자열 길이 제약: 최소 길이는 13입니다. 최대 길이는 45입니다. 패턴: `^fsmt-[0-9a-f]{8,40}$` ** [NetworkInterfaceId](#API_CreateMountTarget_ResponseSyntax) ** 탑재 대상을 생성할 때 Amazon EFS가 생성한 네트워크 인터페이스의 ID입니다. 유형: 문자열 ** [OwnerId](#API_CreateMountTarget_ResponseSyntax) ** AWS 계정 리소스를 소유한 ID입니다. 유형: 문자열 길이 제약 조건: 최대 길이는 14입니다. 패턴: `^(\d{12})|(\d{4}-\d{4}-\d{4})$` ** [SubnetId](#API_CreateMountTarget_ResponseSyntax) ** 탑재 대상의 서브넷의 ID입니다. 유형: 문자열 길이 제약: 최소 길이는 15입니다. 최대 길이는 47입니다. 패턴: `^subnet-[0-9a-f]{8,40}$` ** [VpcId](#API_CreateMountTarget_ResponseSyntax) ** 탑재 대상이 구성된 Virtual Private Cloud(VPC) ID입니다. 유형: 문자열 ## 오류 ** AvailabilityZonesMismatch ** 탑재 대상에 지정된 가용 영역이 파일 시스템의 가용 영역과 다를 경우 반환됩니다. 자세한 내용은 [리전 및 One Zone 스토리지 중복성](https://docs.aws.amazon.com/efs/latest/ug/accessing-fs)을 참조하세요. ** ErrorCode ** 오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다. ** Message ** 오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다. HTTP 상태 코드: 400 ** BadRequest ** 요청이 잘못되었거나 잘못된 파라미터 값 또는 필수 파라미터 누락 등의 오류가 있는 경우 반환됩니다. ** ErrorCode ** 오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다. ** Message ** 오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다. HTTP 상태 코드: 400 ** FileSystemNotFound ** 지정된 `FileSystemId` 값이 요청자의에 없는 경우 반환됩니다 AWS 계정. ** ErrorCode ** 오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다. ** Message ** 오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다. HTTP 상태 코드: 404 ** IncorrectFileSystemLifeCycleState ** 파일 시스템의 수명 주기 상태가 “사용 가능”이 아닌 경우 반환됩니다. ** ErrorCode ** 오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다. ** Message ** 오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다. HTTP 상태 코드: 409 ** InternalServerError ** 서버 측에서 오류가 발생한 경우 반환됩니다. ** ErrorCode ** 오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다. ** Message ** 오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다. HTTP 상태 코드: 500 ** IpAddressInUse ** 요청이 서브넷에서 이미 사용 중인 IP 주소(`IpAddress` 또는 `Ipv6Address`)를 지정한 경우 반환됩니다. ** ErrorCode ** 오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다. ** Message ** 오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다. HTTP 상태 코드: 409 ** MountTargetConflict ** 탑재 대상이 파일 시스템의 기존 탑재 대상을 기준으로 지정된 제한 사항 중 하나를 위반할 경우 반환됩니다. ** ErrorCode ** 오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다. ** Message ** 오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다. HTTP 상태 코드: 409 ** NetworkInterfaceLimitExceeded ** 직접 호출 계정이 해당 AWS 리전의 탄력적 네트워크 인터페이스 한도에 도달했습니다. 일부 네트워크 인터페이스를 삭제하거나 계정 할당량 상향을 요청하세요. 자세한 내용은 *Amazon VPC 사용 설명서*의 [Amazon VPC 할당량](https://docs.aws.amazon.com/vpc/latest/userguide/amazon-vpc-limits.html)을 참조하세요(**네트워크 인터페이스** 표의 **리전별 네트워크 인터페이스** 항목 참조). ** ErrorCode ** 오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다. ** Message ** 오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다. HTTP 상태 코드: 409 ** NoFreeAddressesInSubnet ** 요청에 `IpAddress` 또는 `Ipv6Address`가 제공되지 않았으며 지정된 서브넷에 사용 가능한 IP 주소가 없습니다. ** ErrorCode ** 오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다. ** Message ** 오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다. HTTP 상태 코드: 409 ** SecurityGroupLimitExceeded ** 요청에 지정된 `SecurityGroups`의 수가 계정 할당량에 기반한 한도를 초과할 경우 반환됩니다. 일부 보안 그룹을 삭제하거나 계정 할당량 상향을 요청하세요. 자세한 내용은 *Amazon VPC 사용 설명서*의 [Amazon VPC 할당량](https://docs.aws.amazon.com/vpc/latest/userguide/amazon-vpc-limits.html)을 참조하세요(**보안 그룹** 테이블 참조). ** ErrorCode ** 오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다. ** Message ** 오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다. HTTP 상태 코드: 400 ** SecurityGroupNotFound ** 지정된 보안 그룹 중 하나가 서브넷의 Virtual Private Cloud(VPC)에 존재하지 않는 경우 반환됩니다. ** ErrorCode ** 오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다. ** Message ** 오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다. HTTP 상태 코드: 400 ** SubnetNotFound ** 요청에 ID `SubnetId`가 제공된 서브넷이 없는 경우 반환됩니다. ** ErrorCode ** 오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다. ** Message ** 오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다. HTTP 상태 코드: 400 ** UnsupportedAvailabilityZone ** 요청된 Amazon EFS 기능을 지정된 가용 영역에서 사용할 수 없는 경우 반환됩니다. ** ErrorCode ** 오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다. ** Message ** 오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다. 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 + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/CreateMountTarget) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/CreateMountTarget) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/CreateMountTarget) + [AWS Go v2용 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/CreateMountTarget) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/CreateMountTarget) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/CreateMountTarget) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/CreateMountTarget) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/CreateMountTarget) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/CreateMountTarget) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/CreateMountTarget)