REST API services in Floodlight (Device)

Posted on | Edited on |

Introduction

  1. Device的API主要分成兩類，回傳符合條件的Device或是Entity
  2. Entity是一個包含MAC、VLAN、IPV4型態，用來代表網路中最基本的一個元件
  3. Device可以包含很多個Entity，每個Device除了會有多個Entity外，還會有所謂的AttachmentPoint。AttachmentPoint會紀錄該Device是與哪個Switch的哪個Port相連
  4. 一般情況下， Device與Entity是1:1的關係，但是某些情況下，可能一個Device會擁有多個AttachmentPoint、多個IP address或是相同的MAC address擁有不同的VLAN TAG，在此情況下就會有一個Device擁有多個Entity。

API

  • /wm/device/ : 回傳Devices
    1. Method: GET
    2. Parameter: 這邊都是過慮的條件，只有符合這些條件的device才會被選出來。如果什麼參數都沒有，預設就是所有device。
      • mac : device的mac address
      • vlan : device的vlan tag
      • ipv4 : device的ipv4 address
      • dpid : 這個device所連接到的switch的dpid
      • port : 這個device是連接到該switch的哪個port
      • mac_startwith : 以下的參數都如同上面的概念，只不過上面的是要完整符合，這邊的是開頭符合就好
      • vlan_startwith :
      • ipv4_startwith :
      • dpid_startwith :
      • port_startwith :
        1. Code:
      • DeviceRoutable.java
      • AbstractDeviceResource.java
      • DeviceResource.java
      • DeviceSerializer.java
        1. Example:
      • curl -s http://localhost:8080/wm/device/| python -mjson.tool
      • curl -s http://localhost:8080/wm/device/?ipv4=10.0.0.2 | python -mjson.tool
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
[
    {
        "attachmentPoint": [
            {
                "errorStatus": null,
                "port": 2,
                "switchDPID": "00:00:00:00:00:00:00:03"
            }
        ],
        "entityClass": "DefaultEntityClass",
        "ipv4": [
            "10.0.0.2"
        ],
        "lastSeen": 1408555008093,
        "mac": [
            "00:00:00:00:00:02"
        ],
        "vlan": []
    }
]     
```      
- **/wm/device/debug** : 回傳Entities
	1. Method: **GET**
	2. Parameter: 沒有參數，就回傳所有的Entity。
	3. Code:   
		+ DeviceRoutable.java  
		+ AbstractDeviceResource.jave  
		+ DeviceEntityResource.java    
  4. Example:
  		+ curl -s http://localhost:8080/wm/device/debug | python -mjson.tool
      
```python
[
		[
          {
              "activeSince": 1408555008106,
              "ipv4Address": null,
              "lastSeenTimestamp": 1408555008106,
              "macAddress": "00:00:00:00:00:01",
              "switchDPID": "00:00:00:00:00:00:00:02",
              "switchPort": 2,
              "vlan": null
          },
          {
              "activeSince": 1408555007885,
              "ipv4Address": "10.0.0.1",
              "lastSeenTimestamp": 1408555007885,
              "macAddress": "00:00:00:00:00:01",
              "switchDPID": "00:00:00:00:00:00:00:02",
              "switchPort": 2,
              "vlan": null
          }
      ],
      [
          {
              "activeSince": 1408555008093,
              "ipv4Address": "10.0.0.2",
              "lastSeenTimestamp": 1408555008093,
              "macAddress": "00:00:00:00:00:02",
              "switchDPID": "00:00:00:00:00:00:00:03",
              "switchPort": 2,
              "vlan": null
          }
      ]
]
Related Posts