기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
DescribeLocationSmb
서버 메시지 블록(SMB) 파일 서버의 AWS DataSync 전송 위치를 구성하는 방법에 대한 세부 정보를 제공합니다.
구문 요청
{
"LocationArn": "string"
}요청 파라미터
모든 작업에 공통되는 파라미터에 대한 자세한 설명은 공통 파라미터를 참조하세요.
요청은 JSON 형식으로 다음 데이터를 받습니다.
- LocationArn
-
정보를 원하는 SMB 위치의 Amazon 리소스 이름(ARN)을 지정합니다.
유형: 문자열
길이 제약: 최대 길이는 128입니다.
Pattern:
^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}$필수 여부: 예
응답 구문
{
"AgentArns": [ "string" ],
"AuthenticationType": "string",
"CreationTime": number,
"DnsIpAddresses": [ "string" ],
"Domain": "string",
"KerberosPrincipal": "string",
"LocationArn": "string",
"LocationUri": "string",
"MountOptions": {
"Version": "string"
},
"User": "string"
}응답 요소
작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.
다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.
- AgentArns
-
사용자의 SMB 파일 서버와 연결할 수 있는 DataSync 에이전트의 ARN입니다.
타입: 문자열 배열
배열 구성원: 최소수는 1개입니다. 최대 항목 수는 4개입니다.
길이 제약: 최대 길이는 128입니다.
Pattern:
^arn:(aws|aws-cn|aws-us-gov|aws-iso|aws-iso-b):datasync:[a-z\-0-9]+:[0-9]{12}:agent/agent-[0-9a-z]{17}$ - AuthenticationType
-
DataSync가 SMB 파일 서버에 연결하는 데 사용하는 인증 프로토콜입니다.
타입: 문자열
유효 값:
NTLM | KERBEROS - CreationTime
-
SMB 위치가 생성된 시간입니다.
유형: 타임스탬프
- DnsIpAddresses
-
SMB 파일 서버가 속한 DNS 서버의 IPv4 주소입니다. 이 요소는
AuthenticationType가 로 설정된 경우에만 적용됩니다KERBEROS.유형: 문자열 배열
배열 멤버: 최대 항목 수는 2개입니다.
길이 제약: 최소 길이는 7입니다. 최대 길이는 15입니다.
패턴:
\A(25[0-5]|2[0-4]\d|[0-1]?\d?\d)(\.(25[0-5]|2[0-4]\d|[0-1]?\d?\d)){3}\z - Domain
-
SMB 파일 서버가 속한 Windows 도메인의 이름입니다. 이 요소는
AuthenticationType가 로 설정된 경우에만 적용됩니다NTLM.유형: 문자열
길이 제약: 최대 길이는 253입니다.
패턴:
^[A-Za-z0-9]((\.|-+)?[A-Za-z0-9]){0,252}$ - KerberosPrincipal
-
SMB 파일 서버의 파일, 폴더 및 파일 메타데이터에 액세스할 수 있는 권한이 있는 Kerberos 보안 주체입니다.
유형: 문자열
길이 제약 조건: 최소 길이는 1입니다. 최대 길이는 256입니다.
Pattern:
^.+$ - LocationArn
-
SMB 위치의 ARN입니다.
유형: 문자열
길이 제약: 최대 길이는 128입니다.
Pattern:
^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
-
SMB 위치의 URI입니다.
유형: 문자열
길이 제약: 최대 길이는 4360입니다.
패턴:
^(efs|nfs|s3|smb|hdfs|fsx[a-z0-9-]+)://[a-zA-Z0-9.:/\-]+$ - MountOptions
-
DataSync가 SMB 파일 서버에 액세스하는 데 사용하는 SMB 프로토콜 버전입니다.
유형: SmbMountOptions 객체
- User
-
SMB 파일 서버의 파일, 폴더, 파일 메타데이터를 탑재하고 액세스할 수 있는 사용자입니다. 이 요소는
AuthenticationType가 로 설정된 경우에만 적용됩니다NTLM.유형: 문자열
길이 제약: 최대 길이는 104입니다.
패턴:
^[^\x22\x5B\x5D/\\:;|=,+*?\x3C\x3E]{1,104}$
오류
모든 작업에서 공통적으로 발생하는 오류에 대한 자세한 설명은 일반적인 오류섹션을 참조하세요.
- InternalException
-
이 예외는 AWS DataSync 서비스에 오류가 발생할 때 던져집니다.
HTTP 상태 코드: 500
- InvalidRequestException
-
이 예외는 클라이언트가 잘못된 형식의 요청을 제출할 때 던져집니다.
HTTP 상태 코드: 400
예
예
이 예에서는 DescribeLocationSMB의 한 가지 사용법을 보여줍니다.
예 요청
{
"arn:aws:datasync:us-east-1:111222333444:location/loc-0f01451b140b2af49"
}예제
이 예에서는 DescribeLocationSMB의 한 가지 사용법을 보여줍니다.
샘플 응답
{
"AgentArns":[
"arn:aws:datasync:us-east-2:111222333444:agent/agent-0bc3b3dc9bbc15145",
"arn:aws:datasync:us-east-2:111222333444:agent/agent-04b3fe3d261a18c8f"
],
"CreationTime":"1532660733.39",
"Domain":"AMAZON",
"LocationArn":"arn:aws:datasync:us-east-1:111222333444:location/loc-0f01451b140b2af49",
"LocationUri":"smb://hostname.amazon.com/share",
"MountOptions":{
"Version":"SMB3"
},
"User":"user-1"
}
참고
언어별 AWS SDKs
