翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。 # DescribeLocationHdfs Hadoop Distributed File System (HDFS) の AWS DataSync 転送場所の設定方法の詳細を提供します。 ## リクエストの構文 ``` { "LocationArn": "string" } ``` ## リクエストパラメーターすべてのアクションに共通のパラメータの詳細については、「[共通パラメータ](CommonParameters.md)」を参照してください。リクエストは以下のデータを JSON 形式で受け入れます。 ** [LocationArn](#API_DescribeLocationHdfs_RequestSyntax) ** 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}$` 必須: はい ## レスポンスの構文 ``` { "AgentArns": [ "string" ], "AuthenticationType": "string", "BlockSize": number, "CmkSecretConfig": { "KmsKeyArn": "string", "SecretArn": "string" }, "CreationTime": number, "CustomSecretConfig": { "SecretAccessRoleArn": "string", "SecretArn": "string" }, "KerberosPrincipal": "string", "KmsKeyProviderUri": "string", "LocationArn": "string", "LocationUri": "string", "ManagedSecretConfig": { "SecretArn": "string" }, "NameNodes": [ { "Hostname": "string", "Port": number } ], "QopConfiguration": { "DataTransferProtection": "string", "RpcProtection": "string" }, "ReplicationFactor": number, "SimpleUser": "string" } ``` ## レスポンス要素アクションが成功すると、サービスは HTTP 200 レスポンスを返します。サービスから以下のデータが JSON 形式で返されます。 ** [AgentArns](#API_DescribeLocationHdfs_ResponseSyntax) ** HDFS クラスターに安全に接続できる DataSync エージェントの 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_DescribeLocationHdfs_ResponseSyntax) ** ユーザーの ID を決定するために使用される認証のタイプ。タイプ: 文字列有効な値：`SIMPLE | KERBEROS` ** [BlockSize](#API_DescribeLocationHdfs_ResponseSyntax) ** HDFS クラスターに書き込むデータブロックのサイズ。タイプ: 整数有効範囲: 最小値は 1,048,576 です。最大値は 1,073,741,824 です。 ** [CmkSecretConfig](#API_DescribeLocationHdfs_ResponseSyntax) ** DataSync が特定のストレージロケーションへのアクセスに使用するなど、`KerberosKeytab`DataSync が管理するシークレットの設定情報をカスタマー管理で記述します AWS KMS key。型: [CmkSecretConfig](API_CmkSecretConfig.md) オブジェクト ** [CreationTime](#API_DescribeLocationHdfs_ResponseSyntax) ** HDFS の場所が作成された時刻。タイプ: タイムスタンプ ** [CustomSecretConfig](#API_DescribeLocationHdfs_ResponseSyntax) ** DataSync `KerberosKeytab`が特定のストレージロケーションにアクセスするために使用するなど、カスタマーマネージドシークレットの設定情報を、シークレットへのアクセスを提供するカスタマーマネージド AWS Identity and Access Management (IAM) ロールで記述します。型: [CustomSecretConfig](API_CustomSecretConfig.md) オブジェクト ** [KerberosPrincipal](#API_DescribeLocationHdfs_ResponseSyntax) ** HDFS クラスター上のファイルとフォルダーへのアクセス権を持つ Kerberos プリンシパル。`AuthenticationType` を `KERBEROS` と定義するとき、このパラメータが使用されます。タイプ: 文字列長さの制約: 最小長は 1 です。最大長は 256 です。パターン: `^.+$` ** [KmsKeyProviderUri](#API_DescribeLocationHdfs_ResponseSyntax) ** 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_DescribeLocationHdfs_ResponseSyntax) ** HDFS の場所の 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}$` ** [LocationUri](#API_DescribeLocationHdfs_ResponseSyntax) ** HDFS の場所の URI。タイプ: 文字列長さの制約: 最大長は 4,360 です。パターン: `^(efs|nfs|s3|smb|hdfs|fsx[a-z0-9-]+)://[a-zA-Z0-9.:/\-]+$` ** [ManagedSecretConfig](#API_DescribeLocationHdfs_ResponseSyntax) ** DataSync が特定のストレージロケーションにアクセスするために使用するなど、`KerberosKeytab`DataSync が管理するシークレットの設定情報について説明します。DataSync AWSは、デフォルトマネージド KMS キーを使用してこのシークレットを暗号化します AWS Secrets Manager。型: [ManagedSecretConfig](API_ManagedSecretConfig.md) オブジェクト ** [NameNodes](#API_DescribeLocationHdfs_ResponseSyntax) ** HDFS 名前空間を管理する NameNode。タイプ: [HdfsNameNode](API_HdfsNameNode.md) オブジェクトの配列配列メンバー: 最小数は 1 項目です。 ** [QopConfiguration](#API_DescribeLocationHdfs_ResponseSyntax) ** 保護の品質 (QOP) 設定は、HDFS クラスターで設定されたリモートプロシージャコール (RPC) とデータ転送保護の設定を指定します。タイプ: [QopConfiguration](API_QopConfiguration.md) オブジェクト ** [ReplicationFactor](#API_DescribeLocationHdfs_ResponseSyntax) ** HDFS クラスターへの書き込み時にデータをレプリケートする DataNode の数。タイプ: 整数有効範囲: 最小値は 1 です。最大値は 512 です。 ** [SimpleUser](#API_DescribeLocationHdfs_ResponseSyntax) ** ホストオペレーティングシステム上のクライアントを識別するためのユーザー名。`AuthenticationType` を `SIMPLE` と定義するとき、このパラメータが使用されます。タイプ: 文字列長さの制約: 最小長は 1 です。最大長は 256 です。パターン: `^[_.A-Za-z0-9][-_.A-Za-z0-9]*$` ## エラーすべてのアクションに共通のエラーについては、「[共通エラー](CommonErrors.md)」を参照してください。 ** InternalException ** この例外は、 AWS DataSync サービスでエラーが発生した場合にスローされます。 HTTP ステータスコード: 500 ** InvalidRequestException ** この例外は、クライアントが不正な形式のリクエストを送信した場合にスローされます。 HTTP ステータスコード: 400 ## 以下の資料も参照してください。言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/DescribeLocationHdfs) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/DescribeLocationHdfs) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/DescribeLocationHdfs) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/DescribeLocationHdfs) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/DescribeLocationHdfs) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/DescribeLocationHdfs) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/DescribeLocationHdfs) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/DescribeLocationHdfs) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/DescribeLocationHdfs) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/DescribeLocationHdfs)