グローバルIPアドレス割当

グローバルIPアドレス割当

API情報

API種別	メソッド	URI	対象	名称	実行
設定	POST	/:GisServiceCode/virtual-servers/:IvmServiceCode/global-ipaddresses.json	仮想サーバ	グローバルIPアドレス割当	同期

指定した仮想サーバIvmServiceCodeにグローバルIPアドレスを1個割り当てます
仮想サーバに複数のグローバルIPアドレスを割り当てる場合は、APIを個数回だけ繰り返し呼び出します
割り当てられたグローバルIPアドレスはDHCPを用いて受け取ることができます。ただし、仮想サーバにグローバルIPアドレスを複数割り当てた場合、2個目以降のIPアドレスは手動で設定する必要があります
グローバルIPアドレスは自動的に割り当てられるため、任意のアドレスを利用することはできません
IPv4アドレスとIPv6アドレスは常にペアで割り当てられます。
仮想サーバ専有タイプはグローバルネットワークに接続できないため、グローバルIPアドレスを割り当てることはできません
グローバルIPアドレスを指定するには、仮想サーバが停止している必要があります

リクエストパラメータ

	パラメータ	必須	意味	値
URL	GisServiceCode	○	P2契約のサービスコード	gis########
	IvmServiceCode	○	仮想サーバのサービスコード	ivm########

レスポンス

フィールド	タイプ	意味	値
IPv4.IpAddress	String	割り当てられたIPv4アドレス	IPv4アドレス
IPv4.Type	String	アドレス管理	"Managed", "Unmanaged"
IPv4.DomainName	String	逆引きドメイン名	文字列
IPv6.IpAddress	String	割り当てられたIPv6アドレス	IPv6アドレス
IPv6.Type	String	アドレス管理	"Managed", "Unmanaged"

エラーコード

このAPIに関する個別エラーはありません。
共通エラーコードはエラーレスポンスを参照して下さい

制限

特になし

サンプル

リクエストボディ

無し

レスポンス (JSON)

{
    "RequestId": "xxxxxxxx-xxxxxxxx-xxxxxxxx-xxxxxxxx-xxxxxxxx",
    "IPv4": {
        "IpAddress": "203.0.113.11",
        "Type": "managed",
        "DomainName": "11.113.0.203.rev.iijgio.jp"
    },
    "IPv6": {
        "IpAddress": "2001:0db8:0000:0000:0000:0000:0000:000b",
        "Type": "Unmanaged"
    }
}