本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。 # CreateLocationEfs 建立 Amazon EFS 檔案系統的傳輸*位置*。 AWS DataSync 可以使用此位置做為傳輸資料的來源或目的地。開始之前，請確定您了解 DataSync 如何[存取 Amazon EFS 檔案系統](https://docs.aws.amazon.com/datasync/latest/userguide/create-efs-location.html#create-efs-location-access)。 ## 請求語法 ``` { "AccessPointArn": "string", "Ec2Config": { "SecurityGroupArns": [ "string" ], "SubnetArn": "string" }, "EfsFilesystemArn": "string", "FileSystemAccessRoleArn": "string", "InTransitEncryption": "string", "Subdirectory": "string", "Tags": [ { "Key": "string", "Value": "string" } ] } ``` ## 請求參數如需所有動作的一般參數資訊，請參閱《[Common Parameters](CommonParameters.md)》。請求接受採用 JSON 格式的下列資料。 ** [AccessPointArn](#API_CreateLocationEfs_RequestSyntax) ** 指定 DataSync 用來掛載 Amazon EFS 檔案系統的存取點的 Amazon Resource Name (ARN)。如需詳細資訊，請參閱[存取受限制的檔案系統](https://docs.aws.amazon.com/datasync/latest/userguide/create-efs-location.html#create-efs-location-iam)。類型：字串長度限制：長度上限為 128。模式：`^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):elasticfilesystem:[a-z\-0-9]+:[0-9]{12}:access-point/fsap-[0-9a-f]{8,40}$` 必要：否 ** [Ec2Config](#API_CreateLocationEfs_RequestSyntax) ** 指定 DataSync 用來連線至其中一個 Amazon EFS 檔案系統[掛載目標](https://docs.aws.amazon.com/efs/latest/ug/accessing-fs.html)的子網路和安全群組。類型：[Ec2Config](API_Ec2Config.md) 物件必要：是 ** [EfsFilesystemArn](#API_CreateLocationEfs_RequestSyntax) ** 指定 Amazon EFS 檔案系統的 ARN。類型：字串長度限制：長度上限為 128。模式：`^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):elasticfilesystem:[a-z\-0-9]+:[0-9]{12}:file-system/fs-[0-9a-f]{8,40}$` 必要：是 ** [FileSystemAccessRoleArn](#API_CreateLocationEfs_RequestSyntax) ** 指定允許 DataSync 存取 Amazon EFS 檔案系統的 AWS Identity and Access Management (IAM) 角色。如需建立此角色的資訊，請參閱[建立用於檔案系統存取的 DataSync IAM 角色](https://docs.aws.amazon.com/datasync/latest/userguide/create-efs-location.html#create-efs-location-iam-role)。類型：字串長度限制：長度上限為 2048。模式：`^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):iam::[0-9]{12}:role/.*$` 必要：否 ** [InTransitEncryption](#API_CreateLocationEfs_RequestSyntax) ** 指定當您的 Amazon EFS 檔案系統傳輸資料時，您是否希望 DataSync 使用 Transport Layer Security (TLS) 1.2 加密。如果您使用 `AccessPointArn` 指定存取點或使用 `FileSystemAccessRoleArn` 指定 IAM 角色，則必須將此參數設定為 `TLS1_2`。類型：字串有效值:`NONE | TLS1_2` 必要：否 ** [Subdirectory](#API_CreateLocationEfs_RequestSyntax) ** 為 Amazon EFS 檔案系統指定掛載路徑。這是 DataSync 在檔案系統上讀取或寫入資料的地方（取決於這是來源或目的地位置）。根據預設，DataSync 會使用根目錄（如果您使用提供[存取點](https://docs.aws.amazon.com/efs/latest/ug/efs-access-points.html))`AccessPointArn`。您也可以使用斜線包含子目錄（例如，`/path/to/folder`)。類型：字串長度限制：長度上限為 4096。模式：`^[a-zA-Z0-9_\-\+\./\p{Zs}]*$` 必要：否 ** [Tags](#API_CreateLocationEfs_RequestSyntax) ** 指定代表您要新增至資源之標籤的鍵/值對。此數值可以是空字串。此值可協助您管理、篩選和搜尋資源。建議您為位置建立名稱標籤。類型：[TagListEntry](API_TagListEntry.md) 物件陣列陣列成員：項目數下限為 0。項目數上限為 50。必要：否 ## 回應語法 ``` { "LocationArn": "string" } ``` ## 回應元素如果動作成功，則服務傳回 HTTP 200 回應。服務會傳回下列 JSON 格式的資料。 ** [LocationArn](#API_CreateLocationEfs_ResponseSyntax) ** 您建立之 Amazon EFS 檔案系統位置的 Amazon Resource Name (ARN)。類型：字串長度限制：長度上限為 128。模式：`^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):datasync:[a-z\-0-9]+:[0-9]{12}:location/loc-[0-9a-z]{17}$` ## 錯誤如需所有動作常見錯誤的資訊，請參閱[常見錯誤類型](CommonErrors.md)。 ** 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`中指定 `AccessPointArn`、 `FileSystemAccessRoleArn`和的值。 ``` { "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 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/CreateLocationEfs) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/CreateLocationEfs) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/CreateLocationEfs) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/CreateLocationEfs) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/CreateLocationEfs) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/CreateLocationEfs) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/CreateLocationEfs) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/CreateLocationEfs) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/CreateLocationEfs) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/CreateLocationEfs)