翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
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
-
VPC セキュリティグループ IDsの配列。
型: 文字列の配列
配列メンバー: 最大数は 100 項目です。
長さの制限: 最小長は 11 です。最大長は 43 です。
パターン:
^sg-[0-9a-f]{8,40}必須: いいえ
レスポンスの構文
HTTP/1.1 204
レスポンス要素
アクションが成功した場合、サービスは空の HTTP 本文を持つ HTTP 204 レスポンスを返します。
エラー
- BadRequest
-
リクエストの形式が正しくない場合や、無効なパラメータ値や必須パラメータの欠落などのエラーが含まれている場合に返されます。
- ErrorCode
-
エラーコードは、エラー状態を個別に識別する文字列です。エラーを検出してタイプ別に処理するプログラムによって読み取りおよび解釈されるためのものです。
- Message
-
エラーメッセージには、エラー状態の一般的な説明が英語で含まれます。これは人が理解できるようにするためのものです。シンプルなプログラムの場合、処理できない、または処理されないエラー状態が発生すると、メッセージがエンドユーザーに直接表示されます。より徹底したエラー処理を備え、適切に国際化されている洗練されたプログラムでは、エラーメッセージが無視される傾向にあります。
HTTP ステータスコード: 400
- IncorrectMountTargetState
-
マウントターゲットがオペレーションで正しい状態でない場合に返されます。
- ErrorCode
-
エラーコードは、エラー状態を個別に識別する文字列です。エラーを検出してタイプ別に処理するプログラムによって読み取りおよび解釈されるためのものです。
- Message
-
エラーメッセージには、エラー状態の一般的な説明が英語で含まれます。これは人が理解できるようにするためのものです。シンプルなプログラムの場合、処理できない、または処理されないエラー状態が発生すると、メッセージがエンドユーザーに直接表示されます。より徹底したエラー処理を備え、適切に国際化されている洗練されたプログラムでは、エラーメッセージが無視される傾向にあります。
HTTP ステータスコード: 409
- InternalServerError
-
サーバー側でエラーが発生した場合に返されます。
- ErrorCode
-
エラーコードは、エラー状態を個別に識別する文字列です。エラーを検出してタイプ別に処理するプログラムによって読み取りおよび解釈されるためのものです。
- Message
-
エラーメッセージには、エラー状態の一般的な説明が英語で含まれます。これは人が理解できるようにするためのものです。シンプルなプログラムの場合、処理できない、または処理されないエラー状態が発生すると、メッセージがエンドユーザーに直接表示されます。より徹底したエラー処理を備え、適切に国際化されている洗練されたプログラムでは、エラーメッセージが無視される傾向にあります。
HTTP ステータスコード: 500
- MountTargetNotFound
-
指定された ID のマウントターゲットが発信者の AWS アカウントで見つからない場合に返されます。
- ErrorCode
-
エラーコードは、エラー状態を個別に識別する文字列です。エラーを検出してタイプ別に処理するプログラムによって読み取りおよび解釈されるためのものです。
- Message
-
エラーメッセージには、エラー状態の一般的な説明が英語で含まれます。これは人が理解できるようにするためのものです。シンプルなプログラムの場合、処理できない、または処理されないエラー状態が発生すると、メッセージがエンドユーザーに直接表示されます。より徹底したエラー処理を備え、適切に国際化されている洗練されたプログラムでは、エラーメッセージが無視される傾向にあります。
HTTP ステータスコード: 404
- SecurityGroupLimitExceeded
-
リクエストで
SecurityGroups指定された の数が、アカウントクォータに基づく制限より大きい場合に返されます。一部のセキュリティグループを削除するか、アカウントクォータの引き上げをリクエストします。詳細については、「Amazon VPC ユーザーガイド」の「Amazon VPC クォータ」を参照してください (セキュリティグループの表を参照）。- ErrorCode
-
エラーコードは、エラー状態を個別に識別する文字列です。エラーを検出してタイプ別に処理するプログラムによって読み取りおよび解釈されるためのものです。
- Message
-
エラーメッセージには、エラー状態の一般的な説明が英語で含まれます。これは人が理解できるようにするためのものです。シンプルなプログラムの場合、処理できない、または処理されないエラー状態が発生すると、メッセージがエンドユーザーに直接表示されます。より徹底したエラー処理を備え、適切に国際化されている洗練されたプログラムでは、エラーメッセージが無視される傾向にあります。
HTTP ステータスコード: 400
- SecurityGroupNotFound
-
指定したセキュリティグループの 1 つがサブネットの仮想プライベートクラウド (VPC) に存在しない場合に返されます。
- ErrorCode
-
エラーコードは、エラー状態を個別に識別する文字列です。エラーを検出してタイプ別に処理するプログラムによって読み取りおよび解釈されるためのものです。
- Message
-
エラーメッセージには、エラー状態の一般的な説明が英語で含まれます。これは人が理解できるようにするためのものです。シンプルなプログラムの場合、処理できない、または処理されないエラー状態が発生すると、メッセージがエンドユーザーに直接表示されます。より徹底したエラー処理を備え、適切に国際化されている洗練されたプログラムでは、エラーメッセージが無視される傾向にあります。
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以下の資料も参照してください。
言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
