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

# CreateLocationHdfs
<a name="API_CreateLocationHdfs"></a>

하둡 분산 파일 시스템(HDFS)의 전송 *위치를* 생성합니다.는이 위치를 데이터 전송을 위한 소스 또는 대상으로 사용할 AWS DataSync 수 있습니다.

시작하기 전에 먼저 DataSync가 [HDFS 클러스터에 액세스](https://docs.aws.amazon.com/datasync/latest/userguide/create-hdfs-location.html#accessing-hdfs)하는 방법을 이해해야 합니다.

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

```
{
   "AgentArns": [ "string" ],
   "AuthenticationType": "string",
   "BlockSize": number,
   "CmkSecretConfig": { 
      "KmsKeyArn": "string",
      "SecretArn": "string"
   },
   "CustomSecretConfig": { 
      "SecretAccessRoleArn": "string",
      "SecretArn": "string"
   },
   "KerberosKeytab": blob,
   "KerberosKrb5Conf": blob,
   "KerberosPrincipal": "string",
   "KmsKeyProviderUri": "string",
   "NameNodes": [ 
      { 
         "Hostname": "string",
         "Port": number
      }
   ],
   "QopConfiguration": { 
      "DataTransferProtection": "string",
      "RpcProtection": "string"
   },
   "ReplicationFactor": number,
   "SimpleUser": "string",
   "Subdirectory": "string",
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ]
}
```

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

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

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

 ** [AgentArns](#API_CreateLocationHdfs_RequestSyntax) **   <a name="DataSync-CreateLocationHdfs-request-AgentArns"></a>
HDFS 클러스터에 연결할 수 있는 DataSync 에이전트의 Amazon 리소스 이름(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_CreateLocationHdfs_RequestSyntax) **   <a name="DataSync-CreateLocationHdfs-request-AuthenticationType"></a>
사용자 ID를 결정하는 데 사용되는 인증 타입.  
타입: 문자열  
유효 값: `SIMPLE | KERBEROS`   
필수 사항 여부: 예

 ** [BlockSize](#API_CreateLocationHdfs_RequestSyntax) **   <a name="DataSync-CreateLocationHdfs-request-BlockSize"></a>
HDFS 클러스터에 쓸 데이터 블록의 크기입니다. 블록 크기는 512바이트의 배수여야 합니다. 기본 블록 크기는 128메비바이트(MiB)입니다.  
유형: 정수  
유효한 범위: 최소값은 1048576입니다. 최대값은 1073741824입니다.  
필수 여부: 아니요

 ** [CmkSecretConfig](#API_CreateLocationHdfs_RequestSyntax) **   <a name="DataSync-CreateLocationHdfs-request-CmkSecretConfig"></a>
DataSync가 고객 관리형으로 특정 Hadoop 분산 파일 시스템(HDFS) 스토리지 위치에 액세스하는 데 사용하는 Kerberos 키탭을 포함하는 DataSync 관리형 보안 암호의 구성 정보를 지정합니다 AWS KMS key.  
이 파라미터를 `CreateLocationHdfs` 요청의 일부로 포함하는 경우 KMS 키 ARN만 제공합니다. DataSync는 `KerberosKeytab`에 대해 지정한와 함께이 KMS 키를 사용하여 위치 액세스 자격 증명을 저장하는 DataSync 관리형 보안 암호를 생성합니다.  
DataSync에 지정한 KMS 키에 액세스할 수 있는 권한이 있는지 확인합니다. 자세한 내용은 [ 사용자 지정으로 암호화된 서비스 관리형 보안 암호 사용을 참조하세요 AWS KMS key](https://docs.aws.amazon.com/datasync/latest/userguide/location-credentials.html#service-secret-custom-key).  
`CmkSecretConfig`(`KerberosKeytab` 포함) 또는 `CustomSecretConfig`(`KerberosKeytab` 제외)을 사용하여 `CreateLocationHdfs` 요청에 대한 자격 증명을 제공할 수 있습니다. 같은 요청에 대해 두 파라미터를 모두 제공하지 마세요.
유형: [CmkSecretConfig](API_CmkSecretConfig.md)객체  
필수 여부: 아니요

 ** [CustomSecretConfig](#API_CreateLocationHdfs_RequestSyntax) **   <a name="DataSync-CreateLocationHdfs-request-CustomSecretConfig"></a>
HDFS 스토리지 위치의 Kerberos 키 탭이 Secrets Manager의 이진수에 저장되는 고객 관리형 Secrets Manager 보안 암호에 대한 구성 정보를 지정합니다. 이 구성에는 보안 암호 ARN과 보안 암호에 대한 액세스를 제공하는 IAM 역할의 ARN이 포함됩니다. 자세한 내용은 [ 관리하는 보안 암호 사용을 참조하세요](https://docs.aws.amazon.com/datasync/latest/userguide/location-credentials.html#custom-secret-custom-key).  
`CmkSecretConfig`(`KerberosKeytab` 포함) 또는 `CustomSecretConfig`(`KerberosKeytab` 제외)을 사용하여 `CreateLocationHdfs` 요청에 대한 자격 증명을 제공할 수 있습니다. 같은 요청에 대해 두 파라미터를 모두 제공하지 마세요.
유형: [CustomSecretConfig](API_CustomSecretConfig.md)객체  
필수 여부: 아니요

 ** [KerberosKeytab](#API_CreateLocationHdfs_RequestSyntax) **   <a name="DataSync-CreateLocationHdfs-request-KerberosKeytab"></a>
정의된 Kerberos 보안 주체와 암호화된 키 간의 매핑이 포함된 Kerberos 키 테이블(keytab)입니다. 파일 주소를 제공하여 파일에서 키탭을 로드할 수 있습니다.  
`AuthenticationType`에 `KERBEROS`가 지정된 경우 이 파라미터가 필요합니다.
타입: Base64로 인코딩된 이진 데이터 객체  
길이 제약: 최대 길이는 65536입니다.  
필수 여부: 아니요

 ** [KerberosKrb5Conf](#API_CreateLocationHdfs_RequestSyntax) **   <a name="DataSync-CreateLocationHdfs-request-KerberosKrb5Conf"></a>
Kerberos 구성 정보가 포함된 `krb5.conf` 파일입니다. 파일 주소를 제공하여 `krb5.conf`파일을 로드할 수 있습니다. AWS CLI를 사용하는 경우, base64 인코딩을 자동으로 수행합니다. 그렇지 않으면 base64 인코딩 형식의 텍스트를 제공하십시오.  
`AuthenticationType`에 `KERBEROS`가 지정된 경우 이 파라미터가 필요합니다.
타입: Base64로 인코딩된 이진 데이터 객체  
길이 제약: 최대 길이는 131072입니다.  
필수 여부: 아니요

 ** [KerberosPrincipal](#API_CreateLocationHdfs_RequestSyntax) **   <a name="DataSync-CreateLocationHdfs-request-KerberosPrincipal"></a>
HDFS 클러스터의 파일 및 폴더에 대한 액세스 권한이 있는 Kerberos 보안 주체입니다.  
`AuthenticationType`에 `KERBEROS`가 지정된 경우 이 파라미터가 필요합니다.
유형: 문자열  
길이 제약 조건: 최소 길이는 1입니다. 최대 길이는 256입니다.  
패턴: `^.+$`   
필수 여부: 아니요

 ** [KmsKeyProviderUri](#API_CreateLocationHdfs_RequestSyntax) **   <a name="DataSync-CreateLocationHdfs-request-KmsKeyProviderUri"></a>
HDFS 클러스터의 키 관리 서버(KMS)의 URI입니다.  
타입: 문자열  
길이 제약: 최소 길이는 1. 최대 길이는 255.  
패턴: `^kms:\/\/http[s]?@(([a-zA-Z0-9\-]*[a-zA-Z0-9])\.)*([A-Za-z0-9\-]*[A-Za-z0-9])(;(([a-zA-Z0-9\-]*[a-zA-Z0-9])\.)*([A-Za-z0-9\-]*[A-Za-z0-9]))*:[0-9]{1,5}\/kms$`   
필수 여부: 아니요

 ** [NameNodes](#API_CreateLocationHdfs_RequestSyntax) **   <a name="DataSync-CreateLocationHdfs-request-NameNodes"></a>
HDFS 네임스페이스를 관리하는 NameNode입니다. NameNode는 파일 및 디렉터리 열기, 닫기 및 이름 바꾸기와 같은 작업을 수행합니다. NameNode에는 데이터 블록을 DataNode에 매핑하기 위한 정보가 들어 있습니다. 하나의 NameNode만 사용할 수 있습니다.  
타입: [HdfsNameNode](API_HdfsNameNode.md)객체 배열  
어레이 멤버: 최소 항목 수 1개.  
필수 항목 여부: 예

 ** [QopConfiguration](#API_CreateLocationHdfs_RequestSyntax) **   <a name="DataSync-CreateLocationHdfs-request-QopConfiguration"></a>
QOP(Quality of Protection) 구성은 Hadoop 분산 파일 시스템(HDFS) 클러스터에 구성된 원격 프로시저 호출(RPC) 및 데이터 전송 방지 설정을 지정합니다. `QopConfiguration`이 지정되지 않은 경우 `RpcProtection` 및 `DataTransferProtection`은 기본적으로 `PRIVACY`로 설정됩니다. `RpcProtection` 또는 `DataTransferProtection`을 설정하면 다른 파라미터는 동일한 값을 가정합니다.  
유형: [QopConfiguration](API_QopConfiguration.md)객체  
필수 여부: 아니요

 ** [ReplicationFactor](#API_CreateLocationHdfs_RequestSyntax) **   <a name="DataSync-CreateLocationHdfs-request-ReplicationFactor"></a>
HDFS 클러스터에 쓸 때 데이터를 복제할 DataNode의 수입니다. 기본적으로 데이터는 3개의 DataNode에 복제됩니다.  
타입: 정수  
유효 범위: 최소값 1. 최대값은 512입니다.  
필수 여부: 아니요

 ** [SimpleUser](#API_CreateLocationHdfs_RequestSyntax) **   <a name="DataSync-CreateLocationHdfs-request-SimpleUser"></a>
호스트 운영 체제에서 클라이언트를 식별하는 데 사용되는 사용자 이름입니다.  
`AuthenticationType`에 `SIMPLE`가 지정된 경우 이 파라미터가 필요합니다.
유형: 문자열  
길이 제약 조건: 최소 길이는 1입니다. 최대 길이는 256입니다.  
패턴: `^[_.A-Za-z0-9][-_.A-Za-z0-9]*$`   
필수 여부: 아니요

 ** [Subdirectory](#API_CreateLocationHdfs_RequestSyntax) **   <a name="DataSync-CreateLocationHdfs-request-Subdirectory"></a>
HDFS 클러스터의 하위 디렉터리입니다. 이 하위 디렉터리는 HDFS 클러스터에서 데이터를 읽거나 쓰는 데 사용됩니다. 하위 디렉터리를 지정하지 않으면 기본적으로 `/`로 설정됩니다.  
유형: 문자열  
길이 제약: 최대 길이는 4096입니다.  
패턴: `^[a-zA-Z0-9_\-\+\./\(\)\$\p{Zs}]+$`   
필수 여부: 아니요

 ** [Tags](#API_CreateLocationHdfs_RequestSyntax) **   <a name="DataSync-CreateLocationHdfs-request-Tags"></a>
위치에 추가하려는 태그를 나타내는 키-값 쌍입니다. 값은 빈 문자열일 수도 있습니다. 태그를 사용하여 리소스의 이름을 지정하는 것이 좋습니다.  
타입: [TagListEntry](API_TagListEntry.md)객체 배열  
배열 구성원: 최소수는 0개입니다. 최대수 50개.  
필수 여부: 아니요

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

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

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

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

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

 ** [LocationArn](#API_CreateLocationHdfs_ResponseSyntax) **   <a name="DataSync-CreateLocationHdfs-response-LocationArn"></a>
생성하는 소스 HDFS 클러스터 위치의 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_CreateLocationHdfs_Errors"></a>

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

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

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

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

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