Section

Get properties for the component

Gets properties for the component, this endpoint needs the at least the OPERATOR role to be executed.

Panel

borderColor	black
bgColor	#fafafb

GET /aspire/_api/resources/:type/:cmpName/properties

Path Parameters

Name

Type

Required

Description

type

string

Required

The type of resource

"connector"
"application"
"publisher"
"service"
"framework"
"other"

cmpName

string

Required

a A component we require properties for. It can be used with or without the version. When used with the version use this syntax: cmpName:version

Request and Response example

Code Block

language	js
theme	RDark

/aspire/_api/resources/connector/sharepoint-online/properties
/aspire/_api/resources/connector/sharepoint-online:5.0-SNAPSHOT/properties
{
    "properties": {
        "connector.framework.feature.hierarchy": "false",
        "connector.framework.feature.contentCrawling": "true",
        "checkSnapshotAfterProcess": "false",
        "mvnCoordinates": "com.accenture.aspire:aspire-sharepointonline-source",
        "component.default.dxf": "dxf/contentSource.xml",
        "component.appbundle.maven.coordinates": "app-rap-connector",
        "connector.framework.isRAP": "true",
        "connector.framework.feature.identityCrawling": "false"
    }
}

Status: 200, 400, 404

...

Section

Get the icon for the component

Gets the icon for the component, this endpoint needs the at least the OPERATOR role to be executed.

Panel

borderColor	black
bgColor	#fafafb

GET /aspire/_api/resources/:type/:cmpName/icon

Path Parameters

Name

Type

Required

Description

type

string

Required

The type of resource

"connector"
"application"
"publisher"
"service"
"framework"
"other"

cmpName

string

Required

a A component we require icon for. It can be used with or without the version. When used with the version use this syntax: cmpName:version

Query Parameters

Name	Type	Required	Description
thumbnail	boolean	Optional	We want the thumbnail from the icon

Request and Response example

Code Block

language	js
theme	RDark

/aspire/_api/resources/connector/sharepoint-online/icon?thumbnail=true

[the image]

Status: 200, 400, 404

Section

Get the dxf for the component

Gets the icon for the component, this endpoint needs the at least the OPERATOR role to be executed.

Panel

borderColor	black
bgColor	#fafafb

GET /aspire/_api/resources/:type/:cmpName/dxf

Path Parameters

Name

Type

Required

Description

type

string

Required

The type of resource

"connector"
"application"
"publisher"
"service"
"framework"
"other"

cmpName

string

Required

a A component we require the DXF for. It can be used with or without the version. When used with the version use this syntax: cmpName:version

Query Parameters

Name	Type	Required	Description
file	string	Required	The DXF file name

Request and Response example

Code Block

language	js
theme	RDark

/aspire/_api/resources/connector/filesystem/dxf?file=server
{
    "General": [
        {
            "type": "text",
            "key": "url",
            "display": "Base Path",
            "placeholder": "C:\\",
            "tooltip": "All the seeds will be prefixed with this value to form the full path",
            "validations": [
                "required",
                "path"
            ]
        },
        {
            "type": "boolean",
            "key": "ignoreSymLinks",
            "display": "Ignore Symbolic Links",
            "default": false,
            "tooltip": "If selected, symbolic links will not be processed and links in the root items will cause error."
        },
        {
            "type": "boolean",
            "key": "ignoreScanErrors",
            "display": "Ignore Scan Errors",
            "default": false,
            "tooltip": "If selected, the scanning errors won't stop the crawl from continuing, but they are still going to be logged."
        }
    ],
    "Security": [
        {
            "type": "fieldset",
            "display": "Static ACLs",
            "tooltip": "These ACLs will be added to all of the documents.",
            "body": [
                {
                    "type": "multiple",
                    "key": "staticAcl",
                    "body": [
                        {
                            "type": "text",
                            "key": "name",
                            "display": "Name",
                            "placeholder": "john.doe",
                            "validations": [
                                "required"
                            ],
                            "tooltip": "Name of the ACL."
                        },
                        {
                            "type": "text",
                            "display": "Domain",
                            "key": "domain",
                            "placeholder": "domain",
                            "tooltip": "Domain to which the ACL belongs to."
                        },
                        {
                            "key": "entity",
                            "type": "select",
                            "display": "Entity",
                            "tooltip": "Whether or not this ACL is for a group or a user.",
                            "default": "user",
                            "options": [
                                {
                                    "key": "group",
                                    "display": "Group"
                                },
                                {
                                    "key": "user",
                                    "display": "User"
                                }
                            ]
                        },
                        {
                            "key": "access",
                            "type": "select",
                            "display": "Access",
                            "tooltip": "Whether or not this ACL will have access to crawled files",
                            "default": "allow",
                            "options": [
                                {
                                    "key": "allow",
                                    "display": "Allow"
                                },
                                {
                                    "key": "deny",
                                    "display": "Deny"
                                }
                            ]
                        }
                    ]
                }
            ]
        }
    ]
}

Status: 200, 400, 404

...

Section

Delete custom application

Delete the custom application, this endpoint need the OPERATOR role to be executed.

Panel

borderColor	black
bgColor	#fafafb

DELETE /aspire/_api/resources/:type/:cmpName/deleteCustom

Path Parameters

Name

Type

Required

Description

type

string

Required

The type of resource

"connector"
"application"
"publisher"
"service"
"framework"
"other"

cmpName

string

Required

a A component to be deleted

Request example

Code Block

language	js
theme	RDark

DELETE /aspire/_api/resources/connector/customFileSystem/deleteCustom

Status: 200, 404

...

Section

Get Metrics Dashboard

Get the URL to the Metrics Dashboard for a list of given crawls

Panel

borderColor	black
bgColor	#fafafb

POST /aspire/_api/resources/dashboard/metrics

Request example

Code Block

language	js
theme	RDark

POST /aspire/_api/resources/dashboard/metrics
[
   {
      "seed" : "e11dac6b-0083-4d9a-ac3b-0e1bca4f0872",
      "crawlId" : "1623652817"
   },
   {
      "seed" : "98d65d8b-a7eb-4349-9f51-4139cf8a6404",
      "crawlId" : "1623642813"
   }
]

Status: 200

Response example

Code Block

language	js
theme	RDark

{
  "e11dac6b-0083-4d9a-ac3b-0e1bca4f0872" : {
     "url" : "https://kibana_host:5601/....."
  },
  "98d65d8b-a7eb-4349-9f51-4139cf8a6404" : {
     "url" : "https://kibana_host:5601/....."
  }
}

Section

Upload

file

File

Uploads a file to the Aspire resources repository, this endpoint needs the at least the OPERATOR role to be executed.

Panel

borderColor	black
bgColor	#fafafb

POST /aspire/_api/resources/file?description=:description

Body Form

Name	Type	Required	Description
file	file	Required	The file to be uploaded

Query Parameters

Name	Type	Required	Description
description	string	Required	The file description

Request example

Code Block

language	js
theme	RDark

POST /aspire/_api/resources/file?description=groovy --form 'file=@"/C:/Directory/file.groovy"'

Status: 200

Response example

Code Block

language	js
theme	RDark

{
	"id" : "517f161623ea3f43cc567a33914b96c31cbaa2c63d2594174d2b6230b1912ae1"
	"name" : "file.groovy",
	"description" : "groovy",
	"checksum" : "12565092083235"
}

Section

Download

file

File

Uploads Downloads a file to from the Aspire resources repository, this endpoint needs the at least the OPERATOR role to be executed.

Panel

borderColor	black
bgColor	#fafafb

GET /aspire/_api/resources/file/:id

Path Parameters

Name	Type	Required	Description
id	string	Required	The id of the file to download

Request example

Code Block

language	js
theme	RDark

GET /aspire/_api/resources/file/517f161623ea3f43cc567a33914b96c31cbaa2c63d2594174d2b6230b1912ae1

Status: 200

Response example

Code Block

language	js
theme	RDark

[the file]

Section

Update File Description

Updates the description from a file to the Aspire resources repository, this endpoint needs the at least the OPERATOR role to be executed.

Panel

borderColor	black
bgColor	#fafafb

POST /aspire/_api/resources/file/:id?description=:description

Path Parameters

Name	Type	Required	Description
id	string	Required	The id of the file to update

Query Parameters

Name	Type	Required	Description
description	string	Required	The file description

Request example

Code Block

language	js
theme	RDark

POST/aspire/_api/resources/file/517f161623ea3f43cc567a33914b96c31cbaa2c63d2594174d2b6230b1912ae1?description=new_description

Status: 200

Response example

Code Block

language	js
theme	RDark

{
	"id" : "517f161623ea3f43cc567a33914b96c31cbaa2c63d2594174d2b6230b1912ae1"
}

Section

Delete File

Deletes a file from the Aspire resources repository, this endpoint needs the at least the OPERATOR role to be executed.

Panel

borderColor	black
bgColor	#fafafb

DELETE /aspire/_api/resources/file/:id

Path Parameters

Name	Type	Required	Description
id	string	Required	The id of the file to delete

Request example

Code Block

language	js
theme	RDark

DELETE /aspire/_api/resources/file/517f161623ea3f43cc567a33914b96c31cbaa2c63d2594174d2b6230b1912ae1

Status: 200

Response example

Code Block

language	js
theme	RDark

{
	"id" : "517f161623ea3f43cc567a33914b96c31cbaa2c63d2594174d2b6230b1912ae1"
}

Section

Get File List

Gets the list of files in the Aspire resources repository, this endpoint needs the at least the OPERATOR role to be executed.

Panel

borderColor	black
bgColor	#fafafb

GET /aspire/_api/resources/file?from=:from&size=:size

Query Parameters

Name	Type	Required	Description
`from`	integer	Optional	The offset for the results page
size	integer	Optional	The page size

Request example

Code Block

language	js
theme	RDark

GET /aspire/_api/resources/file

Status: 200

Response example

Code Block

language	js
theme	RDark

{
    "count": {
        "totalItems": 1
    },
    "resource": [
        {
            "id" : "517f161623ea3f43cc567a33914b96c31cbaa2c63d2594174d2b6230b1912ae1"
            "name" : "file.groovy",
            "description" : "groovy",
            "checksum" : "12565092083235"
        }
    ]
}

Page tree

Versions Compared

Old Version 26

New Version Current

Key

Get properties for the component

Get the icon for the component

Get the dxf for the component

Delete custom application

Get Metrics Dashboard

Upload

File

Download

File

Update File Description

Delete File

Get File List

Page tree

Page History

Versions Compared

Old Version 26

New Version Current

Key

Get properties for the component

Get the icon for the component

Get the dxf for the component

Delete custom application

Get Metrics Dashboard

Upload

File

Download

File

Update File Description

Delete File

Get File List