ReportsDataExtraction

Use this API to implement reports lifecycle managing and monitoring. With this functionality in place, users can run reports, view their results, and cancel reports in progress. This can be potentially helpful for auditing purposes.

All URIs are relative to https://sailpoint.api.identitynow.com/v3

Method	HTTP request	Description
Suspend-Report	POST /reports/{id}/cancel	Cancel Report
Get-Report	GET /reports/{taskResultId}	Get Report File
Get-ReportResult	GET /reports/{taskResultId}/result	Get Report Result
Start-Report	POST /reports/run	Run Report

cancel-report

Cancels a running report.

API Spec

Parameters

Param Type	Name	Data Type	Required	Description
Path	Id	String	True	ID of the running Report to cancel

Return type

(empty response body)

Responses

Code	Description	Data Type
204	No content - indicates the request was successful but there is no content to be returned in the response.
400	Client Error - Returned if the request body is invalid.	ErrorResponseDto
401	Unauthorized - Returned if there is no authorization header, or if the JWT token is expired.	ListAccessProfiles401Response
403	Forbidden - Returned if the user you are running as, doesn't have access to this end-point.	ErrorResponseDto
429	Too Many Requests - Returned in response to too many requests in a given period of time - rate limited. The Retry-After header in the response includes how long to wait before trying again.	ListAccessProfiles429Response
500	Internal Server Error - Returned if there is an unexpected error.	ErrorResponseDto

HTTP request headers

• Content-Type: Not defined
• Accept: application/json

Example

$Id = "a1ed223247144cc29d23c632624b4767" # String | ID of the running Report to cancel

# Cancel Report

try {
    Suspend-Report -Id $Id 
    
    # Below is a request that includes all optional parameters
    # Suspend-Report -Id $Id  
} catch {
    Write-Host $_.Exception.Response.StatusCode.value__ "Exception occurred when calling Suspend-Report"
    Write-Host $_.ErrorDetails
}

[Back to top]

get-report

Gets a report in file format.

API Spec

Parameters

Param Type	Name	Data Type	Required	Description
Path	TaskResultId	String	True	Unique identifier of the task result which handled report
Query	FileFormat	String	True	Output format of the requested report file
Query	Name	String	(optional)	preferred Report file name, by default will be used report name from task result.
Query	Auditable	Boolean	(optional) (default to $false)	Enables auditing for current report download. Will create an audit event and sent it to the REPORT cloud-audit kafka topic. Event will be created if there is any result present by requested taskResultId.

Return type

System.IO.FileInfo

Responses

Code	Description	Data Type
200	Report file in selected format. CSV by default.	System.IO.FileInfo
400	Client Error - Returned if the request body is invalid.	ErrorResponseDto
401	Unauthorized - Returned if there is no authorization header, or if the JWT token is expired.	ListAccessProfiles401Response
403	Forbidden - Returned if the user you are running as, doesn't have access to this end-point.	ErrorResponseDto
404	Not Found - returned if the request URL refers to a resource or object that does not exist	ErrorResponseDto
429	Too Many Requests - Returned in response to too many requests in a given period of time - rate limited. The Retry-After header in the response includes how long to wait before trying again.	ListAccessProfiles429Response
500	Internal Server Error - Returned if there is an unexpected error.	ErrorResponseDto

HTTP request headers

• Content-Type: Not defined
• Accept: application/csv, application/pdf, application/json

Example

$TaskResultId = "ef38f94347e94562b5bb8424a56397d8" # String | Unique identifier of the task result which handled report
$FileFormat = "csv" # String | Output format of the requested report file
$Name = "Identities Details Report" # String | preferred Report file name, by default will be used report name from task result. (optional)
$Auditable = $true # Boolean | Enables auditing for current report download. Will create an audit event and sent it to the REPORT cloud-audit kafka topic.  Event will be created if there is any result present by requested taskResultId. (optional) (default to $false)

# Get Report File

try {
    Get-Report -TaskResultId $TaskResultId -FileFormat $FileFormat 
    
    # Below is a request that includes all optional parameters
    # Get-Report -TaskResultId $TaskResultId -FileFormat $FileFormat -Name $Name -Auditable $Auditable  
} catch {
    Write-Host $_.Exception.Response.StatusCode.value__ "Exception occurred when calling Get-Report"
    Write-Host $_.ErrorDetails
}

[Back to top]

get-report-result

Get the report results for a report that was run or is running. Returns empty report result in case there are no active task definitions with used in payload task definition name.

API Spec

Parameters

Param Type	Name	Data Type	Required	Description
Path	TaskResultId	String	True	Unique identifier of the task result which handled report
Query	Completed	Boolean	(optional) (default to $false)	state of task result to apply ordering when results are fetching from the DB

Return type

ReportResults

Responses

Code	Description	Data Type
200	Details about report that was run or is running.	ReportResults
400	Client Error - Returned if the request body is invalid.	ErrorResponseDto
401	Unauthorized - Returned if there is no authorization header, or if the JWT token is expired.	ListAccessProfiles401Response
403	Forbidden - Returned if the user you are running as, doesn't have access to this end-point.	ErrorResponseDto
429	Too Many Requests - Returned in response to too many requests in a given period of time - rate limited. The Retry-After header in the response includes how long to wait before trying again.	ListAccessProfiles429Response
500	Internal Server Error - Returned if there is an unexpected error.	ErrorResponseDto

HTTP request headers

• Content-Type: Not defined
• Accept: application/json

Example

$TaskResultId = "ef38f94347e94562b5bb8424a56397d8" # String | Unique identifier of the task result which handled report
$Completed = $true # Boolean | state of task result to apply ordering when results are fetching from the DB (optional) (default to $false)

# Get Report Result

try {
    Get-ReportResult -TaskResultId $TaskResultId 
    
    # Below is a request that includes all optional parameters
    # Get-ReportResult -TaskResultId $TaskResultId -Completed $Completed  
} catch {
    Write-Host $_.Exception.Response.StatusCode.value__ "Exception occurred when calling Get-ReportResult"
    Write-Host $_.ErrorDetails
}

[Back to top]

start-report

Use this API to run a report according to report input details. If non-concurrent task is already running then it returns, otherwise new task creates and returns.

API Spec

Parameters

Param Type	Name	Data Type	Required	Description
Body	ReportDetails	ReportDetails	True

Return type

TaskResultDetails

Responses

Code	Description	Data Type
200	Details about running report task.	TaskResultDetails
400	Client Error - Returned if the request body is invalid.	ErrorResponseDto
401	Unauthorized - Returned if there is no authorization header, or if the JWT token is expired.	ListAccessProfiles401Response
403	Forbidden - Returned if the user you are running as, doesn't have access to this end-point.	ErrorResponseDto
429	Too Many Requests - Returned in response to too many requests in a given period of time - rate limited. The Retry-After header in the response includes how long to wait before trying again.	ListAccessProfiles429Response
500	Internal Server Error - Returned if there is an unexpected error.	ErrorResponseDto

HTTP request headers

• Content-Type: application/json
• Accept: application/json

Example

$ReportDetails = @"{
  "reportType" : "ACCOUNTS",
  "arguments" : {
    "application" : "2c9180897e7742b2017e781782f705b9",
    "sourceName" : "Active Directory"
  }
}"@

# Run Report

try {
    $Result = ConvertFrom-JsonToReportDetails -Json $ReportDetails
    Start-Report -ReportDetails $Result 
    
    # Below is a request that includes all optional parameters
    # Start-Report -ReportDetails $Result  
} catch {
    Write-Host $_.Exception.Response.StatusCode.value__ "Exception occurred when calling Start-Report"
    Write-Host $_.ErrorDetails
}

[Back to top]