AttachNetworkInterface
可以指定NetworkInterfaceId、InstanceId、NetworkCardIndex等参数,附加一个弹性网卡(ENI)到一台专有网络VPC类型ECS实例上
服务地址:
华东1 金融云
输入参数
只看必填
RegionId实例所在地域的ID
NetworkInterfaceId弹性网卡ID
InstanceId实例ID
TrunkNetworkInstanceId中继网卡ID
WaitForNetworkConfigurationReady>该参数已废弃
请选择布尔值
NetworkCardIndex网卡指定的物理网卡索引
插件下载了解更多
VS Code 插件
安装插件之前,确保已安装 VS Code安装插件之前,确保已安装 VS Code
Alibaba Cloud Developer Toolkit is a collection of extensions that can help access Alibaba Cloud services in Visual Studio Code.
JetBrains 插件
安装插件之前,确保已安装 JetBrains IDE安装插件之前,确保已安装 JetBrains IDE
The Alibaba Cloud Developer Toolkit for JetBrains makes it easier to access Alibaba Cloud services.

接口说明

调用该接口时,请注意:

  • 弹性网卡必须处于可用Available)状态,一个弹性网卡只能同时附加到一台相同可用区且相同专有网络的实例上。

  • 实例需处于运行中(Running)或者已停止(Stopped)状态,部分实例规格的实例在附加弹性网卡时必须为已停止(Stopped)状态,更多信息,请参见附加弹性网卡中的需要停止实例的 ECS 实例规格章节。

    说明 如果实例最后一次启动时间在 2018 年 4 月 1 日之前(包括但不限于启动新购的实例、重启、重开机),您必须提前调用 RebootInstance 重启一直保持运行中状态的实例,否则无法附加弹性网卡。
  • 一台实例可以同时附加多个弹性网卡,更多信息,请参见弹性网卡概述

  • 弹性网卡所在的交换机必须与实例所在交换机属于同一可用区且同一专有网络 VPC。

  • 该接口为异步接口,调用成功后,您可以通过查询弹性网卡状态或监听网卡操作事件的方式来感知操作结果。 弹性网卡状态机如下图所示:

    • Attaching 说明附加弹性网卡请求发送成功,弹性网卡正在附加到 ECS 实例中。
    • InUse 说明弹性网卡已附加到 ECS 实例。
    • Available 说明弹性网卡附加到 ECS 实例失败。

调用示例详情参见附加弹性网卡

请求参数

字段名称字段详情
RegionIdstring

实例所在地域的 ID。您可以调用 DescribeRegions 查看最新的阿里云地域列表。

示例值:cn-hangzhou参考取值来源:
    DescribeRegions
NetworkInterfaceIdstring

弹性网卡 ID。

示例值:eni-bp17pdijfczax1huji****参考取值来源:
    CreateNetworkInterface
    DescribeNetworkInterfaces
InstanceIdstring

实例 ID。

示例值:i-bp16qstyvxj9gpqw****参考取值来源:
    RunInstances
    StopInstances
    CreateInstance
    StartInstances
    RebootInstances
    DescribeInstances
    ModifyManagedInstance
    RenewReservedInstances
    AttachInstanceRamRole
    DetachInstanceRamRole
    DeregisterManagedInstance
    PurchaseReservedInstancesOffering
TrunkNetworkInstanceIdstring

中继网卡 ID。展开详情

示例值:eni-f8zapqwj1v1j4ia3****
WaitForNetworkConfigurationReadyboolean
说明 该参数已废弃。
示例值:null
NetworkCardIndexinteger<int32>

网卡指定的物理网卡索引。展开详情

示例值:0

返回参数

字段名称字段详情
RequestIdstring

请求 ID。

示例值:473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E
变更历史
暂无变更历史