기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
CreateLocationHdfs
Hadoop 분산 파일 시스템 (HDFS) 의 엔드포인트를 생성합니다.
요청 구문
{
"AgentArns": [ "string" ],
"AuthenticationType": "string",
"BlockSize": number,
"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"
}
]
}요청 파라미터
모든 작업에 공통인 파라미터에 대한 자세한 내용은 일반 파라미터 를 참조하십시오.
요청은 JSON 형식의 다음 데이터를 받습니다.
- AgentArns
-
HDFS 클러스터에 연결하는 데 사용되는 에이전트의 Amazon 리소스 이름(ARN)입니다.
유형: 문자열 배열
배열 멤버: 최소 항목 수는 1개입니다. 최대 항목 수는 4입니다.
길이 제약: 최대 길이는 128입니다.
패턴:
^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
-
사용자의 ID를 확인하는 데 사용되는 인증 유형입니다.
유형: String
유효한 값:
SIMPLE | KERBEROS필수 항목 여부: 예
- BlockSize
-
HDFS 클러스터에 쓸 데이터 블록의 크기입니다. 블록 크기는 512바이트의 배수여야 합니다. 기본 블록 크기는 128메비바이트(MiB)입니다.
유형: Integer
유효한 범위: 최소값 104857입니다. 최대입니다.
필수 항목 여부: 아니요
- KerberosKeytab
-
정의된 Kerberos 보안 주체와 암호화된 키 간의 매핑이 포함된 Kerberos 키 테이블(keytab)입니다. 파일 주소를 제공하여 파일에서 keytab을 로드할 수 있습니다. 를 사용하는 경우 base64 인코딩을 자동으로 수행합니다. AWS CLI 그렇지 않으면 base64 인코딩 형식의 텍스트를 입력하세요.
참고
AuthenticationType에KERBEROS가 지정된 경우 이 파라미터가 필요합니다.유형: Base64로 인코딩된 이진 데이터 객체
길이 제약: 최대 길이는 655입니다.
필수 항목 여부: 아니요
- KerberosKrb5Conf
-
Kerberos 구성 정보가 포함된
krb5.conf파일입니다. 파일 주소를 제공하여krb5.conf파일을 로드할 수 있습니다. 를 AWS CLI 사용하는 경우 base64 인코딩을 자동으로 수행합니다. 그렇지 않으면 base64 인코딩 형식의 텍스트를 입력하세요.참고
AuthenticationType에KERBEROS가 지정된 경우 이 파라미터가 필요합니다.유형: Base64로 인코딩된 이진 데이터 객체
길이 제약: 최대 길이는 13입니다.
필수 항목 여부: 아니요
- KerberosPrincipal
-
HDFS 클러스터의 파일 및 폴더에 대한 액세스 권한이 있는 Kerberos 보안 주체입니다.
참고
AuthenticationType에KERBEROS가 지정된 경우 이 파라미터가 필요합니다.유형: String
길이 제약: 최소 길이는 1입니다. 최대 길이 256.
Pattern:
^.+$필수 항목 여부: 아니요
- KmsKeyProviderUri
-
HDFS 클러스터의 키 관리 서버(KMS)의 URI입니다.
유형: String
길이 제약: 최소 길이는 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
-
HDFS 네임스페이스를 관리합니다. NameNode 는 파일 및 디렉터리 열기, 닫기 및 이름 바꾸기와 같은 작업을 NameNode 수행합니다. NameNode에는 데이터 블록을 에 매핑하기 위한 정보가 들어 DataNodes 있습니다. 하나만 사용할 수 NameNode 있습니다.
유형: HdfsNameNode 객체 배열
배열 멤버: 최소 항목 수는 1개입니다.
필수 항목 여부: 예
- QopConfiguration
-
QOP(Quality of Protection) 구성은 Hadoop 분산 파일 시스템(HDFS) 클러스터에 구성된 원격 프로시저 호출(RPC) 및 데이터 전송 방지 설정을 지정합니다.
QopConfiguration이 지정되지 않은 경우RpcProtection및DataTransferProtection은 기본적으로PRIVACY로 설정됩니다.RpcProtection또는DataTransferProtection을 설정하면 다른 파라미터는 동일한 값을 가정합니다.유형: QopConfiguration 객체
필수 항목 여부: 아니요
- ReplicationFactor
-
HDFS DataNodes 클러스터에 쓸 때 데이터를 복제할 수 기본적으로 데이터는 DataNodes 3입니다.
유형: Integer
유효한 범위: 최소값 1. 최대입니다.
필수 항목 여부: 아니요
- SimpleUser
-
호스트 운영 체제에서 클라이언트를 식별하는 데 사용되는 사용자 이름입니다.
참고
AuthenticationType에SIMPLE가 지정된 경우 이 파라미터가 필요합니다.유형: String
길이 제약: 최소 길이는 1입니다. 최대 길이 256.
Pattern:
^[_.A-Za-z0-9][-_.A-Za-z0-9]*$필수 항목 여부: 아니요
- Subdirectory
-
HDFS 클러스터의 하위 디렉터리입니다. 이 하위 디렉터리는 HDFS 클러스터에서 데이터를 읽거나 쓰는 데 사용됩니다. 하위 디렉터리를 지정하지 않으면 기본적으로
/로 설정됩니다.유형: String
길이 제약: 최대 길이는 40입니다.
패턴:
^[a-zA-Z0-9_\-\+\./\(\)\$\p{Zs}]+$필수 항목 여부: 아니요
- Tags
-
위치에 추가하려는 태그를 나타내는 키-값 페어입니다. 값은 빈 문자열일 수도 있습니다. 태그를 사용하여 리소스의 이름을 지정하는 것이 좋습니다.
유형: TagListEntry 객체 배열
배열 멤버: 최소 항목 수는 0개입니다. 최대 항목 수 50개.
필수 항목 여부: 아니요
응답 구문
{
"LocationArn": "string"
}응답 요소
작업이 성공하면 서비스가 HTTP 200 응답을 다시 전송합니다.
다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.
- LocationArn
-
생성된 소스 HDFS 클러스터 위치의 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
참고 항목
이 API를 언어별 AWS SDK 중 하나로 사용하는 방법에 대한 자세한 내용은 다음을 참조하세요.
