本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
DescribeLocationSmb
提供有关如何配置服务器消息块 (SMB) 文件服务器的 AWS DataSync 传输位置的详细信息。
请求语法
{
"LocationArn": "string"
}请求参数
有关所有操作的通用参数的信息，请参阅常用参数。
请求接受采用 JSON 格式的以下数据。
- LocationArn
-
指定您想要了解的 SMB 位置的 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",
"CreationTime": number,
"DnsIpAddresses": [ "string" ],
"Domain": "string",
"KerberosPrincipal": "string",
"LocationArn": "string",
"LocationUri": "string",
"MountOptions": {
"Version": "string"
},
"User": "string"
}响应元素
如果此操作成功，则该服务将会发送回 HTTP 200 响应。
服务以 JSON 格式返回以下数据。
- AgentArns
-
可以与您的 SMB 文件服务器连接的 DataSync 代理。 ARNs
类型：字符串数组
数组成员：最少 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
-
DataSync 用于连接您的 SMB 文件服务器的身份验证协议。
类型：字符串
有效值：
NTLM | KERBEROS - CreationTime
-
创建 SMB 位置的时间。
类型：时间戳
- DnsIpAddresses
-
您的 SMB 文件服务器所属的 DNS 服务器 IPv4 的地址。仅当设置
AuthenticationType为时，此元素才适用KERBEROS。类型：字符串数组
数组成员：最多 15 项。
长度限制：最小长度为 7。最大长度为 15。
模式：
\A(25[0-5]|2[0-4]\d|[0-1]?\d?\d)(\.(25[0-5]|2[0-4]\d|[0-1]?\d?\d)){3}\z - Domain
-
SMB 文件服务器所属的 Windows 域的名称。仅当设置
AuthenticationType为时，此元素才适用NTLM。类型：字符串
长度约束：最大长度为 253。
模式：
^[A-Za-z0-9]((\.|-+)?[A-Za-z0-9]){0,252}$ - KerberosPrincipal
-
有权访问 SMB 文件服务器中的文件、文件夹和文件元数据的 Kerberos 主体。
类型：字符串
长度限制：最小长度为 1。最大长度为 256。
模式：
^.+$ - LocationArn
-
SMB 位置的 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
-
SMB 位置的 URI。
类型：字符串
长度约束：最大长度为 4360。
模式：
^(efs|nfs|s3|smb|hdfs|fsx[a-z0-9-]+)://[a-zA-Z0-9.:/\-]+$ - MountOptions
-
DataSync 用于访问您的 SMB 文件服务器的 SMB 协议版本。
类型：SmbMountOptions 对象
- User
-
可以挂载和访问 SMB 文件服务器中文件、文件夹和文件元数据的用户。仅当设置
AuthenticationType为时，此元素才适用NTLM。类型：字符串
长度约束：最大长度为 104。
模式：
^[^\x22\x5B\x5D/\\:;|=,+*?\x3C\x3E]{1,104}$
错误
有关所有操作的常见错误信息，请参阅 常见错误。
- InternalException
-
当 AWS DataSync 服务中发生错误时，会引发此异常。
HTTP 状态代码：500
- InvalidRequestException
-
当客户端提交格式错误的请求时，会引发此异常。
HTTP 状态代码：400
示例
示例
此示例说明了的一种用法 DescribeLocationSmb。
示例请求
{
"arn:aws:datasync:us-east-1:111222333444:location/loc-0f01451b140b2af49"
}示例
此示例说明了的一种用法 DescribeLocationSmb。
示例响应
{
"AgentArns":[
"arn:aws:datasync:us-east-2:111222333444:agent/agent-0bc3b3dc9bbc15145",
"arn:aws:datasync:us-east-2:111222333444:agent/agent-04b3fe3d261a18c8f"
],
"CreationTime":"1532660733.39",
"Domain":"AMAZON",
"LocationArn":"arn:aws:datasync:us-east-1:111222333444:location/loc-0f01451b140b2af49",
"LocationUri":"smb://hostname.amazon.com/share",
"MountOptions":{
"Version":"SMB3"
},
"User":"user-1"
}
另请参阅
有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容：
