DescribeLocationHdfs - AWS DataSync

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

DescribeLocationHdfs

返回資料:會執行 Hadoop 分散式檔案系統 (HDFS) 的位置。

請求語法

{ "LocationArn": "string" }

請求參數

如需所有動作共用參數的相關資訊,請參閱一般參數

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

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}$

必要:是

回應語法

{ "AgentArns": [ "string" ], "AuthenticationType": "string", "BlockSize": number, "CreationTime": number, "KerberosPrincipal": "string", "KmsKeyProviderUri": "string", "LocationArn": "string", "LocationUri": "string", "NameNodes": [ { "Hostname": "string", "Port": number } ], "QopConfiguration": { "DataTransferProtection": "string", "RpcProtection": "string" }, "ReplicationFactor": number, "SimpleUser": "string" }

回應元素

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

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

AgentArns

用於連線到 HDFS 叢集之代理程式的 ARN。

類型:字串陣列

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

長度限制:長度上限為 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。。

CreationTime

HDFS 位置的時間。

類型:Timestamp

KerberosPrincipal

此為 Kerberos 主體,有權存取 HDFS 叢集上的檔案和資料夾。如果定義為,則會AuthenticationType使用此參數KERBEROS

類型:字串

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

LocationUri

HDFS 叢集位置的 URI。

類型:字串

長度上限為 4360。

模式:^(efs|nfs|s3|smb|hdfs|fsx[a-z0-9-]+)://[a-zA-Z0-9.:/\-]+$

NameNodes

管NameNode理 HDFS 命名空間。

類型:HdfsNameNode 物件陣列

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

QopConfiguration

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

類型:QopConfiguration 物件

ReplicationFactor

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

類型:整數

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

SimpleUser

用於識別主機作業系統上用戶端的使用者名稱。如果定義為,則會AuthenticationType使用此參數SIMPLE

類型:字串

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

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

錯誤

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

InternalException

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

HTTP 狀態碼:500

InvalidRequestException

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

HTTP 狀態碼:400

另請參閱

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