翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。 # DescribeMountTargets ファイルシステムのすべての現在のマウントターゲット、または特定のマウントターゲットの説明を返します。現在のマウント・ターゲットをすべてリクエストする場合、応答で返されるマウント・ターゲットの順序は指定されていません。 このオペレーションには、`FileSystemId` で指定したファイルシステム ID 、または `MountTargetId` で指定したマウントターゲットのファイルシステムのいずれかで、`elasticfilesystem:DescribeMountTargets` のアクションに対する許可が必要です。 対応する CLI コマンドは `describe-mount-targets` です。 ## リクエストの構文 ``` GET /2015-02-01/mount-targets?AccessPointId=AccessPointId&FileSystemId=FileSystemId&Marker=Marker&MaxItems=MaxItems&MountTargetId=MountTargetId HTTP/1.1 ``` ## URI リクエストパラメータ リクエストでは、次の URI パラメータを使用します。 ** [AccessPointId](#API_DescribeMountTargets_RequestSyntax) ** (オプション) リスト表示するマウントターゲットがあるアクセスポイントの ID。`FileSystemId` または `MountTargetId`がリクエストに含まれていない場合は、必ずリクエストに含める必要があります。アクセスポイント ID または ARN を入力として受け入れます。 長さの制約: 最大長は 128 です。 パターン: `^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:access-point/fsap-[0-9a-f]{8,40}|fsap-[0-9a-f]{8,40})$` ** [FileSystemId](#API_DescribeMountTargets_RequestSyntax) ** （オプション）マウントターゲットをリストするファイルシステムの ID（文字列）。`AccessPointId` または `MountTargetId`がリクエストに含まれていない場合は、必ずリクエストに含める必要があります。ファイルシステム ID または ARN を入力として受け入れます。 長さの制約: 最大長は 128 です。 パターン: `^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$` ** [Marker](#API_DescribeMountTargets_RequestSyntax) ** (オプション) 前の `DescribeMountTargets` オペレーション (文字列)から返された不透明なページ割りトークン。存在する場合は、前回のコールが中断された場所からリストを続行するように指定します。 長さの制限：最小長 1、最大長は 128 です。 パターン: `.+` ** [MaxItems](#API_DescribeMountTargets_RequestSyntax) ** (オプション) 応答で返すマウントターゲットの最大数。現在、この数値は自動的に 10 に設定され、その他の値は無視されます。100 を超えるマウントターゲットがある場合、レスポンスはページあたり 100 でページ割りされます。 有効な範囲: 最小値 は 1 です。 ** [MountTargetId](#API_DescribeMountTargets_RequestSyntax) ** (オプション) 説明するマウントターゲットの ID (文字列)。`FileSystemId` が含まれていない場合は、リクエストに含める必要があります。マウントターゲット ID または ARN を入力として受け入れます。 長さの制限: 最小長は 13 です。最大長は 45 です。 Pattern: `^fsmt-[0-9a-f]{8,40}$` ## リクエストボディ リクエストにリクエスト本文がありません。 ## レスポンスの構文 ``` HTTP/1.1 200 Content-type: application/json { "Marker": "string", "MountTargets": [ { "AvailabilityZoneId": "string", "AvailabilityZoneName": "string", "FileSystemId": "string", "IpAddress": "string", "Ipv6Address": "string", "LifeCycleState": "string", "MountTargetId": "string", "NetworkInterfaceId": "string", "OwnerId": "string", "SubnetId": "string", "VpcId": "string" } ], "NextMarker": "string" } ``` ## レスポンス要素 アクションが成功すると、サービスは HTTP 200 レスポンスを返します。 サービスから以下のデータが JSON 形式で返されます。 ** [Marker](#API_DescribeMountTargets_ResponseSyntax) ** リクエストに `Marker` が含まれていた場合、応答はこのフィールドにその値を返します。 タイプ: 文字列 長さの制限: 最小長は 1 です。最大長は 128 です。 パターン: `.+` ** [MountTargets](#API_DescribeMountTargets_ResponseSyntax) ** ファイルシステムのマウントターゲットを `MountTargetDescription` オブジェクトの配列として返します。 型: [MountTargetDescription](API_MountTargetDescription.md) オブジェクトの配列 ** [NextMarker](#API_DescribeMountTargets_ResponseSyntax) ** 値が存在する場合、返されるマウントターゲットがさらに多くなります。後続のリクエストでは、この値を使ってリクエストに `Marker` を指定することで、次のマウントターゲットの設定を取得することができます。 タイプ: 文字列 長さの制限: 最小長は 1 です。最大長は 128 です。 パターン: `.+` ## エラー ** AccessPointNotFound ** 指定された`AccessPointId`値がリクエスタの に存在しない場合に返されます AWS アカウント。 ** ErrorCode ** エラーコードは、エラー状態を個別に識別する文字列です。エラーを検出してタイプ別に処理するプログラムによって読み取りおよび解釈されるためのものです。 ** Message ** エラーメッセージには、エラー状態の一般的な説明が英語で含まれます。これは人が理解できるようにするためのものです。シンプルなプログラムの場合、処理できない、または処理されないエラー状態が発生すると、メッセージがエンドユーザーに直接表示されます。より徹底したエラー処理を備え、適切に国際化されている洗練されたプログラムでは、エラーメッセージが無視される傾向にあります。 HTTP ステータスコード: 404 ** BadRequest ** リクエストの形式が正しくない場合や、無効なパラメータ値や必須パラメータの欠落などのエラーが含まれている場合に返されます。 ** ErrorCode ** エラーコードは、エラー状態を個別に識別する文字列です。エラーを検出してタイプ別に処理するプログラムによって読み取りおよび解釈されるためのものです。 ** Message ** エラーメッセージには、エラー状態の一般的な説明が英語で含まれます。これは人が理解できるようにするためのものです。シンプルなプログラムの場合、処理できない、または処理されないエラー状態が発生すると、メッセージがエンドユーザーに直接表示されます。より徹底したエラー処理を備え、適切に国際化されている洗練されたプログラムでは、エラーメッセージが無視される傾向にあります。 HTTP ステータスコード: 400 ** FileSystemNotFound ** 指定された`FileSystemId`値がリクエスタの に存在しない場合に返されます AWS アカウント。 ** ErrorCode ** エラーコードは、エラー状態を個別に識別する文字列です。エラーを検出してタイプ別に処理するプログラムによって読み取りおよび解釈されるためのものです。 ** Message ** エラーメッセージには、エラー状態の一般的な説明が英語で含まれます。これは人が理解できるようにするためのものです。シンプルなプログラムの場合、処理できない、または処理されないエラー状態が発生すると、メッセージがエンドユーザーに直接表示されます。より徹底したエラー処理を備え、適切に国際化されている洗練されたプログラムでは、エラーメッセージが無視される傾向にあります。 HTTP ステータスコード: 404 ** InternalServerError ** サーバー側でエラーが発生した場合に返されます。 ** ErrorCode ** エラーコードは、エラー状態を個別に識別する文字列です。エラーを検出してタイプ別に処理するプログラムによって読み取りおよび解釈されるためのものです。 ** Message ** エラーメッセージには、エラー状態の一般的な説明が英語で含まれます。これは人が理解できるようにするためのものです。シンプルなプログラムの場合、処理できない、または処理されないエラー状態が発生すると、メッセージがエンドユーザーに直接表示されます。より徹底したエラー処理を備え、適切に国際化されている洗練されたプログラムでは、エラーメッセージが無視される傾向にあります。 HTTP ステータスコード: 500 ** MountTargetNotFound ** 指定された ID のマウントターゲットが発信者の AWS アカウントで見つからない場合に返されます。 ** ErrorCode ** エラーコードは、エラー状態を個別に識別する文字列です。エラーを検出してタイプ別に処理するプログラムによって読み取りおよび解釈されるためのものです。 ** Message ** エラーメッセージには、エラー状態の一般的な説明が英語で含まれます。これは人が理解できるようにするためのものです。シンプルなプログラムの場合、処理できない、または処理されないエラー状態が発生すると、メッセージがエンドユーザーに直接表示されます。より徹底したエラー処理を備え、適切に国際化されている洗練されたプログラムでは、エラーメッセージが無視される傾向にあります。 HTTP ステータスコード: 404 ## 例 ### ファイル・システム用に作成されたマウント・ターゲットの説明を取得する 次のリクエストは、指定されたファイルシステムに対して作成されたマウントターゲットの説明を取得します。 #### リクエスト例 ``` GET /2015-02-01/mount-targets?FileSystemId=fs-01234567 HTTP/1.1 Host: elasticfilesystem.us-west-2.amazonaws.com x-amz-date: 20140622T191252Z Authorization: <...> ``` #### レスポンス例 ``` HTTP/1.1 200 OK x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef Content-Type: application/json Content-Length: 357 { "MountTargets":[ { "OwnerId":"251839141158", "MountTargetId":"fsmt-01234567", "FileSystemId":"fs-01234567", "SubnetId":"subnet-01234567", "LifeCycleState":"added", "IpAddress":"10.0.2.42", "NetworkInterfaceId":"eni-1bcb7772" } ] } ``` ## 以下の資料も参照してください。 言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/DescribeMountTargets) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/DescribeMountTargets) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/DescribeMountTargets) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DescribeMountTargets) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DescribeMountTargets) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/DescribeMountTargets) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/DescribeMountTargets) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DescribeMountTargets) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/DescribeMountTargets) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/DescribeMountTargets)