CreateLocationEfs - AWS DataSync

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

CreateLocationEfs

建立 Amazon EFS 檔案系統的端點。

請求語法

{ "Ec2Config": { "SecurityGroupArns": [ "string" ], "SubnetArn": "string" }, "EfsFilesystemArn": "string", "Subdirectory": "string", "Tags": [ { "Key": "string", "Value": "string" } ] }

請求參數

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

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

Ec2Config

Amazon EFS 檔案系統使用的子網路和安全群組。您所提供的安全群組,必須能夠與指定子網路中掛載目標上的安全群組進行通訊。

安全群組 M (掛載目標的安全群組) 與安全群組 S (您所提供讓 DataSync 在此階段使用的安全群組) 之間的確切關係為:

  • 安全群組 M (您與掛載目標建立關聯的安全群組) 必須允許從安全群組 S 使用 TCP 通訊協定,透過 NFS 連接埠 (2049) 進行的傳入存取。您可以依 IP 地址 (CIDR 範圍) 或安全群組啟用傳入連線。

  • 安全群組 S (提供給 DataSync、用來存取 EFS 的安全群組) 應設有規則,允許外傳連線至檔案系統其中一個掛載目標上的 NFS 連接埠。您可以根據 IP 地址 (CIDR 範圍) 或安全群組來允許傳出連線。

    如需安全群組與掛載目標的資訊,請參閱Amazon EC2 執行個體和掛載目標的安全群組中的亞馬遜 EFS 使用者指南。

類型:Ec2Config 物件

必要:是

EfsFilesystemArn

Amazon EFS 檔案系統的 Amazon Resource Name (ARN)。

類型:字串

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

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

必要:是

Subdirectory

位置路徑中的子目錄。此 EFS 檔案系統中的子目錄將用於從 EFS 來源位置讀取資料,或寫入資料至 EFS 目的地。根據預設,AWS DataSync 會使用根目錄。

注意

Subdirectory 必須使用正斜線來指定。例如,/path/to/folder

類型:字串

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

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

必要:否

Tags

代表您要新增至資源之標籤的鍵值對。此數值可以是空字串。此值可協助您管理、篩選和搜尋資源。建議您為位置建立名稱標籤。

類型:陣列TagListEntry對象

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

必要:否

回應語法

{ "LocationArn": "string" }

回應元素

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

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

LocationArn

建立的 Amazon EFS 檔案系統位置的 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

下列範例會建立 Amazon EFS 檔案系統的端點。

請求範例

{ "Ec2Config": { SecurityGroupArns": ["arn:aws:ec2:us-east-2:11122233344:security-group/sg-0117195988293d62f"], "SubnetArn": "arn:aws:ec2:us-east-2:11122233344:subnet/subnet-f45a0e678", }, "EfsFilesystemArn" :"arn:aws:elasticfilesystem:us-east-2:111222333444:file-system/fs-12345efs", "Subdirectory": "/MySubdirectory", "Tags": [ { "Key": "Name", "Value": "ElasticFileSystem-1" } ] }

Example

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

回應範例

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

另請參閱

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