Admin API Syntax and General Usage

Admin API Syntax and standard HTTP operations.

The Admin API has a consistent pattern for each data type, with the following basic access syntax:

[http | https]:/host:port/arc/adminapi/version/data_type[/object_id][?options]

The parameters of this line are in Admin API Syntax Parameters.

The HTTP method specifies the following operation types:

GET

List of an item identified through the object_id or object_name, or all items, with default summary information. The URL option 'detail=true' returns all data details.

POST

Update: The fields in the request data update the item with matching object _id.

Create: If the URL or request data does not specify the object_id, ArcViz creates a new data item.

Validate: To verify that the connection is successful, issue the POST command two times:

  1. Issue the POST command with the validate flag set to true.
    [
      {
       "id":18,
       "name": "ArcEngine Dev",
       "type": "arcengine",
       "validate": "true",
       "info": {
       "PARAMS": {
       "HOST": "localhost",
       "PORT": "21051",
       "USERNAME": "admin",
       "SETTINGS": {
       "ANALYTICAL_VIEW_MAX_REFRESH_THREADS": "1",
       "MAX_PARTITIONS_FOR_REFRESH_INSERT": "1"
                   }
    .....
    .....
                 }
              }
      }
    ]
  2. On success, issue the same POST command without the validate flag. This step saves the data.
DELETE

Delete the specified item.

While any standard HTTP access method can be used, we use the python request modules for HTTP operations with the following common setup:
import json
import requests
api_url = [http|htttps]://host:port/arc/adminapi/version
login_url = [http|https]:/host:port/arc/apps/login