本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
UpdateLocationSmb
修改您正在使用的服务器消息块 (SMB) 传输位置的以下配置参数。 AWS DataSync
有关更多信息，请参阅使用 SMB 文件服务器配置 DataSync 传输。
请求语法
{
"AgentArns": [ "string" ],
"AuthenticationType": "string",
"DnsIpAddresses": [ "string" ],
"Domain": "string",
"KerberosKeytab": blob,
"KerberosKrb5Conf": blob,
"KerberosPrincipal": "string",
"LocationArn": "string",
"MountOptions": {
"Version": "string"
},
"Password": "string",
"Subdirectory": "string",
"User": "string"
}请求参数
有关所有操作的通用参数的信息，请参阅常用参数。
请求接受采用 JSON 格式的以下数据。
- AgentArns
-
指定 DataSync 可以连接到 SMB 文件服务器的一个或多个代理。使用代理的 Amazon 资源名称 (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
-
指定用于连接您的 DataSync SMB 文件服务器的身份验证协议。 DataSync 支持
NTLM（默认）和KERBEROS身份验证。有关更多信息，请参阅提供 DataSync 对 SMB 文件服务器的访问权限。
类型：字符串
有效值：
NTLM | KERBEROS必需：否
- DnsIpAddresses
-
指定 SMB 文件服务器所属的 DNS 服务器 IPv4 的地址。仅当设置
AuthenticationType为时，此参数才适用KERBEROS。如果您的环境中有多个域，则配置此参数 DataSync 可确保连接到正确的 SMB 文件服务器。
类型：字符串数组
数组成员：最多 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。如果您的环境中有多个域，则配置此参数可确保 DataSync 连接到正确的文件服务器。
类型：字符串
长度约束：最大长度为 253。
模式：
^[A-Za-z0-9]((\.|-+)?[A-Za-z0-9]){0,252}$必需：否
- KerberosKeytab
-
指定您的 Kerberos 密钥表 (keytab) 文件，其中包括您的 Kerberos 主密钥和加密密钥之间的映射。
该文件必须采用 base64 编码。如果您使用的是 AWS CLI，则编码已为您完成。
为避免任务执行错误，请确保用于创建密钥表文件的 Kerberos 主体与您指定的内容完全匹配。
KerberosPrincipal类型：Base64 编码的二进制数据对象
长度约束：最大长度为 65536。
必需：否
- KerberosKrb5Conf
-
指定用于定义您的 Kerberos 领域配置的 Kerberos 配置文件 (
krb5.conf)。该文件必须采用 base64 编码。如果您使用的是 AWS CLI，则编码已为您完成。
类型：Base64 编码的二进制数据对象
长度约束：最大长度为 131072。
必需：否
- KerberosPrincipal
-
指定 Kerberos prinicpal，这是您的 Kerberos 领域中的一个身份，有权访问 SMB 文件服务器中的文件、文件夹和文件元数据。
Kerberos 校长可能看起来像。
HOST/kerberosuser@MYDOMAIN.ORG主体名称区分大小写。如果您为此参数指定的主体与您用于创建 keytab 文件的主体不完全匹配，则 DataSync 任务执行将失败。
类型：字符串
长度限制：最小长度为 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}$必需：是
- MountOptions
-
指定用于访问 SMB 文件服务器的服务器消息块 (SMB) 协议的版本。 AWS DataSync
类型：SmbMountOptions 对象
必需：否
- Password
-
指定可以挂载 SMB 文件服务器并有权限访问传输中涉及的文件和文件夹的用户的密码。仅当设置
AuthenticationType为时，此参数才适用NTLM。类型：字符串
长度约束：最大长度为 104。
模式：
^.{0,104}$必需：否
- Subdirectory
-
指定 SMB 文件服务器导出的共享的名称，该共享 DataSync将在其中读取或写入数据。您可以在共享路径中包含子目录（例如，
/path/to/subdirectory）。确保网络中的其他 SMB 客户端也可以挂载此路径。要复制指定子目录中的所有数据， DataSync 必须能够装载 SMB 共享并访问其所有数据。有关更多信息，请参阅提供 DataSync 对 SMB 文件服务器的访问权限。
类型：字符串
长度约束：最大长度为 4096。
模式：
^[a-zA-Z0-9_\-\+\./\(\)\$\p{Zs}]+$必需：否
- User
-
指定可以挂载 SMB 文件服务器并有权限访问传输中涉及的文件和文件夹的用户名。仅当设置
AuthenticationType为时，此参数才适用NTLM。有关选择具有适当访问权限级别的用户进行传输的信息，请参阅提供对 SMB 文件服务器的 DataSync 访问权限。
类型：字符串
长度约束：最大长度为 104。
模式：
^[^\x22\x5B\x5D/\\:;|=,+*?\x3C\x3E]{1,104}$必需：否
响应元素
如果此操作成功，则该服务会发送回带有空 HTTP 正文的 HTTP 200 响应。
错误
有关所有操作的常见错误信息，请参阅 常见错误。
- InternalException
-
当 AWS DataSync 服务中发生错误时，会引发此异常。
HTTP 状态代码：500
- InvalidRequestException
-
当客户端提交格式错误的请求时，会引发此异常。
HTTP 状态代码：400
另请参阅
有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容：
