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-.]*)*[A-Za-z0-9-]*[A-Za-z0-9]$

必要:否

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 回應。

Errors

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

InternalException

當錯誤發生時,就會擲出此例外狀況AWS DataSync服務。

HTTP 狀態碼:500

InvalidRequestException

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

HTTP 狀態碼:400

另請參閱

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