ModifyMountTargetSecurityGroups - Amazon Elastic File System

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

ModifyMountTargetSecurityGroups

マウントターゲットに対して有効なセキュリティグループの設定を変更します。

マウントターゲットを作成すると、Amazon は新しいネットワークインターフェイスEFSも作成します。詳細については、「CreateMountTarget」を参照してください。このオペレーションでは、マウントターゲットに関連するネットワークインターフェースに有効なセキュリティグループを、リクエストで指定された SecurityGroups に置き換えます。このオペレーションには、マウントターゲットのネットワークインターフェースが作成されており、マウントターゲットのライフサイクル状態が deleted でないことが必要です。

このオペレーションには、次のアクションに対する許可が必要です。

  • マウントターゲットのファイルシステム上での elasticfilesystem:ModifyMountTargetSecurityGroups アクション。

  • マウントターゲットのネットワークインターフェース上での ec2:ModifyNetworkInterfaceAttribute アクション。

リクエストの構文

PUT /2015-02-01/mount-targets/MountTargetId/security-groups HTTP/1.1 Content-type: application/json { "SecurityGroups": [ "string" ] }

URI リクエストパラメータ

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

MountTargetId

変更するセキュリティグループがあるマウントターゲットの ID。

長さの制限: 最小長は 13 です。最大長は 45 です。

パターン:^fsmt-[0-9a-f]{8,40}$

必須: はい

リクエストボディ

リクエストは、 JSON形式の次のデータを受け入れます。

SecurityGroups

最大 5 つのVPCセキュリティグループ の配列IDs。

タイプ:文字列の配列

配列メンバー: 最大数は 100 項目です。

長さの制限: 最小長は 11 です。最大長は 43 です。

Pattern: ^sg-[0-9a-f]{8,40}

必須:いいえ

レスポンスの構文

HTTP/1.1 204

レスポンス要素

アクションが成功すると、サービスは空のHTTP本文を含む HTTP 204 レスポンスを返します。

エラー

BadRequest

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

HTTP ステータスコード: 400

IncorrectMountTargetState

マウントターゲットがオペレーションで正しい状態でない場合に返されます。

HTTP ステータスコード: 409

InternalServerError

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

HTTP ステータスコード: 500

MountTargetNotFound

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

HTTP ステータスコード: 404

SecurityGroupLimitExceeded

リクエストで指定された SecurityGroups のサイズが 5 より大きい場合に返されます。

HTTP ステータスコード: 400

SecurityGroupNotFound

指定されたセキュリティグループの 1 つがサブネットの仮想プライベートクラウド () に存在しない場合に返されますVPC。

HTTP ステータスコード: 400

マウントターゲットのセキュリティグループを置き換える

次の例では、マウントターゲットに関連付けられたネットワーク インターフェイスに有効なセキュリティグループを置き換えます。

リクエスト例

PUT /2015-02-01/mount-targets/fsmt-9a13661e/security-groups HTTP/1.1 Host: elasticfilesystem.us-west-2.amazonaws.com x-amz-date: 20140620T223446Z Authorization: <...> Content-Type: application/json Content-Length: 57 { "SecurityGroups" : [ "sg-188d9f74" ] }

レスポンス例

HTTP/1.1 204 No Content x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef

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

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