기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다. # UpdateLocationHdfs 사용 중인 Hadoop 분산 파일 시스템(HDFS) 전송 위치의 다음 구성 파라미터를 수정합니다 AWS DataSync. 자세한 내용은 [HDFS 클러스터를 사용하는 DataSync 전송 구성](https://docs.aws.amazon.com/datasync/latest/userguide/create-hdfs-location.html)을 참조하세요. ## 구문 요청 ``` { "AgentArns": [ "string" ], "AuthenticationType": "string", "BlockSize": number, "CmkSecretConfig": { "KmsKeyArn": "string", "SecretArn": "string" }, "CustomSecretConfig": { "SecretAccessRoleArn": "string", "SecretArn": "string" }, "KerberosKeytab": blob, "KerberosKrb5Conf": blob, "KerberosPrincipal": "string", "KmsKeyProviderUri": "string", "LocationArn": "string", "NameNodes": [ { "Hostname": "string", "Port": number } ], "QopConfiguration": { "DataTransferProtection": "string", "RpcProtection": "string" }, "ReplicationFactor": number, "SimpleUser": "string", "Subdirectory": "string" } ``` ## 요청 파라미터 모든 작업에 공통되는 파라미터에 대한 자세한 설명은 [공통 파라미터](CommonParameters.md)를 참조하세요. 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [AgentArns](#API_UpdateLocationHdfs_RequestSyntax) ** 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_UpdateLocationHdfs_RequestSyntax) ** 사용자 ID를 결정하는 데 사용되는 인증 타입. 타입: 문자열 유효 값: `SIMPLE | KERBEROS` 필수 여부: 아니요 ** [BlockSize](#API_UpdateLocationHdfs_RequestSyntax) ** HDFS 클러스터에 쓸 데이터 블록의 크기입니다. 타입: 정수 유효한 범위: 최소값은 1048576입니다. 최대값은 1073741824입니다. 필수 여부: 아니요 ** [CmkSecretConfig](#API_UpdateLocationHdfs_RequestSyntax) ** DataSync가 특정 전송 위치에 액세스하는 데 DataSync 사용하는 `KerberosKeytab` 또는 자격 증명 세트와 고객 관리형 보안 암호에 대한 구성 정보를 지정합니다 AWS KMS key. 유형: [CmkSecretConfig](API_CmkSecretConfig.md)객체 필수 여부: 아니요 ** [CustomSecretConfig](#API_UpdateLocationHdfs_RequestSyntax) ** DataSync가 특정 전송 위치에 액세스하는 데 사용하는 `KerberosKeytab` 또는 자격 증명 세트와 보안 암호에 대한 액세스를 제공하는 고객 관리형 AWS Identity and Access Management (IAM) 역할과 같은 고객 관리형 보안 암호의 구성 정보를 지정합니다. 유형: [CustomSecretConfig](API_CustomSecretConfig.md)객체 필수 여부: 아니요 ** [KerberosKeytab](#API_UpdateLocationHdfs_RequestSyntax) ** 정의된 Kerberos 보안 주체와 암호화된 키 간의 매핑이 포함된 Kerberos 키 테이블(keytab)입니다. 파일 주소를 제공하여 파일에서 키탭을 로드할 수 있습니다. 타입: Base64로 인코딩된 이진 데이터 객체 길이 제약: 최대 길이는 65536입니다. 필수 여부: 아니요 ** [KerberosKrb5Conf](#API_UpdateLocationHdfs_RequestSyntax) ** Kerberos 구성 정보가 포함된 `krb5.conf` 파일입니다. 파일 주소를 제공하여 `krb5.conf`파일을 로드할 수 있습니다. AWS CLI를 사용하는 경우, base64 인코딩을 자동으로 수행합니다. 그렇지 않으면 base64 인코딩 형식의 텍스트를 제공하십시오. 타입: Base64로 인코딩된 이진 데이터 객체 길이 제약: 최대 길이는 131072입니다. 필수 여부: 아니요 ** [KerberosPrincipal](#API_UpdateLocationHdfs_RequestSyntax) ** HDFS 클러스터의 파일 및 폴더에 대한 액세스 권한이 있는 Kerberos 보안 주체입니다. 타입: 문자열 길이 제약 조건: 최소 길이는 1입니다. 최대 길이는 256입니다. 패턴: `^.+$` 필수 여부: 아니요 ** [KmsKeyProviderUri](#API_UpdateLocationHdfs_RequestSyntax) ** 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$` 필수 여부: 아니요 ** [LocationArn](#API_UpdateLocationHdfs_RequestSyntax) ** 소스 HDFS 클러스터 위치의 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}$` 필수 여부: 예 ** [NameNodes](#API_UpdateLocationHdfs_RequestSyntax) ** HDFS 네임스페이스를 관리하는 NameNode입니다. NameNode는 파일 및 디렉터리 열기, 닫기 및 이름 바꾸기와 같은 작업을 수행합니다. NameNode에는 데이터 블록을 DataNode에 매핑하기 위한 정보가 들어 있습니다. 하나의 NameNode만 사용할 수 있습니다. 타입: [HdfsNameNode](API_HdfsNameNode.md)객체 배열 배열 구성원: 최소수는 1개입니다. 필수 여부: 아니요 ** [QopConfiguration](#API_UpdateLocationHdfs_RequestSyntax) ** QOP(Quality of Protection) 구성은 Hadoop 분산 파일 시스템(HDFS) 클러스터에 구성된 원격 프로시저 호출(RPC) 및 데이터 전송 개인 정보 보호 설정을 지정합니다. 타입: [QopConfiguration](API_QopConfiguration.md)객체 필수 여부: 아니요 ** [ReplicationFactor](#API_UpdateLocationHdfs_RequestSyntax) ** HDFS 클러스터에 쓸 때 데이터를 복제할 DataNode의 수입니다. 타입: 정수 유효 범위: 최소값 1. 최대값은 512입니다. 필수 여부: 아니요 ** [SimpleUser](#API_UpdateLocationHdfs_RequestSyntax) ** 호스트 운영 체제에서 클라이언트를 식별하는 데 사용되는 사용자 이름입니다. 타입: 문자열 길이 제약 조건: 최소 길이는 1입니다. 최대 길이는 256입니다. 패턴: `^[_.A-Za-z0-9][-_.A-Za-z0-9]*$` 필수 여부: 아니요 ** [Subdirectory](#API_UpdateLocationHdfs_RequestSyntax) ** HDFS 클러스터의 하위 디렉터리입니다. 이 하위 디렉터리는 HDFS 클러스터에서 데이터를 읽거나 쓰는 데 사용됩니다. 타입: 문자열 길이 제약: 최대 길이는 4096입니다. 패턴: `^[a-zA-Z0-9_\-\+\./\$\p{Zs}]+$` 필수 여부: 아니요 ## 응답 요소 작업이 성공하면 서비스가 비어 있는 HTTP 본문과 함께 HTTP 200 응답을 다시 전송합니다. ## 오류 모든 작업에서 공통적으로 발생하는 오류에 대한 자세한 설명은 [일반적인 오류](CommonErrors.md)섹션을 참조하세요. ** InternalException ** 이 예외는 AWS DataSync 서비스에 오류가 발생할 때 던져집니다. HTTP 상태 코드: 500 ** InvalidRequestException ** 이 예외는 클라이언트가 잘못된 형식의 요청을 제출할 때 던져집니다. HTTP 상태 코드: 400 ## 참고 언어별 AWS SDKs + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/UpdateLocationHdfs) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/UpdateLocationHdfs) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/UpdateLocationHdfs) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/UpdateLocationHdfs) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/UpdateLocationHdfs) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/UpdateLocationHdfs) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/UpdateLocationHdfs) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/UpdateLocationHdfs) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/UpdateLocationHdfs) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/UpdateLocationHdfs)