Example usage

The following is a sample POST request for the export operation:

POST /webadaptor/sharing/rest/community/groups/3ca5299f4b3d423ebd66e9f72f9ef638/export HTTP/1.1
Host: machine.domain.com
Content-Type: multipart/form-data; boundary=----WebKitFormBoundaryYhbOXGMMNAbGl1gv

------WebKitFormBoundaryYhbOXGMMNAbGl1gv
Content-Disposition: form-data; name="itemIdList"


------WebKitFormBoundaryYhbOXGMMNAbGl1gv
Content-Disposition: form-data; name="async"

true
------WebKitFormBoundaryYhbOXGMMNAbGl1gv
Content-Disposition: form-data; name="f"

pjson
------WebKitFormBoundaryYhbOXGMMNAbGl1gv--

Description

The export operation extracts all supported items, or a set of supported items, from a group and exports them into an export package (.epk) that can be uploaded and imported into a separate ArcGIS Enterprise organization. In addition, the export operation can be used to extract content so that it can be moved between disconnected environments, as well as assist with workflows where select content needs to be backed up and restored or archived. It is important to note that the receiving organization must be using the same version (or later) of ArcGIS Enterprise as the environment where the export package was generated.

To demonstrate this functionality, consider the following scenario: You are a group owner who wants to move a set of the group's items from your organization's development environment to staging, and then from staging to production. You can call this operation and specify a list of item IDs for the items you wish to move to staging using the itemIdList parameter. Once the selected items have been exported into the downloadable export package, you can upload the package to your staging environment using the Add Item operation and, once added, call the Import operation to add the items to a designated group in your staging environment. This process can then be repeated to move the group's content from staging to production.

Request parameters

Accessing results

If async is false, and f is set to html, the response is an octet stream a client uses for downloading the export package. If f is set to json, the octet stream response cannot be returned on a successful export and an HTTP Status 400 error is returned.

If there are no items to export, a JSON response resembling the one below will be returned:

{
  "itemsExported": [],
  "itemsSkipped": [],
  "itemsFailedExport": []
}

If async is true, a jobID and key is returned:

{
  "jobId": "0c3d9012681845e4aa3ca3e5f9aae8fa",
  "key": "DjUElZ3XQjbJ2S/g7D5644SCEaTfDniHo5XQYYVWGjY="
}

Group owners attempting to export group content, but who are not administrators, must use both the jobID and key values to check the job's results and status using the following URL format:

https://machine.domain.com/webadaptor/sharing/rest/portals/<orgID>/jobs/<jobID>?key=<keyValue>

Administrators can check the job's results and status using the jobID value in the following URL format:

https://machine.domain.com/webadaptor/sharing/rest/portals/<orgID>/jobs/<jobID>

If successful, a success response will be returned containing an itemID and other job information. To download the export package, append the itemID from the response using the following URL format:

https://machine.domain.com/webadaptor/portal/sharing/rest/content/items/<itemID>/data

JSON Response example

{
  "id": "fadcd0a7b58c422ebcf0847aad76885d",
  "definition": {
    "type": "export",
    "operationId": "cm009fe62d885748a4a19050844e1f8c20",
    "groupId": "3ca5299f4b3d423ebd66e9f72f9ef638",
    "groupTitle": "myGroup"
  },
  "status": "succeeded",
  "created": 1586901221029,
  "modified": 1586901241914,
  "messages": [
    "Starting export of items in group 'myGroup' with id '142b3c7995ec447288f15db4d301fe53'.",
    "{\"itemsExported\":[{\"itemId\":\"7c1124277b2f4847ae668de6c5135e6d\"},{\"itemId\":\"ac34a93042bb468faf17e933609ade79\"},{\"itemId\":\"f672235d835d46008b4d68145238ab19\"}],\"itemsSkipped\":[],\"itemsFailedExport\":[]}",
    "Added Export Package item with id '63a078b6aef54f1c91102fd9d4aa47f5' for group with id '142b3c7995ec447288f15db4d301fe53'."
  ],
  "result": {
    "itemId": "63a078b6aef54f1c91102fd9d4aa47f5",
    "created": 1586901241910
  }
}