文档中心

AttachNetworkInterface(为主机添加网卡)

为一个主机实例添加辅网卡

约束条件1:每个主机实例默认拥有主网卡,只能用该接口添加一个辅网卡。

Request Parameters(请求参数)

InstanceId

  • 待添加网卡的实例ID
  • 类型: String
  • 有效值:标准UUID格式,形如^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$
  • 是否可缺省: 否

SecurityGroupId.N

  • 实例绑定的安全组集合(只识别第一个数组成员)
  • 类型: String列表
  • 有效值:标准UUID格式,形如^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$
  • 是否可缺省: 否

SubnetId

  • 新的子网ID
  • 类型: String
  • 有效值:标准UUID格式,形如^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$
  • 是否可缺省: 否

PrivateIpAddress

  • 私有IP地址,新的子网IP地址范围内的任意有效值,只有在更改子网时可同步设置此参数,如果在更改子网时未指定该参数,系统自动从新的子网有效地址池中随机选取一个
  • 类型: String
  • 有效值:标准IP地址格式
  • 是否可缺省: 是

Response Elements(返回值)

RequestId

  • 请求ID
  • 类型: String
  • 是否可缺省: 否

Return

  • 返回状态
  • 类型: Bool
  • 是否可缺省: 否

Examples(例子)

Sample Request(请求)
http://kec.api.ksyun.com/?Action=AttachNetworkInterface&Version=2016-03-04
&InstanceId=98284100-f6d1-4bbf-886a-1b0765024738
&SubnetId=4d68d87b-5cbb-4b1a-b761-562ecaf143d6
&SecurityGroupId.1=d386fa74-4bcc-4bf9-bb67-3f0e7cb3d50b
&PrivateIpAddress=10.0.0.1
Sample Response(返回)
<?xml version="1.0" encoding="UTF-8"?>
<AttachNetworkInterface Response xmlns="http://vm.ksyun.com/doc/2016-3-09/">
   <RequestId>be000708-ceb5-4313-af1c-1e88c30db865</RequestId>
   <Return>true</Return>
</AttachNetworkInterface Response>