リクエストの構文リクエストパラメータレスポンスの構文レスポンス要素エラー以下の資料も参照してください。

2023 年 12 月 7 日より、バージョン 1 DataSync のエージェントは廃止されます。 DataSync コンソールの [エージェント] ページをチェックして、影響を受けるエージェントがいないか確認してください。その場合は、データ転送やストレージ検出の中断を避けるため、その前にそれらのエージェントを交換してください。さらにサポートが必要な場合は、お問い合わせくださいAWS Support。

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

DescribeLocationHdfs

Hadoop Distributed File System (HDFS) の場所に関する認証情報などのメタデータを返します。

リクエストの構文


{
   "LocationArn": "string"
}

リクエストパラメータ

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

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

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}$

必須: はい

レスポンスの構文


{
   "AgentArns": [ "string" ],
   "AuthenticationType": "string",
   "BlockSize": number,
   "CreationTime": number,
   "KerberosPrincipal": "string",
   "KmsKeyProviderUri": "string",
   "LocationArn": "string",
   "LocationUri": "string",
   "NameNodes": [ 
      { 
         "Hostname": "string",
         "Port": number
      }
   ],
   "QopConfiguration": { 
      "DataTransferProtection": "string",
      "RpcProtection": "string"
   },
   "ReplicationFactor": number,
   "SimpleUser": "string"
}

レスポンス要素

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

サービスから以下のデータが 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 です。

CreationTime

HDFS ロケーションが作成された時刻。

タイプ: Timestamp

KerberosPrincipal

HDFS クラスター上のファイルとフォルダーへのアクセス権を持つ Kerberos プリンシパル。AuthenticationType を 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