翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
DescribeMountTargetSecurityGroups
マウントターゲットに対して現在有効なセキュリティグループを返します。このオペレーションには、マウントターゲットのネットワークインターフェースが作成されており、マウントターゲットのライフサイクル状態が deleted でないことが必要です。
このオペレーションには、次のアクションに対する許可が必要です。
-
マウントターゲットのファイルシステム上での
elasticfilesystem:DescribeMountTargetSecurityGroupsアクション。 -
マウントターゲットのネットワークインターフェース上での
ec2:DescribeNetworkInterfaceAttributeアクション。
リクエストの構文
GET /2015-02-01/mount-targets/MountTargetId/security-groups HTTP/1.1
URI リクエストパラメータ
リクエストでは、次の URI パラメータを使用します。
- MountTargetId
-
取得するセキュリティグループがあるマウントターゲットの ID。
長さの制限: 最小長は 13 です。最大長は 45 です。
Pattern:
^fsmt-[0-9a-f]{8,40}$必須: はい
リクエストボディ
リクエストにリクエスト本文がありません。
レスポンスの構文
HTTP/1.1 200
Content-type: application/json
{
"SecurityGroups": [ "string" ]
}レスポンス要素
アクションが成功すると、サービスは HTTP 200 レスポンスを返します。
サービスから以下のデータが JSON 形式で返されます。
- SecurityGroups
-
セキュリティグループの配列。
型: 文字列の配列
配列メンバー: 最大数は 100 項目です。
長さの制限: 最小長は 11 です。最大長は 43 です。
パターン：
^sg-[0-9a-f]{8,40}
エラー
- BadRequest
-
リクエストの形式が正しくない場合や、無効なパラメータ値や必須パラメータの欠落などのエラーが含まれている場合に返されます。
HTTP ステータスコード：400
- IncorrectMountTargetState
-
マウントターゲットがオペレーションで正しい状態でない場合に返されます。
HTTP ステータスコード: 409
- InternalServerError
-
サーバー側でエラーが発生した場合に返されます。
HTTP ステータスコード：500
- MountTargetNotFound
-
指定された ID のマウントターゲットが発信者の AWS アカウント で見つからない場合に返されます。
HTTP ステータスコード: 404
例
ファイルシステムに有効なセキュリティグループを取得
次の例では、マウントターゲットに関連付けられたネットワーク インターフェイスに有効なセキュリティグループを取得します。
リクエスト例
GET /2015-02-01/mount-targets/fsmt-9a13661e/security-groups HTTP/1.1
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20140620T223513Z
Authorization: <...>レスポンス例
HTTP/1.1 200 OK
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef
Content-Length: 57
{
"SecurityGroups" : [
"sg-188d9f74"
]
}以下の資料も参照してください。
言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
