기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
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 파일 시스템의 위치를 생성합니다. 이런 종류의 시나리오에서는 요청에 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" }
참고 항목
이 API를 언어별 AWS SDK 중 하나로 사용하는 방법에 대한 자세한 내용은 다음을 참조하세요.