すべてのプロダクト
Search
ドキュメントセンター

Elastic Compute Service:ModifyNetworkInterfaceAttribute

最終更新日:Oct 29, 2026

Elastic Network Interface (ENI) の属性 (キュー数、関連付けられたセキュリティグループ、キューの深さ、トラフィックモード、インスタンスのリリース時に ENI を保持するかどうか など) を変更します。

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

  • アクション:特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。

  • API:アクションを具体的に実行するための API。

  • アクセスレベル:各 API に対して事前定義されているアクセスの種類。有効な値:create、list、get、update、delete。

  • リソースタイプ:アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。

    • リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。

    • リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。

  • 条件キー:サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。

  • 依存アクション:ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

ecs:ModifyNetworkInterfaceAttribute

update

*NetworkInterface

acs:ecs:{#regionId}:{#accountId}:eni/{#eniId}

*SecurityGroup

acs:ecs:{#regionId}:{#accountId}:securitygroup/{#securitygroupId}

なし なし

リクエストパラメーター

パラメーター

型

必須 / 任意

説明

例

RegionId

string

必須

ネットワークインターフェースのリージョン ID。 DescribeRegions 操作を呼び出して、最新のリージョンリストをクエリできます。

cn-hangzhou

NetworkInterfaceName

string

任意

Elastic Network Interface (ENI) の名前。名前は 2~128 文字で、先頭は英字または中国語の文字とする必要があります。http:// または https:// で始めることはできません。英字、中国語の文字、数字など、Unicode の Letter カテゴリの文字がサポートされています。コロン (:)、アンダースコア (_)、期間 (.)、ハイフン (-) を含めることができます。

デフォルト値: 空。

eniTestName

NetworkInterfaceId

string

必須

ネットワークインターフェースの ID。

eni-bp67acfmxazb4p****

QueueNumber

integer

任意

ENI のキュー数。有効な値: 1~2048。

  • Available 状態の ENI、または Stopped 状態のインスタンスにアタッチされている (InUse) ENI のキュー数を変更できます。

  • ENI のキュー数は、インスタンスタイプで許可されている ENI あたりのキューの最大値を超えることはできません。インスタンスにアタッチされているすべての ENI の合計キュー数は、インスタンスタイプで許可されている合計キュークォータを超えることはできません。 DescribeInstanceTypes 操作を呼び出し、MaximumQueueNumberPerEni パラメーターおよび TotalEniQueueQuantity パラメーターをクエリして、ENI あたりのキューの最大値とインスタンスタイプの合計キュークォータを取得できます。

8

Description

string

任意

ネットワークインターフェースの説明。説明は 2~255 文字で、http:// または https:// で始めることはできません。

デフォルト値: 空。

testDescription

SecurityGroupId

array

任意

セキュリティグループ ID のリスト。セカンダリネットワークインターフェースが指定されたセキュリティグループに追加され、現在のセキュリティグループから削除されます。

  • N の有効値は、各ネットワークインターフェースが参加できるセキュリティグループのクォータによって異なります。詳細については、「使用制限」を参照してください。

  • 変更はすぐに効果がありますが、わずかな遅延が生じる場合があります。

string

任意

セキュリティグループ ID のリスト。

  • N の有効値は、各ネットワークインターフェースが参加できるセキュリティグループのクォータによって異なります。詳細については、「使用制限」を参照してください。

  • セカンダリ ENI のセキュリティグループのみ変更できます。

  • セキュリティグループ設定が適用されると、セカンダリネットワークインターフェースが指定されたセキュリティグループに追加され、現在のセキュリティグループから削除されます。

  • 変更はすぐに効果がありますが、わずかな遅延が生じる場合があります。

sg-bp67acfmxazb4p****

DeleteOnRelease

boolean

任意

インスタンスのリリース時に ENI を保持するかどうかを指定します。有効な値:

  • true: ENI は保持されません。

  • false: ENI は保持されます。

true

RxQueueSize

integer

任意

ネットワークインターフェースのインバウンドキューの深さ。

説明

このパラメーターは招待プレビュー中であり、一般公開されていません。使用する必要がある場合は、チケットを提出してホワイトリストアクセスを申請してください。

以下の項目に注意してください:

  • このパラメーターは、第 7 世代以降の ECS インスタンスタイプにのみ適用されます。

  • このパラメーターは現在、Linux イメージにのみ適用されます。

  • インバウンドキューの深さを大きくすると、インバウンドスループットが向上し、パケット損失レートが低下しますが、より多くのメモリを消費します。

8192

TxQueueSize

integer

任意

ネットワークインターフェースのアウトバウンドキューの深さ。

説明

このパラメーターは招待プレビュー中であり、一般公開されていません。使用する必要がある場合は、チケットを提出してホワイトリストアクセスを申請してください。

以下の項目に注意してください:

  • このパラメーターは、第 7 世代以降の ECS インスタンスタイプにのみ適用されます。

  • このパラメーターは現在、Linux イメージにのみ適用されます。

  • アウトバウンドキューの深さを大きくすると、アウトバウンドスループットが向上し、パケット損失レートが低下しますが、より多くのメモリを消費します。

8192

NetworkInterfaceTrafficConfig

object

任意

ネットワークインターフェースのトラフィックパラメーター。

NetworkInterfaceTrafficMode

string

任意

ネットワークインターフェースのトラフィックパターン。パラメーターの有効な値:

  • 標準: TCP トラフィックパターンを使用します。

  • HighPerformance: Elastic RDMA Interface (ERI) を有効にし、RDMA トラフィックパターンを使用します。

Elastic Network Interface (ENI) がインスタンスにアタッチされている場合、以下の項目に注意してください:

  • インスタンスの RDMA ネットワークインターフェースの合計数は、インスタンスタイプで許可されている RDMA ネットワークインターフェースのクォータを超えることはできません。DescribeInstanceTypes 操作を呼び出し、EriQuantity パラメーターをクエリして、インスタンスタイプの RDMA ネットワークインターフェースのクォータを取得できます。

説明

このパラメーターは招待プレビュー中であり、一般公開されていません。

HighPerformance

QueueNumber

integer

任意

ネットワークインターフェースのキュー数。 Elastic Network Interface (ENI) がインスタンスにアタッチされている場合、以下の項目に注意してください:

  • キュー数は、インスタンスタイプで許可されているネットワークインターフェースあたりのキューの最大値を超えることはできません。

  • インスタンスにアタッチされているすべてのネットワークインターフェースの合計キュー数は、インスタンスタイプで許可されている合計キュークォータを超えることはできません。DescribeInstanceTypes 操作を呼び出し、MaximumQueueNumberPerEni パラメーターおよび TotalEniQueueQuantity パラメーターをクエリして、ネットワークインターフェースあたりのキューの最大値とインスタンスタイプの合計キュークォータを取得できます。

説明

このパラメーターは招待プレビュー中であり、一般公開されていません。

8

QueuePairNumber

integer

任意

RDMA ネットワークインターフェースのキュー数。 Elastic Network Interface (ENI) がインスタンスにアタッチされている場合、以下の項目に注意してください:

  • キュー数は、インスタンスタイプで許可されている RDMA ネットワークインターフェースあたりのキューの最大値を超えることはできません。DescribeInstanceTypes 操作を呼び出し、QueuePairNumber パラメーターをクエリして、インスタンスタイプの RDMA ネットワークインターフェースあたりのキューの最大値を取得できます。

説明

このパラメーターは招待プレビュー中であり、一般公開されていません。

8

RxQueueSize

integer

任意

ネットワークインターフェースのインバウンドキューの深さ。

説明

このパラメーターは招待プレビュー中であり、一般公開されていません。使用する必要がある場合は、チケットを提出してホワイトリストアクセスを申請してください。

以下の項目に注意してください:

  • このパラメーターは、第 7 世代以降の ECS インスタンスタイプにのみ適用されます。

  • このパラメーターは現在、Linux イメージにのみ適用されます。

  • インバウンドキューの深さを大きくすると、インバウンドスループットが向上し、パケット損失レートが低下しますが、より多くのメモリを消費します。

8192

TxQueueSize

integer

任意

ネットワークインターフェースのアウトバウンドキューの深さ。

説明

このパラメーターは招待プレビュー中であり、一般公開されていません。使用する必要がある場合は、チケットを提出してホワイトリストアクセスを申請してください。

以下の項目に注意してください:

  • このパラメーターは、第 7 世代以降の ECS インスタンスタイプにのみ適用されます。

  • このパラメーターは現在、Linux イメージにのみ適用されます。

  • アウトバウンドキューの深さを大きくすると、アウトバウンドスループットが向上し、パケット損失レートが低下しますが、より多くのメモリを消費します。

8192

ConnectionTrackingConfiguration

object

任意

ネットワーク接続性追跡構成情報のコレクション。

このパラメーターを使用する前に、接続タイムアウト管理 の注意深い読み取りを行ってください。

TcpEstablishedTimeout

integer

任意

確立された TCP 接続のタイムアウト期間。単位: 秒。有効な値: 30、60、80、100、200、300、500、700、910。

デフォルト値: 910。

910

TcpClosedAndTimeWaitTimeout

integer

任意

閉じられた TCP 接続および TIME_WAIT 状態の TCP 接続のタイムアウト期間。単位: 秒。有効な値: 3~15 の整数。

デフォルト値: 3。

説明

ECS インスタンスを NLB または CLB インスタンスと併用する場合、TIME_WAIT 状態の接続のデフォルトのタイムアウト期間は 15 秒です。

3

UdpTimeout

integer

任意

UDP フローのタイムアウト期間。単位: 秒。有効な値: 10、20、30、60、80、100。

デフォルト値: 30。

説明

ECS インスタンスを NLB または CLB インスタンスと併用する場合、デフォルト値は 100 秒です。

30

EnhancedNetwork

object

任意

このパラメーターは一般公開されていません。

EnableSriov

boolean

任意

このパラメーターは一般公開されていません。

true

EnableRss

boolean

任意

説明

このパラメーターは一般公開されていません。

false

VirtualFunctionTotalQueueNumber

integer

任意

SR-IOV が有効な場合の仮想関数の合計キュー数。

4

VirtualFunctionQuantity

integer

任意

SR-IOV が有効な場合の仮想関数の数。有効な値: 1~256。

1

EnableExpress

boolean

任意

説明

このパラメーターは一般公開されていません。

SourceDestCheck

boolean

任意

ソース/送信先チェックを有効にするかどうかを指定します。ネットワークセキュリティを向上させるために、この特徴を有効にすることを推奨します。有効な値:

  • true: 有効。

  • false: 無効。

デフォルト値: false。

説明

この特徴は特定のリージョンでのみサポートされています。使用する前に、ソース/送信先チェック の注意深い読み取りを行ってください。

false

EnablePrimaryIPv6

boolean

任意

ネットワークインターフェースのプライマリ IPv6 アドレスを有効にするかどうかを指定します。

レスポンスフィールド

フィールド

型

説明

例

object

リクエスト ID

RequestId

string

リクエスト ID

473469C7-AA6F-4DC5-B3DB-A3DC0DE3****

例

成功レスポンス

JSONJSON

{
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****"
}

エラーコード

HTTP ステータスコード

エラーコード

エラーメッセージ

説明

400 InvalidOperation.NotSupportModifyQueueNumber %s
400 MissingParameter %s 必須パラメーターが指定されていません。
400 UnsupportedParameter %s 指定されたパラメーターはサポートされていません。パラメーターが正しいかどうかを確認してください。
400 InvalidParameter %s 現在のリクエストパラメーターが無効です。もう一度お試しください。
400 InvalidInstanceID.Malformed %s
400 InvalidOperation.InvalidEcsState %s 現在のクラウドサービスのサービスステータスでは、この操作は許可されていません。
400 InvalidOperation.InvalidEniState %s 現在の ENI の状態では、この操作を実行できません。
400 InvalidOperation.DetachPrimaryEniNotAllowed %s インスタンスからプライマリ ENI をデタッチすることはできません。
400 InvalidParams.EniId %s 指定されたパラメーター EniId は無効です。
400 Forbidden.RegionId %s 現在、このリージョンではサービスを利用できません。
400 JoinedGroupLimitExceed %s 指定されたリソースが参加できるセキュリティグループの最大数に達しました。詳細については、エラーメッセージ内の %s プレースホルダーの実際の返却結果を参照してください。
400 InvalidEniQueueSize.RegionOrUserNotSupported The specified parameter RxQueueSize or TxQueueSize is not supported in this region, or this account is not in the whitelist of using eni QueueSize. リージョンまたはユーザーが ENI キューの深さの設定をサポートしていません。
400 InvalidParameter.EniQueueSize The specified parameter TxQueueSize and RxQueueSize are not equal or exceed limit. ENI のアウトバウンドおよびインバウンド方向のキューの深さが等しくないか、有効値を超えています。
400 InvalidParameter.Conflict %s パラメーターが競合しています。
400 InvalidConnectionTrackingConfiguration.RegionOrUserNotSupported The specified parameter ConnectionTrackingConfiguration is not supported in this region, or this account is not in the whitelist of using network interface ConnectionTrackingConfiguration. このリージョンまたはユーザーでは、ENI 接続構成の設定はサポートされていません。
400 InvalidParameter.InvalidQueuePairNumber The specified parameter QueuePairNumber exceeds limit. 指定された RDMA NIC キューの数が上限を超えています。
400 InvalidParameter.EniConnectionTrackingConfiguration The specify network interface connection tracking configuration exceeds limit. ネットワークインターフェースコントローラー (NIC) に指定されたネットワーク接続構成が、許可された範囲を超えています。
400 InvalidOperation.MaxEniQueuePairNumberExceed The QueuePairNumber on the RDMA ENI exceeds the upper limit allowed for a single ENI. Elastic Network Interface (ENI) の RDMA キューの数が、ネットワークインターフェースコントロール (NIC) あたりの最大値を超えています。
400 InvalidOperation.HighPerformanceEniPerInstanceLimitExceeded The number of RDMA ENIs attached to the ECS instance exceeds the upper limit. Elastic Network Interface (ENI) が属する ECS インスタンスにアタッチされている RDMA ネットワークインターフェースコントロール (NIC) の数が上限を超えています。
400 InvalidOperation.InstanceTypeNotSupportHighPerformance The ECS instance type where the ENI is located does not support the RDMA mode. Elastic Network Interface (ENI) がアタッチされている ECS インスタンスの ECS インスタンスタイプは、RDMA 通信モードをサポートしていません。
400 InvalidTrafficMode.ModifyToStandardNotSupported The specified parameter NetworkInterfaceTrafficMode is not supported to modify to Standard. Elastic Network Interface (ENI) の通信モードを標準に変更する操作はサポートされていません。
400 InvalidOperation.EniTrafficModeNotSupportIPv6 The ENI using High Performance traffic mode does not support IPv6.
400 InvalidOperation.EniQueuePairNumberOverflow The RDMA QueuePairNumber of the ECS instance associated with the specified ENI exceeds the limit. 指定された Elastic Network Interface (ENI) がアタッチされている ECS インスタンスの RDMA ネットワークインターフェースコントロール (NIC) キューの数が上限を超えています。
400 InvalidParameter.QueuePairNumberMustEmpty When the traffic mode is set to Standard, the QueuePairNumber must be empty. TCP 通信パターンで Elastic ネットワークインターフェース (ENI) を作成する場合、ネットワークインターフェースコントローラー (NIC) の RDMA パターンキュー数は空である必要があります。
400 InvalidParameter.EniTrafficMode The ENI traffic mode is set incorrectly, it must be either Standard or HighPerformance. ネットワークインターフェースコントローラー (NIC) の通信パターンは無効です。有効な値: Standard、HighPerformance。
400 InvalidOperation.InstanceTypeNotSupportRss The ECS instance type does not support Rss. 指定されたインスタンスのインスタンスタイプでは、RSS の有効化はサポートされていません。
400 InvalidParameter.EniEnhancedNetwork The input parameter "EnhancedNetwork" is illegal, when EnableSriov is true, VirtualFunctionTotalQueueNumber must not be empty, and VirtualFunctionQuantity must be 1 to 256. When EnableSriov is empty or false, VirtualFunctionTotalQueueNumber and VirtualFunctionQuantity must be empty. 指定されたネットワーク強化パラメーターは無効です。EnableSriov が true にセットされている場合、VirtualFunctionTotalQueueNumber は空であってはならず、VirtualFunctionQuantity の数量は 1 から 256 の有効値内である必要があります。EnableSriov が空または false にセットされている場合、VirtualFunctionTotalQueueNumber と VirtualFunctionQuantity は空である必要があります。
400 InvalidOperation.NotSupportModifyVFQueueNumberAndVFQuantity The ENI not support modify VirtualFunctionTotalQueueNumber and VirtualFunctionQuantity when EnableSriov is true. EnableSriov が true にセットされている場合、VirtualFunctionTotalQueueNumber と VirtualFunctionQuantity の数量の変更はサポートされていません。
400 InvalidOperation.TrunkAttachmentMustEmpty The Attachment of the current Trunk type Network Interface must be empty when modify EnableSriov to true. EnableSriov を true に設定する場合、トランク ENI にアタッチされているデバイスは空である必要があります。
400 Throttling Request was denied due to request throttling, try again later. リクエストがスロットルされました。
400 InvalidOperation.SourceDestCheckUnsupported Modifying sourceDestCheck attribute for network interface is not allowed in the %s region. 現在のリージョンでは、ネットワークインターフェース (NIC) の SourceDestCheck プロパティの変更はサポートされていません。
400 InvalidOperation.EnablePrimaryIPv6 The specified ENI can not enable primary IPv6 or already has primary IPv6. 指定された ENI ではプライマリ IPv6 を有効にできないか、既にプライマリ IPv6 アドレスが設定されています。
500 InternalError The request processing has failed due to some unknown error, exception or failure. 内部エラーが発生しました。もう一度お試しください。
403 InvalidUserType.NotSupported %s ユーザータイプが無効です。
403 Abs.InvalidAccount.NotFound %s アカウントが見つからないか、AccessKey は有効期限切れです。
403 Forbidden.NotSupportRAM %s Resource Access Management (RAM) ユーザーによるこの操作の実行はサポートされていません。
403 Forbidden.SubUser %s 現在の RAM ユーザーには、このリソースに対する操作を実行する権限がありません。
403 MaxEniCountExceeded %s ENI の最大数を超えています。
403 EniPerInstanceLimitExceeded %s このインスタンスタイプの ENI の数が上限に達しています。
403 InvalidOperation.AvailabilityZoneMismatch %s ゾーンが一致しないため、この操作は許可されていません。
403 InvalidOperation.VpcMismatch %s この操作は許可されていません。
403 SecurityGroupInstanceLimitExceed %s セキュリティグループ内のインスタンスの最大値に達しました。
403 InvalidSecurityGroupId.NotVpc %s 指定されたセキュリティグループは無効です。
403 InvalidOperation.InvalidEniType %s 現在のネットワークインターフェースタイプでは、この操作は実行できません。
403 InvalidOperation.EniServiceManaged %s 操作は無効です。
403 InvalidOperation.MultiGroupType The specified instance can't join different types of security group. 指定されたインスタンスは、異なるタイプのセキュリティグループに追加できません。
403 InvalidOperation.EniCountExceeded The maximum number of eni in a enterprise level security group is exceeded. 高度セキュリティグループ内の ENI の数が上限に達しています。
403 InvalidParams.NetworkInterfaceName %s
403 InvalidOperation.ModifyPrimaryEniQueueNumber Primary NetworkInterface is not allowed to modify queue number.
403 InvalidOperation.InvalidEniState Available status or ECS instance attached is Stopped is allowed to modify network interface queue number. 現在の ENI の状態では、この操作を実行できません。
403 InvalidOperation.ResourceManagedByCloudProduct %s クラウドサービスのマネージドセキュリティグループは変更操作をサポートしていません。
403 InvalidParameter.InvalidEniQueueNumber %s Elastic Network Interface (ENI) キューの数が正しくありません。詳細については、エラーメッセージ内の %s プレースホルダーの実際の返却結果を参照してください。
403 InvalidOperation.MaxEniQueueNumberExceeded %s Elastic Network Interface (ENI) キューの数が上限を超えています。詳細については、エラーメッセージ内の %s プレースホルダーの実際の返却結果を参照してください。
403 InvalidOperation.ExceedInstanceTypeQueueNumber %s Elastic Network Interface (ENI) キューの合計数が上限を超えています。詳細については、エラーメッセージ内の %s プレースホルダーの実際の返却結果を参照してください。
403 AclLimitExceed %s ENI またはインスタンスのセキュリティグループルールの数がクォータを超えています。
403 InvalidOperation.EniTypeUnsupported The specified eni type does not supported. 指定されたサービスタイプはサポートされていません。
403 InvalidVSwitch.Ipv6NotEnabled The VSwitch of ENI does not support IPv6 feature.
404 InvalidEcsId.NotFound %s インスタンスが無効です。
404 InvalidEniId.NotFound %s
404 InvalidVSwitchId.NotFound %s 指定された vSwitch ID は存在しません。
404 InvalidSecurityGroupId.NotFound %s 指定されたセキュリティグループはアカウント配下に存在しません。セキュリティグループ ID が正しいかどうかを確認してください。
404 InvalidOperation.PrimaryEniOnlySupportModifyNameAndDesc Primary NetworkInterface is only allowed to modify name and description. プライマリ ENI の名前と説明のみ変更できます。
404 InvalidParameter.SecurityGroupIdRepeated The specified security group ids has repeated. 指定されたセキュリティグループはすでに追加されています。SecurityGroupIds パラメーター値が正しいかどうかを確認してください。
409 OperationConflict Request was denied due to conflict with a previous request,please try again later. リクエストの競合が発生しました。しばらく待ってから再試行するか、チケットを提出してください。
409 TokenProcessing The previous token request is still processing. Please try again later.

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。