2023 年 12 月 7 日より、バージョン 1 DataSync のエージェントは廃止されます。 DataSync コンソールの [エージェント] ページをチェックして、影響を受けるエージェントがいないか確認してください。その場合は、データ転送やストレージ検出の中断を避けるため、その前にそれらのエージェントを交換してください。さらにサポートが必要な場合は、お問い合わせくださいAWS Support
翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
UpdateLocationHdfs
Hadoop 分散ファイルシステムクラスター用に以前に作成した場所の一部のパラメータを更新します。
リクエストの構文
{
"AgentArns": [ "string" ],
"AuthenticationType": "string",
"BlockSize": number,
"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"
}リクエストパラメータ
すべてのアクションに共通のパラメータの詳細については、「共通パラメータ」を参照してください。
リクエストは以下の JSON 形式のデータを受け入れます。
- AgentArns
-
HDFS クラスターへの接続に使用されるエージェントの ARN。
型: 文字列の配列
配列メンバー: 最小数は 1 項目です。最大数は 4 項目です。
長さの制限: 最大長は 128 です。
パターン:
^arn:(aws|aws-cn|aws-us-gov|aws-iso|aws-iso-b):datasync:[a-z\-0-9]+:[0-9]{12}:agent/agent-[0-9a-z]{17}$必須: いいえ
- AuthenticationType
-
ユーザーの ID を決定するために使用される認証のタイプ。
タイプ: 文字列
有効な値:
SIMPLE | KERBEROS必須: いいえ
- BlockSize
-
HDFS クラスターに書き込むデータブロックのサイズ。
型: 整数
値の範囲: 最小値 は 1,048,576 です。最大値は 1,073,741,824 です。
必須: いいえ
- KerberosKeytab
-
定義された Kerberos プリンシパルと暗号化キー間のマッピングを含む Kerberos キーテーブル (キータブ)。ファイルのアドレスを指定して、ファイルからキータブをロードできます。を使用するとAWS CLI、Base64 エンコーディングが自動的に実行されます。それ以外の場合は、base64 でエンコードされたテキストを指定します。
型: Base64 でエンコードされたバイナリデータオブジェクト
長さの制限: 最大長は 65,536 です。
必須: いいえ
- KerberosKrb5Conf
-
Kerberos 構成情報を含む
krb5.confファイル。ファイルのアドレスを指定して、krb5.confファイルをロードできます。使用している AWS CLI では、base64 エンコードを実行します。それ以外の場合は、base64 でエンコードされたテキストを指定します。型: Base64 でエンコードされたバイナリデータオブジェクト
長さの制限: 最大長は 131,072 です。
必須: いいえ
- KerberosPrincipal
-
HDFS クラスター上のファイルとフォルダーへのアクセス権を持つ Kerberos プリンシパル。
型: 文字列
長さの制限: 最小長は 1 です。最大長は 256 です。
パターン:
^.+$必須: いいえ
- KmsKeyProviderUri
-
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
-
ソース HDFS クラスターの場所の Amazon リソースネーム (ARN)。
型: 文字列
長さの制限: 最大長は 128 です。
パターン:
^arn:(aws|aws-cn|aws-us-gov|aws-iso|aws-iso-b):datasync:[a-z\-0-9]+:[0-9]{12}:location/loc-[0-9a-z]{17}$必須: はい
- NameNodes
-
NameNode は HDFS 名前空間を管理します。は、ファイルやディレクトリを開く、閉じる、 NameNode 名前を変更するなどの操作を実行します。には、 NameNode データブロックをにマップするための情報が含まれています。 DataNodes使用できるのは 1 つだけです NameNode。
型: HdfsNameNode オブジェクトの配列
配列メンバー: 最小数は 1 項目です。
必須: いいえ
- QopConfiguration
-
保護の品質 (QOP) 設定では、Hadoop Distributed File System (HDFS) クラスターで構成されたリモートプロシージャコール (RPC) とデータ転送のプライバシー設定を指定します。
型: QopConfiguration オブジェクト
必須: いいえ
- ReplicationFactor
-
HDFS DataNodes クラスターへの書き込み時にデータを複製する番号です。
型: 整数
有効範囲: 最小値 は 1 最大値は 512 です。
必須: いいえ
- SimpleUser
-
ホストオペレーティングシステム上のクライアントを識別するために使用されるユーザー名。
型: 文字列
長さの制限: 最小長は 1 です。最大長は 256 です。
パターン:
^[_.A-Za-z0-9][-_.A-Za-z0-9]*$必須: いいえ
- Subdirectory
-
HDFS クラスター内のサブディレクトリ。このサブディレクトリは、HDFS クラスターからデータを読み取り、または HDFS クラスターにデータを書き込むために使用されます。
型: 文字列
長さの制限: 最大長は 4,096 です。
パターン:
^[a-zA-Z0-9_\-\+\./\(\)\$\p{Zs}]+$必須: いいえ
レスポンス要素
アクションが成功した場合、サービスは空の HTTP 本文を持つ HTTP 200 応答を返します。
エラー
すべてのアクションに共通のエラーについては、「共通エラー」を参照してください。
- InternalException
-
この例外は、AWS DataSync サービスでエラーが発生した場合にスローされます。
HTTP ステータスコード: 500
- InvalidRequestException
-
この例外は、クライアントが不正な形式のリクエストを送信した場合にスローされます。
HTTP ステータスコード: 400
以下の資料も参照してください。
言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
