本文へジャンプします。

ニフクラ ユーザーガイド

クラウド トップ>API> コンピューティング> CreateNetworkInterface

CreateNetworkInterface

処理概要

追加NICを新規作成します。1回のリクエストで、1つの追加NICを作成できます。

追加NICの作成には時間がかかることがあります。このAPIのレスポンス「status」を確認し「processing」が返ってきた、またはタイムアウトした場合はAPI「DescribeNetworkInterfaces」のレスポンス値「status」で追加NICのステータスを確認できます。
APIのパラメーター「NiftyNetworkId」の指定できるのは、プライベートLANのネットワークユニークIDです。

指定するパラメーター

パラメーター 型 説明 必須
NiftyNetworkId string ネットワークユニークID
 ○
IpAddress string

IPアドレス

1) 指定されたネットワークがプライベートLANでDHCPが有効化されている 値 : IPアドレス | static(手動化)
Default : DHCPによるIPアドレス自動発行
2) 指定されたネットワークがプライベートLANでDHCPが無効化されている 値 : static(手動化)

使用可能文字: IPアドレス、static(手動化)
Placement.AvailabilityZone string ゾーン情報
Default: ニフクラが決定
Description string メモ情報

応答フィールド

フィールド (項目) 型 説明
CreateNetworkInterfaceResponse - CreateNetworkInterface レスポンス
Ancestor: なし
Children: requestId | return | networkInterface
requestId string リクエスト識別子
Ancestor: CreateNetworkInterfaceResponse
Children: なし
return boolean 処理ステータス
値:
  • true (成功)
Ancestor: CreateNetworkInterfaceResponse
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 ネットワークインターフェースのステータス
値:
  • processing (処理中)
Ancestor: networkInterface
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>

ニフクラ サイト内検索

APIメニュー

  • ツイッターでフォローしてください
  • ニフクラ公式フェイスブックページ
  • ※本ページ記載の金額は、すべて税抜表示です。
  • ※本ページ記載の他社製品名および会社名などは、各社の商標または登録商標です。
  • ※本ページの内容は、2021年2月25日時点の情報です。

推奨画面サイズ　1024×768 以上

ページの先頭へ