CreateLocationEfs - AWS DataSync

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

CreateLocationEfs

전송을 위해 액세스할 AWS DataSync 수 있는 Amazon EFS 파일 시스템의 엔드포인트를 생성합니다. 자세한 내용은 EFS EFS용 위치 생성을 참조하십시오.

요청 구문

{ "AccessPointArn": "string", "Ec2Config": { "SecurityGroupArns": [ "string" ], "SubnetArn": "string" }, "EfsFilesystemArn": "string", "FileSystemAccessRoleArn": "string", "InTransitEncryption": "string", "Subdirectory": "string", "Tags": [ { "Key": "string", "Value": "string" } ] }

요청 파라미터

모든 작업에 공통되는 파라미터에 대한 자세한 내용은 범용 파라미터를 참조하십시오.

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

AccessPointArn

Amazon EFS 파일 시스템에 액세스하는 데 DataSync 사용하는 액세스 지점의 Amazon 리소스 이름 (ARN) 을 지정합니다.

유형: String

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

패턴: ^arn:(aws|aws-cn|aws-us-gov|aws-iso|aws-iso-b):elasticfilesystem:[a-z\-0-9]+:[0-9]{12}:access-point/fsap-[0-9a-f]{8,40}$

필수 항목 여부: 아니요

Ec2Config

Amazon EFS 파일 시스템에 액세스하는 데 DataSync 사용하는 서브넷 및 보안 그룹을 지정합니다.

유형: Ec2Config 객체

필수 항목 여부: 예

EfsFilesystemArn

Amazon EFS 파일 시스템에 대한 ARN을 지정합니다.

유형: String

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

패턴: ^arn:(aws|aws-cn|aws-us-gov|aws-iso|aws-iso-b):elasticfilesystem:[a-z\-0-9]*:[0-9]{12}:file-system/fs-.*$

필수 항목 여부: 예

FileSystemAccessRoleArn

Amazon EFS 파일 시스템을 탑재할 때 DataSync 수임하는 AWS Identity and Access Management (IAM) 역할을 지정합니다.

유형: String

길이 제약: 최대 길이는 2,048입니다.

패턴: ^arn:(aws|aws-cn|aws-us-gov|aws-iso|aws-iso-b):iam::[0-9]{12}:role/.*$

필수 항목 여부: 아니요

InTransitEncryption

Amazon EFS 파일 시스템으로 또는 파일 시스템에서 데이터를 복사할 때 전송 계층 보안 (TLS) 1.2 암호화를 사용할지 여부를 지정합니다. DataSync

AccessPointArn을 사용하여 액세스 지점을 지정하거나 FileSystemAccessRoleArn을 사용하여 IAM 역할을 지정하는 경우 이 파라미터를 TLS1_2로 설정해야 합니다.

유형: String

유효한 값: NONE | TLS1_2

필수 항목 여부: 아니요

Subdirectory

Amazon EFS 파일 시스템에 대한 탑재 경로를 지정합니다. 이 위치가 데이터를 DataSync 읽거나 쓰는 위치입니다 (소스 위치인지 대상 위치인지에 따라 다름). 기본적으로 루트 디렉터리를 DataSync 사용하지만 하위 디렉터리를 포함시킬 수도 있습니다.

참고

슬래시로 값을 지정해야 합니다(예: /path/to/folder).

유형: String

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

패턴: ^[a-zA-Z0-9_\-\+\./\(\)\p{Zs}]*$

필수 항목 여부: 아니요

Tags

리소스에 추가하려는 태그를 나타내는 키-값 페어를 지정합니다. 값은 빈 문자열일 수도 있습니다. 이 값은 리소스 관리, 필터링 및 검색에 도움이 됩니다. 위치에 대한 이름 태그를 생성하는 것이 좋습니다.

유형: TagListEntry 객체 배열

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

필수 항목 여부: 아니요

응답 구문

{ "LocationArn": "string" }

응답 요소

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

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

LocationArn

생성한 Amazon EFS 파일 시스템 위치의 Amazon 리소스 이름 (ARN) 입니다.

유형: String

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

패턴: ^arn:(aws|aws-cn|aws-us-gov|aws-iso|aws-iso-b):datasync:[a-z\-0-9]+:[0-9]{12}:location/loc-[0-9a-z]{17}$

오류

모든 작업에 공통적으로 나타나는 오류에 대한 자세한 내용은 을 참조하십시오일반적인 오류.

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 파일 시스템의 위치를 생성합니다. 이런 종류의 시나리오에서는 요청에 AccessPointArnFileSystemAccessRoleArn, 및 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" }

참고 항목

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