ニフクラAPI (コンピューティング: NiftyUpdateInstanceNetworkInterfaces)

NiftyUpdateInstanceNetworkInterfaces

処理概要

サーバーのネットワーク設定を指定した状態に変更します。

マルチIPアドレスが設定されているサーバーについて
・グローバルネットワーク設定の変更は行うことができません
・プライベートネットワーク設定の変更は行うことができます

サーバーに設定されているマルチIPアドレスのネットワークを他のネットワークに変更したい、または取り外したい場合はAPI「DisassociateMultiIpAddressGroup」を実行する必要があります。

指定するパラメーター

パラメーター	型	説明	必須
InstanceId	string	サーバー名	○
NetworkInterface.n.DeviceIndex	integer	※指定不可
NetworkInterface.n.SecurityGroupId.n	string	※指定不可
NetworkInterface.n.NetworkId	string	ネットワークID 使用可能文字: net-COMMON_GLOBAL(共通グローバル)、net-COMMON_PRIVATE(共通プライベート)、net-MULTI_IP_ADDRESS(マルチIPアドレス)、プライベートLANのネットワークID	○ (ネットワーク名といずれか)
NetworkInterface.n.NetworkName	string	ネットワーク名(共通グローバル、共通プライベート、マルチIPアドレスを指定する場合はネットワークIDを指定)	○ (ネットワークIDといずれか)
NetworkInterface.n.IpAddress	string	IPアドレス 1）指定されたネットワークが共通グローバル 値 : 付替グローバルIPアドレス Default : DHCPによるIPアドレス自動発行 2）指定されたネットワークが共通プライベート 値 : 付替プライベートIPアドレス Default : DHCPによるIPアドレス自動発行 3）指定されたネットワークがプライベートLANでDHCPが有効化されている 値 : IPアドレス | static(手動化) Default : DHCPによるIPアドレス自動発行 4）指定されたネットワークがプライベートLANでDHCPが無効化されている 値 : static(手動化)
NiftyReboot	string	再起動オプション 値: force (強制再起動) true (通常再起動) false (再起動しない) Default: true

応答フィールド

フィールド (項目)	型	説明
NiftyUpdateInstanceNetworkInterfacesResponse	-	NiftyUpdateInstanceNetworkInterfacesレスポンス
␣requestId	string	リクエスト識別子
␣return	boolean	処理ステータス 値: true (成功)

リクエストサンプル

    https://jp-east-1.computing.api.nifcloud.com/api/
  ?Action=NiftyUpdateInstanceNetworkInterfaces
  &InstanceId=server01
  &NetworkInterface.1.NetworkId=net-0k87j180
  &NetworkInterface.1.IpAddress=static
  &CommonParams

  

応答サンプル

    <NiftyUpdateInstanceNetworkInterfacesResponse xmlns="https://computing.api.nifcloud.com/api/">
  <requestId>ac501097-4c8d-475b-b06b-a90048ec181c</requestId>
  <return>true</return>
</NiftyUpdateInstanceNetworkInterfacesResponse>