Cisco Cisco ASA 5580 Adaptive Security Appliance

Page of 29
 
About the ASA REST API v1.3.2 
Resource Identity 
 
kind: objectref#networkobject => represents a reference to an object of type ‘networkobject’ 
kind: IPAddress => represents a primitive resource of type ‘ipAddress’ 
Primitive kinds 
Some primitives like IP Address, Network, FQDN, Service Type, etc. can be represented using “kind” when they are 
mixed with other resource types. In those cases, “kind” will be without a ‘#’ and will be specified directly. Such 
resources will be very simple and in addition to “kind” they will include only a “value” attribute which specifies the value. 
Example: 
"kind: "IPv4Address " 
"value": "1.1.1.1" 
 
Resource Association 
Other resources can be referenced from a given resource. There are two types of references: 
1.  Through an in-line object where the complete referring object is present in its entirety. This approach is used 
rarely and supported only in certain APIs. 
2.  The most common way to refer to another resource is through its resource identifier, which could be objectId or 
refLink. 
Example: 
"kind": "objectref#networkObjectGroup" , 
"refLink": "http://host/api/object/networkObjectGroups/548292" ,  
"objectId":"548292" 
OR 
"kind": "objectref#networkObjectGroup" , 
"refLink": "http://host/api/object/networkObjectGroup/Lab%20Printers" , 
"objectId": "Lab Printers" 
 
Object ‘rangeInfo’ 
Most collection resources will include a “rangeInfo” object, which provides details on the range of items contained in the 
collection. The GET request and Query API support pagination and will never return more than a defined maximum