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)
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"
}
}