差异REST API versions

Resources, attributes, and behaviors might differ among the REST API versions andAOS-CXsoftware release.

AOS-CX Network Analytics Engine scripts

URIs that specify monitors in Network Analytics Engine scripts must be REST v1 URIs.

Interfaces and ports

其余v10.04 API提供了interfacesresource to configure and get information about switch ports and interfaces of all types. Theportsresource is not supported by the REST v10.04 API.

GET method

The GET method query parameters differ between REST v1 and REST v10.04:

• The REST v10.04selectorparameter includes a value ofwritable, which enables you to get only the mutable attributes of a resource.

• The REST v1depthparameter has a default of 0 and a range of 0 through 3.

  The REST v10.04depthparameter has a default of 1 and a range of 1 through 4. The REST v10.04depth=1is equivalent to the REST v1depth=0, and so on.

Resource collections

In REST v10.04, the members of a resource collection are represented as JSON objects, where the key is the index and the value is the URI of the resource.

For example, the response to a GET request to/rest/v10.04/system/vrfsis as follows:

{ "default": "/rest/v10.04/system/vrfs/default", "mgmt": "/rest/v10.04/system/vrfs/mgmt" }

In contrast, the response to a GET request to/rest/v1/system/vrfson the same switch is as follows:

[ "/rest/v1/system/vrfs/default", "/rest/v1/system/vrfs/mgmt" ]