Specially handled URLs
The Automation Service recognizes certain URLs as special and handles them differently. There are URLs that are handled specially by the refget verb. These are documented in Reference Downloading. Additionally, there are 2 kinds of URLs that are recognized. These are documented below.
OSS URLs
urn:adsk.objects:os.object:<YOUR_BUCKET_KEY>/<OBJECT_KEY> form can be used to upload/download data to/from OSS without having to create presigned URLs. You must also provide an appropriate APS token.
Example
{
"activityId": "<YOUR_APP_NICKNAME>.ListLayersActivity+my_current_version",
"arguments": {
"InputDwg": {
"url": "urn:adsk.objects:os.object:<YOUR_BUCKET_KEY>/<OBJECT_KEY_INPUT_FILE>",
"verb": "get",
"headers": {
"Authorization": "Bearer <YOUR_ACCESS_TOKEN>"
}
},
"result": {
"url": "urn:adsk.objects:os.object:<YOUR_BUCKET_KEY>/<OBJECT_KEY_OUTPUT_FILE>",
"verb": "put",
"headers": {
"Authorization": "Bearer <YOUR_ACCESS_TOKEN>"
}
}
}
}
Intermediate Storage URLs
The das://intermediate scheme can be used to store intermediate data between workitems. Currently 2 forms are supported:
- das://intermediate/<some_path>/<some_more_path>/<item>.<ext>: in output arguments only and only put verb is supported. See also Combinator.
- das://intermediate.<workitemId>/<some_path>/<some_more_path>/<item>.<ext>: in input arguments only and only get verb is supported.
Example
{
"activityId" : "AutoCAD.PlotToPdf+prod",
"arguments" {
"HostDwg": {
"url": "http://sample.com/drawing1.dwg"
},
"Result" : {
"url": "das://intermediate/page1.pdf" //upload result to intermediate storage of the Automation Service.
}
}
}
The resulting PDF file is sent to the intermediate storage of the Automation Service where it is retained for 3 days. The user can create another WorkItem as follows to reuse the output of previous WorkItem. Let’s assume that the WorkItem id of the above WorkItem is 12345. ProcessPdf is an activity that takes a pdf file as input and produces another pdf file as output.
{
"activityId" : "AutoCAD.ProcessPdf+prod",
"arguments" {
"HostDwg": {
"url": "das://intermediate.12345/page1.pdf" //retrieve page1.pdf from the previous WorkItem.
},
"Result" : {
"url": "http://myserver.com/final.pdf" //upload result to some server where it is permanently stored and can be retrieved by the user.
}
}
}