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

# CreateLocationFsxOntap
<a name="API_CreateLocationFsxOntap"></a>

Amazon FSx for NetApp ONTAP 파일 시스템의 전송 *위치를* 생성합니다.이 위치를 데이터 전송을 위한 소스 또는 대상으로 사용할 AWS DataSync 수 있습니다.

시작하려면 먼저 DataSync에서 [FSx for ONTAP 파일 시스템에 액세스하는 방법](https://docs.aws.amazon.com/datasync/latest/userguide/create-ontap-location.html#create-ontap-location-access)을 이해해야 합니다.

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

```
{
   "Protocol": { 
      "NFS": { 
         "MountOptions": { 
            "Version": "string"
         }
      },
      "SMB": { 
         "CmkSecretConfig": { 
            "KmsKeyArn": "string",
            "SecretArn": "string"
         },
         "CustomSecretConfig": { 
            "SecretAccessRoleArn": "string",
            "SecretArn": "string"
         },
         "Domain": "string",
         "ManagedSecretConfig": { 
            "SecretArn": "string"
         },
         "MountOptions": { 
            "Version": "string"
         },
         "Password": "string",
         "User": "string"
      }
   },
   "SecurityGroupArns": [ "string" ],
   "StorageVirtualMachineArn": "string",
   "Subdirectory": "string",
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ]
}
```

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

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

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

 ** [Protocol](#API_CreateLocationFsxOntap_RequestSyntax) **   <a name="DataSync-CreateLocationFsxOntap-request-Protocol"></a>
가 Amazon FSx 파일 시스템에 액세스하는 데 AWS DataSync 사용하는 데이터 전송 프로토콜을 지정합니다.  
타입: [FsxProtocol](API_FsxProtocol.md)객체  
필수 여부: 예

 ** [SecurityGroupArns](#API_CreateLocationFsxOntap_RequestSyntax) **   <a name="DataSync-CreateLocationFsxOntap-request-SecurityGroupArns"></a>
파일 시스템의 선호 서브넷에 대한 액세스를 제공하는 Amazon EC2 보안 그룹을 지정합니다.  
보안 그룹은 (사용 중인 프로토콜에 따라) 다음 포트에서 아웃바운드 트래픽을 허용해야 합니다:  
+  **NFS(Network File System)**: TCP 포트 111, 635 및 2,049
+  **SMB(Server Message Block)**: TCP 포트 445
파일 시스템의 보안 그룹은 동일한 포트에서 인바운드 트래픽도 허용해야 합니다.  
타입: 문자열 배열  
배열 구성원: 최소수는 1개입니다. 최대 항목 수 5개.  
길이 제약: 최대 길이는 128입니다.  
패턴: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):ec2:[a-z\-0-9]*:[0-9]{12}:security-group/sg-[a-f0-9]+$`   
필수 여부: 예

 ** [StorageVirtualMachineArn](#API_CreateLocationFsxOntap_RequestSyntax) **   <a name="DataSync-CreateLocationFsxOntap-request-StorageVirtualMachineArn"></a>
데이터를 복사하려는 파일 시스템에서 스토리지 가상 머신(SVM)의 ARN을 지정합니다.  
타입: 문자열  
길이 제약: 최대 길이는 162입니다.  
패턴: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):fsx:[a-z\-0-9]+:[0-9]{12}:storage-virtual-machine/fs-[0-9a-f]+/svm-[0-9a-f]{17,}$`   
필수 여부: 예

 ** [Subdirectory](#API_CreateLocationFsxOntap_RequestSyntax) **   <a name="DataSync-CreateLocationFsxOntap-request-Subdirectory"></a>
데이터를 주고 받을 SVM에 파일 공유 경로를 지정합니다.  
정션 경로(탑재 지점이라고도 함), qtree 경로(NFS 파일 공유의 경우) 또는 공유 이름(SMB 파일 공유의 경우)을 지정할 수 있습니다. 예를 들어, 탑재 경로는 `/vol1`, `/vol1/tree1`또는 `/share1`일 수 있습니다.  
SVM의 루트 볼륨에 정션 경로를 지정하지 않습니다. 자세한 설명은 *Amazon FSx for NetApp ONTAP User Guide*(Amazon FSx for NetApp ONTAP 사용자 가이드)의 [Managing FSx for ONTAP storage virtual machines](https://docs.aws.amazon.com/fsx/latest/ONTAPGuide/managing-svms.html)(FSx for ONTAP 스토리지 가상 머신 관리)를 참조하세요.
타입: 문자열  
길이 제약: 최대 길이는 255입니다.  
패턴: `^[^\u0000\u0085\u2028\u2029\r\n]{1,255}$`   
필수 여부: 아니요

 ** [Tags](#API_CreateLocationFsxOntap_RequestSyntax) **   <a name="DataSync-CreateLocationFsxOntap-request-Tags"></a>
 AWS 리소스를 분류, 필터링 및 검색하는 데 도움이 되는 레이블을 지정합니다. 위치에 대한 이름 태그를 하나 이상 생성하는 것이 좋습니다.  
타입: [TagListEntry](API_TagListEntry.md)객체 배열  
배열 구성원: 최소수는 0개입니다. 최대수 50개.  
필수 여부: 아니요

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

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

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

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

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

 ** [LocationArn](#API_CreateLocationFsxOntap_ResponseSyntax) **   <a name="DataSync-CreateLocationFsxOntap-response-LocationArn"></a>
생성한 FSx for ONTAP 파일 시스템 위치에 대해 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_CreateLocationFsxOntap_Errors"></a>

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

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

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

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

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