CreateNetworkInterface
処理概要
追加NICを新規作成します。1回のリクエストで、1つの追加NICを作成できます。
追加NICの作成には時間がかかることがあります。このAPIのレスポンス「status」を確認し「processing」が返ってきた、またはタイムアウトした場合はAPI「DescribeNetworkInterfaces」のレスポンス値「status」で追加NICのステータスを確認できます。
APIのパラメーター「NiftyNetworkId」の指定できるのは、プライベートLANのネットワークユニークIDです。
指定するパラメーター
パラメーター | 型 | 説明 | 必須 | ||||
---|---|---|---|---|---|---|---|
NiftyNetworkId | string |
ネットワークユニークID |
○ | ||||
IpAddress | string |
IPアドレス
使用可能文字: IPアドレス、static(手動化) |
|||||
Placement.AvailabilityZone | string |
ゾーン情報 Default: ニフクラが決定 |
|||||
Description | string |
メモ情報 |
応答フィールド
フィールド (項目) | 型 | 説明 |
---|---|---|
CreateNetworkInterfaceResponse | - |
CreateNetworkInterface レスポンス Ancestor: なし Children: requestId | return | networkInterface |
requestId | string |
リクエスト識別子 Ancestor: CreateNetworkInterfaceResponse Children: なし |
return | boolean |
処理ステータス 値:
Children: なし |
networkInterface | - |
ネットワークインターフェースの情報 Ancestor: CreateNetworkInterfaceResponse Children: association | attachment | availabilityZone | description | groupSet | interfaceType | ipv6AddressesSet | macAddress | networkInterfaceId | ownerId | privateDnsName | privateIpAddress | privateIpAddressV6 | privateIpAddressesSet | requesterId | requesterManaged | sourceDestCheck | status | subnetId | tagSet | vpcId | niftyNetworkId | niftyNetworkName |
association | - |
付替IPの関連付け情報 Ancestor: networkInterface Children: allocationId | associationId | ipOwnerId | publicDnsName | publicIp | publicIpV6 |
allocationId | string |
※空を返却 Ancestor: association Children: なし |
associationId | string |
※空を返却 Ancestor: association Children: なし |
ipOwnerId | string |
※空を返却 Ancestor: association Children: なし |
publicDnsName | string |
※空を返却 Ancestor: association Children: なし |
publicIp | string |
※空を返却 Ancestor: association Children: なし |
publicIpV6 | string |
※空を返却 Ancestor: association Children: なし |
attachment | - |
サーバーへの割り当て情報 Ancestor: networkInterface Children: attachmentId | attachTime | deleteOnTermination | deviceIndex | instanceId | instanceOwnerId | status |
attachmentId | string |
アタッチメントID ※空を返却 Ancestor: attachment Children: なし |
attachTime | timestamp |
サーバーへの接続時刻 ※空を返却 Ancestor: attachment Children: なし |
deleteOnTermination | boolean |
※空を返却 Ancestor: attachment Children: なし |
deviceIndex | integer |
デバイス番号 ※空を返却 Ancestor: attachment Children: なし |
instanceId | string |
サーバー名 ※空を返却 Ancestor: item Children: なし |
instanceOwnerId | string |
※空を返却 Ancestor: attachment Children: なし |
status | string |
ネットワークインターフェースのステータス ※空を返却 Ancestor: attachment Children: なし |
availabilityZone | string |
ゾーン情報 Ancestor: networkInterface Children: なし |
description | string |
メモ情報(CDATA付) Ancestor: networkInterface Children: なし |
groupSet | - |
ファイアウォール情報セット Ancestor: networkInterface Children: item |
item | - |
ファイアウォール情報 Ancestor: groupSet Children: groupId |
groupId | string |
ファイアウォールグループ名 ※空を返却 Ancestor: item Children: なし |
interfaceType | string |
ネットワークインターフェースタイプ Ancestor: networkInterface Children: なし |
ipv6AddressesSet | - |
グローバルIPアドレス(IPv6)情報セット Ancestor: networkInterface Children: item |
item | - |
グローバルIPアドレス(IPv6)情報 Ancestor: ipv6AddressesSet Children: ipv6Address |
ipv6Address | string |
※空を返却 Ancestor: item Children: なし |
macAddress | string |
MACアドレス ※空を返却 Ancestor: networkInterface Children: なし |
networkInterfaceId | string |
ネットワークインターフェースID Ancestor: networkInterface Children: なし |
ownerId | string |
※空を返却 Ancestor: networkInterface Children: なし |
privateDnsName | string |
※空を返却 Ancestor: networkInterface Children: なし |
privateIpAddress | string |
プライベートIPアドレス Ancestor: networkInterface Children: なし |
privateIpAddressV6 | string |
プライベートIPアドレス(IPv6) ※空を返却 Ancestor: networkInterface Children: なし |
privateIpAddressesSet | - |
プライベートIPアドレス(IPv4)情報セット Ancestor: networkInterface Children: item |
item | - |
プライベートIPアドレス(IPv4)情報 Ancestor: privateIpAddressesSet Children: association | primary | privateDnsName | privateIpAddress |
association | - |
プライベートIPアドレス(IPv4)のネットワークインターフェース関連付け情報 Ancestor: item Children: allocationId | associationId | ipOwnerId | publicDnsName | publicIp | publicIpV6 |
allocationId | string |
※空を返却 Ancestor: association Children: なし |
associationId | string |
※空を返却 Ancestor: association Children: なし |
ipOwnerId | string |
※空を返却 Ancestor: association Children: なし |
publicDnsName | string |
※空を返却 Ancestor: association Children: なし |
publicIp | string |
※空を返却 Ancestor: association Children: なし |
publicIpV6 | string |
※空を返却 Ancestor: association Children: なし |
primary | boolean |
※空を返却 Ancestor: item Children: なし |
privateDnsName | string |
※空を返却 Ancestor: item Children: なし |
privateIpAddress | string |
※空を返却 Ancestor: item Children: なし |
requesterId | string |
※空を返却 Ancestor: networkInterface Children: なし |
requesterManaged | boolean |
※空を返却 Ancestor: networkInterface Children: なし |
sourceDestCheck | string |
※空を返却 Ancestor: networkInterface Children: なし |
status | string |
ネットワークインターフェースのステータス 値:
Children: なし |
subnetId | string |
※空を返却 Ancestor: networkInterface Children: なし |
tagSet | - |
※空を返却 リソースに設定されているタグ情報セット Ancestor: networkInterface Children: item |
item | - |
リソースに設定されているタグ情報 Ancestor: tagSet Children: key | value |
key | string |
設定されているタグのキー Ancestor: item Children: なし |
value | string |
設定されているタグの値 Ancestor: item Children: なし |
vpcId | string |
※空を返却 Ancestor: networkInterface Children: なし |
niftyNetworkId | string |
ネットワークユニークID Ancestor: networkInterface Children: なし |
niftyNetworkName | string |
ネットワーク名 Ancestor: networkInterface Children: なし |
リクエストサンプル
https://jp-east-1.computing.api.nifcloud.com/api/
?Action=CreateNetworkInterface
&NiftyNetwokrId=net-0v3nmuh8
&IpAddress=10.0.5.111
&Placement.AvailabilityZone=east-12
&description=memo
&CommonParams
応答サンプル
<CreateNetworkInterfaceResponse xmlns="https://computing.api.nifcloud.com/api/">
<requestId>ac501097-4c8d-475b-b06b-a90048ec181c</requestId>
<return>true</return>
<networkInterface>
<association>
<allocationId/>
<associationId/>
<ipOwnerId/>
<publicDnsName/>
<publicIp/>
<publicIpV6/>
</association>
<attachment>
<attachmentId/>
<attachTime/>
<deleteOnTermination/>
<deviceIndex/>
<instanceId/>
<instanceOwnerId/>
<status/>
</attachment>
<availabilityZone>east-12</availabilityZone>
<description>memo</description>
<groupSet>
<item>
<groupId/>
</item>
</groupSet>
<interfaceType>interface</interfaceType>
<ipv6AddressesSet>
<item>
<ipv6Address/>
</item>
</ipv6AddressesSet>
<macAddress/>
<networkInterfaceId>ni-3db04f80</networkInterfaceId>
<ownerId/>
<privateDnsName/>
<privateIpAddress>10.0.5.111</privateIpAddress>
<privateIpAddressV6/>
<privateIpAddressesSet>
<item>
<association>
<allocationId/>
<associationId/>
<ipOwnerId/>
<publicDnsName/>
<publicIp/>
<publicIpV6/>
</association>
<primary/>
<privateDnsName/>
<privateIpAddress/>
</item>
</privateIpAddressesSet>
<requesterId/>
<requesterManaged/>
<sourceDestCheck/>
<status>available</status>
<subnetId/>
<tagSet>
<item>
<key/>
<value/>
</item>
</tagSet>
<vpcId/>
<niftyNetworkId>net-0v3nmuh8</niftyNetworkId>
<niftyNetworkName>prilan1</niftyNetworkName>
</networkInterface>
</CreateNetworkInterfaceResponse>