DescribeLocationHdfs - AWS DataSync

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

DescribeLocationHdfs

返回元数据,例如有关 Hadoop Distributed File System(HDFS)信息。

请求语法

{ "LocationArn": "string" }

请求参数

有关所有操作的通用参数的信息,请参阅通用参数

请求接受采用 JSON 格式的以下数据。

LocationArn

要描述的 HDFS 集群位置的 Amazon 资源名称(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 集群的大小大小。

类型:整数

有效范围:最多 最大值为

CreationTime

HDFS 创建时间。

类型:时间戳

KerberosPrincipal

有权访问 HDFS 集群上的文件和文件夹的 Kerberos 主体。如果定义为,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。

类型:字符串

长度限制:最大长度为 430 0 0 0 0 0 0 0 0

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

NameNodes

管理 H NameNode DFS 管理 HDFS。

类型:HdfsNameNode 对象数组

数组成员:最少 1 项。

QopConfiguration

保护质量(QOP)配置指定在 Hadoop Distributed File System(HDFS)集群上配置的远程程序调用(RPC)和数据传输保护设置。

类型:QopConfiguration 对象

ReplicationFactor

写入 HDFS 集群时要将数据复制到的 HDFS 数量。DataNodes

类型:整数

有效范围:最小值为 1。最大值为 Futed

SimpleUser

用于在主机操作系统上标识客户端的用户名。如果定义为,AuthenticationType则使用此参数SIMPLE

类型:字符串

长度限制:最小长度为 1。长度上限为 256。

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

错误

有关所有操作常见错误的信息,请参阅常见错误

InternalException

当AWS DataSync服务中发生错误时,会引发此异常。

HTTP 状态代码:500

InvalidRequestException

当客户端提交格式错误的请求时,会引发此异常。

HTTP 状态代码:400

另请参阅

有关在特定语言的 AWS 软件开发工具包中使用此 API 的更多信息,请参阅以下内容: