翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。 # DescribeLocationEfs Amazon EFS ファイルシステムの AWS DataSync 転送場所の設定方法の詳細を提供します。 ## リクエストの構文 ``` { "LocationArn": "string" } ``` ## リクエストパラメーターすべてのアクションに共通のパラメータの詳細については、「[共通パラメータ](CommonParameters.md)」を参照してください。リクエストは以下のデータを JSON 形式で受け入れます。 ** [LocationArn](#API_DescribeLocationEfs_RequestSyntax) ** 情報を取得する 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}$` 必須: はい ## レスポンスの構文 ``` { "AccessPointArn": "string", "CreationTime": number, "Ec2Config": { "SecurityGroupArns": [ "string" ], "SubnetArn": "string" }, "FileSystemAccessRoleArn": "string", "InTransitEncryption": "string", "LocationArn": "string", "LocationUri": "string" } ``` ## レスポンス要素アクションが成功すると、サービスは HTTP 200 レスポンスを返します。サービスから以下のデータが JSON 形式で返されます。 ** [AccessPointArn](#API_DescribeLocationEfs_ResponseSyntax) ** DataSync が Amazon EFS ファイルシステムにアクセスするために使用するアクセスポイントの 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}$` ** [CreationTime](#API_DescribeLocationEfs_ResponseSyntax) ** 場所が作成された時刻。タイプ: タイムスタンプ ** [Ec2Config](#API_DescribeLocationEfs_ResponseSyntax) ** AWS DataSync が Amazon EFS ファイルシステムの[マウントターゲット](https://docs.aws.amazon.com/efs/latest/ug/accessing-fs.html)の 1 つに接続するために使用するサブネットとセキュリティグループ。型: [Ec2Config](API_Ec2Config.md) オブジェクト ** [FileSystemAccessRoleArn](#API_DescribeLocationEfs_ResponseSyntax) ** 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_DescribeLocationEfs_ResponseSyntax) ** DataSync が Amazon EFS ファイルシステムとの間でデータを転送するときに、Transport Layer Security (TLS) 暗号化を使用するかどうかを示します。タイプ: 文字列有効な値：`NONE | TLS1_2` ** [LocationArn](#API_DescribeLocationEfs_ResponseSyntax) ** Amazon EFS ファイルシステムの場所の 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}$` ** [LocationUri](#API_DescribeLocationEfs_ResponseSyntax) ** Amazon EFS ファイルシステムの場所の URL。タイプ: 文字列長さの制約: 最大長は 4,360 です。パターン: `^(efs|nfs|s3|smb|hdfs|fsx[a-z0-9-]+)://[a-zA-Z0-9.:/\-]+$` ## エラーすべてのアクションに共通のエラーについては、「[共通エラー](CommonErrors.md)」を参照してください。 ** InternalException ** この例外は、 AWS DataSync サービスでエラーが発生した場合にスローされます。 HTTP ステータスコード: 500 ** InvalidRequestException ** この例外は、クライアントが不正な形式のリクエストを送信した場合にスローされます。 HTTP ステータスコード: 400 ## 例 ### リクエスト例次の例は、特定の Amazon EFS ファイルシステムの場所に関する情報を取得する方法を示しています。 ``` { "LocationArn": "arn:aws:datasync:us-east-2:111222333444:location/loc-12abcdef012345678" } ``` ### レスポンス例次の例は、Amazon EFS ファイルシステムに関する場所の詳細を返します。 ``` { "CreationTime": 1653319021.353, "Ec2Config": { "SubnetArn": "arn:aws:ec2:us-east-2:111222333444:subnet/subnet-1234567890abcdef1", "SecurityGroupArns": [ "arn:aws:ec2:us-east-2:111222333444:security-group/sg-1234567890abcdef2" ] }, "LocationArn": "arn:aws:datasync:us-east-2:111222333444:location/loc-abcdef01234567890", "LocationUri": "efs://us-east-2.fs-021345abcdef6789/" } ``` ### レスポンス例: 制限付きの Amazon EFS ファイルシステムの場所の説明次の例では、アクセスが制限されている Amazon EFS ファイルシステムの場所の詳細 (`AccessPointArn`、`FileSystemAccessRoleArn`、`InTransitEncryption` 要素など) を返します。 ``` { "CreationTime": 1653319021.353, "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" }] } ``` ## 以下の資料も参照してください。言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/DescribeLocationEfs) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/DescribeLocationEfs) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/DescribeLocationEfs) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/DescribeLocationEfs) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/DescribeLocationEfs) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/DescribeLocationEfs) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/DescribeLocationEfs) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/DescribeLocationEfs) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/DescribeLocationEfs) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/DescribeLocationEfs)