Get report images via report in request body

post/jobs

This operation is identical to POST /jobs (createJobWithParams), except instead of supplying the reportUri parameter, you supply the BIRD report (in JSON or XML) in the request body.

This operation should be used by a client that has edited the BIRD report.

To access this operation, the "Content-Type" must be "application/vnd.sas.report.content+json" or "application/vnd.sas.report.content+xml".

This operation does not benefit from cache-based performance.

Request Samples

1

Response Samples

1{
2  "id": "d145d576-78d0-42d4-a5fc-569cd0533903",
3  "version": 2,
4  "state": "running",
5  "durationMSec": 155,
6  "creationTimeStamp": "2017-11-17T18:46:59.774000Z",
7  "links": [
8    {
9      "method": "GET",
10      "rel": "self",
11      "href": "/reportImages/jobs/d145d576-78d0-42d4-a5fc-569cd0533903",
12      "uri": "/reportImages/jobs/d145d576-78d0-42d4-a5fc-569cd0533903",
13      "type": "application/vnd.sas.report.images.job+json"
14    },
15    {
16      "method": "GET",
17      "rel": "state",
18      "href": "/reportImages/jobs/d145d576-78d0-42d4-a5fc-569cd0533903/state",
19      "uri": "/reportImages/jobs/d145d576-78d0-42d4-a5fc-569cd0533903/state",
20      "type": "text/plain"
21    }
22  ],
23  "images": [
24    {
25      "sectionIndex": 0,
26      "sectionName": "vi6",
27      "sectionLabel": "Page 1",
28      "elementName": "ve41",
29      "modifiedTimeStamp": "2017-11-16T18:19:23.600000Z",
30      "visualType": "Table",
31      "size": "268x151",
32      "state": "completed",
33      "links": [
34        {
35          "method": "GET",
36          "rel": "image",
37          "href": "/reportImages/images/K738605462B1380786238.svg",
38          "uri": "/reportImages/images/K738605462B1380786238.svg",
39          "type": "image/svg+xml"
40        }
41      ]
42    },
43    {
44      "sectionIndex": 1,
45      "sectionName": "vi47",
46      "sectionLabel": "Page 2",
47      "elementName": "ve50",
48      "modifiedTimeStamp": "2017-11-12T14:05:13.450000Z",
49      "visualType": "pie",
50      "size": "268x151",
51      "state": "running",
52      "links": [
53        {
54          "method": "GET",
55          "rel": "staleImage",
56          "href": "/reportImages/images/K738605462B1234567890.svg",
57          "uri": "/reportImages/images/K738605462B1234567890.svg",
58          "type": "image/svg+xml"
59        }
60      ]
61    }
62  ]
63}

Query Parameters

NameTypeRequiredDescription
imageType
string
false

In addition to the default "svg" for SVG image generation, "png" is now supported and results in a png image being created.

Allowed values:
svgpng
Default:
svg
layoutType
string
false

The type of image to render. thumbnail -- selects a suitable report element and reduces the detail to better render at a smaller size. normal -- selects a suitable report element, but there is no reduction of detail. entireSection -- the entire section (page).

Allowed values:
thumbnailnormalentireSection
Default:
thumbnail
refresh
boolean
false

If true, bypass caches and generate a new image.

Default:
false
renderLimit
integer<int32>
false

Limit how many images to render. For no limit, set to -1. Clients can specify "1" to quickly get the first image and how many remaining images are available.

Default:
-1
sectionIndex
integer<int32>
false

The section to render. This parameter applies when layoutType==entireSection.

Default:
0
selectionType
string
false

The selected operation. report -- get a single image, representing the entire report. perSection -- get one image per section. visualElements -- specify the visual elements to render in parameter visualElementNames or visualElementName for the /directImage operation.

Allowed values:
reportperSectionvisualElements
Default:
report
style
string
false

The only non-empty value supported is "highContrast", which results in a high contrast image being rendered.

Allowed values:
(null/empty string)highContrast
visualElementNames
string
false

If "selectionType=visualElements" is specified, this parameter lists the element names to render. Separate multiple elements with commas.

wait
number<float>
false

The number of seconds to wait for an update before returning from the "long poll". The maximum is 30 seconds.

Default:
0.5
size
string
true

The size of the rendered image. Format is widthxheight, with no spaces. For example, "268x151".

Header Parameters

NameTypeRequiredDescription
Accept-Language
string
false

The user's locale. For non-thumbnail operations, this locale is a factor for both rendering and caching. For thumbnail requests, typically only the right-to-left aspect is considered. Thumbnails do not typically include localizable content, and consequently are shareable among users with different locales. For details, see Accept-Language.

Accept-Locale
string
false

A "format locale" distinct from the user's language (Accept-Language). Usage and syntax is similar to Accept-Language.

Request Body

The report from which to generate images (JSON or XML, per Content-Type header).

Responses

StatusMeaningDescription
201Created

The job has both been created and is in the "completed" state; the image(s) are ready.

HeadersSchema
202Accepted

The requested job has been created but has not completed.

HeadersSchema
400Bad Request

The request was invalid.

HeadersSchema
404Not Found

The report could not be found.

HeadersSchema