mirror of
https://github.com/LukeHagar/developer.sailpoint.com.git
synced 2025-12-06 04:19:31 +00:00
72 lines
2.1 KiB
YAML
72 lines
2.1 KiB
YAML
get:
|
|
tags:
|
|
- Reports Data Extraction
|
|
description: >-
|
|
Gets a report in file format.
|
|
operationId: getReport
|
|
summary: "Get Report File"
|
|
security:
|
|
- oauth2: [sp:report:read]
|
|
parameters:
|
|
- in: path
|
|
name: taskResultId
|
|
schema:
|
|
type: string
|
|
required: true
|
|
description: Unique identifier of the task result which handled report
|
|
example: ef38f94347e94562b5bb8424a56397d8
|
|
- in: path
|
|
name: fileFormat
|
|
schema:
|
|
type: string
|
|
required: true
|
|
description: Output format of the requested report file
|
|
example: 'CSV'
|
|
- in: query
|
|
name: name
|
|
required: false
|
|
schema:
|
|
type: string
|
|
example: 'Identities Details Report'
|
|
description: preferred Report file name, by default will be used report name from task result.
|
|
responses:
|
|
'200':
|
|
description: Details about running report task.
|
|
content:
|
|
application/octet-stream:
|
|
schema:
|
|
type: string
|
|
format: binary
|
|
headers:
|
|
Content-disposition:
|
|
description: The requested report's filename
|
|
schema:
|
|
type: string
|
|
example: 'attachment;filename=\"fileName"'
|
|
'400':
|
|
$ref: '../../v3/responses/400.yaml'
|
|
'401':
|
|
$ref: '../../v3/responses/401.yaml'
|
|
'403':
|
|
$ref: '../../v3/responses/403.yaml'
|
|
'404':
|
|
description: Not Found - returned if the request URL refers to a resource or object that does not exist
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: '../../v3/schemas/ErrorResponseDto.yaml'
|
|
examples:
|
|
"404":
|
|
summary: An example of a 404 response object
|
|
value:
|
|
detailCode: "404 Not found"
|
|
trackingId: "b21b1f7ce4da4d639f2c62a57171b427"
|
|
messages:
|
|
- locale: "en-US"
|
|
localeOrigin: "DEFAULT"
|
|
text: "<h1>File Not Found - 404 Error</h1> The requested file was not found."
|
|
'429':
|
|
$ref: '../../v3/responses/429.yaml'
|
|
'500':
|
|
$ref: '../../v3/responses/500.yaml'
|