edit-icon download-icon

ModifyNetworkInterfaceAttribute

最終更新日: Aug 01, 2018

この API を呼び出すことで、ENI(Elastic Network Interface)の属性を変更できます。毎回 1 つの ENI の属性のみを変更することができます。

リクエストパラメータ

名前 必須かどうか 説明
Action String はい インタフェースの名前。値: ModifyNetworkInterfaceAttribute
RegionId String はい インスタンスのリージョン ID。
NetworkInterfaceId String いいえ ENI ID。
SecurityGroupId.N String いいえ セキュリティグループの ID。新しいセキュリティグループは以前のものに置き換わり、セキュリティグループはENIと同じ VPC になる必要です。
NetworkInterfaceName String いいえ ENI 名。
  • [2,128] 漢字または英文字の文字列です。大文字/小文字または漢字で始まり、数字、アンダースコア(_)、ハイフン( - )を含めることができます。
  • ENI がコンソールに表示されます。
  • http:// または https:// で始めることはできません。
  • このパラメーターを指定しないと、デフォルトでは NULL になります。
Description String いいえ ENI の説明。
  • [2,256] の漢字または英文字の文字列です。
  • http:// または https:// で始めることはできません。
  • このパラメーターを指定しないと、デフォルトでは NULL になります。

リターンパラメータ

すべてが共通の応答パラメータです。詳細については、パブリックパラメータを参照してください。

リクエストの例

  1. https://ecs.aliyuncs.com/?Action=ModifyNetworkInterfaceAttribute
  2. &RegionId=cn-hangzhou
  3. &NetworkInterfaceId=[networkInterfaceId]
  4. &<Common Request Parameters>

リスポンスの例

XML 形式

  1. <DetachNetworkInterfaceResponse>
  2. <RequestId>04F0F334-1335-436C-A1D7-6C044FExxxxx</RequestId>
  3. </DetachNetworkInterfaceResponse>

JSON 形式

  1. {
  2. "RequestId": "04F0F334-1335-436C-A1D7-6C044FExxxxx",
  3. }

エラーコード

このインタフェースに固有のエラーコードは次のとおりです。 その他のエラーコードについては、API エラーコードセンターをご参照ください。

エラーコード エラーメッセージ HTTP ステータスコード 意味
Abs.InvalidAccount.NotFound アカウントが見つからないか、ak が期限切れです。 403 指定された Alibaba Cloud アカウントは存在しません。または、AccessKey の有効期限が切れています。
Forbidden.NotSupportRAM このアクションは、RAM モードではアクセスできません。 403 RAM ユーザーは、リソースへのアクセスに制限されています。
UnsupportedParameter パラメータはサポートされていません。 400 指定されたパラメータは存在しません。あるいは、指定されたパラメータはサポートされていません。
Forbidden.SubUser 指定された操作は使用できません。 403 RAM ユーザーは、リソースへのアクセスに制限されています。
MissingParameter この要求を処理するために必須の入力パラメーターは指定されていません。 400 必要なパラメーターを指定する必要があります。
InvalidVSwitchId.NotFound 指定された VSwitchId が見つかりません。 404 指定された VSwitchId は存在しません。
InvalidSecurityGroupId.NotFound 指定された SecurityGroupId が見つかりません。 404 指定された SecurityGroupId は存在しません。
InvalidOperation.AvailabilityZoneMismatch 指定された ENI および ECS インスタンスの VPC VS スイッチは、同じアベイラビリティゾーンにありません。 403 指定された VSwitchId、ENI、およびInstanceId は同じゾーンにありません。
InvalidOperation.VpcMismatch 指定された ENI とセキュリティグループの VPC が同じ VPC にありません。 403 指定された ENI と SecurityGroupId は同じ VPC にありません。
SecurityGroupInstanceLimitExceed セキュリティグループ内のインスタンスの最大数を超えています。 403 指定した SecurityGroupId のインスタンスの最大数を超えています。
InvalidSecurityGroupId.NotVpc 指定された SecurityGroupId は VPC にありません。 403 指定された SecurityGroupId は VPC にありません。
InvalidOperation.InvalidEniType この操作は、現在の ENI タイプでは許可されていません。 403 指定されたアクションは ENI のタイプのため失敗しました。