7.5 Экземпляр сети
Описание объекта Экземпляр сети представлено в таблице ниже.
name | value | type |
---|---|---|
id | 17 | int |
network_type_id | 1 | int |
name | Inner space #52 | string |
net_cidr | 10.239.0.0/16 | cidr |
default_gw | 10.239.0.1 | inet |
vlan_id | 1 | int |
mtu | 1500 | int (1500-9000) |
Параметр net_cidr играет роль пула IP-адресов данного экземпляра сети.
Параметр MTU является необязательным, при его отсутствии будет использовано значение по умолчанию 1500.
Параметр default_gw представляет собой значение маршрута по умолчанию для портов этой сети.
Методы¶
7.5.1 net-list()¶
Данный метод позволяет получить список всех экземпляров сети в пределах видимости запросившего пользователя (пользователь с ролью Суперадмина видит все сети. Остальные пользователи видят только сети в тех ВЦОД, в которых им назначена какая-либо роль).
Запрос:
Ответ:
{
"id" : "e3eaa494-9a59-11ee-b778-103379a977b0",
"jsonrpc" : "2.0",
"result" : {
"code" : 1,
"data" : [
{
"backend" : 2,
"creator" : 1,
"gw" : "10.78.27.1",
"id" : "101",
"mtu" : 1500,
"name" : "Q9 routed L26",
"net_cidr" : "10.78.27.0/24",
"network_type_id" : 2,
"vlan_id" : 2070,
"vxlan_multicast_addr" : "239.248.77.79",
"vxlan_port" : null
},
{
"backend" : 2,
"creator" : 1,
"gw" : "10.100.200.1",
"id" : "102",
"mtu" : 9000,
"name" : "Q9 local",
"net_cidr" : "10.100.200.0/22",
"network_type_id" : 1,
"vlan_id" : null,
"vxlan_multicast_addr" : "239.248.77.79",
"vxlan_port" : 9009
},
{
"backend" : 2,
"creator" : 1,
"gw" : "10.110.200.1",
"id" : "103",
"mtu" : 3000,
"name" : "test mtu",
"net_cidr" : "10.110.200.0/24",
"network_type_id" : 1,
"vlan_id" : null,
"vxlan_multicast_addr" : "239.248.77.79",
"vxlan_port" : 9009
}
]
}
}
При указании параметра objective возможно получение альтернативного варианта ответа:
Уровень 1: network_id
Запрос:
{
"jsonrpc": "2.0",
"method": "net-list",
"id": "e726c166-9a58-11ee-bfaf-76fa79a977b0",
"params": {
"objective": 1
}
}
Ответ:
{
"id" : "e726c166-9a58-11ee-bfaf-76fa79a977b0",
"jsonrpc" : "2.0",
"result" : {
"code" : 1,
"data" : {
"101" : {
"GW" : "10.78.27.1",
"backend" : 2,
"id" : 101,
"mtu" : 1500,
"name" : "Q9 routed L26",
"net_cidr" : "10.78.27.0/24",
"network_type_id" : 2,
"vlan_id" : 2070
},
"102" : {
"GW" : "10.100.200.1",
"backend" : 2,
"id" : 102,
"mtu" : 9000,
"name" : "Q9 local",
"net_cidr" : "10.100.200.0/22",
"network_type_id" : 1,
"vlan_id" : null
},
"103" : {
"GW" : "10.110.200.1",
"backend" : 2,
"id" : 103,
"mtu" : 3000,
"name" : "test mtu",
"net_cidr" : "10.110.200.0/24",
"network_type_id" : 1,
"vlan_id" : null
}
}
}
}
7.5.2 nets-create()¶
С помощью nets-create() можно создать экземпляр сети.
Изолированные сети может создавать пользователь, которому назначена роль Админа ВЦОД в любом ВЦОД.
Параметр default_gw является опциональным. При отсутствии этого параметра для сети будет использоваться первый свободный IP-адрес.
Запрос (изолированная сеть):
{
"jsonrpc": "2.0",
"method": "nets-create",
"id": "bd555b58-ab9e-11ed-9568-7e7c4f83c07e",
"params": {
"type": 1,
"name": "Сеть для iSCSI",
"cidr": "192.168.100.0/24",
"default_gw": "192.168.100.1"
}
}
Запрос (маршрутизируемая сеть):
{
"jsonrpc": "2.0",
"method": "nets-create",
"id": "bd555b58-ab9e-11ed-9568-7e7c4f83c07e",
"params": {
"type": 2,
"name": "Сеть для AltaVault",
"cidr": "192.168.202.0/24",
"default_gw": "192.168.100.254",
"vlan_id": 80
}
}
Ответ:
{
"id": "bd555b58-ab9e-11ed-9568-7e7c4f83c07e",
"jsonrpc": "2.0",
"result": {
"code": 0,
"data": {
"message": "Network 29 created"
},
"id": 29
}
}
7.5.3 nets-delete()¶
nets-delete() позволяет удалить экземпляр сети.
Запрос:
{
"jsonrpc": "2.0",
"method": "nets-delete",
"id": "d13c3fb0-ab9e-11ed-931c-607d4f83c07e",
"params": {
"id": 8
}
}
Ответ:
{
"id": "d13c3fb0-ab9e-11ed-931c-607d4f83c07e",
"jsonrpc": "2.0",
"result": {
"code": 0,
"data": {
"message" : "Network ID: 8 removed"
},
"id": 8
}
}
7.5.4 net-ippool-usage()¶
С помощью данного метода можно получить информацию об использовании пула IP-адресов сетей.
Запрос:
Ответ:
{
"id" : "0868871a-c119-11e9-8b86-9d6faace7a14",
"jsonrpc" : "2.0",
"result" : {
"code" : 1,
"data" : [
{
"address" : "10.52.31.2",
"network_id" : 29,
"vdc_id" : 8,
"vm_id" : 132
},
{
"address" : "10.52.31.3",
"network_id" : 29,
"vdc_id" : 8,
"vm_id" : 133
},
{
"address" : "10.102.70.26",
"network_id" : 30,
"vdc_id" : 8,
"vm_id" : 131
},
{
"address" : "10.102.70.27",
"network_id" : 30,
"vdc_id" : 8,
"vm_id" : 134
},
{
"address" : "172.20.20.2",
"network_id" : 40,
"vdc_id" : 8,
"vm_id" : 89
},
{
"address" : "172.20.20.3",
"network_id" : 40,
"vdc_id" : 8,
"vm_id" : 90
},
{
"address" : "192.168.250.2",
"network_id" : 54,
"vdc_id" : 8,
"vm_id" : 101
},
{
"address" : "192.168.250.3",
"network_id" : 54,
"vdc_id" : 8,
"vm_id" : 102
}
]
}
}
Суперадмин может дополнительно указывать в запросе параметр vdc_id, тогда в ответе будут сети, назначенные в данный ВЦОД. Ответ для остальных пользователей будет ограничен теми ВЦОД, где у них назначена минимально достаточная или какая-либо роль.
Запрос:
{
"jsonrpc": "2.0",
"method": "net-ippool-usage",
"id": "0868871a-c119-11e9-8b86-9d6faace7a14",
"params": {
"vdc_id": 8
}
}
При указании параметра objective возможно получение альтернативного варианта ответа:
Уровень 1: network_id
Уровень 2: vdc_ud
Уровень 3: vm_id : IP address
Запрос:
{
"jsonrpc": "2.0",
"method": "net-ippool-usage",
"id": "26c4c7da-c314-11e9-bf1d-b6d9abce7a14",
"params": {
"objective": 1
}
}
Ответ:
{
"id" : "26c4c7da-c314-11e9-bf1d-b6d9abce7a14",
"jsonrpc" : "2.0",
"result" : {
"code" : 1,
"data" : {
"2" : {
"16" : {
"129" : "10.100.0.3",
"149" : "10.100.0.4",
"150" : "10.100.0.5",
"88" : "10.100.0.2"
}
},
"26" : {
"16" : {
"128" : "172.16.17.2"
}
},
"27" : {
"2" : {
"105" : "172.16.30.2"
}
},
"29" : {
"8" : {
"132" : "10.52.31.2",
"133" : "10.52.31.3"
}
},
"3" : {
"2" : {
"100" : "10.0.20.7",
"123" : "10.0.20.8",
"124" : "10.0.20.9",
"125" : "10.0.20.10",
"135" : "10.0.20.11",
"136" : "10.0.20.12",
"137" : "10.0.20.13",
"138" : "10.0.20.14",
"139" : "10.0.20.15",
"140" : "10.0.20.16",
"141" : "10.0.20.17",
"142" : "10.0.20.18",
"143" : "10.0.20.19",
"144" : "10.0.20.20",
"145" : "10.0.20.21",
"146" : "10.0.20.22",
"147" : "10.0.20.23",
"148" : "10.0.20.24",
"91" : "10.0.20.2",
"92" : "10.0.20.3",
"93" : "10.0.20.4",
"94" : "10.0.20.5",
"99" : "10.0.20.6"
}
},
"30" : {
"2" : {
"41" : "10.102.70.10",
"42" : "10.102.70.20",
"71" : "10.102.70.21",
"72" : "10.102.70.22",
"73" : "10.102.70.23",
"74" : "10.102.70.24",
"76" : "10.102.70.25"
},
"8" : {
"131" : "10.102.70.26",
"134" : "10.102.70.27"
}
},
"40" : {
"2" : {
"130" : "172.20.20.4"
},
"8" : {
"89" : "172.20.20.2",
"90" : "172.20.20.3"
}
},
"54" : {
"8" : {
"101" : "192.168.250.2",
"102" : "192.168.250.3"
}
}
}
}
}
7.5.5 net-ippool-free()¶
Этот метод позволяет получить информацию о количестве свободных IP-адресов в пуле IP-адресов.
Запрос:
Ответ:
{
"id" : "a1cdc2ba-383f-11ea-8c80-fa66a3df8354",
"jsonrpc" : "2.0",
"result" : {
"code" : 1,
"data" : [
{
"free_addresses" : 249,
"network_id" : 23,
"network_name" : "Сеть для AltaVault"
},
{
"free_addresses" : 506,
"network_id" : 54,
"network_name" : "SBM/CIFS for S3 gateway"
},
{
"free_addresses" : 251,
"network_id" : 40,
"network_name" : "WWW"
},
{
"free_addresses" : 229,
"network_id" : 59,
"network_name" : "Routed L26"
},
{
"free_addresses" : 251,
"network_id" : 30,
"network_name" : "dNFS unix"
},
{
"free_addresses" : 250,
"network_id" : 55,
"network_name" : "XSCF network L26"
},
{
"free_addresses" : 11,
"network_id" : 60,
"network_name" : "28_bit_network"
}
]
}
При указании параметра objective возможно получение альтернативного варианта ответа:
Уровень 1: network_id
Запрос:
{
"jsonrpc": "2.0",
"method": "net-ippool-free",
"id": "a1cdc2ec-383f-11ea-8c80-fa66a3df8354",
"params": {
"objective": "yo"
}
}
Ответ:
{
"id" : "a1cdc2ec-383f-11ea-8c80-fa66a3df8354",
"jsonrpc" : "2.0",
"result" : {
"code" : 1,
"data" : {
"23" : {
"free_addresses" : 249,
"network_id" : 23,
"network_name" : "Сеть для AltaVault"
},
"30" : {
"free_addresses" : 251,
"network_id" : 30,
"network_name" : "dNFS unix"
},
"40" : {
"free_addresses" : 251,
"network_id" : 40,
"network_name" : "WWW"
},
"54" : {
"free_addresses" : 506,
"network_id" : 54,
"network_name" : "SBM/CIFS for S3 gateway"
},
"55" : {
"free_addresses" : 250,
"network_id" : 55,
"network_name" : "XSCF network L26"
},
"59" : {
"free_addresses" : 229,
"network_id" : 59,
"network_name" : "Routed L26"
},
"60" : {
"free_addresses" : 11,
"network_id" : 60,
"network_name" : "28_bit_network"
}
}
}
}
7.5.6 net-ippool-show()¶
С помощью этого метода можно получить список IP-адресов в IP-pool с информацией об использовании для каждого адреса. Для выполнения запроса необходимо быть создателем сети или иметь роль Cluster master.
Запрос:
{
"jsonrpc": "2.0",
"method": "net-ippool-show",
"id": "eeaba5a6-0852-11ef-b7d3-9897893f453a",
"params": {
"network_id": 125600
}
}
Ответ:
{
"id" : "eeaba5a6-0852-11ef-b7d3-9897893f453a",
"jsonrpc" : "2.0",
"result" : {
"code" : 1,
"data" : {
"ippool" : [
{ "10.100.200.123" : 0 },
{ "10.100.200.7" : 0 },
{ "10.100.200.84" : 0 },
{ "10.100.200.66" : 0 },
{ "10.100.200.170" : 0 },
{ "10.100.200.50" : 0 },
{ "10.100.200.196" : 0 },
{ "10.100.200.81" : 0 },
{ "10.100.200.48" : 0 },
{ "10.100.200.101" : 0 },
{ "10.100.200.169" : 0 },
{ "10.100.200.224" : 0 }
]
}
}
}
При указании параметра objective возможно получение альтернативного варианта ответа.
Запрос:
{
"jsonrpc": "2.0",
"method": "net-ippool-show",
"id": "eb7cd598-0853-11ef-ab55-b8348a3f453a",
"params": {
"objective": 1,
"network_id": 125600
}
}
Ответ:
{
"id" : "eb7cd598-0853-11ef-ab55-b8348a3f453a",
"jsonrpc" : "2.0",
"result" : {
"code" : 1,
"data" : {
"ippool" : {
"10.100.200.1" : 0,
"10.100.200.10" : 0,
"10.100.200.100" : 1,
"10.100.200.101" : 0,
"10.100.200.102" : 0,
"10.100.200.103" : 0,
"10.100.200.104" : 0,
"10.100.200.105" : 0,
"10.100.200.106" : 0,
"10.100.200.107" : 0,
"10.100.200.108" : 0,
"10.100.200.109" : 0,
"10.100.200.11" : 0,
"10.100.200.110" : 0,
"10.100.200.111" : 0,
"10.100.200.112" : 0,
"10.100.200.113" : 0,
"10.100.200.114" : 0,
"10.100.200.115" : 0,
"10.100.200.116" : 0,
"10.100.200.117" : 0,
"10.100.200.118" : 0,
"10.100.200.119" : 0,
"10.100.200.12" : 0,
"10.100.200.120" : 0,
"10.100.200.121" : 0,
"10.100.200.122" : 0,
"10.100.200.123" : 0,
"10.100.200.124" : 0,
"10.100.200.125" : 0,
"10.100.200.126" : 0,
"10.100.200.127" : 0,
"10.100.200.128" : 0,
"10.100.200.129" : 0,
"10.100.200.13" : 0,
"10.100.200.130" : 0,
"10.100.200.131" : 0,
"10.100.200.132" : 0,
"10.100.200.133" : 0,
"10.100.200.134" : 0,
"10.100.200.135" : 0,
"10.100.200.136" : 0,
"10.100.200.137" : 0,
"10.100.200.138" : 0,
"10.100.200.139" : 0,
"10.100.200.14" : 0,
"10.100.200.140" : 0,
"10.100.200.141" : 0,
"10.100.200.142" : 0,
"10.100.200.143" : 0,
"10.100.200.144" : 0,
"10.100.200.145" : 0,
"10.100.200.146" : 0,
"10.100.200.147" : 0,
"10.100.200.148" : 0,
"10.100.200.149" : 0,
"10.100.200.15" : 0,
"10.100.200.150" : 0,
"10.100.200.151" : 0,
"10.100.200.152" : 0,
"10.100.200.153" : 0,
"10.100.200.154" : 0,
"10.100.200.155" : 0,
"10.100.200.156" : 0,
"10.100.200.157" : 0,
"10.100.200.158" : 0,
"10.100.200.159" : 0,
"10.100.200.16" : 0,
"10.100.200.160" : 0,
"10.100.200.161" : 0,
"10.100.200.162" : 0,
"10.100.200.163" : 0,
"10.100.200.164" : 0,
"10.100.200.165" : 0,
"10.100.200.166" : 0,
"10.100.200.167" : 0,
"10.100.200.168" : 0,
"10.100.200.169" : 0,
"10.100.200.17" : 0,
"10.100.200.170" : 0,
"10.100.200.171" : 0,
"10.100.200.172" : 0,
"10.100.200.173" : 0,
"10.100.200.174" : 0,
"10.100.200.175" : 0,
"10.100.200.176" : 0,
"10.100.200.177" : 0,
"10.100.200.178" : 0,
"10.100.200.179" : 0,
"10.100.200.18" : 0,
"10.100.200.180" : 0,
"10.100.200.181" : 0,
"10.100.200.182" : 0,
"10.100.200.183" : 0,
"10.100.200.184" : 0,
"10.100.200.185" : 0,
"10.100.200.186" : 0,
"10.100.200.187" : 0,
"10.100.200.188" : 0,
"10.100.200.189" : 0,
"10.100.200.19" : 0,
"10.100.200.190" : 0,
"10.100.200.191" : 0,
"10.100.200.192" : 0,
"10.100.200.193" : 0,
"10.100.200.194" : 0,
"10.100.200.195" : 0,
"10.100.200.196" : 0,
"10.100.200.197" : 0,
"10.100.200.198" : 0,
"10.100.200.199" : 0,
"10.100.200.2" : 0,
"10.100.200.20" : 0,
"10.100.200.200" : 1,
"10.100.200.201" : 0,
"10.100.200.202" : 0,
"10.100.200.203" : 0,
"10.100.200.204" : 0,
"10.100.200.205" : 0,
"10.100.200.206" : 0,
"10.100.200.207" : 0,
"10.100.200.208" : 0,
"10.100.200.209" : 0,
"10.100.200.21" : 0,
"10.100.200.210" : 0,
"10.100.200.211" : 0,
"10.100.200.212" : 0,
"10.100.200.213" : 0,
"10.100.200.214" : 0,
"10.100.200.215" : 0,
"10.100.200.216" : 0,
"10.100.200.217" : 0,
"10.100.200.218" : 0,
"10.100.200.219" : 0,
"10.100.200.22" : 0,
"10.100.200.220" : 0,
"10.100.200.221" : 0,
"10.100.200.222" : 0,
"10.100.200.223" : 0,
"10.100.200.224" : 0,
"10.100.200.225" : 0,
"10.100.200.226" : 0,
"10.100.200.227" : 0,
"10.100.200.228" : 0,
"10.100.200.229" : 0,
"10.100.200.23" : 0,
"10.100.200.230" : 0,
"10.100.200.231" : 0,
"10.100.200.232" : 0,
"10.100.200.233" : 0,
"10.100.200.234" : 0,
"10.100.200.235" : 0,
"10.100.200.236" : 0,
"10.100.200.237" : 0,
"10.100.200.238" : 0,
"10.100.200.239" : 0,
"10.100.200.24" : 0,
"10.100.200.240" : 0,
"10.100.200.241" : 0,
"10.100.200.242" : 0,
"10.100.200.243" : 0,
"10.100.200.244" : 0,
"10.100.200.245" : 0,
"10.100.200.246" : 0,
"10.100.200.247" : 0,
"10.100.200.248" : 0,
"10.100.200.249" : 0,
"10.100.200.25" : 0,
"10.100.200.250" : 0,
"10.100.200.251" : 0,
"10.100.200.252" : 0,
"10.100.200.26" : 0,
"10.100.200.27" : 0,
"10.100.200.28" : 0,
"10.100.200.29" : 0,
"10.100.200.3" : 0,
"10.100.200.30" : 0,
"10.100.200.31" : 0,
"10.100.200.32" : 0,
"10.100.200.33" : 0,
"10.100.200.34" : 0,
"10.100.200.35" : 0,
"10.100.200.36" : 0,
"10.100.200.37" : 0,
"10.100.200.38" : 0,
"10.100.200.39" : 0,
"10.100.200.4" : 0,
"10.100.200.40" : 0,
"10.100.200.41" : 0,
"10.100.200.42" : 0,
"10.100.200.43" : 0,
"10.100.200.44" : 0,
"10.100.200.45" : 0,
"10.100.200.46" : 0,
"10.100.200.47" : 0,
"10.100.200.48" : 0,
"10.100.200.49" : 0,
"10.100.200.5" : 0,
"10.100.200.50" : 0,
"10.100.200.51" : 0,
"10.100.200.52" : 0,
"10.100.200.53" : 0,
"10.100.200.54" : 0,
"10.100.200.55" : 0,
"10.100.200.56" : 0,
"10.100.200.57" : 0,
"10.100.200.58" : 0,
"10.100.200.59" : 0,
"10.100.200.6" : 0,
"10.100.200.60" : 0,
"10.100.200.61" : 0,
"10.100.200.62" : 0,
"10.100.200.63" : 0,
"10.100.200.64" : 0,
"10.100.200.65" : 0,
"10.100.200.66" : 0,
"10.100.200.67" : 0,
"10.100.200.68" : 0,
"10.100.200.69" : 0,
"10.100.200.7" : 0,
"10.100.200.70" : 0,
"10.100.200.71" : 0,
"10.100.200.72" : 0,
"10.100.200.73" : 0,
"10.100.200.74" : 0,
"10.100.200.75" : 0,
"10.100.200.76" : 0,
"10.100.200.77" : 0,
"10.100.200.78" : 0,
"10.100.200.79" : 0,
"10.100.200.8" : 0,
"10.100.200.80" : 0,
"10.100.200.81" : 0,
"10.100.200.82" : 0,
"10.100.200.83" : 0,
"10.100.200.84" : 0,
"10.100.200.85" : 0,
"10.100.200.86" : 0,
"10.100.200.87" : 0,
"10.100.200.88" : 0,
"10.100.200.89" : 0,
"10.100.200.9" : 0,
"10.100.200.90" : 0,
"10.100.200.91" : 0,
"10.100.200.92" : 0,
"10.100.200.93" : 0,
"10.100.200.94" : 0,
"10.100.200.95" : 0,
"10.100.200.96" : 0,
"10.100.200.97" : 0,
"10.100.200.98" : 0,
"10.100.200.99" : 0
}
}
}
}
7.5.7 net-ippool-delete()¶
Данный метод позволяет удалить IP-адрес из IP-pool сети. Для выполнения запроса необходимо быть создателем сети или иметь роль Cluster master.
Запрос:
{
"jsonrpc": "2.0",
"method": "net-ippool-delete",
"id": "f46d5b52-0950-11ef-9f45-6d878a3f453a",
"params": {
"network_id": 125600,
"address": "10.100.200.100"
}
}
Ответ:
{
"id" : "f46d5b52-0950-11ef-9f45-6d878a3f453a",
"jsonrpc" : "2.0",
"result" : {
"code" : 1,
"data" : {}
}
}
7.5.8 net-ippool-add()¶
С помощью этого метода можно добавить IP-адрес в IP-pool сети. Адрес не должен быть за пределами CIDR сети. Для выполнения запроса необходимо быть создателем сети или иметь роль Cluster master.
Запрос:
{
"jsonrpc": "2.0",
"method": "net-ippool-add",
"id": "e5e727c6-0952-11ef-a3b8-d732893f453a",
"params": {
"network_id": 125600,
"address": "10.100.200.100"
}
}
Ответ: