翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。 # 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" } ] } ``` ## リクエストパラメーター すべてのアクションに共通のパラメータの詳細については、「[共通パラメータ](CommonParameters.md)」を参照してください。 リクエストは以下のデータを JSON 形式で受け入れます。 ** [AccessPointArn](#API_CreateLocationEfs_RequestSyntax) ** DataSync が Amazon EFS ファイルシステムにアクセスするために使用するアクセスポイントの Amazon リソースネーム (ARN) を指定します。 詳細については、「[Accessing restricted file systems](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) ロールを指定します。 このロールの作成については、「[Creating a DataSync IAM role for file system access](https://docs.aws.amazon.com/datasync/latest/userguide/create-efs-location.html#create-efs-location-iam-role)」を参照してください。 タイプ: 文字列 長さの制約: 最大長は 2,048 です。 パターン: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):iam::[0-9]{12}:role/.*$` 必須: いいえ ** [InTransitEncryption](#API_CreateLocationEfs_RequestSyntax) ** DataSync が Amazon EFS ファイルシステムとの間でデータを転送するときに、Transport Layer Security (TLS) 1.2 暗号化を使用するかどうかを指定します。 `AccessPointArn` または `FileSystemAccessRoleArn` を使用した IAM ロールを使用してアクセスポイントを指定する場合、このパラメータを `TLS1_2` に設定する必要があります。 タイプ: 文字列 有効な値：`NONE | TLS1_2` 必須: いいえ ** [Subdirectory](#API_CreateLocationEfs_RequestSyntax) ** Amazon EFS ファイルシステムのマウントパスを指定します。これは、DataSync がファイルシステム上のデータの読み取りまたは書き込み (送信元の場所か送信先の場所かによって異なります) を行う場所です。 デフォルトで、DataSync はルートディレクトリ (または `AccessPointArn` を使用して指定する[アクセスポイント](https://docs.aws.amazon.com/efs/latest/ug/efs-access-points.html)) を使用します。フォワードスラッシュ (例: `/path/to/folder`) を使用してサブディレクトリを含めることもできます。 タイプ: 文字列 長さの制約: 最大長は 4,096 です。 パターン: `^[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 リソースネーム (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 ファイルシステムの場所を作成します。このようなシナリオでは、リクエストで `AccessPointArn`、`FileSystemAccessRoleArn`、`InTransitEncryption` の値を指定しなければならない場合があります。 ``` { "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 SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/CreateLocationEfs) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/CreateLocationEfs) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/CreateLocationEfs) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/CreateLocationEfs) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/CreateLocationEfs) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/CreateLocationEfs) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/CreateLocationEfs) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/CreateLocationEfs) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/CreateLocationEfs)