Version 1.7.0 to 1.8.0

What's Updated

[ devices ]

GET /devices/{serial}/lossAndLatencyHistory

- Response property goodput value added

- Summary changed from Get the uplink loss percentage and latency in milliseconds for a wired network device. to Get the uplink loss percentage and latency in milliseconds, and goodput in kilobits per second for a wired network device.

[ networks ]

GET /networks/{networkId}/firmwareUpgrades

- Response property timezone value added

- Response property products value added

- Summary changed from Get current maintenance window for a network to Get firmware upgrade information for a network

POST /networks/{networkId}/devices/claim

- Summary changed from Claim devices into a network to Claim devices into a network. (Note: for recently claimed devices, it may take a few minutes for API requsts against that device to succeed)

PUT /networks/{networkId}/firmwareUpgrades

- Optional property timezone Added

- Optional property products Added

- Summary changed from Update current maintenance window for a network to Update firmware upgrade information for a network

PATH /networks/{networkId}/firmwareUpgrades/rollbacks

- Path added

- New operation

Rollback a Firmware Upgrade For A Network

POST /networks/{networkId}/firmwareUpgrades/rollbacks

{
    "product": "switch",
    "status": "pending",
    "upgradeBatchId": 23456,
    "time": "2020-10-21T02:00:00Z",
    "toVersion": {
        "id": 7857,
        "firmware": "switch-15-5-2",
        "shortName": "MS 25.5.2",
        "releaseType": "stable"
    },
    "reasons": [
        {
            "category": "performance",
            "comment": "Network was slower with the upgrade"
        },
        {
            "category": "stability",
            "comment": "We saw some errors in the logs we didn't expect"
        }
    ]
}

[ wireless ]

PUT /networks/{networkId}/wireless/ssids/{number}

- Optional property baseDistinguishedName Added

- Optional property serverCaCertificate Added

- Property adaptivePolicyGroupId Deleted

- Optional property oauth Added

- Optional property localRadius Added

- Optional property adultContentFilteringEnabled Added

- Optional property dnsRewrite Added

PATH /networks/{networkId}/wireless/ssids/{number}/bonjourForwarding

- Path added

- New operation

List the Bonjour forwarding setting and rules for the SSID

GET /networks/{networkId}/wireless/ssids/{number}/bonjourForwarding
{
    "enabled": true,
    "rules": [
        {
            "description": "A simple bonjour rule",
            "vlanId": "1",
            "services": [
                "All Services"
            ]
        }
    ]
}
- New operation

Update the bonjour forwarding setting and rules for the SSID

PUT /networks/{networkId}/wireless/ssids/{number}/bonjourForwarding
{
    "enabled": true,
    "rules": [
        {
            "description": "A simple bonjour rule",
            "vlanId": "1",
            "services": [
                "All Services"
            ]
        }
    ]
}

PATH /networks/{networkId}/wireless/ssids/{number}/vpn

- Path added

- New operation

List the VPN settings for the SSID.

GET /networks/{networkId}/wireless/ssids/{number}/vpn

{
    "splitTunnel": {
        "enabled": true,
        "rules": [
            {
                "protocol": "any",
                "destCidr": "1.1.1.1/32",
                "destPort": "any",
                "policy": "allow",
                "comment": "split tunnel rule 1"
            },
            {
                "destCidr": "foo.com",
                "destPort": "any",
                "policy": "deny",
                "comment": "split tunnel rule 2"
            }
        ]
    }
}

- New operation

Update the VPN settings for the SSID

PUT /networks/{networkId}/wireless/ssids/{number}/vpn

{
    "splitTunnel": {
        "enabled": true,
        "rules": [
            {
                "protocol": "any",
                "destCidr": "1.1.1.1/32",
                "destPort": "any",
                "policy": "allow",
                "comment": "split tunnel rule 1"
            },
            {
                "destCidr": "foo.com",
                "destPort": "any",
                "policy": "deny",
                "comment": "split tunnel rule 2"
            }
        ]
    }
}