本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
CreateLocationFsxOpenZfs
為 Amazon FSx for OpenZFS 檔案系統建立傳輸位置。 AWS DataSync 可以使用此位置做為傳輸資料的來源或目的地。
開始之前,請確定您了解 DataSync 如何存取 FSx for OpenZFS 檔案系統。
注意
CreateLocationFsxOpenZfs
操作SMB
不支援與 相關的請求參數。
請求語法
{
"FsxFilesystemArn": "string
",
"Protocol": {
"NFS": {
"MountOptions": {
"Version": "string
"
}
},
"SMB": {
"Domain": "string
",
"MountOptions": {
"Version": "string
"
},
"Password": "string
",
"User": "string
"
}
},
"SecurityGroupArns": [ "string
" ],
"Subdirectory": "string
",
"Tags": [
{
"Key": "string
",
"Value": "string
"
}
]
}
請求參數
如需所有動作的一般參數資訊,請參閱《Common Parameters》。
請求接受採用 JSON 格式的下列資料。
- FsxFilesystemArn
-
FSx for OpenZFS 檔案系統的 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-.*$
必要:是
- Protocol
-
AWS DataSync 用來存取檔案系統的通訊協定類型。
類型:FsxProtocol 物件
必要:是
- SecurityGroupArns
-
用來設定 FSx for OpenZFS 檔案系統之安全群組的 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
-
位置路徑中的子目錄必須以
/fsx
開頭。DataSync 會使用此子目錄來讀取或寫入資料 (視檔案系統是來源還是目的地位置而定)。類型:字串
長度限制:長度上限為 4096。
模式:
^[^\u0000\u0085\u2028\u2029\r\n]{1,4096}$
必要:否
- Tags
-
代表您要新增至資源之標籤的鍵/值對。此數值可以是空字串。此值可協助您管理、篩選和搜尋資源。建議您為位置建立名稱標籤。
類型:TagListEntry 物件陣列
陣列成員:項目數下限為 0。項目數上限為 50。
必要:否
回應語法
{
"LocationArn": "string"
}
回應元素
如果動作成功,則服務傳回 HTTP 200 回應。
服務會傳回下列 JSON 格式的資料。
- LocationArn
-
您建立之 FSx for OpenZFS 檔案系統位置的 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 SDKs中使用此 API 的詳細資訊,請參閱以下內容: