CreateLocationHdfs - AWS DataSync

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

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 Resource Names (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 集群。區塊大小必須是 512 位元組的倍數。預設的區塊大小為 128 兆位元組 (MiB)。

類型:整數

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

:必要 否

KerberosKeytab

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

注意

如果KERBEROS指定於AuthenticationType,此參數為必要項目。

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

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

:必要 否

KerberosKrb5Conf

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

注意

如果KERBEROS指定於AuthenticationType,此參數為必要項目。

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

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

:必要 否

KerberosPrincipal

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

注意

如果KERBEROS指定於AuthenticationType,此參數為必要項目。

類型:字串

長度限制:長度下限為 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$

:必要 否

NameNodes

管理 HDFS 命名空間的 NameNode。該 NameNode 執行操作,如打開,關閉和重命名文件和目錄。NameNode 包含的信息數據塊映射到數據 DataNodes 點。您只能使用一個 NameNode。

類型:陣列HdfsNameNode對象

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

:必要 是

QopConfiguration

保護品質 (QOP) 設定會指定 Hadoop 分散式檔案系統 (HDFS) 叢集上設定的遠端程序呼叫 (RPC) 和資料傳輸保護設定。如果QopConfiguration未指定,RpcProtectionDataTransferProtection預設為PRIVACY。如果您設定RpcProtection或者DataTransferProtection,則另一個參數會假設相同的值。

類型:QopConfiguration 物件

:必要 否

ReplicationFactor

寫入 HDFS 叢集時,要將資料複寫到資料的 DataNodes Node 數目。根據預設,資料會複製到三個 DataNodes。

類型:整數

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

:必要 否

SimpleUser

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

注意

如果SIMPLE指定於AuthenticationType,此參數為必要項目。

類型:字串

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

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

:必要 否

Subdirectory

HDFS 集群中的子目錄。此子目錄用於讀取資料或寫入資料到 HDFS 群集。如未指定子目錄,其預設值為/

類型:字串

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

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

:必要 否

Tags

代表您要新增至位置之標籤的鍵值對。此數值可以是空字串。建議您使用標籤來命名資源。

類型:陣列TagListEntry對象

陣列成員:項目數下限為 0。項目數上限為 50。

:必要 否

回應語法

{ "LocationArn": "string" }

回應元素

如果動作成功,則服務傳回 HTTP 200 回應。

服務會傳回下列 JSON 格式的資料。

LocationArn

來源 HDFS 叢集位置的 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}$

Errors

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

InternalException

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

HTTP 狀態碼:500

InvalidRequestException

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

HTTP 狀態碼:400

另請參閱

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