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

用來判斷使用者身分的驗證類型。

類型:字串

有效值: SIMPLE | KERBEROS

必要:必要 否

BlockSize

數據塊的大小寫入 HDFS 集群。

類型:整數

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

必要:必要 否

KerberosKeytab

Kerberos 金鑰表格 (Keytab),其中包含已定義的 Kerberos 主體與加密金鑰之間的對應。您可以通過提供文件的地址從文件中加載 Keytab。如果您使用AWS CLI,它會為您執行 base64 編碼。否則,請提供 base64 編碼的文字。

類型:Base64 編碼二進位資料物件

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

必要:必要 否

KerberosKrb5Conf

所以此krb5.conf檔案,其中包含 Kerberos 組態資訊。您可以載入krb5.conf檔案,方法是提供檔案的位址。如果您使用的是AWS CLI,它會為您執行 base64 編碼。否則,請提供 base64 編碼的文字。

類型:Base64 編碼二進位資料物件

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

必要:必要 否

KerberosPrincipal

Kerberos 主體可以存取 HDFS 叢集上的檔案和資料夾。

類型:字串

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

模式:^.+$

必要:必要 否

KmsKeyProviderUri

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

來源 HDFS 叢集位置的 Amazon Resource Name (ARN)。

類型:字串

長度限制:長度上限為 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 包含的信息數據塊映射到數據 DataNodes 點。您只能使用一個 NameNode。

類型:陣列HdfsNameNode對象

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

必要:必要 否

QopConfiguration

保護品質 (QOP) 設定會指定 Hadoop 分散式檔案系統 (HDFS) 叢集上設定的遠端程序呼叫 (RPC) 和資料傳輸隱私權設定。

類型:QopConfiguration 物件

必要:必要 否

ReplicationFactor

寫入 HDFS 叢集時,要將資料複寫到資料的 DataNodes Node 數目。

類型:整數

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

必要:必要 否

SimpleUser

用來識別主機作業系統上用戶端的使用者名稱。

類型:字串

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

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

必要:必要 否

Subdirectory

HDFS 集群中的子目錄。此子目錄用於讀取數據或寫入數據到 HDFS 集群。

類型:字串

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

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

必要:必要 否

回應元素

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

Errors

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

InternalException

當錯誤發生時,就會擲出此例外狀況AWS DataSync服務。

HTTP 狀態碼:HTTP 狀態碼 500

InvalidRequestException

當用戶端提交格式錯誤的要求時,就會擲出此例外狀況。

HTTP 狀態碼:HTTP 狀態碼 400

另請參閱

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