CreateLocationFsxWindows - AWS DataSync

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

CreateLocationFsxWindows

為 Amazon FSx for Windows File Server 系統建立一個端點。

請求語法

{ "Domain": "string", "FsxFilesystemArn": "string", "Password": "string", "SecurityGroupArns": [ "string" ], "Subdirectory": "string", "Tags": [ { "Key": "string", "Value": "string" } ], "User": "string" }

請求參數

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

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

Domain

指定 FSx for Windows File Server 所屬的 Windows 網域的名稱。

類型:字串

長度長度長度長度長度長度的長度長度

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

必要:否

FsxFilesystemArn

指定 FSx for Windows File Server 檔案系統的 Amazon Resource Name (ARN)。

類型:字串

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

模式:^arn:(aws|aws-cn|aws-us-gov|aws-iso|aws-iso-b):fsx:[a-z\-0-9]*:[0-9]{12}:file-system/fs-.*$

必要:是

Password

指定具有存取文件系統中檔案和資料夾許可之使用者的密碼。

類型:字串

長度長度長度長度長度長度長度的長度

模式:^.{0,104}$

必要:是

SecurityGroupArns

指定安全群組的 ARN,這些群組提供存取檔案系統偏好子網路之安全群組的 ARN。

注意

如果選擇的安全群組不允許從本身進行連線的安全群組,請採取下列行動之一:

  • 設定安全群組以允許其在本身進行通訊。

  • 選擇可與掛載目標安全性群組通訊的其他安全性群組。

類型:字串陣列

陣列成員:項目數下限為 1。項目數上限為 5。

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

模式:^arn:(aws|aws-cn|aws-us-gov|aws-iso|aws-iso-b):ec2:[a-z\-0-9]*:[0-9]{12}:security-group/sg-[a-f0-9]+$

必要:是

Subdirectory

使用正斜線指定檔案系統的掛載路徑。這是DataSync讀取或寫入資料的位置(取決於這是來源還是目的地位置)

類型:字串

長度長度長度長度長度長度長度的長度長度

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

必要:否

Tags

指定可協助您分類、篩選和搜尋 AWS 資源的標籤。建議您為位置建立至少一個名稱標籤。

類型:TagListEntry 物件陣列

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

必要:否

User

指定具有存取檔案系統中檔案、資料夾和中繼資料之權限的使用者。

如需選擇具有足夠權限之使用者的相關資訊,請參閱必要權限

類型:字串

長度長度長度長度長度長度長度的長度

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

必要:是

回應語法

{ "LocationArn": "string" }

回應元素

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

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

LocationArn

您建立的 FSx for Windows File Server 系統位置的 FSx for 您建立的 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}$

錯誤

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

InternalException

當在AWS DataSync服務中發生錯誤時,拋出此異常。

HTTP 狀態碼:500

InvalidRequestException

當客戶端提交格式錯誤的請求時,拋出此異常。

HTTP 狀態碼:400

另請參閱

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