DescribeMountTargets - Amazon Elastic File System
リクエストの構文URI リクエストパラメータリクエストボディレスポンスの構文レスポンス要素エラー例以下の資料も参照してください。

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

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

レスポンス要素

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

次のデータは、 サービスによって 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"
      }
   ]
}

以下の資料も参照してください。

言語固有の のいずれかAPIでこれを使用する方法の詳細については AWS SDKs、以下を参照してください。