本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
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"
}請求參數
如需所有動作的一般參數資訊，請參閱《Common Parameters》。
請求接受採用 JSON 格式的下列資料。
- AgentArns
-
指定可連線至 SMB 檔案伺服器的 DataSync 代理程式 （或代理程式）。您可以使用其 Amazon Resource Name (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身分驗證。如需詳細資訊，請參閱提供 SMB 檔案伺服器的 DataSync 存取權。
類型：字串
有效值:
NTLM | KERBEROS必要：否
- DnsIpAddresses
-
指定 SMB 檔案伺服器所屬之 DNS 伺服器的 IPv4 地址。此參數僅適用於
AuthenticationType設為 的情況KERBEROS。如果您的環境中有多個網域，設定此參數可確保 DataSync 連線至正確的 SMB 檔案伺服器。
類型：字串陣列
陣列成員：最多 2 個項目。
長度限制：長度下限為 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，則編碼會為您完成。
為了避免任務執行錯誤，請確定您用來建立 keytab 檔案的 Kerberos 主體與您為 指定的完全相符
KerberosPrincipal。類型：Base64 編碼的二進位資料物件
長度限制條件：長度上限為 65536。
必要：否
- KerberosKrb5Conf
-
指定 Kerberos 組態檔案 (
krb5.conf)，以定義您的 Kerberos 領域組態。檔案必須為 base64 編碼。如果您使用的是 AWS CLI，則編碼會為您完成。
類型：Base64 編碼的二進位資料物件
長度限制：長度上限為 131072。
必要：否
- KerberosPrincipal
-
指定 Kerberos 權限，這是 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
-
指定 AWS DataSync 用於存取 SMB 檔案伺服器的伺服器訊息區塊 (SMB) 通訊協定版本。
類型：SmbMountOptions 物件
必要：否
- Password
-
指定可掛載 SMB 檔案伺服器，並具有許可可存取傳輸中涉及之檔案和資料夾的使用者密碼。此參數僅適用於
AuthenticationType設為 的情況NTLM。類型：字串
長度限制：長度上限為 104。
模式：
^.{0,104}$必要：否
- Subdirectory
-
指定由 SMB 檔案伺服器匯出的共用名稱，DataSync 會在其中讀取或寫入資料。您可以在共用路徑中包含子目錄 （例如
/path/to/subdirectory)。請確定您網路中的其他 SMB 用戶端也可以掛載此路徑。若要複製指定子目錄中的所有資料，DataSync 必須能夠掛載 SMB 共享並存取其所有資料。如需詳細資訊，請參閱提供 SMB 檔案伺服器的 DataSync 存取權。
類型：字串
長度限制：長度上限為 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
另請參閱
如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱以下內容：
