Versions Compared

Key

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


The connectors API provides functionality that allows a administrator or operator to perform actions such as adding and configuring connectors.

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

Pagination query string parameters

Sorting query string parameter

Section

Get all connectors

Lists all the connectors configured in the Aspire, this endpoint need the at least the OPERATOR role to be executed. 

Panel
borderColorblack
bgColor#fafafb
GET /aspire/_api/connectors

Query String Parameters

NameTypeRequiredDescription
fromintegerOptionalIndicates the initial page to be retrieved
sizeintegerOptionalSpecifies the size of results page
sortBystringOptionalField by which results are sorted
Section

Get all connectors, filtered

Lists connectors configured in the Aspire, filtered by a specified criteria, this endpoint need the at least the OPERATOR role to be executed.

Panel
borderColorblack
bgColor#fafafb

POST /aspire/_api/connectors/getAll

Pagination query string parameters

Sorting query string parameters

Filters: The connector filter definition here

sortModestringOptional

Sort mode

  • "asc" for ascending sort,
  • "desc" for descending sort

    Response

    Code Block
    languagejs
    themeRDark
    {
        "connectorcount": [{
        "id": "AAABcID5GBc=",
        "typetotalItems": {2
        },
        "idconnector": "filesystem",[
          "name": "File System"
    {
            },
        "descriptionid": "NetApp connector948a9d99-5b71-4023-976e-14dcdc82f231",
           "created": 1596707252548,
        "updatedartifact": 1596707252548,
    	"properties": { This will be a dynamic JSON object } 
      },
      {
    "com.accenture.aspire:aspire-ldap-cache-source",
                "idtype": "AAABcIueWUc=ldap",
         "type": {
          "iddescription": "sharepoint-onlineLDAP",
                "nameproperties": "Sharepoint online"
    {
         },
        "description       "enableFetcher": "SharePoint Onlinetrue",
               "created": 1596707252548,
        "updatedenableFetchUrl": 1596707252548"true",
    	"properties":  { This will be a dynamic JSON object }  
      }],
      "frominfoCacheSize": "100",
      "size": 10,
      "totalItems": 10000,
      "message": "optional response message"
    }

    Status

    Response codeDescription200Success Section

    Get all connectors, filtered

    Lists connectors configured in the Aspire, filtered by a specified criteria

    Panel
    borderColorblack
    bgColor#fafafb

    POST /aspire/_api/connectors/getAll

    Query String Parameters

    NameTypeRequiredDescriptionfromintegerOptionalIndicates the initial page to be retrievedsizeintegerOptionalSpecifies the size of results pagesortBystringOptionalField by which results are sortedsortModestringOptional

    Sort mode

    • "asc" for ascending sort,
    • "desc" for descending sort

    Body Parameters

    NameTypeRequiredDescriptionfilterJSONRequiredFilters retrieved credentials. Check the filter definition here

    Response

    Code Block
    languagejs
    {
      "connector": [{
        "id": "AAABcID5GBc=             ....
                },
                "checksum": "2f29393b0fb89ab1d70c0df85c698214def4952467488c3df03d37baeab5d39e"
            },
            {
                "id": "16e901a5-75c7-4969-90d2-70ad299916f3",
                "artifact": "com.accenture.aspire:aspire-filesystem-source",
                "type": "filesystem",
                "description": "FS_Demo",
                "properties": {
                    "enableFetcher": "true",
        "type": {
               "idenableFetchUrl": "filesystemtrue",
          "name": "File System"
        },
        "descriptioninfoCacheSize": "NetApp connector100",
        "created": 1596707252548,
        "updated": 1596707252548,
    	"properties": { This will be a dynamic JSON....
     object } 
      },
      {
        "id": "AAABcIueWUc=" },
         "type": {
          "idchecksum": "sharepoint-online0d5130e07c1e6123bcfa6c6e81850693a2e2e3d03d896c7725dd3cb536c86b62",
          "name": "Sharepoint online"
        },
        "description": "SharePoint Online",
        "created": 1596707252548,
        "updated": 1596707252548,
    	"properties": { This will be a dynamic JSON object }  
      }],
      "from": 100,
      "size": 10,
      "totalItems": 10000,
      "message": "optional response message"
    }

    Status

    Response codeDescription200Success
    ]
    }

    Status: 200




    Response

    Section

    Get a single connector

    Get information about a single connector configured in Aspire, this endpoint need the at least the OPERATOR role to be executed.

    Panel
    borderColorblack
    bgColor#fafafb

    GET /aspire/_api/connectors/:id


    Path Parameters

    NameTypeRequiredDescription
    idstringRequiredThe id of the connector to return


    Response

    Code Block
    languagejs
    themeRDark
    {
        "connector": {
            "id": "948a9d99-5b71-4023-976e-14dcdc82f231",
            "artifact": "com.accenture.aspire:aspire-ldap-cache-source",
            "type": "ldap",
            "description": "LDAP",
            "properties": {
                "enableFetcher": "true",
                "enableFetchUrl": "true",
                "infoCacheSize": "100",
    			.............
            },
      
    Section

    Get a single connector

    Get information about a single connector configured in Aspire

    Panel
    borderColorblack
    bgColor#fafafb

    GET /aspire/_api/connectors/:id

    Query String Parameters

    NameTypeRequiredDescription
    idstringRequiredThe id of the connector to return
    Code Block
    languagejs
    {
      "connector": {
        "id": "AAABcID5GBc=",
        "type": {
          "id": "filesystem",
          "namechecksum": "File System2f29393b0fb89ab1d70c0df85c698214def4952467488c3df03d37baeab5d39e"
        },
        "description": "NetApp connector",
        "created": 1596707252548,
        "updated": 1596707252548,
    	"properties": { This will be a dynamic JSON object } 
      }
    }

    Status

    Response codeDescription200Success404The given connector id was not found Section
    
    }

    Status: 200, 404




    Example

    Section

    Add connector(s)

    Add connectors to Aspire, this endpoint need the at least the ADMINISTRATOR role to be executed.

    Panel
    borderColor

    Add multiple connectors

    Add multiple connectors to Aspire

    Panel
    borderColorblack
    bgColor#fafafb
    POST /aspire/_api/connectors


    Body Parameters

    NameTypeRequiredDescription
    typestringRequiredThe type of this connector
    descriptionstringRequiredAn optional The description of the connector
    artifactstringRequiredThe name of the artifact
    propertiesobjectRequiredConnector properties


    Example

    Code Block
    languagejs
    themeRDark
    POST /aspire/_api/connectors
    [{
       "type": "filesystem",
      "description": "NetApp"
    },
    {
     {
            "type": "sharepointfilesystem",
            "description": "SharePoint Online"
    }]

    Response

    Code Block
    languagejs
    {
      "connector": [{
    FS Demo Test 1",
            "idartifact": "AAABcID5GBc=com.accenture.aspire:aspire-filesystem-source",
            "typeproperties": "filesystem",
    {
                "descriptionenableFetcher": "NetApptrue",
           "created": 1596707252548,
        "updatedenableFetchUrl": 1596707252548"true",
    	"properties": { This will be a dynamic JSON object  } 
      }"infoCacheSize": "100",
       {
        "id": "BAABcID5GBc=",
        "typedeleteCheckAfterErrors": "sharepointNEVER",
    			.....
          "description": "SharePoint Online",}
        "created": 1596707252548},
        {
     "updated": 1596707252548,
    	"properties": { This will be a dynamic JSON object } 
      }]
    }

    See Response Body for details regrading the response body returned where multiple items are affected with some (or all) returning errors

    Status

    Response codeDescription
    201Created
    406Not acceptable - there was an issue validating the input
    Section
           "type": "filesystem",
            "description": "FS Demo Test 2",
            "artifact": "com.accenture.aspire:aspire-filesystem-source",
            "properties": {
                "enableFetcher": "true",
                "enableFetchUrl": "true",
                "infoCacheSize": "100",
                "deleteCheckAfterErrors": "NEVER",
    			.................
            }
        }
    ]


    Response

    Code Block
    languagejs
    themeRDark
    {
        "connector": [
            {
                "id": "8e971436-b78a-4c6d-bafb-e16f1433c6f6",
                "artifact": "com.accenture.aspire:aspire-filesystem-source",
            

    Add single connector

    Add a single connector to Aspire

    Panel
    borderColorblack
    bgColor#fafafb
    POST /aspire/_api/connectors

    Body Parameters

    NameTypeRequiredDescription
    typestringRequiredThe type of this connector
    descriptionstringRequiredAn optional description of the connector
    Code Block
    languagejs
    POST /aspire/_api/connectors
    {
      "type": "filesystem",
      "description": "NetApp"
    }

    Response

    Code Block
    languagejs
    {
      "connector": [{
        "id": "AAABcID5GBc=",
        "type": "filesystem",
                "description": "NetAppFS_Demo_Test_1",
        "created": 1596707252548,
            "updatedproperties": 1596707252548,
    	"properties": { This will be a dynamic JSON object } 
      }]
    }

    See Response Body for details regrading the response body returned where multiple items are affected with some (or all) returning errors

    Status

    Response codeDescription201Created406Not acceptable - there was an issue validating the input Section

    Update multiple connectors

    Updates multiple connectors in Aspire.

    Panel
    borderColorblack
    bgColor#fafafb

    PUT /aspire/_api/connectors

    Body Parameters

    NameTypeRequiredDescriptionidstringRequiredThe identifier of the connector to updatetypestringOptional
    The type of the connectordescriptionstringOptionalAn optional description of the connector

    Examples

    Code Block
    languagejs
    PUT /aspire/_api/connectors
    {
      "AAABcID5GBc=": {
        "id": "AAABcID5GBc=",
    {
                    "enableFetcher": "true",
                    "enableFetchUrl": "true",
                    "infoCacheSize": "100",
    				..........
                },
                "checksum": "c27b11a3996c4dc6f3a03b79397679fa68256241a865faeef7f06271b558bb46"
            },
            {
                "id": "9ad25f3b-ae34-4cff-85e1-6884e5b8f070",
                "artifact": "com.accenture.aspire:aspire-filesystem-source",
                "type": "filesystem",
                "description": "Net AppFS_Demo_Test_2",
           "type": "filesystem"
      },
      "AAABcID5GBd=properties": {
               "id": "AAABcID5GBd=",
        "descriptionenableFetcher": "Sharepoint onlinetrue",
        "type": "sharepoint"
      }
    }

    Response

    Code Block
    languagejs
    {
      "connector": [{
                "idenableFetchUrl": "AAABcID5GBc=true",
         "description": "Net App",
        "type": "filesystem",
        "createdinfoCacheSize": 1596707252548,
        "updated": 1596707252548,
    	"properties": { This will be a dynamic JSON object }  
       },
       {
    "100",
    				.............
                },
                "idchecksum": "AAABcID5GBd=19a1ce2e3bb658c4831bbc706a13393874822bf03e1bac31a4f197770410afbb",
          "description": "Sharepoint online",}
        "type": "sharepoint",
        "created": 1596707252548,
        "updated": 1596707252548,
    	"properties": { This will be a dynamic JSON object }  
       }]
    }

    See Response Body for details regrading regarding the response body returned where multiple items are affected with some (or all) returning errors

    406Not acceptable - there was an issue validating the input

    Status

    Response codeDescription200Success404Not found - a given connector identifier was not found

    : 201, 406





    Filters retrieved connectors. Check the filter definition here
    Section

    Update

    single

    connector(s)

    Updates a single connector connectors in Aspire, this endpoint need the ADMINISTRATOR role to be executed.

    Panel
    borderColorblack
    bgColor#fafafb

    PUT /aspire/_api/connectors/:id

    PUT /aspire/_api/connectors


    Path ParametersQuery String Parameters

    NameTypeRequiredDescription
    idstringRequiredThe identifier of the connector to update


    Body Parameters

    NameTypeRequiredDescription
    idstringRequiredThe identifier of the connector to update
    typedescriptionstringOptionalxThe type description of the connector
    propertiesdescriptionobjectstringxOptionalAn optional description of the connectorConnector properties

    x - at least one field must be present

    Example
    Example - update one connector

    Code Block
    languagethemejsRDark
    PUT /aspire/_api/connectors/AAABcID5GBc%3D600f70ef-7a90-4364-bdb9-7a9b5f81f6fe
    {
        "id": "AAABcID5GBc="600f70ef-7a90-4364-bdb9-7a9b5f81f6fe",
        "description": "NetApp - First- UPDATE",
        "typeproperties": "filesystem"
    }

    Response

    Code Block
    languagejs
    {
      "connector": [{
        "idenableFetcher": "AAABcID5GBc=true",
        "description": "Net App", .....
        "}
    }


    Example - update more connectors

    Code Block
    languagejs
    themeRDark
    PUT /aspire/_api/connectors
    {
      "AAABcID5GBc=type": "filesystem",{
        "createdid": 1596707252548"AAABcID5GBc=",
        "updateddescription": "Net 1596707252548App",
    	    "properties": {
     This will be a dynamic JSON object }  
       "enableFetcher": "true",
          .....
        }]
    }

    See Response Body for details regrading the response body returned where multiple items are affected with some (or all) returning errors

    Status

    Response codeDescription
    200Success
    404Not found - a given connector identifier was not found
    406Not acceptable - there was an issue validating the input
    Section

    Delete multiple connectors, filtered

    Delete multiple connectors from Aspire, filtered by a specified criteria

    Panel
    borderColorblack
    bgColor#fafafb

    POST /aspire/_api/connectors/deleteAll

    Body Parameters

    NameTypeRequiredDescription
    filterJSONRequired
      },
      "AAABcID5GBd=": {
        "id": "AAABcID5GBd=",
        "description": "Sharepoint online",
        "properties": {
          "enableFetcher": "true",
          .....
        }
      }
    }


    Response

    Code Block
    languagejs
    themeRDark
    {
      "messageconnector": "optional response message"
    }

    See Response Body for details regrading the response body returned where multiple items are affected with some (or all) returning errors

    Status

    Response codeDescription200Success404Not found - a given credential identifier was not found406Not acceptable - there was an issue validating the input Section
    [{"updated":true,"id":"AAABcID5GBc="},{"updated":true,"id":"AAABcID5GBd="}]}

    Status: 200, 404, 406


    Section

    Update connectors, filtered

    Update connectors configured in the Aspire, filtered by a specified criteria, this endpoint need the ADMINISTRATOR role to be executed.

    Panel
    borderColorblack
    bgColor#fafafb

    PUT /

    Delete single connector

    Delete one or more connectors from Aspire.

    Panel
    borderColorblack
    bgColor#fafafb
    DELETE /

    aspire/_api/connectors/

    :id

    Query String Parameters

    NameTypeRequiredDescriptionidstringRequiredThe identifier(s) of the connector(s) to delete

    Example

    Code Block
    languagejs
    DELETE /aspire/_api/connectors/AAABcID5GBc=

    Response

    Code Block
    languagejs
    {
      "message": "optional response message"
    }

    See Response Body for details regrading the response body returned where multiple items are affected with some (or all) returning errors

    Status

    Response codeDescription200Success404Not found - a given connector identifier was not found406Not acceptable - there was an issue validating the input

    updateAll

    Filters: The connector filter definition here

    Update body parameter:

    Code Block
    themeRDark
    {
      "update" : {
        "description" : "DESCRIPTION"
        "properties": {
          "enableFetcher": "true",
          .....
        }
      }
    }


    Response

    Code Block
    languagejs
    themeRDark
    {
      "message": "update result response message"
    }

    Status: 200, 406





    Response

    Section

    Delete connector(s)

    Delete one or more connectors from Aspire, this endpoint need the ADMINISTRATOR role to be executed.

    Section

    Get connectors types

    Lists all available connectors types

    Panel
    borderColorblack
    bgColor#fafafb

    DELETE /aspire/_api/connectors/:id

    DELETE /aspire/_api/connectors

    POST

    GET

    /aspire/_api/connectors/

    type

    delete

    Query String Parameters

    NameTypeRequiredDescription
    typestringOptionalFilter results to return only the specified type
    Code Block
    languagejs
    {
      "type": [{
        "id": "filesystem",
        "description": "Filesytem Connector",
    	"coordinates": "com.accenture.aspire:aspire-filesystem-source"
      },
      {
        "id": "sharepoint-online",
        "description": "SharePoint Online Connector",
        "coordinates": "com.accenture.aspire:aspire-sharepoint-online-source"
      },
      ...
      ]
    }

    Status

    Response codeDescription200Success Section

    Get specific connector type

    Returns the type of a specific connector

    Panel
    borderColorblack
    bgColor#fafafb
    GET /aspire/_api/connectors/:id/type

    Query String Parameters

    NameTypeRequiredDescription

    Response

    Code Block
    languagejs
    {
      "type": [{
        "id": "filesystem",
        "description": "Filesytem Connector",
        "coordinates": "com.accenture.aspire:aspire-filesystem-source"
      }
      ]
    }


    Path Parameters and Query parameters

    NameTypeRequiredDescription
    idstringRequiredThe identifier(s) of the connector(s) to delete


    Body Parameter

    NameTypeRequiredDescription
    idsstringRequiredThe identifier(s) of the connector(s) to delete


    Examples

    Code Block
    languagejs
    themeRDark
    DELETE /aspire/_api/connectors/AAABcID5GBc
    
    DELETE /aspire/_api/connectors?id=AAABcID5GBc&id=AAABcID5GBd
    
    POST /aspire/_api/connectors/delete
    {
      "ids":["AAABcID5GBc","AAABcID5GBd"]
    }
    


    Response

    Code Block
    languagejs
    themeRDark
    {
      "message": "delete result response message"
    }

    Status: 200, 404, 406


    Section

    Delete multiple connectors, filtered

    Delete multiple connectors from Aspire, filtered by a specified criteria, this endpoint need the ADMINISTRATOR role to be executed.

    Panel
    borderColorblack
    bgColor#fafafb

    POST /aspire/_api/connectors/deleteAll

    Filters: The connector filter definition here

    Response

    Code Block
    languagejs
    themeRDark
    {
      "message": "delete result response message"
    }

    Status: 200




    Section

    Export connector(s)

    Export one or more connector from Aspire, this endpoint needs at least the OPERATOR role to be executed.

    Panel
    borderColorblack
    bgColor#fafafb

    GET /aspire/_api/connectors/export

    GET /aspire/_api/connectors/export/:id

    POST /aspire/_api/connectors/exportAll

    Info

    Every configuration item has the option to export from the UI, using the single menu or by the bulk actions:

    Image AddedImage Added

    Note

    Something important that you need to know is that when you export a config item that depends on another, the export will contain also all the dependencies.

    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.


    Path Parameters and Query parameters

    NameTypeRequiredDescription
    idstringRequiredThe identifier(s) of the connector(s) to export


    Body Parameter

    NameTypeRequiredDescription
    idsstringRequiredThe identifier(s) of the connector(s) to export


    Examples

    Code Block
    languagejs
    themeRDark
    GET /aspire/_api/connectors/export/AAABcID5GBc
    
    DELETE /aspire/_api/connectors/export?id=AAABcID5GBc&id=AAABcID5GBd
    
    POST /aspire/_api/connectors/export
    {
      "ids":["AAABcID5GBc","AAABcID5GBd"]
    }
    


    Response

    Code Block
    languagejs
    themeRDark
    {
      "export": {
        "connectors": {
          "connector": [
            {
              "id": "<connector_id>",
              "artifact": "com.accenture.aspire:aspire-rest-source",
              "type": "rest-api",
              "description": "RestConnector",
              "properties": {
                "debug": false,
                "wDebug": false,
                ...
              },
              "checksum": "82a70c88cbfa46dfd79d6430bfesdf5646c13089604fb609831f16f"
            },
    		...
          ]
        }
      }
    }

    Status: 200, 404, 406


    Section

    Export multiple connectors, filtered

    Export multiple connectors from Aspire, filtered by a specified criteria, this endpoint needs at least the OPERATOR role to be executed.

    Panel
    borderColorblack
    bgColor#fafafb

    POST /aspire/_api/connectors/exportAll

    Filters: The connection filter definition here

    Response

    Code Block
    languagejs
    themeRDark
    {
      "export": {
        "connectors": {
          "connector": [
            {
              "id": "<connector_id>",
              "artifact": "com.accenture.aspire:aspire-rest-source",
              "type": "rest-api",
              "description": "RestConnector",
              "properties": {
                "debug": false,
                "wDebug": false,
                ...
              },
              "checksum": "82a70c88cbfa46dfd79d6430bfesdf5646c13089604fb609831f16f"
            },
    		...
          ]
        }
      }
    }

    Status: 200




    Section

    Import

    The import usage can be found here





    Status

    Get connector type dxf

    Returns the dxf for a specific connector type

    Section

    Filters
    Anchor
    FiltersAnchor
    FiltersAnchor

    Connector filter:

    Code Block
    languagejs
    themeRDark
    {  
    
    Response codeDescription
    200Success
    Section
    Panel
    borderColorblack
    bgColor#fafafb
    GET /aspire/_api/connectors/type/:typeId/dxf

    Query String Parameters

    NameTypeRequiredDescription

    Response

    Code Block
    languagejs
    {
      "dxf": {...}
      "message": "optional response message"
    }

    Status

    Response codeDescription200Success404Not found - a given service identifier was not found SectionFilters AnchorFiltersAnchorFiltersAnchor

     Some endpoint queries require a filter. A filter is basically a JSON object with the following format:

    Credentials filter:

    Code Block
    languagejs
      "filter" : {
        "ids" : ["id1ID1", "id2ID2", "id3ID3", ...],
        "type" : "TYPE",
        "description" : "DESCRIPTION",
    	"artifact" : "ARTIFACT"
      }
    
    Note
    When using delete endpoints, ids in the filter are mandatory.
    }