CreateLocationEfs - AWS DataSync

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

CreateLocationEfs

為 Amazon EFS 檔案系統建立傳輸位置。 AWS DataSync 可以使用此位置做為傳輸資料的來源或目的地。

開始之前,請確定您了解 DataSync 如何存取 Amazon EFS 檔案系統

請求語法

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

請求參數

如需所有動作的一般參數資訊,請參閱《Common Parameters》。

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

AccessPointArn

指定 DataSync 用來掛載 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}:access-point/fsap-[0-9a-f]{8,40}$

必要:否

Ec2Config

指定 DataSync 用來連線至其中一個 Amazon EFS 檔案系統掛載目標的子網路和安全群組。

類型:Ec2Config 物件

必要:是

EfsFilesystemArn

指定 Amazon EFS 檔案系統的 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-.*$

必要:是

FileSystemAccessRoleArn

指定允許 DataSync 存取 Amazon EFS 檔案系統的 AWS Identity and Access Management (IAM) 角色。

如需建立此角色的資訊,請參閱建立檔案系統存取的 DataSync IAM 角色

類型:字串

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

模式:^arn:(aws|aws-cn|aws-us-gov|aws-iso|aws-iso-b):iam::[0-9]{12}:role/.*$

必要:否

InTransitEncryption

指定您是否希望 DataSync 在將資料傳輸至 Amazon EFS 檔案系統時,使用 Transport Layer Security (TLS) 1.2 加密。

如果您使用 AccessPointArn 指定存取點或使用 FileSystemAccessRoleArn 指定 IAM 角色,則必須將此參數設定為 TLS1_2

類型:字串

有效值:NONE | TLS1_2

必要:否

Subdirectory

為 Amazon EFS 檔案系統指定掛載路徑。這是 DataSync 讀取或寫入檔案系統資料的地方 (取決於這是來源或目的地位置)。

根據預設,DataSync 會使用根目錄 (如果您使用 提供存取點)AccessPointArn。您也可以使用斜線包含子目錄 (例如,/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}$

錯誤

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

InternalException

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

HTTP 狀態碼:500

InvalidRequestException

當用戶端提交格式不正確的請求時,就會擲出此例外狀況。

HTTP 狀態碼:400

範例

請求範例

下列範例會建立 Amazon EFS 檔案系統的位置。

{ "Ec2Config": { "SubnetArn": "arn:aws:ec2:us-east-2:11122233344:subnet/subnet-1234567890abcdef1", "SecurityGroupArns": [ "arn:aws:ec2:us-east-2:11122233344:security-group/sg-1234567890abcdef2" ] }, "EfsFilesystemArn": "arn:aws:elasticfilesystem:us-east-2:111222333444:file-system/fs-021345abcdef6789", "Subdirectory": "/mount/path", "Tags": [{ "Key": "Name", "Value": "ElasticFileSystem-1" }] }

請求範例:為受限的 Amazon EFS 檔案系統建立位置

下列範例會為具有限制存取的 Amazon EFS 檔案系統建立位置。在這種情況下,您可能需要在請求InTransitEncryption中指定 AccessPointArnFileSystemAccessRoleArn和 的值。

{ "AccessPointArn": "arn:aws:elasticfilesystem:us-east-2:111222333444:access-point/fsap-1234567890abcdef0", "Ec2Config": { "SubnetArn": "arn:aws:ec2:us-east-2:111222333444:subnet/subnet-1234567890abcdef1", "SecurityGroupArns": [ "arn:aws:ec2:us-east-2:111222333444:security-group/sg-1234567890abcdef2" ] }, "FileSystemAccessRoleArn": "arn:aws:iam::111222333444:role/AwsDataSyncFullAccessNew", "InTransitEncryption": "TLS1_2", "LocationArn": "arn:aws:datasync:us-east-2:111222333444:location/loc-abcdef01234567890", "LocationUri": "efs://us-east-2.fs-021345abcdef6789/", "Subdirectory": "/mount/path", "Tags": [{ "Key": "Name", "Value": "ElasticFileSystem-1" }] }

回應範例

回應會傳回 Amazon EFS 檔案系統的位置 ARN。

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

另請參閱

如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊,請參閱以下內容: