기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
CreateLocationNfs
읽거나 쓸 수 있는 네트워크 파일 시스템 (NFS) 서버의 파일 시스템을 정의합니다.
요청 구문
{
"MountOptions": {
"Version": "string"
},
"OnPremConfig": {
"AgentArns": [ "string" ]
},
"ServerHostname": "string",
"Subdirectory": "string",
"Tags": [
{
"Key": "string",
"Value": "string"
}
]
}요청 파라미터
모든 작업에 공통적인 매개 변수에 대한 자세한 내용은 일반 매개 변수를 참조하십시오.
요청은 JSON 형식의 다음 데이터를 받습니다.
- MountOptions
-
NFS 공유를 탑재하는 데 사용할DataSync 수 있는 NFS 탑재 옵션입니다.
유형: NfsMountOptions 객체
필수 항목 여부: 아니요
- OnPremConfig
-
NFS 서버에 연결하는 데 사용되는 에이전트의 Amazon 리소스 이름(ARN) 목록이 들어 있습니다.
AWS Snowcone 디바이스에서 데이터를 복사하는 경우 AWS Snowcone의 NFS 서버에서 자세한 내용을 참조하세요.
유형: OnPremConfig 객체
필수 항목 여부: 예
- ServerHostname
-
NFS 서버의 이름입니다. 이 값은 NFS 서버의 IP 주소 또는 도메인 이름 서비스(DNS) 이름입니다. 온프레미스에 설치된 에이전트는 이 호스트 이름을 사용하여 네트워크에 NFS 서버를 탑재합니다.
AWS Snowcone 디바이스에서 데이터를 복사하는 경우 AWS Snowcone의 NFS 서버에서 자세한 내용을 참조하세요.
참고
이 이름은 DNS와 호환되거나 IP 버전 4(IPv4) 주소여야 합니다.
유형: String
길이 제약: 최대 길이는 255입니다.
패턴:
^(([a-zA-Z0-9\-]*[a-zA-Z0-9])\.)*([A-Za-z0-9\-]*[A-Za-z0-9])$필수 항목 여부: 예
- Subdirectory
-
NFS 소스 위치에서 데이터를 읽거나 NFS 대상에 데이터를 쓰는 데 사용되는 NFS 파일 시스템의 하위 디렉터리입니다. NFS 경로는 NFS 서버에서 내보낸 경로 또는 해당 경로의 하위 디렉터리여야 합니다. 이 경로는 네트워크의 다른 NFS 클라이언트에서 탑재할 수 있는 것이어야 합니다.
NFS 서버에서 내보낸 모든 경로를 확인하려면 서버에 액세스할 수 있는 NFS 클라이언트에서 “
showmount -e nfs-server-name”을 실행합니다. 결과에 나타나는 모든 디렉터리와 그 디렉터리의 하위 디렉터리를 지정할 수 있습니다. Kerberos 인증 없이 NFS 내보내기에 액세스할 수 있는지 확인하십시오.지정된 폴더의 모든 데이터를 전송하려면 DataSync에 모든 데이터를 읽을 수 있는 권한이 있어야 합니다. 이렇게 하려면 로 NFS 내보내기를
no_root_squash,구성하거나 모든 파일에 대한 권한이 모든 사용자에 대한 읽기 액세스를DataSync 허용하는지 확인합니다. 이렇게 하면 에이전트가 파일을 읽을 수 있습니다. 추가적으로 모든 실행 액세스를 활성화해야 에이전트가 디렉터리에 액세스할 수 있습니다.AWS Snowcone 디바이스에서 데이터를 복사하는 경우 AWS Snowcone의 NFS 서버에서 자세한 내용을 참조하세요.
NFS 내보내기 구성에 대한 자세한 내용을 알아보려면 18.7. Red Hat Enterprise Linux 설명서의 /etc/exports 구성 파일
을 참조하세요. 유형: String
길이 제약: 최대 길이는 4096입니다.
패턴:
^[a-zA-Z0-9_\-\+\./\(\)\p{Zs}]+$필수 항목 여부: 예
- Tags
-
위치에 추가하려는 태그를 나타내는 키-값 페어입니다. 값은 빈 문자열일 수도 있습니다. 태그를 사용하여 리소스의 이름을 지정하는 것이 좋습니다.
유형: TagListEntry 객체 배열
배열 멤버: 최소 항목 수는 0개입니다. 최대 항목 수 50개.
필수 항목 여부: 아니요
응답 구문
{
"LocationArn": "string"
}응답 요소
작업이 성공하면 서비스가 HTTP 200 응답을 다시 전송합니다.
다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.
- LocationArn
-
생성된 소스 NFS 파일 시스템 위치의 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
예시
예
다음 예에서는 지정된 NFS 버전을 마운트 옵션으로 사용하여 NFS 파일 시스템의 엔드포인트를 생성합니다.
예제 요청
{
"MountOptions": {
"Version": : "NFS4_0"
},
"OnPremConfig": {
"AgentArn": [ "arn:aws:datasync:us-east-2:111222333444:agent/agent-0b0addbeef44b3nfs" ]
},
"ServerHostname": "MyServer@amazon.com",
"Subdirectory": "/MyFolder",
"Tags": [
{
"Key": "Name",
"Value": "ElasticFileSystem-1"
}
]
}예
응답은 NFS 위치의 Amazon 리소스 이름 (ARN) 을 반환합니다.
샘플 응답
{
"LocationArn": "arn:aws:datasync:us-east-2:111222333444:location/loc-07db7abfc326c50aa"
}참고 항목
이 API를 언어별 AWS SDK 중 하나로 사용하는 방법에 대한 자세한 내용은 다음을 참조하세요.
