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

# DescribeLocationSmb
<a name="API_DescribeLocationSmb"></a>

SMB(Server Message Block) 파일 서버의 AWS DataSync 전송 위치를 구성하는 방법에 대한 세부 정보를 제공합니다.

## 구문 요청
<a name="API_DescribeLocationSmb_RequestSyntax"></a>

```
{
   "LocationArn": "string"
}
```

## 요청 파라미터
<a name="API_DescribeLocationSmb_RequestParameters"></a>

모든 작업에 공통되는 파라미터에 대한 자세한 설명은 [공통 파라미터](CommonParameters.md)를 참조하세요.

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

 ** [LocationArn](#API_DescribeLocationSmb_RequestSyntax) **   <a name="DataSync-DescribeLocationSmb-request-LocationArn"></a>
정보를 원하는 SMB 위치의 Amazon 리소스 이름(ARN)을 지정합니다.  
유형: 문자열  
길이 제약: 최대 길이는 128입니다.  
패턴: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):datasync:[a-z\-0-9]+:[0-9]{12}:location/loc-[0-9a-z]{17}$`   
필수 여부: 예

## 응답 구문
<a name="API_DescribeLocationSmb_ResponseSyntax"></a>

```
{
   "AgentArns": [ "string" ],
   "AuthenticationType": "string",
   "CmkSecretConfig": { 
      "KmsKeyArn": "string",
      "SecretArn": "string"
   },
   "CreationTime": number,
   "CustomSecretConfig": { 
      "SecretAccessRoleArn": "string",
      "SecretArn": "string"
   },
   "DnsIpAddresses": [ "string" ],
   "Domain": "string",
   "KerberosPrincipal": "string",
   "LocationArn": "string",
   "LocationUri": "string",
   "ManagedSecretConfig": { 
      "SecretArn": "string"
   },
   "MountOptions": { 
      "Version": "string"
   },
   "User": "string"
}
```

## 응답 요소
<a name="API_DescribeLocationSmb_ResponseElements"></a>

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

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

 ** [AgentArns](#API_DescribeLocationSmb_ResponseSyntax) **   <a name="DataSync-DescribeLocationSmb-response-AgentArns"></a>
사용자의 SMB 파일 서버와 연결할 수 있는 DataSync 에이전트의 ARN입니다.  
타입: 문자열 배열  
배열 구성원: 최소수는 1개입니다. 최대 항목 수는 8개입니다.  
길이 제약: 최대 길이는 128입니다.  
패턴: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):datasync:[a-z\-0-9]+:[0-9]{12}:agent/agent-[0-9a-z]{17}$` 

 ** [AuthenticationType](#API_DescribeLocationSmb_ResponseSyntax) **   <a name="DataSync-DescribeLocationSmb-response-AuthenticationType"></a>
DataSync가 SMB 파일 서버에 연결하는 데 사용하는 인증 프로토콜입니다.  
타입: 문자열  
유효 값: `NTLM | KERBEROS` 

 ** [CmkSecretConfig](#API_DescribeLocationSmb_ResponseSyntax) **   <a name="DataSync-DescribeLocationSmb-response-CmkSecretConfig"></a>
DataSync가 고객 관리형를 사용하여 특정 스토리지 위치에 액세스하는 데 사용하는 `Password` 또는와 같은 `KerberosKeytab` DataSync 관리형 보안 암호의 구성 정보를 설명합니다 AWS KMS key.  
유형: [CmkSecretConfig](API_CmkSecretConfig.md)객체

 ** [CreationTime](#API_DescribeLocationSmb_ResponseSyntax) **   <a name="DataSync-DescribeLocationSmb-response-CreationTime"></a>
SMB 위치가 생성된 시간입니다.  
유형: 타임스탬프

 ** [CustomSecretConfig](#API_DescribeLocationSmb_ResponseSyntax) **   <a name="DataSync-DescribeLocationSmb-response-CustomSecretConfig"></a>
`KerberosKeytab` DataSync가 보안 암호에 대한 액세스를 제공하는 고객 관리형 AWS Identity and Access Management (IAM) 역할을 사용하여 특정 스토리지 위치에 액세스하는 데 사용하는 `Password` 또는와 같은 고객 관리형 보안 암호의 구성 정보를 설명합니다.  
유형: [CustomSecretConfig](API_CustomSecretConfig.md)객체

 ** [DnsIpAddresses](#API_DescribeLocationSmb_ResponseSyntax) **   <a name="DataSync-DescribeLocationSmb-response-DnsIpAddresses"></a>
SMB 파일 서버가 속한 DNS 서버의 IPv4 또는 IPv6 주소입니다. 이 값은 `AuthenticationType`이 `KERBEROS`로 설정된 경우에만 적용됩니다.  
유형: 문자열 배열  
배열 멤버: 최대 항목 수는 2개입니다.  
길이 제약: 최소 길이는 7입니다. 최대 길이는 39입니다.  
패턴: `\A((25[0-5]|2[0-4]\d|[0-1]?\d?\d)(\.(25[0-5]|2[0-4]\d|[0-1]?\d?\d)){3}|([0-9a-fA-F]{1,4}:){7,7}[0-9a-fA-F]{1,4}|([0-9a-fA-F]{1,4}:){1,7}:|([0-9a-fA-F]{1,4}:){1,6}:[0-9a-fA-F]{1,4}|([0-9a-fA-F]{1,4}:){1,5}(:[0-9a-fA-F]{1,4}){1,2}|([0-9a-fA-F]{1,4}:){1,4}(:[0-9a-fA-F]{1,4}){1,3}|([0-9a-fA-F]{1,4}:){1,3}(:[0-9a-fA-F]{1,4}){1,4}|([0-9a-fA-F]{1,4}:){1,2}(:[0-9a-fA-F]{1,4}){1,5}|[0-9a-fA-F]{1,4}:((:[0-9a-fA-F]{1,4}){1,6}))\z` 

 ** [Domain](#API_DescribeLocationSmb_ResponseSyntax) **   <a name="DataSync-DescribeLocationSmb-response-Domain"></a>
SMB 파일 서버가 속한 Windows 도메인의 이름입니다. 이 값은 `AuthenticationType`이 `NTLM`로 설정된 경우에만 적용됩니다.  
유형: 문자열  
길이 제약: 최대 길이는 253입니다.  
패턴: `^[A-Za-z0-9]((\.|-+)?[A-Za-z0-9]){0,252}$` 

 ** [KerberosPrincipal](#API_DescribeLocationSmb_ResponseSyntax) **   <a name="DataSync-DescribeLocationSmb-response-KerberosPrincipal"></a>
SMB 파일 서버의 파일, 폴더, 파일 메타데이터에 액세스할 권한이 있는 Kerberos 보안 주체입니다.  
유형: 문자열  
길이 제약 조건: 최소 길이는 1입니다. 최대 길이는 256입니다.  
패턴: `^.+$` 

 ** [LocationArn](#API_DescribeLocationSmb_ResponseSyntax) **   <a name="DataSync-DescribeLocationSmb-response-LocationArn"></a>
SMB 위치의 ARN입니다.  
유형: 문자열  
길이 제약: 최대 길이는 128입니다.  
패턴: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):datasync:[a-z\-0-9]+:[0-9]{12}:location/loc-[0-9a-z]{17}$` 

 ** [LocationUri](#API_DescribeLocationSmb_ResponseSyntax) **   <a name="DataSync-DescribeLocationSmb-response-LocationUri"></a>
SMB 위치의 URI입니다.  
유형: 문자열  
길이 제약: 최대 길이는 4360입니다.  
패턴: `^(efs|nfs|s3|smb|hdfs|fsx[a-z0-9-]+)://[a-zA-Z0-9.:/\-]+$` 

 ** [ManagedSecretConfig](#API_DescribeLocationSmb_ResponseSyntax) **   <a name="DataSync-DescribeLocationSmb-response-ManagedSecretConfig"></a>
DataSync가 특정 스토리지 위치에 액세스하는 데 사용하는 `Password` 또는와 같은 `KerberosKeytab` DataSync 관리형 보안 암호의 구성 정보를 설명합니다. DataSync는 기본 AWS관리형 KMS 키를 사용하여이 보안 암호를 암호화합니다 AWS Secrets Manager.  
유형: [ManagedSecretConfig](API_ManagedSecretConfig.md)객체

 ** [MountOptions](#API_DescribeLocationSmb_ResponseSyntax) **   <a name="DataSync-DescribeLocationSmb-response-MountOptions"></a>
DataSync가 SMB 파일 서버에 액세스하는 데 사용하는 SMB 프로토콜의 버전입니다.  
유형: [SmbMountOptions](API_SmbMountOptions.md)객체

 ** [User](#API_DescribeLocationSmb_ResponseSyntax) **   <a name="DataSync-DescribeLocationSmb-response-User"></a>
SMB 파일 서버의 파일, 폴더, 파일 메타데이터를 탑재하고 액세스할 수 있는 사용자입니다. 이 값은 `AuthenticationType`이 `NTLM`로 설정된 경우에만 적용됩니다.  
유형: 문자열  
길이 제약: 최대 길이는 104입니다.  
패턴: `^[^\x22\x5B\x5D/\\:;|=,+*?\x3C\x3E]{1,104}$` 

## 오류
<a name="API_DescribeLocationSmb_Errors"></a>

모든 작업에서 공통적으로 발생하는 오류에 대한 자세한 설명은 [일반적인 오류](CommonErrors.md)섹션을 참조하세요.

 ** InternalException **   
이 예외는 AWS DataSync 서비스에 오류가 발생할 때 던져집니다.  
HTTP 상태 코드: 500

 ** InvalidRequestException **   
이 예외는 클라이언트가 잘못된 형식의 요청을 제출할 때 던져집니다.  
HTTP 상태 코드: 400

## 예
<a name="API_DescribeLocationSmb_Examples"></a>

### 예제
<a name="API_DescribeLocationSmb_Example_1"></a>

이 예에서는 DescribeLocationSMB의 한 가지 사용법을 보여줍니다.

#### 예 요청
<a name="API_DescribeLocationSmb_Example_1_Request"></a>

```
{
  "arn:aws:datasync:us-east-1:111222333444:location/loc-0f01451b140b2af49"
}
```

### 예제
<a name="API_DescribeLocationSmb_Example_2"></a>

이 예에서는 DescribeLocationSMB의 한 가지 사용법을 보여줍니다.

#### 샘플 응답
<a name="API_DescribeLocationSmb_Example_2_Response"></a>

```
{
   "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"
}
```

## 참고
<a name="API_DescribeLocationSmb_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/DescribeLocationSmb) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/DescribeLocationSmb) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/DescribeLocationSmb) 
+  [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/DescribeLocationSmb) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/DescribeLocationSmb) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/DescribeLocationSmb) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/DescribeLocationSmb) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/DescribeLocationSmb) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/DescribeLocationSmb) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/DescribeLocationSmb)