Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


The System API handles the import/export functionality of configuration items in Aspire. This API enables users to save their configuration settings to a file or external storage and later restore those settings or apply them to other instances of Aspire.

Easy Heading Free
navigationTitleOn this Page
navigationExpandOptionexpand-all-by-default

Section

Export

Export all the configuration items of the Aspire, this includes all the: connectors, credentials, connections, workflows, policies, schedules and seeds. This endpoint needs the at least the OPERATOR role to be executed.

Panel
borderColorblack
bgColor#fafafb
GET /aspire/_api/system/export
Info

The export endpoint will generate a file with a content similar to this response.

Note

Take into consideration that components with resources loaded into elastic, will be exported, but the resource itself will not, so you will need to reupload the resource and go and select your resource in the component again.


Response

Code Block
languagejs
themeRDark
{
  "export": {
    "seeds": {
      "seed": [
        {
          "id": "<seed_id>",
          "type": "ldap-identity",
          "description": "LDAP",
          "connector": "<connector_id>",
          "seed": "dummy",
          "priority": "medium",
          "checksum": "36da0d996e4d156d33s2d54sad468ef5bbc85e09da8c",
          "connection": "<connection_id>",
          "properties": {
            "seed": "dummy",
            "userKeyAttribute": "dn",
            ...
          }
        },
        {
          "id": "<seed_id>",
          "type": "rest-api",
          "description": "REST",
          "connector": "<connector_id>",
          "seed": "N\/A",
          "priority": "medium",
          "checksum": "eb4b51659226093casdf3854sdf8f67e4f0de8217c0fd86ea565ce0",
          "connection": "<connection_id>",
          "properties": {
            "seed": "N\/A",
            "crawlRules": [
              {
                "conditionalScript": false,
                "entityType": "root",
                "shouldStop": false,
                ...
              }
            ],
            "stopOnScannerError": true
          }
        },
        ...
      ]
    },
    "connectors": {
      "connector": [
        {
          "id": "<connector_id>",
          "artifact": "com.accenture.aspire:aspire-rest-source",
          "type": "rest-api",
          "description": "RestConnector",
          "properties": {
            "debug": false,
            "wDebug": false,
            ...
          },
          "checksum": "82a70c88cbfa46dfd79d6430bfesdf5646c13089604fb609831f16f"
        },
        {
          "id": "<connector_id>",
          "artifact": "com.accenture.aspire:aspire-ldap-identity-source",
          "type": "ldap-identity",
          "description": "LDAP",
          "properties": {
            "debug": false,
            "wDebug": false,
            ...    
          },
          "checksum": "c03b3a168e0b4a5456d3df5g4caa480fb047f6459f9acac2ee65a2"
        },
        ...
      ]
    },
    "credentials": {
      "credential": [
        {
          "id": "<credential_id>",
          "type": "rest-api",
          "description": "RestCredentials",
          "properties": {
            "type": "bearer",
            "query": {
              ...
            }
          }
        },
        {
          "id": "<credential_id>",
          "type": "ldap-identity",
          "description": "LDAPCred",
          "properties": {
            "authenticationType": "SIMPLE",
            ...
          }
        },
        ...
      ]
    },
    "connections": {
      "connection": [
        {
          "id": "<connection_id>",
          "type": "rest-api",
          "description": "AlationConnection",
          "credential": "<credential_id>",
          "properties": {
            "maxRetries": 3,
            "useThrottling": false,
            "throttling": "throttling_false",
            "useProxy": false,
            "proxy": "proxy_false",
            "trustAllCertificates": false,
            ...
          }
        },
        {
          "id": "<connection_id>",
          "type": "ldap-identity",
          "description": "LDAPConn",
          "credential": "<credential_id>",
          "properties": {            
            "connectTimeout": "15s",
            "readTimeout": "15s",
            "useTLS": false,
            ...
          }
        },
        ...
      ]
    },
    "policies": {
      "policy": [
        {
          "id": "<policy_id>",
          "type": "throttle",
          "description": "pT",
          "period": "day",
          "value": 1
        },
        {
          "id": "<policy_id>",
          "type": "route",
          "description": "pR",
          "routeTo": "ss"
        },
        {
          "id": "<policy_id>",
          "type": "deleteIncremental",
          "description": "pD",
          "deletesPolicy": "IMMEDIATE",
          "deleteCheckAfterErrors": "ALWAYS"
        }
      ]
    },
    "schedules": {
      "schedule": {
        "id": "<schedule_id>",
        "type": "time",
        "description": "test",
        "enabled": "false",
        "scheduleTimeType": "daily",
        "stopOnFail": false,
        "schedule": "0 0 0 1\/1 * ?",
        "after": null,
        "seeds": "<seed_id>",
        "crawlMode": "full",
        "completeThreshold": 1.0,
        "action": "pause"
      }
    },
    "workflows": {
      "workflow": [
        {
          "id": "<workflow_id>",
          "type": "connector",
          "description": "myWorkflow",
          "checksum": "dc7d632e4fac3aed7404d2c260sd3f54eea266f9fd4af73b6251d6cb",
          "templates": {
            ...
          },
          "events": {
            "event": [
              ...
            ]
          },
          "rules": {
            "rule": [
              ...
            ]
          }
        },
        ...
      ]
    }
  }
}

Status: 200




Section

Import

Import the configuration items of the Aspire export file, this can include: connectors, credentials, connections, workflows, policies, schedules and seeds. This endpoint needs the at least the OPERATOR role to be executed.

Panel
borderColorblack
bgColor#fafafb

POST /aspire/_api/system/import

Info

The import endpoint needs a file generated from the export.



Note

Take into consideration that components with resources loaded into elastic, will be imported, but you will need to reupload the resource and go and select your resource in the component again.




Response

Code Block
languagejs
themeRDark
{
  "response": {
      "policies": [
          "pT",
          "pR",
          "pD"
      ],
      "connectors": [
          "RestConnector",
          "LDAP",
          "Azure",
          ...
      ],
      "credentials": [
          "RestCredentials",
          "LDAPCred",
          ...
      ],
      "connections": [
          "RESTConnection",
          "LDAPConn",
          ...
      ],
      "workflows": [
          "myWorkflow",
          ...
      ],
      "seeds": [
          "LDAP",
          "REST",
          ...
      ],
      "schedules": [
          "test"
      ]
  },
  "message": "File system_export.aspire imported successfully"
}

Status: 200, 404




Section

Export / Import UI


Info

You can also use the UI options to Export / Import in the Tools section:


                                                   Image Modified


Also, every configuration item has the export option.


Image Modified Image Modified


Note

Note that the configuration items do not have the import option, this is because the import is a single endpoint for all and is handled from the import option in the tools section.