ModifyNetworkInterfaceAttribute - Elastic Compute Service - Alibaba Cloud ドキュメントセンター

Elastic Network Interface (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	必須	ENI が配置されているリージョンの ID。 DescribeRegions 操作を呼び出して、Alibaba Cloud の最新のリージョンリストを照会できます。	cn-hangzhou
RegionId	string	必須	ENI が配置されているリージョンの ID。 DescribeRegions 操作を呼び出して、Alibaba Cloud の最新のリージョンリストを照会できます。	cn-hangzhou
NetworkInterfaceName	string	任意	ENI の名前。名前の長さは 2～128 文字である必要があります。先頭は英字または中国語文字である必要があり、`http://` または `https://` で始めることはできません。英字、数字、中国語文字、コロン (:)、アンダースコア (_)、ピリオド (.)、ハイフン (-) を使用できます。デフォルト値：空。	eniTestName
NetworkInterfaceId	string	必須	ENI の ID。	eni-bp67acfmxazb4p****
QueueNumber	integer	任意	ENI のキュー数。有効な値：1～2048。 `Available` 状態の ENI、または `Stopped` 状態のインスタンスにアタッチ (`InUse`) されている ENI のキュー数を変更できます。 ENI のキュー数は、インスタンスタイプごとの ENI あたりのキュー数の制限を超えることはできません。インスタンスにアタッチされているすべての ENI のキューの合計数は、インスタンスタイプの合計キュークォータを超えることはできません。DescribeInstanceTypes 操作を呼び出し、`MaximumQueueNumberPerEni` および `TotalEniQueueQuantity` パラメーターの値を確認して、インスタンスタイプの制限を取得できます。	8
Description	string	任意	ENI の説明。説明の長さは 2～255 文字である必要があり、http:// または https:// で始めることはできません。デフォルト値：空。	testDescription
SecurityGroupId	array	任意	1 つ以上のセキュリティグループの ID。指定されたセキュリティグループは、セカンダリネットワークインターフェースに現在関連付けられているセキュリティグループを置き換えます。指定できるセキュリティグループの数はクォータの対象となります。詳細については、「制限事項」をご参照ください。この変更はほぼ即時に有効になりますが、わずかな遅延が発生する場合があります。
	string	任意	セキュリティグループ ID。指定できるセキュリティグループの数は、ENI を関連付けることができるセキュリティグループの数のクォータによって決まります。詳細については、「制限事項」をご参照ください。セキュリティグループは、セカンダリネットワークインターフェースに対してのみ変更できます。このパラメーターを設定すると、セカンダリ ENI は指定されたセキュリティグループに参加し、現在のセキュリティグループから削除されます。この変更はほぼ即時に有効になりますが、わずかな遅延が発生する場合があります。	sg-bp67acfmxazb4p****
DeleteOnRelease	boolean	任意	アタッチされているインスタンスがリリースされるときに ENI をリリースするかどうかを指定します。有効な値： true: ENI はリリースされます。 false: ENI は保持されます。	true
RxQueueSize	integer	任意	ENI の受信 (Rx) キューの深さ。説明このパラメーターはプライベートプレビュー段階です。アクセスをリクエストするには、チケットを送信してください。このパラメーターは、第 7 世代以降の ECS インスタンスタイプにのみ適用されます。このパラメーターは Linux イメージにのみ適用されます。 Rx キューの深さを大きくすると、インバウンドスループットが向上し、パケット損失が減少しますが、より多くのメモリを消費します。	8192
TxQueueSize	integer	任意	ENI の送信 (Tx) キューの深さ。説明このパラメーターはプライベートプレビュー段階です。アクセスをリクエストするには、チケットを送信してください。このパラメーターは、第 7 世代以降の ECS インスタンスタイプにのみ適用されます。このパラメーターは Linux イメージにのみ適用されます。 Tx キューの深さを大きくすると、アウトバウンドスループットが向上し、パケット損失が減少しますが、より多くのメモリを消費します。	8192
NetworkInterfaceTrafficConfig	object	任意	ENI の通信パラメーター。
NetworkInterfaceTrafficMode	string	任意	ENI の通信モード。有効な値： Standard: TCP 通信モードを使用します。 HighPerformance: Elastic RDMA Interface (ERI) 機能を有効にし、RDMA 通信モードを使用します。 ENI が InUse 状態の場合：インスタンス上の ERI 対応 ENI の合計数は、インスタンスタイプの ERI クォータを超えることはできません。DescribeInstanceTypes 操作を呼び出し、EriQuantity パラメーターの値を確認してクォータを取得できます。説明このパラメーターはプライベートプレビュー段階です。	HighPerformance
QueueNumber	integer	任意	ENI のキュー数。ENI が InUse 状態の場合、次の点にご注意ください：キュー数は、インスタンスタイプでサポートされている ENI あたりの最大キュー数を超えることはできません。インスタンスにアタッチされているすべての ENI のキューの合計数は、インスタンスタイプの合計キュークォータを超えることはできません。DescribeInstanceTypes 操作を呼び出し、MaximumQueueNumberPerEni および TotalEniQueueQuantity パラメーターの値を確認して、インスタンスタイプの制限を取得できます。説明このパラメーターはプライベートプレビュー段階です。	8
QueuePairNumber	integer	任意	RDMA 対応 ENI のキュー数。ENI が InUse 状態の場合、次の点にご注意ください：キュー数は、インスタンスタイプでサポートされている単一の RDMA 対応 ENI の最大キュー数を超えることはできません。DescribeInstanceTypes 操作を呼び出し、QueuePairNumber パラメーターの値を確認して制限を取得できます。説明このパラメーターはプライベートプレビュー段階です。	8
RxQueueSize	integer	任意	ENI の受信 (Rx) キューの深さ。説明このパラメーターはプライベートプレビュー段階です。アクセスをリクエストするには、チケットを送信してください。このパラメーターは、第 7 世代以降の ECS インスタンスタイプにのみ適用されます。このパラメーターは Linux イメージにのみ適用されます。 Rx キューの深さを大きくすると、インバウンドスループットが向上し、パケット損失が減少しますが、より多くのメモリを消費します。	8192
TxQueueSize	integer	任意	ENI の送信 (Tx) キューの深さ。説明このパラメーターはプライベートプレビュー段階です。アクセスをリクエストするには、チケットを送信してください。このパラメーターは、第 7 世代以降の ECS インスタンスタイプにのみ適用されます。このパラメーターは Linux イメージにのみ適用されます。 Tx キューの深さを大きくすると、アウトバウンドスループットが向上し、パケット損失が減少しますが、より多くのメモリを消費します。	8192
ConnectionTrackingConfiguration	object	任意	コネクショントラッキングの設定。詳細については、「接続タイムアウト管理」をご参照ください。
TcpEstablishedTimeout	integer	任意	ESTABLISHED 状態の TCP 接続のタイムアウト期間 (秒単位)。有効な値は 30、60、80、100、200、300、500、700、910 です。デフォルト値：910。	910
TcpClosedAndTimeWaitTimeout	integer	任意	FIN-WAIT-2 および TIME-WAIT 状態の TCP 接続のタイムアウト期間 (秒単位)。値は 3～15 の整数である必要があります。デフォルト値：3。説明 ECS インスタンスが Network Load Balancer (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	任意
VirtualFunctionQuantity	integer	任意
SourceDestCheck	boolean	任意	送信元/送信先チェックを有効にするかどうかを指定します。この機能を有効にすると、ネットワークセキュリティが強化されます。有効な値： true: 送信元/送信先チェックを有効にします。 false: 送信元/送信先チェックを無効にします。デフォルト値：false。説明この機能は特定のリージョンでのみ利用可能です。詳細については、「送信元/送信先チェック」をご参照ください。	false

レスポンスフィールド

フィールド	型	説明	例
	object	リクエストに対して返されたデータ。
RequestId	string	リクエストの一意の識別子。	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
400	InvalidOperation.DetachPrimaryEniNotAllowed	%s
400	InvalidParams.EniId	%s
400	Forbidden.RegionId	%s
400	JoinedGroupLimitExceed	%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.
400	InvalidParameter.EniQueueSize	The specified parameter TxQueueSize and RxQueueSize are not equal or exceed limit.
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.
400	InvalidParameter.InvalidQueuePairNumber	The specified parameter QueuePairNumber exceeds limit.
400	InvalidParameter.EniConnectionTrackingConfiguration	The specify network interface connection tracking configuration exceeds limit.
400	InvalidOperation.MaxEniQueuePairNumberExceed	The QueuePairNumber on the RDMA ENI exceeds the upper limit allowed for a single ENI.
400	InvalidOperation.HighPerformanceEniPerInstanceLimitExceeded	The number of RDMA ENIs attached to the ECS instance exceeds the upper limit.
400	InvalidOperation.InstanceTypeNotSupportHighPerformance	The ECS instance type where the ENI is located does not support the RDMA mode.
400	InvalidTrafficMode.ModifyToStandardNotSupported	The specified parameter NetworkInterfaceTrafficMode is not supported to modify to Standard.
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.
400	InvalidParameter.QueuePairNumberMustEmpty	When the traffic mode is set to Standard, the QueuePairNumber must be empty.
400	InvalidParameter.EniTrafficMode	The ENI traffic mode is set incorrectly, it must be either Standard or HighPerformance.
400	InvalidOperation.InstanceTypeNotSupportRss	The ECS instance type does not support 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.
400	InvalidOperation.NotSupportModifyVFQueueNumberAndVFQuantity	The ENI not support modify VirtualFunctionTotalQueueNumber and VirtualFunctionQuantity when EnableSriov is true.
400	InvalidOperation.TrunkAttachmentMustEmpty	The Attachment of the current Trunk type Network Interface must be empty when modify EnableSriov to true.
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.
500	InternalError	The request processing has failed due to some unknown error, exception or failure.
403	InvalidUserType.NotSupported	%s
403	Abs.InvalidAccount.NotFound	%s
403	Forbidden.NotSupportRAM	%s
403	Forbidden.SubUser	%s
403	MaxEniCountExceeded	%s
403	EniPerInstanceLimitExceeded	%s
403	InvalidOperation.AvailabilityZoneMismatch	%s
403	InvalidOperation.VpcMismatch	%s
403	SecurityGroupInstanceLimitExceed	%s
403	InvalidSecurityGroupId.NotVpc	%s	参数SecurityGroupId无效，该安全组的网络类型不是专有网络。
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.
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.
403	InvalidOperation.ResourceManagedByCloudProduct	%s
403	InvalidParameter.InvalidEniQueueNumber	%s
403	InvalidOperation.MaxEniQueueNumberExceeded	%s
403	InvalidOperation.ExceedInstanceTypeQueueNumber	%s
403	AclLimitExceed	%s
403	InvalidOperation.EniTypeUnsupported	The specified eni type does not supported.
404	InvalidEcsId.NotFound	%s
404	InvalidEniId.NotFound	%s
404	InvalidVSwitchId.NotFound	%s
404	InvalidSecurityGroupId.NotFound	%s
404	InvalidOperation.PrimaryEniOnlySupportModifyNameAndDesc	Primary NetworkInterface is only allowed to modify name and description.
404	InvalidParameter.SecurityGroupIdRepeated	The specified security group ids has repeated.

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

変更履歴

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