기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
DescribeLocationEfs
Amazon EFS 파일 시스템의 AWS DataSync 위치에 대한 메타데이터를 반환합니다.
요청 구문
{
"LocationArn": "string"
}요청 파라미터
모든 작업에 공통되는 파라미터에 대한 자세한 내용은 범용 파라미터를 참조하십시오.
요청은 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}$Required: Yes
응답 구문
{
"AccessPointArn": "string",
"CreationTime": number,
"Ec2Config": {
"SecurityGroupArns": [ "string" ],
"SubnetArn": "string"
},
"FileSystemAccessRoleArn": "string",
"InTransitEncryption": "string",
"LocationArn": "string",
"LocationUri": "string"
}응답 요소
작업이 성공하면 서비스가 HTTP 200 응답을 다시 전송합니다.
다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.
- AccessPointArn
-
Amazon EFS 파일 시스템에 액세스하는 데 DataSync 사용하는 액세스 지점의 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}$ - CreationTime
-
위치가 생성된 시간입니다.
유형: Timestamp
- Ec2Config
-
AWS DataSync가 Amazon EFS 파일 시스템에 액세스하는 데 사용하는 서브넷 및 보안 그룹입니다.
유형: Ec2Config 객체
- 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) 암호화를 DataSync 사용할지 여부를 설명합니다.
유형: String
유효한 값:
NONE | TLS1_2 - LocationArn
-
Amazon EFS 파일 시스템 위치의 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}$ - LocationUri
-
Amazon EFS 파일 시스템 위치의 URL입니다.
유형: String
길이 제약: 최대 길이는 4360입니다.
패턴:
^(efs|nfs|s3|smb|hdfs|fsx[a-z0-9-]+)://[a-zA-Z0-9.:/\-]+$
오류
모든 작업에 공통적으로 나타나는 오류에 대한 자세한 내용은 을 참조하십시오일반적인 오류.
- InternalException
-
이 예외는 AWS DataSync 서비스에 오류가 발생할 때 발생합니다.
HTTP 상태 코드: 500
- InvalidRequestException
-
클라이언트가 잘못된 형식의 요청을 제출하면 이 예외가 발생합니다.
HTTP 상태 코드: 400
예시
예제 요청
다음 예에서는 특정 Amazon EFS 파일 시스템 위치에 대한 정보를 가져오는 방법을 보여줍니다.
{ "LocationArn": "arn:aws:datasync:us-east-2:111222333444:location/loc-12abcdef012345678" }
샘플 응답
다음 예에서는 Amazon EFS 파일 시스템에 대한 위치 세부 정보를 반환합니다.
{ "CreationTime": 1653319021.353, "Ec2Config": { "SubnetArn": "arn:aws:ec2:us-east-2:111222333444:subnet/subnet-1234567890abcdef1", "SecurityGroupArns": [ "arn:aws:ec2:us-east-2:111222333444:security-group/sg-1234567890abcdef2" ] }, "LocationArn": "arn:aws:datasync:us-east-2:111222333444:location/loc-abcdef01234567890", "LocationUri": "efs://us-east-2.fs-021345abcdef6789/" }
샘플 응답: 제한된 Amazon EFS 파일 시스템의 위치 설명
다음 예제는 AccessPointArnFileSystemAccessRoleArn, 및 InTransitEncryption 요소를 포함하여 액세스가 제한된 Amazon EFS 파일 시스템에 대한 위치 세부 정보를 반환합니다.
{ "CreationTime": 1653319021.353, "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" }] }
참고 항목
이 API를 언어별 AWS SDK 중 하나로 사용하는 방법에 대한 자세한 내용은 다음을 참조하세요.
