

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

# UpdateLocationHdfs
<a name="API_UpdateLocationHdfs"></a>

使用している Hadoop Distributed File System (HDFS) 転送場所の次の設定パラメータを変更します AWS DataSync。

詳細については、「[Configuring AWS DataSync transfers with an HDFS cluster](https://docs.aws.amazon.com/datasync/latest/userguide/create-hdfs-location.html)」を参照してください。

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

```
{
   "AgentArns": [ "string" ],
   "AuthenticationType": "string",
   "BlockSize": number,
   "CmkSecretConfig": { 
      "KmsKeyArn": "string",
      "SecretArn": "string"
   },
   "CustomSecretConfig": { 
      "SecretAccessRoleArn": "string",
      "SecretArn": "string"
   },
   "KerberosKeytab": blob,
   "KerberosKrb5Conf": blob,
   "KerberosPrincipal": "string",
   "KmsKeyProviderUri": "string",
   "LocationArn": "string",
   "NameNodes": [ 
      { 
         "Hostname": "string",
         "Port": number
      }
   ],
   "QopConfiguration": { 
      "DataTransferProtection": "string",
      "RpcProtection": "string"
   },
   "ReplicationFactor": number,
   "SimpleUser": "string",
   "Subdirectory": "string"
}
```

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

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

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

 ** [AgentArns](#API_UpdateLocationHdfs_RequestSyntax) **   <a name="DataSync-UpdateLocationHdfs-request-AgentArns"></a>
HDFS クラスターに接続できる DataSync エージェントの Amazon リソースネーム (ARN)。  
タイプ: 文字列の配列  
配列メンバー: 最小数は 1 項目です。最大 8 項目。  
長さの制約: 最大長は 128 です。  
パターン: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):datasync:[a-z\-0-9]+:[0-9]{12}:agent/agent-[0-9a-z]{17}$`   
必須: いいえ

 ** [AuthenticationType](#API_UpdateLocationHdfs_RequestSyntax) **   <a name="DataSync-UpdateLocationHdfs-request-AuthenticationType"></a>
ユーザーの ID を決定するために使用される認証のタイプ。  
タイプ: 文字列  
有効な値：`SIMPLE | KERBEROS`  
必須: いいえ

 ** [BlockSize](#API_UpdateLocationHdfs_RequestSyntax) **   <a name="DataSync-UpdateLocationHdfs-request-BlockSize"></a>
HDFS クラスターに書き込むデータブロックのサイズ。  
タイプ: 整数  
有効範囲: 最小値 は 1,048,576 です。最大値は 1,073,741,824 です。  
必須: いいえ

 ** [CmkSecretConfig](#API_UpdateLocationHdfs_RequestSyntax) **   <a name="DataSync-UpdateLocationHdfs-request-CmkSecretConfig"></a>
DataSync が特定の転送場所へのアクセスに使用する `KerberosKeytab`または認証情報のセット、およびカスタマーマネージドなど、DataSync が管理するシークレットの設定情報を指定します AWS KMS key。  
型: [CmkSecretConfig](API_CmkSecretConfig.md) オブジェクト  
必須: いいえ

 ** [CustomSecretConfig](#API_UpdateLocationHdfs_RequestSyntax) **   <a name="DataSync-UpdateLocationHdfs-request-CustomSecretConfig"></a>
DataSync が特定の転送場所にアクセスするために使用する `KerberosKeytab`または一連の認証情報、およびシークレットへのアクセスを提供するカスタマーマネージド AWS Identity and Access Management (IAM) ロールなど、カスタマーマネージドシークレットの設定情報を指定します。  
型: [CustomSecretConfig](API_CustomSecretConfig.md) オブジェクト  
必須: いいえ

 ** [KerberosKeytab](#API_UpdateLocationHdfs_RequestSyntax) **   <a name="DataSync-UpdateLocationHdfs-request-KerberosKeytab"></a>
定義された Kerberos プリンシパルと暗号化キー間のマッピングを含む Kerberos キーテーブル (キータブ)。ファイルのアドレスを指定して、ファイルからキータブをロードできます。  
タイプ: Base64 でエンコードされたバイナリデータオブジェクト  
長さの制約: 最大長は 65,536 です。  
必須: いいえ

 ** [KerberosKrb5Conf](#API_UpdateLocationHdfs_RequestSyntax) **   <a name="DataSync-UpdateLocationHdfs-request-KerberosKrb5Conf"></a>
Kerberos 構成情報を含む `krb5.conf` ファイル。ファイルのアドレスを指定して、`krb5.conf` ファイルをロードできます。 AWS CLIを使用している場合は、base64 エンコードが実行されます。それ以外の場合は、base64 でエンコードされたテキストを指定します。  
タイプ: Base64 でエンコードされたバイナリデータオブジェクト  
長さの制約: 最大長は 131,072 です。  
必須: いいえ

 ** [KerberosPrincipal](#API_UpdateLocationHdfs_RequestSyntax) **   <a name="DataSync-UpdateLocationHdfs-request-KerberosPrincipal"></a>
HDFS クラスター上のファイルとフォルダーへのアクセス権を持つ Kerberos プリンシパル。  
タイプ: 文字列  
長さの制約: 最小長は 1 です。最大長は 256 です。  
パターン: `^.+$`   
必須: いいえ

 ** [KmsKeyProviderUri](#API_UpdateLocationHdfs_RequestSyntax) **   <a name="DataSync-UpdateLocationHdfs-request-KmsKeyProviderUri"></a>
HDFS クラスターのキー管理サーバー (KMS) の URI。  
タイプ: 文字列  
長さの制約: 最小長は 1 です。最大長は 255 です。  
パターン: `^kms:\/\/http[s]?@(([a-zA-Z0-9\-]*[a-zA-Z0-9])\.)*([A-Za-z0-9\-]*[A-Za-z0-9])(;(([a-zA-Z0-9\-]*[a-zA-Z0-9])\.)*([A-Za-z0-9\-]*[A-Za-z0-9]))*:[0-9]{1,5}\/kms$`   
必須: いいえ

 ** [LocationArn](#API_UpdateLocationHdfs_RequestSyntax) **   <a name="DataSync-UpdateLocationHdfs-request-LocationArn"></a>
ソース HDFS クラスターの場所の 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}$`   
必須: はい

 ** [NameNodes](#API_UpdateLocationHdfs_RequestSyntax) **   <a name="DataSync-UpdateLocationHdfs-request-NameNodes"></a>
HDFS 名前空間を管理する NameNode。NameNode は、ファイルやディレクトリのオープン、クローズ、名前の変更などの操作を実行します。NameNode には、データのブロックを DataNode にマップするための情報が含まれています。NameNode は 1 つのみを使用できます。  
タイプ: [HdfsNameNode](API_HdfsNameNode.md) オブジェクトの配列  
配列メンバー: 最小数は 1 項目です。  
必須: いいえ

 ** [QopConfiguration](#API_UpdateLocationHdfs_RequestSyntax) **   <a name="DataSync-UpdateLocationHdfs-request-QopConfiguration"></a>
保護の品質 (QOP) 設定では、Hadoop Distributed File System (HDFS) クラスターで構成されたリモートプロシージャコール (RPC) とデータ転送のプライバシー設定を指定します。  
タイプ: [QopConfiguration](API_QopConfiguration.md) オブジェクト  
必須: いいえ

 ** [ReplicationFactor](#API_UpdateLocationHdfs_RequestSyntax) **   <a name="DataSync-UpdateLocationHdfs-request-ReplicationFactor"></a>
HDFS クラスターへの書き込み時にデータをレプリケートする DataNode の数。  
タイプ: 整数  
有効範囲: 最小値 は 1 です。最大値は 512 です。  
必須: いいえ

 ** [SimpleUser](#API_UpdateLocationHdfs_RequestSyntax) **   <a name="DataSync-UpdateLocationHdfs-request-SimpleUser"></a>
ホストオペレーティングシステム上のクライアントを識別するために使用されるユーザー名。  
タイプ: 文字列  
長さの制約: 最小長は 1 です。最大長は 256 です。  
パターン: `^[_.A-Za-z0-9][-_.A-Za-z0-9]*$`   
必須: いいえ

 ** [Subdirectory](#API_UpdateLocationHdfs_RequestSyntax) **   <a name="DataSync-UpdateLocationHdfs-request-Subdirectory"></a>
HDFS クラスター内のサブディレクトリ。このサブディレクトリは、HDFS クラスターからデータを読み取り、または HDFS クラスターにデータを書き込むために使用されます。  
タイプ: 文字列  
長さの制約: 最大長は 4,096 です。  
パターン: `^[a-zA-Z0-9_\-\+\./\(\)\$\p{Zs}]+$`   
必須: いいえ

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

アクションが成功した場合、サービスは空の HTTP 本文を持つ HTTP 200 レスポンスを返します。

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

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

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

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

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

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