本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
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 的詳細資訊,請參閱下列說明: