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