Skip to main content
Splunk® Enterprise

Upgrade Readiness

Splunk® Enterprise
9.3.1

REST API reference for the Upgrade Readiness App

Use the REST API to run scans programmatically on your Splunk platform instance.

Endpoints that contain jura apply only to jQuery scans.

Authentication and authorization
To use this REST API, you must have write permissions to the Upgrade Readiness App.

/services/pura_app_list

https://<host>:<mPort>/services/pura_app_list?type={scan_type}

Lists the apps for a user by the scan type


Usage details
To use this endpoint, you must have permission to see the apps on your instance.


GET

Expand

Fetches the list of apps for a user by the scan type.


/services/pura_dismiss_app

https://<host>:<mPort>/services/pura_dismiss_app

Dismisses an application path.


Usage details
To use this endpoint, a previous scan must be available for this user.


POST

Expand

Writes an entry for a specified app path in the KV store for the user and updates the JSON report accordingly.


/services/pura_export_report

https://<host>:<mPort>/services/pura_export_report?ID={scan_ID}&format={file_format}&app_name={app_name}&app_path={app_path}

Fetches a JSON or CSV report for a given scan_ID and app_path.


Usage details
To use this endpoint, a previous scan result must be available, and you must know its scan_ID and app_path.


GET

Expand

Fetches the JSON or CSV report for a previous scan, given a scan_ID.


/services/pura_scan_deployment

https://<host>:<mPort>/services/pura_scan_deployment

Triggers a new Python scan of the apps installed on the Splunk platform instance for which you have at least read permission.


Usage details
To use this endpoint, a scan must not be running.


POST

Expand

Starts a scan and writes progress in the KV store.


/services/jura_scan_deployment

https://<host>:<mPort>/services/jura_scan_deployment

Triggers a new jQuery scan of the apps installed on the Splunk platform instance for which you have at least read permission.


Usage details
To use this endpoint, a scan must not be running.


POST

Expand

Starts a scan and writes progress in the KV store.


/services/pura_schedule_scan

https://<host>:<mPort>/services/pura_schedule_scan

Schedules a scan at a custom time or at the default time at 1:00 AM daily.

Returns the custom scan details from the KV store if stored.


Usage details
To use this endpoint, you must have permission to see the apps on your instance.


POST

Expand Schedules a scan at the given time interval. By default, if no time is specified, the scan is scheduled for 1:00 AM daily.

GET

Expand

Returns the scan schedule details saved in the KV store.


/services/pura_sendemail

https://<host>:<mPort>/services/pura_sendemail

Email a specific app report to the specified email addresses and app.


Usage details
To use this endpoint, you must complete a scan and correctly configure email details.


POST

Expand Sends the app report as an email to the specified email addresses.

/services/pura_read_progress

https://<host>:<mPort>/services/pura_read_progress

Reads current progress for an ongoing or completed Python scan.


Usage details
To use this endpoint, you must be running a scan or have completed a scan.


GET

Expand

Reads current progress of an ongoing scan on the instance from the KV store or fetches the previous scan results for the user.


/services/jura_read_progress

https://<host>:<mPort>/services/jura_read_progress

Reads current progress for an ongoing or completed jQuery scan.


Usage details
To use this endpoint, you must be running a scan or have completed a scan.


GET

Expand

Reads current progress of an ongoing scan on the instance from the KV store or fetches the previous scan results for the user.


/services/pura_cancel_scan

https://<host>:<mPort>/services/pura_cancel_scan

Cancels an ongoing Python scan for the user on the instance.


Usage details
To use this endpoint, you must be running a scan.


DELETE

Expand

Sets a canceled flag for the ongoing scan which restricts the scan from writing further progress in the KV store and allows the thread to return.


/services/jura_cancel_scan

https://<host>:<mPort>/services/jura_cancel_scan

Cancels an ongoing jQuery scan for the user on the instance.


Usage details
To use this endpoint, you must be running a scan.


DELETE

Expand

Sets a canceled flag for the ongoing scan which restricts the scan from writing further progress in the KV store and allows the thread to return.



/services/pura_dismiss_file

https://<host>:<mPort>/services/pura_dismiss_file

Dismisses a file path from the scan report and omits it from future scans.


Usage details
To use this endpoint, a previous scan must be available for this user.


POST

Expand

Writes an entry for a specified file path in the KV store for a user and updates the JSON report by removing the file path entry.


/services/pura_remote_dismiss_app

https://<host>:<mPort>/services/pura_remote_dismiss_app

Dismisses an application path for the merged Python report of local and remote instances.


Usage details
To use this endpoint, a previous scan must be available for this user.


POST

Expand

Writes an entry for a specified app path in the KV store for the user and updates the JSON report accordingly.


/services/jura_remote_dismiss_app

https://<host>:<mPort>/services/jura_remote_dismiss_app

Dismisses an application path for the merged jQuery report of local and remote instances.


Usage details
To use this endpoint, a previous scan must be available for this user.


POST

Expand

Writes an entry for a specified app path in the KV store for the user and updates the JSON report accordingly.


/services/pura_remote_dismiss_file

https://<host>:<mPort>/services/pura_remote_dismiss_file

Dismisses a file path for the merged Python report from local and remote scan report and skips it in future scans.


Usage details
To use this endpoint, a previous scan must be available for this user.


POST

Expand

Writes an entry for a specified file path in the KV store for a user and updates the JSON report by removing the file path entry.


/services/jura_remote_dismiss_file

https://<host>:<mPort>/services/jura_remote_dismiss_file

Dismisses a file path for the merged jQuery report from local and remote scan report and skips it in future scans.


Usage details
To use this endpoint, a previous scan must be available for this user.


POST

Expand

Writes an entry for a specified file path in the KV store for a user and updates the JSON report by removing the file path entry.


/services/pura_remote_result

https://<host>:<mPort>/services/pura_remote_result

Reads the latest merged Python scan report of the local and remote instances.


Usage details
To use this endpoint, you must have completed a scheduled scan and have a merged scan report.


GET

Expand

Reads the latest merged scan report of the local and remote instances.


/services/jura_remote_result

https://<host>:<mPort>/services/jura_remote_result

Reads the latest merged jQuery scan report of the local and remote instances.


Usage details
To use this endpoint, you must have completed a scheduled scan and have a merged scan report.


GET

Expand

Reads the latest merged scan report of the local and remote instances.


/services/pura_remote_schedule_scan

https://<host>:<mPort>/services/pura_remote_schedule_scan

Schedules a Python scan at a custom time or at the default time at 1 AM daily based on user inputs.

Returns the custom scan details from the KV store if stored.


Usage details
To use this endpoint, you must have permission to see the apps on your instance.


POST

Expand

Schedules a scan at the given time interval. By default, if no time is specified, the scan is scheduled for 1:00 AM daily.

GET

Expand

Returns the scan schedule details saved in the KV store.


/services/jura_remote_schedule_scan

https://<host>:<mPort>/services/jura_remote_schedule_scan

Schedules a jQuery scan at a custom time or at the default time at 4 AM daily based on user inputs.

Returns the custom scan details from the KV store if stored.


Usage details
To use this endpoint, you must have permission to see the apps on your instance.


POST

Expand

Schedules a scan at the given time interval. By default, if no time is specified, the scan is scheduled for 1:00 AM daily.

GET

Expand

Returns the scan schedule details saved in the KV store.


/services/pura_remote_export_report

https://<host>:<mPort>/services/pura_remote_export_report?ID={scan_ID}&format={file_format}&app_name={app_name}&app_path={app_path}&host={host}

Fetches a JSON or CSV report for a given Python scan_ID and app path.


Usage details
To use this endpoint, a previous scan result must be available, and you must know its scan_ID and app_path.


GET

Expand

Fetches the JSON or CSV report for a previous scan, given a scan_ID.


/services/jura_remote_export_report

https://<host>:<mPort>/services/jura_remote_export_report?ID={scan_ID}&format={file_format}&app_name={app_name}&app_path={app_path}&host={host}

Fetches a JSON or CSV report for a given jQuery scan_ID and app path.


Usage details
To use this endpoint, a previous scan result must be available, and you must know its scan_ID and app_path.


GET

Expand

Fetches the JSON or CSV report for a previous scan, given a scan_ID.


/services/pura_remote_sendemail

https://<host>:<mPort>/services/pura_remote_sendemail

Email a specific Python app report to the specified email addresses and app.


Usage details
To use this endpoint, you must complete a scan and correctly configure email details.


POST

Expand Sends the app report as an email to the specified email addresses.

/services/jura_remote_sendemail

https://<host>:<mPort>/services/jura_remote_sendemail

Email a specific jQuery app report to the specified email addresses and app.


Usage details
To use this endpoint, you must complete a scan and correctly configure email details.


POST

Expand Sends the app report as an email to the specified email addresses.

/services/pura_latest_report

https://<host>:<mPort>/services/pura_latest_report

Get the latest scheduled Python scan report.


Usage details
To use this endpoint, a scheduled scan must be completed.


GET

Expand

Get the latest scheduled scan report.


/services/jura_latest_report

https://<host>:<mPort>/services/jura_latest_report

Get the latest scheduled jQuery scan report.


Usage details
To use this endpoint, a scheduled scan must be completed.


GET

Expand

Get the latest scheduled scan report.


/services/pura_manage_remote_scan

https://<host>:<mPort>/services/pura_manage_remote_scan

Updates the schedule scan details in scripted input of the host.


Usage details
To use this endpoint, you must have permission to see the apps on your instance.


POST

Expand

Updates the scripted input according to the schedule scan details specified.


/services/pura_user_records

https://<host>:<mPort>/services/pura_user_records

View or update the user Python version upgrade requests.


Usage details
To use this endpoint, you must have permission to see the apps on your instance.


POST

Expand

Submit a Python version upgrade request.

GET

Expand

Gets the user Python version upgrade request records.


/services/pura_check_python_version

https://<host>:<mPort>/services/pura_check_python_version

Get the current Python version on the server.


Usage details
To use this endpoint, you must have permission to see the apps on your instance.


GET

Expand

Get the current Python version on the server.

Last modified on 21 January, 2022
Act on Splunk Platform Compatibility scan results with the Upgrade Readiness App   Manage weekly emails from the Upgrade Readiness App

This documentation applies to the following versions of Splunk® Enterprise: 8.2.0, 8.2.1, 8.2.2, 8.2.3, 8.2.4, 8.2.5, 8.2.6, 8.2.7, 8.2.8, 8.2.9, 8.2.10, 8.2.11, 8.2.12, 9.0.1, 9.0.2, 9.0.3, 9.0.4, 9.0.5, 9.0.6, 9.0.7, 9.0.8, 9.0.9, 9.0.10, 9.1.0, 9.1.1, 9.1.2, 9.1.3, 9.1.4, 9.1.5, 9.1.6, 9.1.7, 9.2.0, 9.2.1, 9.2.2, 9.2.3, 9.2.4, 9.3.0, 9.3.1, 9.3.2, 9.4.0


Was this topic useful?







You must be logged into splunk.com in order to post comments. Log in now.

Please try to keep this discussion focused on the content covered in this documentation topic. If you have a more general question about Splunk functionality or are experiencing a difficulty with Splunk, consider posting a question to Splunkbase Answers.

0 out of 1000 Characters