Elastic Network Interface (ENI) を VPC 接続の ECS インスタンスにアタッチします。NetworkInterfaceId、InstanceId、NetworkCardIndex などのパラメーターを指定できます。
操作説明
この操作を呼び出す際は、以下の項目に注意してください:
-
ENI は Available (
Available) ステータスである必要があります。ENI は、同じゾーンおよび VPC に存在する 1 つのインスタンスにのみアタッチできます。 -
ECS インスタンスは Running または Stopped ステータスである必要があります。一部の ECS インスタンスタイプでは、ENI をアタッチする際に ECS インスタンスが Stopped ステータスである必要があります。詳細については、ENI のアタッチの ECS インスタンスの停止が必要な ECS インスタンスタイプに関するセクションを参照してください。
説明インスタンスが 2018 年 4 月 1 日より前に最後に起動された場合(新規購入インスタンスの起動、再起動、電源オンを含むがこれに限定されない)、RebootInstance を呼び出して Running ステータスのインスタンスを再起動する必要があります。そうしないと、ENI をアタッチできません。
-
1 つのインスタンスに複数の ENI を同時にアタッチできます。詳細については、ENI の概要を参照してください。
-
ENI が属する vSwitch は、インスタンスと同じゾーンおよび VPC に存在する必要があります。
-
これは非同期操作です。呼び出しが成功した後、ENI のステータスを確認するか、ENI の操作イベントをリッスンして結果を取得できます。ENI の状態機械は以下の図のとおりです:

Attaching は、ENI のアタッチリクエストが正常に送信され、ENI が ECS インスタンスにアタッチ中であることを示します。
InUse は、ENI が ECS インスタンスにアタッチされたことを示します。
Available は、ENI の ECS インスタンスへのアタッチが失敗したことを示します。
詳細については、ENI のアタッチを参照してください。
今すぐお試しください
テスト
RAM 認証
|
アクション |
アクセスレベル |
リソースタイプ |
条件キー |
依存アクション |
|
ecs:AttachNetworkInterface |
update |
*NetworkInterface
*Instance
|
なし | なし |
リクエストパラメーター
|
パラメーター |
型 |
必須 / 任意 |
説明 |
例 |
| RegionId |
string |
必須 |
インスタンスのリージョン ID。 DescribeRegions を呼び出して、最新のリージョンリストをクエリできます。 |
cn-hangzhou |
| NetworkInterfaceId |
string |
必須 |
ENI の ID。 |
eni-bp17pdijfczax1huji**** |
| InstanceId |
string |
必須 |
インスタンスの ID。 |
i-bp16qstyvxj9gpqw**** |
| TrunkNetworkInstanceId |
string |
任意 |
トランク ENI の ID。 説明
このパラメーターはまだ利用できません。 |
eni-f8zapqwj1v1j4ia3**** |
| WaitForNetworkConfigurationReady |
boolean |
任意 |
説明
このパラメーターは非推奨です。 |
null |
| NetworkCardIndex |
integer |
任意 |
ENI に指定するネットワークカードのインデックス。 説明
NetworkCardIndex の有効な値はインスタンスファミリーによって異なります。インスタンスタイプがネットワークカードをサポートしていない場合、このパラメーターは指定できません。インスタンスタイプがネットワークカードをサポートしている場合、有効な値についてはインスタンスファミリーを参照してください。 |
0 |
レスポンスフィールド
|
フィールド |
型 |
説明 |
例 |
|
object |
|||
| RequestId |
string |
リクエスト ID |
473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E |
例
成功レスポンス
JSONJSON
{
"RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
}
エラーコード
|
HTTP ステータスコード |
エラーコード |
エラーメッセージ |
説明 |
|---|---|---|---|
| 400 | MissingParameter | %s | |
| 400 | UnsupportedParameter | %s | |
| 400 | InvalidParameter | %s | |
| 400 | InvalidInstanceID.Malformed | %s | |
| 400 | InvalidOperation.InvalidRegion | %s | |
| 400 | InvalidOperation.InvalidEcsState | %s | |
| 400 | InvalidOperation.InvalidEniState | %s | |
| 400 | InvalidOperation.DetachPrimaryEniNotAllowed | %s | |
| 400 | Forbidden.RegionId | %s | |
| 400 | InvalidOperation.InvalidGeneration | %s | |
| 400 | InvalidParams.EniId | %s | |
| 400 | InvalidOperation.UserNotSupportNetworkCard | User not support network card. | |
| 400 | InvalidOperation.ConnectionTrackingConfigNotSupportMemberEni | Member eni not support ConnectionTrackingConfiguration. | |
| 400 | InvalidParameter.NetworkCardIndexInvalid | The network card index is invalid or the current ECS/ENI type does not support the value. | |
| 400 | InvalidOperation.InstanceTypeNotSupportRss | The ECS instance type does not support Rss. | |
| 400 | OperationDenied.NoEniStock | The requested resource of ENI is insufficient in the specified ECS, please retry or upgrade to enterprise-level computing instance types. | |
| 400 | InvalidOperation.InstanceTypeNotSupportSriov | The specified instance type does not support ENI Sriov. | |
| 500 | InternalError | The request processing has failed due to some unknown error, exception or failure. | |
| 500 | InvalidSecurityGroupId.EniMustHaveSecurityGroup | The specified network card does not have an associated security group. | |
| 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 | InvalidInstanceId.NotFound | %s | |
| 403 | InvalidEni.NotSameVpc | %s | |
| 403 | InvalidOperation.Ipv4CountExceeded | %s | |
| 403 | InvalidOperation.EniServiceManaged | %s | |
| 403 | InvalidOperation.MultiGroupType | The specified instance can't join different types of security group. | |
| 403 | InvalidOperation.NotSupportEnterpriseGroup | The specified instance type doesn't support enterprise level security group. | |
| 403 | InvalidOperation.EniCountExceeded | The maximum number of eni in a enterprise level security group is exceeded. | |
| 403 | InvalidOperation.EipBindModel | %s | |
| 403 | InvalidOperation.Ipv6NotSupport | %s | |
| 403 | InvalidOperation.HotPlugNotSupport | %s | |
| 403 | InvalidInstance.NetworkType | %s | |
| 403 | InvalidOperation.InvalidTrunkEniStatus | %s | |
| 403 | InvalidOperation.TrunkingIsNotAllowed | %s | |
| 403 | InvalidOperation.InstanceTypeNotSupportEniTrunking | %s | |
| 403 | InvalidOperation.EniTypeNotSupportTrunking | %s | |
| 403 | InvalidOperation.EniTrunkDeviceFull | %s | |
| 403 | InvalidParameter.EniNotBelongTrunk | %s | |
| 403 | InvalidOperation.EniTypeNotSupportAttachToTrunk | %s | |
| 403 | InvalidParameter.EniNotBelongEcs | %s | |
| 403 | InvalidParameter.InvalidEniQueueNumber | %s | |
| 403 | InvalidOperation.MaxEniQueueNumberExceeded | %s | |
| 403 | InvalidOperation.ExceedInstanceTypeQueueNumber | %s | |
| 403 | InvalidOperation.HighPerformanceTrafficModeNotSupportTrunkEni | %s | |
| 403 | InvalidOperation.HighPerformanceTrafficModeNotSupportMemberEni | %s | |
| 403 | InvalidOperation.InstanceTypeNotSupportHighPerformanceTrafficMode | %s | |
| 403 | InvalidOperation.EniTrafficModeNotSupportIpv6 | %s | |
| 403 | InvalidOperation.MaxEniQueuePairNumberExceed | %s | |
| 403 | InvalidParameter.InvalidQueuePairNumber | %s | |
| 403 | InvalidOperation.EniQueuePairNumberOverflow | %s | |
| 403 | InvalidOperation.HighPerformanceEniPerInstanceLimitExceeded | %s | |
| 403 | InvalidOperation.Ipv6CountExceeded | %s. | |
| 403 | InvalidOperation.PrimaryEniNotExist | Primary Eni Not Exist. | |
| 404 | InvalidEcsId.NotFound | %s | |
| 404 | InvalidEniId.NotFound | %s | |
| 404 | InvalidVSwitchId.NotFound | %s | |
| 404 | InvalidSecurityGroupId.NotFound | %s |
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。