UpdateLocationSmb - AWS DataSync

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

UpdateLocationSmb

更新伺服器訊息區塊 (SMB) 檔案系統存取之前建立位置的部分參數。如需有關建立 SMB 位置的資訊,請參閱建立 SMB 的位置

請求語法

{ "AgentArns": [ "string" ], "Domain": "string", "LocationArn": "string", "MountOptions": { "Version": "string" }, "Password": "string", "Subdirectory": "string", "User": "string" }

請求參數

如需所有動作共用的參數相關資訊,請參閱一般參數

請求接受採用 JSON 格式的下列資料。

AgentArns

用於 Simple Message Block (SMB) 位置之代理程式的 Amazon Resource Names (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}$

必要 否

Domain

SMB 伺服器所屬的 Windows 網域的名稱。

類型:字串

長度限制:長度上限為 253。

模式:^[A-Za-z0-9]((\.|-+)?[A-Za-z0-9]){0,252}$

必要 否

LocationArn

要更新之 SMB 位置的 Amazon Resource Name (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

指定如何 DataSync 可以使用 SMB 通訊協定存取位置。

類型:SmbMountOptions 物件

必要 否

Password

可掛載共用空間並具備許可可在 SMB 檔案共用中存取檔案和資料夾之使用者的密碼。

類型:字串

長度限制:長度上限為 104。

模式:^.{0,104}$

必要 否

Subdirectory

此 SMB 檔案系統中的子目錄將用於從 SMB 來源位置讀取資料,或寫入資料至 SMB 目的地。此 SMB 路徑應該是 SMB 伺服器匯出的路徑或該路徑的子目錄。這樣網路中的其他 SMB 用戶端才能掛載該路徑。

注意

Subdirectory 必須使用正斜線來指定。例如: 。/path/to/folder

若要傳輸您指定的資料夾中的全部資料, DataSync 必須具有掛載 SMB 共用空間並且可以存取該共用空間中的所有資料。為了確保這一點,請執行下列兩項作業的其中一項:

  • 請確保指定的使用者/密碼屬於可以掛載此共用空間的使用者,並且此使用者擁有您希望的所有檔案和目錄的適當許可 DataSync 可以存取。

  • 使用「Backup 操作員」群組成員的認證來掛載共用。

執行這些選項中的任意一種都可以讓代理程式存取資料。代理程式若要存取目錄,您還必須啟用所有執行存取權限。

類型:字串

長度限制:長度上限為 4096。

模式:^[a-zA-Z0-9_\-\+\./\(\)\$\p{Zs}]+$

必要 否

User

可掛載共用空間並具備許可可在 SMB 檔案共用中存取檔案和資料夾之使用者。

類型:字串

長度限制:長度上限為 104。

模式:^[^\x5B\x5D\\/:;|=,+*?]{1,104}$

必要 否

回應元素

如果動作成功,則服務會傳回具空 HTTP 內文的 HTTP 200 回應。

錯誤

如需所有動作常見的錯誤相關資訊,請參閱常見錯誤

InternalException

當中發生錯誤時,就會擲出此例外狀況AWS DataSyncService (服務)

HTTP 狀態碼:500

InvalidRequestException

當客戶端提交格式錯誤的請求時,就會擲出此例外狀況。

HTTP 狀態碼:400

另請參閱

如需在語言特定的 AWS 開發套件之一中使用此 API 的詳細資訊,請參閱下列說明: