기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다. # CreateLocationEfs Amazon EFS 파일 시스템의 전송 *위치*를 생성합니다. AWS DataSync 는 이 위치를 데이터 전송을 위한 소스 또는 대상으로 사용할 수 있습니다. 시작하려면 먼저 DataSync에서 [Amazon EFS 파일 시스템에 액세스](https://docs.aws.amazon.com/datasync/latest/userguide/create-efs-location.html#create-efs-location-access)하는 방법을 이해해야 합니다. ## 구문 요청 ``` { "AccessPointArn": "string", "Ec2Config": { "SecurityGroupArns": [ "string" ], "SubnetArn": "string" }, "EfsFilesystemArn": "string", "FileSystemAccessRoleArn": "string", "InTransitEncryption": "string", "Subdirectory": "string", "Tags": [ { "Key": "string", "Value": "string" } ] } ``` ## 요청 파라미터 모든 작업에 공통되는 파라미터에 대한 자세한 설명은 [공통 파라미터](CommonParameters.md)를 참조하세요. 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [AccessPointArn](#API_CreateLocationEfs_RequestSyntax) ** DataSync가 Amazon EFS 파일 시스템을 탑재하는 데 사용하는 액세스 포인트의 Amazon 리소스 이름(ARN)을 지정합니다. 자세한 내용은 [Accessing restricted file systems](https://docs.aws.amazon.com/datasync/latest/userguide/create-efs-location.html#create-efs-location-iam) 섹션을 참조하세요. 유형: 문자열 길이 제약: 최대 길이는 128입니다. 패턴: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):elasticfilesystem:[a-z\-0-9]+:[0-9]{12}:access-point/fsap-[0-9a-f]{8,40}$` 필수 여부: 아니요 ** [Ec2Config](#API_CreateLocationEfs_RequestSyntax) ** DataSync가 Amazon EFS 파일 시스템의 [탑재 대상](https://docs.aws.amazon.com/efs/latest/ug/accessing-fs.html) 중 하나에 연결하는 데 사용하는 서브넷 및 보안 그룹을 지정합니다. 타입: [Ec2Config](API_Ec2Config.md)객체 필수 항목 여부: 예 ** [EfsFilesystemArn](#API_CreateLocationEfs_RequestSyntax) ** Amazon EFS 파일 시스템에 대한 ARN을 지정합니다. 유형: 문자열 길이 제약: 최대 길이는 128입니다. 패턴: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):elasticfilesystem:[a-z\-0-9]+:[0-9]{12}:file-system/fs-[0-9a-f]{8,40}$` 필수 여부: 예 ** [FileSystemAccessRoleArn](#API_CreateLocationEfs_RequestSyntax) ** DataSync가 Amazon EFS 파일 시스템에 액세스할 수 있도록 허용하는 AWS Identity and Access Management (IAM) 역할을 지정합니다. 이 역할 생성에 대한 자세한 내용은 [Creating a DataSync IAM role for file system access](https://docs.aws.amazon.com/datasync/latest/userguide/create-efs-location.html#create-efs-location-iam-role) 섹션을 참조하세요. 유형: 문자열 길이 제약: 최대 길이 2048. 패턴: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):iam::[0-9]{12}:role/.*$` 필수 여부: 아니요 ** [InTransitEncryption](#API_CreateLocationEfs_RequestSyntax) ** DataSync가 Amazon EFS 파일 시스템으로 또는 파일 시스템에서 데이터를 전송할 때 Transport Layer Security(TLS) 1.2 암호화를 사용할지 여부를 지정합니다. `AccessPointArn`을 사용하여 액세스 지점을 지정하거나 `FileSystemAccessRoleArn`을 사용하여 IAM 역할을 지정하는 경우 이 파라미터를 `TLS1_2`로 설정해야 합니다. 타입: 문자열 유효 값: `NONE | TLS1_2` 필수 여부: 아니요 ** [Subdirectory](#API_CreateLocationEfs_RequestSyntax) ** Amazon EFS 파일 시스템에 대한 탑재 경로를 지정합니다. DataSync가 파일 시스템의 데이터를 읽거나 쓰는 위치입니다(소스 위치인지 대상 위치인지에 따라 다름). 기본적으로 DataSync는 루트 디렉터리(또는 사용자가 `AccessPointArn`을 사용하여 루트 디렉터리를 제공하는 경우 [액세스 포인트](https://docs.aws.amazon.com/efs/latest/ug/efs-access-points.html))를 사용합니다. 전방향 슬래시(예: `/path/to/folder`)를 사용하여 하위 디렉터리를 포함할 수도 있습니다. 유형: 문자열 길이 제약: 최대 길이는 4096입니다. 패턴: `^[a-zA-Z0-9_\-\+\./\(\)\p{Zs}]*$` 필수 여부: 아니요 ** [Tags](#API_CreateLocationEfs_RequestSyntax) ** 리소스에 추가하려는 태그를 나타내는 키-값 쌍을 지정합니다. 값은 빈 문자열일 수도 있습니다. 이 값은 리소스 관리, 필터링 및 검색에 도움이 됩니다. 위치에 대한 이름 태그를 생성하는 것이 좋습니다. 타입: [TagListEntry](API_TagListEntry.md)객체 배열 배열 구성원: 최소수는 0개입니다. 최대수 50개. 필수 여부: 아니요 ## 응답 구문 ``` { "LocationArn": "string" } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [LocationArn](#API_CreateLocationEfs_ResponseSyntax) ** 사용자가 생성하는 Amazon EFS 파일 시스템 위치의 Amazon 리소스 이름(ARN)입니다. 유형: 문자열 길이 제약: 최대 길이는 128입니다. 패턴: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):datasync:[a-z\-0-9]+:[0-9]{12}:location/loc-[0-9a-z]{17}$` ## 오류 모든 작업에서 공통적으로 발생하는 오류에 대한 자세한 설명은 [일반적인 오류 유형](CommonErrors.md)섹션을 참조하세요. ** InternalException ** 이 예외는 AWS DataSync 서비스에 오류가 발생할 때 던져집니다. HTTP 상태 코드: 500 ** InvalidRequestException ** 이 예외는 클라이언트가 잘못된 형식의 요청을 제출할 때 던져집니다. HTTP 상태 코드: 400 ## 예 ### 예 요청 다음 예제에서는 Amazon EFS 파일 시스템에 대해 위치를 생성합니다. ``` { "Ec2Config": { "SubnetArn": "arn:aws:ec2:us-east-2:11122233344:subnet/subnet-1234567890abcdef1", "SecurityGroupArns": [ "arn:aws:ec2:us-east-2:11122233344:security-group/sg-1234567890abcdef2" ] }, "EfsFilesystemArn": "arn:aws:elasticfilesystem:us-east-2:111222333444:file-system/fs-021345abcdef6789", "Subdirectory": "/mount/path", "Tags": [{ "Key": "Name", "Value": "ElasticFileSystem-1" }] } ``` ### 샘플 요청: 제한된 Amazon EFS 파일 시스템에 대해 위치 생성 다음 예제에서는 액세스가 제한된 Amazon EFS 파일 시스템에 대해 위치를 생성합니다. 이런 종류의 시나리오에서는 요청에 `AccessPointArn``FileSystemAccessRoleArn`, 및 `InTransitEncryption`값을 지정해야 할 수 있습니다. ``` { "AccessPointArn": "arn:aws:elasticfilesystem:us-east-2:111222333444:access-point/fsap-1234567890abcdef0", "Ec2Config": { "SubnetArn": "arn:aws:ec2:us-east-2:111222333444:subnet/subnet-1234567890abcdef1", "SecurityGroupArns": [ "arn:aws:ec2:us-east-2:111222333444:security-group/sg-1234567890abcdef2" ] }, "FileSystemAccessRoleArn": "arn:aws:iam::111222333444:role/AwsDataSyncFullAccessNew", "InTransitEncryption": "TLS1_2", "LocationArn": "arn:aws:datasync:us-east-2:111222333444:location/loc-abcdef01234567890", "LocationUri": "efs://us-east-2.fs-021345abcdef6789/", "Subdirectory": "/mount/path", "Tags": [{ "Key": "Name", "Value": "ElasticFileSystem-1" }] } ``` ### 샘플 응답 응답은 Amazon EFS 파일 시스템의 위치 ARN을 반환합니다. ``` { "LocationArn": "arn:aws:datasync:us-east-2:111222333444:location/loc-12abcdef012345678" } ``` ## 참고 언어별 AWS SDKs + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/CreateLocationEfs) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/CreateLocationEfs) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/CreateLocationEfs) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/CreateLocationEfs) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/CreateLocationEfs) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/CreateLocationEfs) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/CreateLocationEfs) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/CreateLocationEfs) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/CreateLocationEfs) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/CreateLocationEfs)