Cisco Cisco ASA 5555-X Adaptive Security Appliance
About the ASA REST API
Resource Identity
Resource Identity
5
‘kind’: ‘collection#accessPolicySet’ => represents list of ACL type.
‘kind’:’object#networkobject’ => represents object of type ‘networkobject’
‘kind’:’objectref#networkobject’ => represents a reference to an object of type ‘networkobject’
‘kind’: ‘IPAddress => represents a primitive resource of type ‘ipAddress’
‘kind’: ‘IPAddress => represents a primitive resource of type ‘ipAddress’
Primitive kinds
Some primitives like IP Address, Network, FQDN, Service Type etc could be represented using ‘kind’ as well when they
are mixed with other resource types. In those cases the ‘kind’ will be without any ‘#’ and will be specified directly. Such
are mixed with other resource types. In those cases the ‘kind’ will be without any ‘#’ and will be specified directly. Such
resources will be very simple and besides ‘kind’ they will only contain ‘value’ attribute, which specifies the value.
Example:
{
”kind”: ”IPv4Address”
”value”: ”1.1.1.1”
}
Resource association
Other resources could be referenced from a given resource. There are two type of referencing:
1. Through inline 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”
}