UpdateLocationHdfs - AWS DataSync

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

UpdateLocationHdfs

更新以前為 Hadoop 分佈式文件系統羣集創建的位置的某些參數。

請求語法

{ "AgentArns": [ "string" ], "AuthenticationType": "string", "BlockSize": number, "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" }

請求參數

有關所有動作通用的參數的信息,請參閲一般參數

請求接受採用 JSON 格式的下列資料。

AgentArns

用於連接到 HDFS 羣集的代理的 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

用於確定用户身份的身份驗證類型。

類型:String

有效值: SIMPLE | KERBEROS

:必要 否

BlockSize

要寫入 HDFS 羣集的數據塊的大小。

類型:整數

有效範圍:最小值為 1048576。最大值為 1073741824。

:必要 否

KerberosKeytab

包含已定義的 Kerberos 主體和加密密鑰之間的映射的 Kerberos 密鑰表 (keytab)。您可以通過提供文件的地址從文件加載 keytab。如果您使用AWS CLI時,它會為您執行 base64 編碼。否則,請提供 base64 編碼的文字。

類型:Base64 編碼二進位資料對象

長度限制條件:長度上限為 65536。

:必要 否

KerberosKrb5Conf

所以此krb5.conf文件,該文件包含 Kerberos 配置信息。您可以加載krb5.conf文件,方法是提供文件的地址。如果您使用AWS CLI時,它會為您執行 base64 編碼。否則,請提供 base64 編碼的文字。

類型:Base64 編碼二進位資料對象

長度限制條件:長度上限為 131072。

:必要 否

KerberosPrincipal

具有 HDFS 羣集上文件和文件夾訪問權限的 Kerberos 主體。

類型:String

長度限制條件:長度下限為 1。長度上限為 256。

模式:^.+$

:必要 否

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$

:必要 否

LocationArn

源 HDFS 集羣位置的 Amazon Resource Name (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}$

:必要 是

NameNodes

管理 HDFS 命名空間的 NameNode。NameNode 執行諸如打開、關閉和重命名文件和目錄等操作。NameNode 包含用於將數據塊映射到數據界面的信息。您只能使用一個 NameNode。

類型:陣列的HdfsNameNode對象

陣列成員:項目數下限為 1。

:必要 否

QopConfiguration

保護質量 (QOP) 配置指定在 Hadoop 分佈式文件系統 (HDFS) 羣集上配置的遠程過程調用 (RPC) 和數據傳輸隱私設置。

類型:QopConfiguration 物件

:必要 否

ReplicationFactor

寫入 HDFS 羣集時要將數據複製到的數據控制 DataNodes 的數量。

類型:整數

有效範圍:最小值為 1。最大值為 512。

:必要 否

SimpleUser

用於標識主機操作系統上客户機的用户名。

類型:String

長度限制條件:長度下限為 1。長度上限為 256。

模式:^[_.A-Za-z0-9][-_.A-Za-z0-9]*$

:必要 否

Subdirectory

HDFS 羣集中的子目錄。此子目錄用於讀寫資料到 HDFS 羣集。

類型:String

長度限制條件:長度上限為 4096。

模式:^[a-zA-Z0-9_\-\+\./\(\)\$\p{Zs}]+$

:必要 否

回應元素

如果動作成功,則服務會傳回具空 HTTP 內文的 HTTP 200 回應。

錯誤

如需所有動作常見的錯誤相關資訊,請參閱常見錯誤

InternalException

此例外情況下發生錯誤時,AWS DataSync服務。

HTTP 狀態碼:500

InvalidRequestException

當客户端提交格式錯誤的請求時,就會拋出此例外狀況。

HTTP 狀態碼:400

另請參閱

如需在語言特定的 AWS 開發套件之一中使用此 API 的詳細資訊,請參閱下列說明: