CreateLocationNfs - AWS DataSync

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

CreateLocationNfs

定義網路檔案系統 (NFS) 伺服器上可供讀取或寫入的檔案系統。

請求語法

{ "MountOptions": { "Version": "string" }, "OnPremConfig": { "AgentArns": [ "string" ] }, "ServerHostname": "string", "Subdirectory": "string", "Tags": [ { "Key": "string", "Value": "string" } ] }

請求參數

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

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

MountOptions

DataSync 可用於掛載您的 NFS 共用的 NFS 掛載選項。

類型:NfsMountOptions 物件

必要:否

OnPremConfig

包含用於連線到 NFS 伺服器之代理程式的 Amazon Resource Name (ARN) 清單。

如果您要將資料複製到AWS Snowcone裝置,請參閱NFS 伺服器AWS Snowcone以了解詳細資訊。

類型:OnPremConfig 物件

必要:是

ServerHostname

NFS 伺服器的名稱。這個值是 NFS 伺服器的 IP 地址或網域名稱服務 (DNS) 名稱。代理程式會於現場部署安裝,並使用此主機名稱在網路中掛載 NFS 伺服器。

如果您要將資料複製到AWS Snowcone裝置,請參閱NFS 伺服器AWS Snowcone以了解詳細資訊。

注意

此名稱必須是 DNS 相容,或必須是 IP 版本 4 (IPv4) 地址。

類型:字串

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

模式:^(([a-zA-Z0-9\-]*[a-zA-Z0-9])\.)*([A-Za-z0-9\-]*[A-Za-z0-9])$

必要:是

Subdirectory

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

若要查看 NFS 伺服器匯出的所有路徑,請從可以存取您伺服器的 NFS 用戶端執行 "showmount -e nfs-server-name"。您可以指定出現在結果中的任何目錄,以及該目錄的任何子目錄。請確定不需經過 Kerberos 驗證即可使用 NFS 匯出功能。

DataSync 需具有讀取所有資料的許可,才能傳輸所指定資料夾中的全部資料。為了確認這一點,請以 no_root_squash, 設定 NFS 匯出,或確定您要 DataSync 讀取的所有檔案,允許所有使用者讀取。如此可讓代理程式讀取檔案。代理程式若要存取目錄,您還必須提供所有執行存取權限。

如果您要將資料複製到AWS Snowcone裝置,請參閱NFS 伺服器AWS Snowcone以了解詳細資訊。

如需 NFS 匯出組態的相關資訊,請參閱18.7. /etc/exports 組態檔案Red Hat Enterprise Linux 文件中的相關資訊。

類型:字串

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

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

必要:是

Tags

代表您要新增至位置之標籤的鍵值對。此數值可以是空字串。建議您使用標籤來命名資源。

類型:陣列TagListEntry對象

陣列成員:項目數下限為 0。項目數上限為 50。

必要:否

回應語法

{ "LocationArn": "string" }

回應元素

如果動作成功,則服務傳回 HTTP 200 回應。

服務會傳回下列 JSON 格式的資料。

LocationArn

建立的來源 NFS 檔案系統位置的 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}$

Errors

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

InternalException

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

HTTP 狀態碼:500

InvalidRequestException

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

HTTP 狀態碼:400

Examples

Example

下列範例會使用指定的 NFS 版本做為掛載選項,為 NFS 檔案系統建立端點。

請求範例

{ "MountOptions": { "Version": : "NFS4_0" }, "OnPremConfig": { "AgentArn": [ "arn:aws:datasync:us-east-2:111222333444:agent/agent-0b0addbeef44b3nfs" ] }, "ServerHostname": "MyServer@amazon.com", "Subdirectory": "/MyFolder", "Tags": [ { "Key": "Name", "Value": "ElasticFileSystem-1" } ] }

Example

響應會傳回 NFS 位置的 Amazon Resource Name (ARN)。

回應範例

{ "LocationArn": "arn:aws:datasync:us-east-2:111222333444:location/loc-07db7abfc326c50aa" }

另請參閱

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