What's Updated
- [ switch ]
  - routing
  - stacks
- [ networks ]
  - clients
    - Returns a timeseries of total traffic consumption rates for all clients on a network within a given timespan, in megabits per second.
  - health
    - Return all global alerts on this network
What's New
- [ organizations ]
  - adaptivePolicy

Version 1.15.0 to 1.16.0

Summary of Changes

5 - New

18 - Updated

517 - Total operations

326 - Total Paths

What's Updated

[ switch ]

routing

List layer 3 interfaces for a switch

GET /devices/{serial}/switch/routing/interfaces

- Response property ipv6 value added

Return a layer 3 interface for a switch

GET /devices/{serial}/switch/routing/interfaces/{interfaceId}

- Response property ipv6 value added

Return layer 3 OSPF routing configuration

GET /networks/{networkId}/switch/routing/ospf

- Response property v3 value added

Create a layer 3 interface for a switch

POST /devices/{serial}/switch/routing/interfaces

- Optional property ipv6 Added

Update a layer 3 interface for a switch

PUT /devices/{serial}/switch/routing/interfaces/{interfaceId}

- Optional property defaultGateway Added

- Optional property ipv6 Added

Update layer 3 OSPF routing configuration

PUT /networks/{networkId}/switch/routing/ospf

- Optional property v3 Added

stacks

List layer 3 interfaces for a switch stack

GET /networks/{networkId}/switch/stacks/{switchStackId}/routing/interfaces

- Response property ipv6 value added

Return a layer 3 interface from a switch stack

GET /networks/{networkId}/switch/stacks/{switchStackId}/routing/interfaces/{interfaceId}

- Response property ipv6 value added

Create a layer 3 interface for a switch stack

POST /networks/{networkId}/switch/stacks/{switchStackId}/routing/interfaces

- Optional property ipv6 Added

Update a layer 3 interface for a switch stack

PUT /networks/{networkId}/switch/stacks/{switchStackId}/routing/interfaces/{interfaceId}

- Optional property defaultGateway Added

- Optional property ipv6 Added

[ networks ]

clients

Returns a timeseries of total traffic consumption rates for all clients on a network within a given timespan, in megabits per second.

GET /networks/{networkId}/clients/bandwidthUsageHistory

- Optional param perPage added

- Optional param startingAfter added

- Optional param endingBefore added

- Response property headers value added

health

Return all global alerts on this network

GET /networks/{networkId}/health/alerts

- Response property peers value added

- Response property id value added

What's New

[ organizations ]

adaptivePolicy

PATH /organizations/{organizationId}/adaptivePolicy/groups

- Path added

- New operation

List adaptive policy groups in a organization

GET /organizations/{organizationId}/adaptivePolicy/groups

Code Snippet

Copy[
    {
        "groupId": "1234",
        "name": "Employee Group",
        "sgt": 1000,
        "description": "Group of XYZ Corp Employees",
        "policyObjects": [
            {
                "id": "2345",
                "name": "Example Policy Object"
            }
        ],
        "createdAt": "2019-06-27T21:34:25.253480Z",
        "updatedAt": "2019-06-27T21:34:25.253480Z"
    }
]

- New operation

Creates a new adaptive policy group

POST /organizations/{organizationId}/adaptivePolicy/groups

Code Snippet

Copy{
    "groupId": "1234",
    "name": "Employee Group",
    "sgt": 1000,
    "description": "Group of XYZ Corp Employees",
    "policyObjects": [
        {
            "id": "2345",
            "name": "Example Policy Object"
        }
    ],
    "createdAt": "2019-06-27T21:34:25.253480Z",
    "updatedAt": "2019-06-27T21:34:25.253480Z"
}

PATH /organizations/{organizationId}/adaptivePolicy/groups/{groupId}

- Path added

- New operation

Returns an adaptive policy group

GET /organizations/{organizationId}/adaptivePolicy/groups/{groupId}
Code Snippet
Copy{
    "groupId": "1234",
    "name": "Employee Group",
    "sgt": 1000,
    "description": "Group of XYZ Corp Employees",
    "policyObjects": [
        {
            "id": "2345",
            "name": "Example Policy Object"
        }
    ],
    "createdAt": "2019-06-27T21:34:25.253480Z",
    "updatedAt": "2019-06-27T21:34:25.253480Z"
}
- New operation

Updates an adaptive policy group. If updating "Infrastructure", only the SGT is allowed. Cannot update "Unknown".

PUT /organizations/{organizationId}/adaptivePolicy/groups/{groupId}
Code Snippet
Copy{
    "groupId": "1234",
    "name": "Employee Group",
    "sgt": 1000,
    "description": "Group of XYZ Corp Employees",
    "policyObjects": [
        {
            "id": "2345",
            "name": "Example Policy Object"
        }
    ],
    "createdAt": "2019-06-27T21:34:25.253480Z",
    "updatedAt": "2019-06-27T21:34:25.253480Z"
}
- New operation

Deletes the specified adaptive policy group and any associated policies and references

DELETE /organizations/{organizationId}/adaptivePolicy/groups/{groupId}

PATH /organizations/{organizationId}/adaptivePolicy/overview

- Path added

- New operation

Returns adaptive policy aggregate statistics for an organization

GET /organizations/{organizationId}/adaptivePolicy/overview
Code Snippet
Copy{
    "counts": {
        "groups": 10,
        "customAcls": 12,
        "policies": 100,
        "denyPolicies": 30,
        "allowPolicies": 70
    }
}

PATH /organizations/{organizationId}/adaptivePolicy/policies

- Path added

- New operation

List adaptive policies in an organization

GET /organizations/{organizationId}/adaptivePolicy/policies

Code Snippet

Copy[
    {
        "adaptivePolicyId": "111",
        "sourceGroup": {
            "id": "222",
            "name": "IoT Devices",
            "sgt": 50
        },
        "destinationGroup": {
            "id": "333",
            "name": "IoT Servers",
            "sgt": 51
        },
        "acls": [
            {
                "id": "444",
                "name": "Block web"
            }
        ],
        "lastEntryRule": "allow",
        "createdAt": "2019-06-27T21:34:25.253480Z",
        "updatedAt": "2019-06-27T21:34:25.253480Z"
    }
]

- New operation

Add an Adaptive Policy

POST /organizations/{organizationId}/adaptivePolicy/policies

Code Snippet

Copy{
    "adaptivePolicyId": "111",
    "sourceGroup": {
        "id": "222",
        "name": "IoT Devices",
        "sgt": 50
    },
    "destinationGroup": {
        "id": "333",
        "name": "IoT Servers",
        "sgt": 51
    },
    "acls": [
        {
            "id": "444",
            "name": "Block web"
        }
    ],
    "lastEntryRule": "allow",
    "createdAt": "2019-06-27T21:34:25.253480Z",
    "updatedAt": "2019-06-27T21:34:25.253480Z"
}

PATH /organizations/{organizationId}/adaptivePolicy/policies/{adaptivePolicyId}

- Path added

- New operation

Return an adaptive policy

GET /organizations/{organizationId}/adaptivePolicy/policies/{adaptivePolicyId}

Code Snippet

Copy{
    "adaptivePolicyId": "111",
    "sourceGroup": {
        "id": "222",
        "name": "IoT Devices",
        "sgt": 50
    },
    "destinationGroup": {
        "id": "333",
        "name": "IoT Servers",
        "sgt": 51
    },
    "acls": [
        {
            "id": "444",
            "name": "Block web"
        }
    ],
    "lastEntryRule": "allow",
    "createdAt": "2019-06-27T21:34:25.253480Z",
    "updatedAt": "2019-06-27T21:34:25.253480Z"
}

- New operation

Update an Adaptive Policy

PUT /organizations/{organizationId}/adaptivePolicy/policies/{adaptivePolicyId}

Code Snippet

Copy{
    "adaptivePolicyId": "111",
    "sourceGroup": {
        "id": "222",
        "name": "IoT Devices",
        "sgt": 50
    },
    "destinationGroup": {
        "id": "333",
        "name": "IoT Servers",
        "sgt": 51
    },
    "acls": [
        {
            "id": "444",
            "name": "Block web"
        }
    ],
    "lastEntryRule": "allow",
    "createdAt": "2019-06-27T21:34:25.253480Z",
    "updatedAt": "2019-06-27T21:34:25.253480Z"
}

- New operation

Delete an Adaptive Policy

DELETE /organizations/{organizationId}/adaptivePolicy/policies/{adaptivePolicyId}