Export entities - BlueCat Integrity - 9.5.0

Address Manager Legacy v1 API Guide

Locale
English
Product name
BlueCat Integrity
Version
9.5.0

Export an octet stream of entities to be transformed into JSON by an API client, saved as a file, or exported to a different system.

API method: GET /v1/exportEntities

Sample selectCriteria JSONs

Example 1 - search selector
{"selector":"search","types":"IP6Block,IP6Network","keyword":"*"}
Example 2 - get_entitytree selector (retrieving all entities that match type and their descendants)
{"selector":"get_entitytree","startEntityId":1,"types":"Configuration,View,Zone,IP4Network,IP4Block,IP6Block,IP6Network,DHCP4Range,DHCP6Range"}
Example 3 - get_entitytree selector (retrieving only direct descendants of startEntity that match type)
{"selector":"get_entitytree","startEntityId":1283641,"types":"IP6Block,IP6Network, IP6Address","children_only":true}
selectCriteria Parameters
  • selector—enter one of the following options for entity selection.
    • search—search entities using a keyword (same behaviour as keyword search in GET /v1/searchByObjectTypes)
    • get_entitytree—retrieve entities and children based on types and object IDs
  • keyword—for use with the search selector. Return results that match specified keyword and provided type(s), or use "*" to retrieve all entities for the provided type(s).
  • startEntityId—for use with the get_entitytree selector. Provide the integer object ID for a specific entity to retrieve the entity and all of its descendants that match type(s) (unless children_only is set to true). Default value is 1, the value to retrieve all entities and descendants that match the provided type(s).
  • children_only—(optional) for use with the get_entitytree selector. Set parameter to boolean value of true to return only the children of startEntityId (startEntityId and descendants beyond startEntityId's immediate children will not be returned). If parameter is not provided or set to false, results will include startEntityId and all descendants (children of children and so on, recursively).
  • types—enter the types of entity to retrieve. Type(s) must be from Reference: exportEntities supported types
  • additionalExportFields—(optional) add this parameter with a value of parentId to include the parent ID of objects in the response.
  • forImport—(optional) add this parameter with a boolean value of true to export entities in a NDJSON format compatible with POST /v1/importEntities
    Note: The entities exported with forImport set to true will still contain extra fields such as id, parentid, type, and state, which are not supported for v1/importEntities processing. Ensure that all unsupported fields are ignored by using the ignoreFields query parameter of v1/importEntities. Custom UDFs are supported as long as they are created in Address Manager before v1/importEntities processing.