本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
UpdateLocationSmb
更新先前为服务器消息块（SMB）文件系统访问创建位置的某些参数。有关创建 SMB 位置的信息，请参阅为 SMB 创建位置。
请求语法
{
"AgentArns": [ "string" ],
"Domain": "string",
"LocationArn": "string",
"MountOptions": {
"Version": "string"
},
"Password": "string",
"Subdirectory": "string",
"User": "string"
}请求参数
有关所有操作通用参数的详细信息，请参阅Commmon Param eters。
请求接受采用 JSON 格式的以下数据。
- AgentArns
-
用于 Simple Message Block (SMB) 位置的代理的 Amazon 资源名称 (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}$必需：否
- Domain
-
SMB 服务器所属的 Windows 域的名称。
类型：字符串
长度约束：最大长约束。
模式：
^[A-Za-z0-9]((\.|-+)?[A-Za-z0-9]){0,252}$必需：否
- 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}$必需：是
- MountOptions
-
指定用于访问 SMB 文件服务器的服务器消息块（SMB）协议的版本。Amazon DataSync
类型：SmbMountOptions 对象
必需：否
- Password
-
可以挂载共享并对 SMB 共享中的文件和文件夹具有访问权限的用户的密码。
类型：字符串
长度约束：最大长约束。
模式：
^.{0,104}$必需：否
- Subdirectory
-
SMB 文件系统中用于从 SMB 源位置读取数据或将数据写入 SMB 目标的子目录。SMB 路径应该是 SMB 服务器导出的路径，或者是该路径的一个子目录。此路径应使其能由网络中的其他 SMB 客户端挂载。
注意
必须使用正斜杠指定
Subdirectory。例如，/path/to/folder。要传输指定文件夹中的所有数据， DataSync 必须具有挂载 SMB 共享并访问该共享中所有数据的权限。为确保这一点，请执行以下任一操作：
-
确保指定以下用户的用户/密码：可以挂载共享的用户、对您要 DataSync 访问的所有文件和目录具有适当权限的用户。
-
使用Backup 操作员组成员的凭据来装载共享。
执行任一操作都可以使代理访问数据。要使代理能够访问目录，您还必须启用所有执行访问权限。
类型：字符串
长度约束：最大长约束。
模式：
^[a-zA-Z0-9_\-\+\./\(\)\$\p{Zs}]+$必需：否
-
- User
-
可以挂载共享并对 SMB 共享中的文件和文件夹具有访问权限的用户。
类型：字符串
长度约束：最大长约束。
模式：
^[^\x5B\x5D\\/:;|=,+*?]{1,104}$必需：否
响应元素
如果此操作成功，则该服务会发送回带有空 HTTP 正文的 HTTP 200 响应。
错误
有关所有操作常见错误的信息，请参阅常见错误。
- InternalException
-
当Amazon DataSync服务中发生错误时，会抛出此异常。
HTTP 状态代码：500
- InvalidRequestException
-
当客户端提交格式错误的请求时，会引发此异常。
HTTP 状态代码：400
另请参阅
有关在特定语言的 Amazon 软件开发工具包中使用此 API 的更多信息，请参阅以下内容：