翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# CreateLocationNfs
<a name="API_CreateLocationNfs"></a>

Network File System (NFS) ファイルサーバーの転送*場所*を作成します。この場所をデータ転送のソースまたは送信先として AWS DataSync 使用できます。

始める前に、必ず DataSync がどのように [NFS ファイルサーバーにアクセス](https://docs.aws.amazon.com/datasync/latest/userguide/create-nfs-location.html#accessing-nfs)するかを理解してください。

## リクエストの構文
<a name="API_CreateLocationNfs_RequestSyntax"></a>

```
{
   "MountOptions": { 
      "Version": "string"
   },
   "OnPremConfig": { 
      "AgentArns": [ "string" ]
   },
   "ServerHostname": "string",
   "Subdirectory": "string",
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ]
}
```

## リクエストパラメーター
<a name="API_CreateLocationNfs_RequestParameters"></a>

すべてのアクションに共通のパラメータの詳細については、「[共通パラメータ](CommonParameters.md)」を参照してください。

リクエストは以下のデータを JSON 形式で受け入れます。

 ** [MountOptions](#API_CreateLocationNfs_RequestSyntax) **   <a name="DataSync-CreateLocationNfs-request-MountOptions"></a>
DataSync が NFS ファイルサーバーをマウントするのに使用できるオプションを指定します。  
タイプ: [NfsMountOptions](API_NfsMountOptions.md) オブジェクト  
必須: いいえ

 ** [OnPremConfig](#API_CreateLocationNfs_RequestSyntax) **   <a name="DataSync-CreateLocationNfs-request-OnPremConfig"></a>
NFS ファイルサーバーに接続する DataSync エージェントの Amazon リソースネーム (ARN) を指定します。  
複数のエージェントを指定できます。詳細については、「[Using multiple DataSync agents](https://docs.aws.amazon.com/datasync/latest/userguide/do-i-need-datasync-agent.html#multiple-agents)」を参照してください。  
タイプ: [OnPremConfig](API_OnPremConfig.md) オブジェクト  
必須: はい

 ** [ServerHostname](#API_CreateLocationNfs_RequestSyntax) **   <a name="DataSync-CreateLocationNfs-request-ServerHostname"></a>
DataSync エージェントが接続する NFS ファイルサーバーの DNS 名または IP アドレス (IPv4 または IPv6) を指定します。  
タイプ: 文字列  
長さの制約: 最大長は 255 です。  
パターン: `^(([a-zA-Z0-9\-]*[a-zA-Z0-9])\.)*([A-Za-z0-9\-:]*[A-Za-z0-9])$`   
必須: はい

 ** [Subdirectory](#API_CreateLocationNfs_RequestSyntax) **   <a name="DataSync-CreateLocationNfs-request-Subdirectory"></a>
DataSync がマウントする NFS ファイルサーバーのエクスポートパスを指定します。  
このパス (またはパスのサブディレクトリ) は、DataSync のデータ転送先または転送元となる場所です。DataSync のエクスポートの構成については、「[NFS ファイルサーバーへのアクセス](https://docs.aws.amazon.com/datasync/latest/userguide/create-nfs-location.html#accessing-nfs)」を参照してください。  
タイプ: 文字列  
長さの制約: 最大長は 4,096 です。  
パターン: `^[a-zA-Z0-9_\-\+\./\(\)\p{Zs}]+$`   
必須: はい

 ** [Tags](#API_CreateLocationNfs_RequestSyntax) **   <a name="DataSync-CreateLocationNfs-request-Tags"></a>
 AWS リソースの分類、フィルタリング、検索に役立つラベルを指定します。少なくとも場所の名前タグを作成することを推奨します。  
タイプ: [TagListEntry](API_TagListEntry.md) オブジェクトの配列  
配列メンバー: 最小数は 0 項目です。最大数は 50 項目です。  
必須: いいえ

## レスポンスの構文
<a name="API_CreateLocationNfs_ResponseSyntax"></a>

```
{
   "LocationArn": "string"
}
```

## レスポンス要素
<a name="API_CreateLocationNfs_ResponseElements"></a>

アクションが成功すると、サービスは HTTP 200 レスポンスを返します。

サービスから以下のデータが JSON 形式で返されます。

 ** [LocationArn](#API_CreateLocationNfs_ResponseSyntax) **   <a name="DataSync-CreateLocationNfs-response-LocationArn"></a>
NFS ファイルサーバー用に作成した転送場所の 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}$` 

## エラー
<a name="API_CreateLocationNfs_Errors"></a>

すべてのアクションに共通のエラーについては、「[共通エラー](CommonErrors.md)」を参照してください。

 ** InternalException **   
この例外は、 AWS DataSync サービスでエラーが発生した場合にスローされます。  
HTTP ステータスコード: 500

 ** InvalidRequestException **   
この例外は、クライアントが不正な形式のリクエストを送信した場合にスローされます。  
HTTP ステータスコード: 400

## 例
<a name="API_CreateLocationNfs_Examples"></a>

### 例
<a name="API_CreateLocationNfs_Example_1"></a>

次の例では、NFS ファイルサーバー用の DataSync 転送場所を作成します。

#### リクエスト例
<a name="API_CreateLocationNfs_Example_1_Request"></a>

```
{
  "MountOptions": {
     "Version": : "NFS4_0"
     },
  "OnPremConfig": {
    "AgentArn": [ "arn:aws:datasync:us-east-2:111222333444:agent/agent-0b0addbeef44b3nfs" ]
          },
          
           "ServerHostname": "MyServer@amazon.com",
           "Subdirectory": "/MyFolder",
           "Tags": [
              {
                "Key": "Name",
                "Value": "FileSystem-1"
              }
           ]
}
```

### 例
<a name="API_CreateLocationNfs_Example_2"></a>

レスポンスは NFS の場所の ARN を返します。

#### レスポンス例
<a name="API_CreateLocationNfs_Example_2_Response"></a>

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

## 以下の資料も参照してください。
<a name="API_CreateLocationNfs_SeeAlso"></a>

言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+  [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/CreateLocationNfs) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/CreateLocationNfs) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/CreateLocationNfs) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/CreateLocationNfs) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/CreateLocationNfs) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/CreateLocationNfs) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/CreateLocationNfs) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/CreateLocationNfs) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/CreateLocationNfs) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/CreateLocationNfs)