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 叢集的資料區塊大值為 HDFS 叢集的大值為 HDFS 叢集。

類型:整數

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

必要:否

KerberosKeytab

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

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

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

必要:否

KerberosKrb5Conf

包含 Kerberos 組態資訊的 krb5.conf 檔案。您可以通過提供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 命名空間的 HDFS 命名空間。NameNode會NameNode執行開啟、關閉以及重新命名檔案和目錄。包NameNode含將資料區塊映射到的資訊DataNodes。您只能使用一個NameNode。

類型:HdfsNameNode 物件陣列

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

必要:否

QopConfiguration

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

類型:QopConfiguration 物件

必要:否

ReplicationFactor

寫入DataNodes至 HDFS 叢集時要將資料複製到其中的數目。

類型:整數

有效範圍:最小值為 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 回應。

錯誤

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

InternalException

當在AWS DataSync服務中發生錯誤時,拋出此異常。

HTTP 狀態碼:500

InvalidRequestException

當客戶端提交格式錯誤的請求時,拋出此異常。

HTTP 狀態碼:400

另請參閱

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