仮想サーバ情報取得

API情報

API種別 メソッド URI 対象 名称 実行
契約、設定 GET

/:GisServiceCode/virtual-servers/:IvmServiceCode.json

/:GisServiceCode/virtual-servers/:IvdServiceCode.json

仮想サーバ 仮想サーバ情報取得 同期

リクエストパラメータ

  パラメータ 必須 意味
URL GisServiceCode P2契約のサービスコード gis########
  ivmServiceCode or ivdServiceCode サービスコード ivm########, ivd########

レスポンス

フィールド タイプ 意味
Label String ラベル 文字列
ContractStatus String 契約状態  
StartDate String 利用開始日 or 課金開始日 YYYYMMDD
StopDate String 解約予定日 YYYYMMDD
Category String 仮想サーバ種別 "BestEffort", "Guarantee", "Dedicated"
Type String 仮想サーバ品目  
OSType String OS種別 "Linux", "Windows"
ServerGroup String サーバグループ "A", "B"
ResourceStatus String 仮想サーバステータス  
ServerSpec.CPU String コア数 例: 1vCore
ServerSpec.Memory String メモリ量(GB) 例: 1GB
Network.MaxTrafficSpeed String 帯域上限(Mbps) 例: 100Mbps
Network.IncludingGlobalSide String 帯域上限にグローバルネットワークを含む品目ならばYes, そうでなければNo "Yes", "No"
StorageList Array ストレージ一覧 オブジェクトの配列
StorageList.PciSlot String PCIスロット 16進数。例: 0x10
StorageList.Boot String ブート可否 "Yes", "No"
StorageList.ServiceCode String ストレージのサービスコード Iba########, ibg########, ibb########, Ica########, icg########, icb########
StorageList.URI String ストレージの情報へアクセスするためのURI URI
StorageList.Type String ストレージ品目  
StorageList.OSType String OS種別 "Linux", "Windows", "None"
StorageList.Mode String ストレージのモード "Basic", "Backup"
StorageList.Encryption String 暗号化 "Yes", "No"
NetworkList Array ネットワーク一覧 オブジェクトの配列
NetworkList.MacAddress String MACアドレス 例: 12-34-56-78-9a-bc
NetworkList.NetworkType String ネットワークタイプ "Global", "PrivateStandard", "Private"
NetworkList.IPv6Enabled String IPv6有効または無効 "Enabled", "Disabled"
NetworkList.ServiceCode String プライベートネットワーク/Vのサービスコード ivl########
NetworkList.URI String プライベートネットワーク/Vの情報へアクセスするためのURI URI
NetworkList.Label String ラベル 文字列
NetworkList.IpAddressList Array IPアドレス一覧 オブジェクト配列
NetworkList.IpAddressList.IPv4.IpAddress String IPv4アドレス  
NetworkList.IpAddressList.IPv4.Type String アドレス管理 "Managed", "Unmanaged"
NetworkList.IpAddressList.IPv6.IpAddress String IPv6アドレス  
NetworkList.IpAddressList.IPv6.Type String アドレス管理 "Managed", "Unmanaged"

エラーコード

制限

サンプル

リクエストボディ

無し

レスポンス (JSON)

Json
{
    "RequestId": "xxxxxxxx-xxxxxxxx-xxxxxxxx-xxxxxxxx-xxxxxxxx",
    "Label": "XXXXX",
    "ContractStatus": "InService",
    "StartDate": "YYYYMMDD",
    "StopDate": "",
    "Category": "Guarantee",
    "Type": "VG1-3",
    "OSType": "Linux",
    "ServerGroup": "A",
    "ResourceStatus": "Stopped",
    "ServerSpec": {
        "CPU": "1Core",
        "Memory": "3GB",
        "Network": {
            "MaxTrafficSpeed": "100Mbps",
            "IncludingGlobalSide": "Yes"
        }
    },
    "StorageList": [
        {
            "PciSlot": "0x10",
            "Boot": "Yes",
            "ServiceCode": "iba########",
            "URI": "",
            "Type": "S30GB_CentOS7_64",  ## opsdと同じ
            "OSType": "Linux",
            "Mode": "Basic",
            "Encryption": "No"
        },
        {
            "PciSlot": "0x11",
            "Boot": "No",
            "Category": "Guarantee",
            "ServiceCode": "ibg#######1",
            "URI": "",
            "Type": "G100GB_IOPS1000",  ## opsdとは異なる
            "OSType": "None",
            "Mode": "Basic",
            "Encryption": "No"
        },
        {
            "PciSlot": "0x12",
            "Boot": "No",
            "Category": "BestEffort",
            "ServiceCode": "ibb#######1",
            "URI": "",
            "Type": "B500GB",  ## opsdとは異なる
            "OSType": "None",
            "Mode": "Basic",
            "Encryption": "No"
        }
    ],
    "NetworkList": [
        {
            "MacAddress": "12-34-56-78-9a-bc",
            "NetworkType": "Global",
            "IPv6Enabled": "No",
            "IpAddressList": [
                {
                    "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"
                    }
                },
                {
                    "IPv4": {
                        "IpAddress": "203.0.113.12",
                        "Type": "Unmanaged",
                        "DomainName": "12.113.0.203.rev.iijgio.jp"
                    },
                    "IPv6": {
                        "IpAddress": "2001:0db8:0000:0000:0000:0000:0000:000c",
                        "Type": "Unmanaged"
                    }
                }
            ]
        },
        {
            "MacAddress": "12-34-56-78-9a-bd",
            "NetworkType": "PrivateStandard",
            "IpAddressList": [
                {
                    "IPv4": {
                        "IpAddress": "192.0.2.1",
                        "Type": "Managed"
                    }
                }
            ]
        },
        {
            "MacAddress": "12-34-56-78-9a-be",
            "NetworkType": "Private",
            "ServiceCode": "ivl#######1",
            "URI": "",
            "Label": "XXXXX"
        },
        {
            "MacAddress": "12-34-56-78-9a-bf",
            "NetworkType": "Private",
            "ServiceCode": "ivl#######2",
            "URI": "",
            "Label": "XXXXX"
        }
    ]
}