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 complete system

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