DescribeMountTargets - Amazon Elastic File System

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

DescribeMountTargets

ファイルシステムのすべての現在のマウントターゲット、または特定のマウントターゲットの説明を返します。現在のマウント・ターゲットをすべてリクエストする場合、応答で返されるマウント・ターゲットの順序は指定されていません。

このオペレーションには、FileSystemId で指定したファイルシステム ID 、または MountTargetId で指定したマウントターゲットのファイルシステムのいずれかで、elasticfilesystem:DescribeMountTargets のアクションに対する許可が必要です。

リクエストの構文

GET /2015-02-01/mount-targets?AccessPointId=AccessPointId&FileSystemId=FileSystemId&Marker=Marker&MaxItems=MaxItems&MountTargetId=MountTargetId HTTP/1.1

URI リクエストパラメータ

リクエストでは、次の URI パラメータを使用します。

AccessPointId

(オプション) リスト表示するマウントターゲットがあるアクセスポイントの 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

(オプション)マウントターゲットをリストするファイルシステムの 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

(オプション) 前の DescribeMountTargets オペレーション (文字列)から返された不透明なページ割りトークン。存在する場合は、前回のコールが中断された場所からリストを続行するように指定します。

長さの制限:最小長は 1 です。最大長は 128 です。

パターン: .+

MaxItems

(オプション) 応答で返すマウントターゲットの最大数。現在、この数値は自動的に 10 に設定され、その他の値は無視されます。100 を超えるマウントターゲットがある場合、レスポンスはページあたり 100 でページ割りされます。

有効な範囲: 最小値 は 1 です。

MountTargetId

(オプション) 説明するマウントターゲットの 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", "LifeCycleState": "string", "MountTargetId": "string", "NetworkInterfaceId": "string", "OwnerId": "string", "SubnetId": "string", "VpcId": "string" } ], "NextMarker": "string" }

レスポンス要素

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

サービスから以下のデータが JSON 形式で返されます。

Marker

リクエストに Marker が含まれていた場合、応答はこのフィールドにその値を返します。

型: 文字列

長さの制限: 最小長は 1 です。最大長は 128 です。

パターン: .+

MountTargets

ファイルシステムのマウントターゲットを MountTargetDescription オブジェクトの配列として返します。

型: MountTargetDescription オブジェクトの配列

NextMarker

値が存在する場合、返されるマウントターゲットがさらに多くなります。後続のリクエストでは、この値を使ってリクエストに Marker を指定することで、次のマウントターゲットの設定を取得することができます。

型: 文字列

長さの制限: 最小長は 1 です。最大長は 128 です。

パターン:.+

エラー

AccessPointNotFound

指定された AccessPointId の値がリクエスタの AWS アカウント に存在しない場合に返されます。

HTTP ステータスコード: 404

BadRequest

リクエストの形式が正しくない場合や、無効なパラメータ値や必須パラメータがないなどのエラーが含まれている場合に返されます。

HTTP ステータスコード:400

FileSystemNotFound

指定された FileSystemId の値がリクエスタの AWS アカウント に存在しない場合に返されます。

HTTP ステータスコード: 404

InternalServerError

サーバー側でエラーが発生した場合に返されます。

HTTP ステータスコード:500

MountTargetNotFound

指定された ID のマウントターゲットが発信者の AWS アカウント で見つからない場合に返されます。

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 SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。