Conventions
Annotations
The keyword RESERVED annotation means the feature is not yet implemented, and the feature specification has not been finalized.
JSON responses
The JSON properties are ordered by property name. However, the provided examples may not follow this rule for better readability.
DBMS object types
For DBMS types, the DBMS dialect is added to the display name: e.g.: Oracle Table
, PostgreSQL Table
, etc. Therefore, there is not a univoque relationship between the object type
property (display name of type
), and the object typeId
property (key of type
).
For example, for an object of type SQLScriptTable
, the type name will be one of these labels: Oracle Table
, PostgreSQL Table
, etc.
Enum types
An enumeration value is encoded as JSON structure as follows:
- If only a display name is available, the value is a JSON structure setting the property
name
, e.g.:"impacts": [{"name": "Code"},{"name": "Architecture"}]
- If only a key is available, the value is a JSON structure setting the property
id
, e.g.:"criticality": {"id": "CRITICAL"}
- If both a key and a display name are available, the value is a JSON structure setting both property
name
andid
, e.g.:"category": {"id": 1, "name": "Access Control List"}
Note that a display name may change over successive releases of CAST Imaging. The linkType
property (refers directly to a link type ID) is an exception to this convention. If there is need to report a display name the linkTypeName
property would be introduced.