- URL:
- https://<root>/<serviceName>/VersionManagementServer/versions/<versionGuid>/post
- Methods:
POST
- Required Capability:
- ArcGIS Advanced Editing user type extension license
- Version Introduced:
- 10.6
Description
The post
operation allows the client to post the changes in their version to the default version. The reconcile
operation must be performed before the post
operation. The session
value performing the post
operation must match the session
value used for the reconcile
operation. To post a subset of edits in the current version to the default version, define the rows
parameter.
The post
operation is supported both synchronously and asynchronously.
Review the read and edit session requirements for version resource operations.
Request parameters
Parameter | Details |
---|---|
| Specifies the output format of the response. The default response format is Values: |
| Specifies the client-generated session ID (GUID). Syntax : |
| Specifies the rows (features or objects) that will be used when posting a subset of edits in the current version to the default version. The object IDs provided must be edits in the current version, which can be obtained from the When the This parameter was introduced at ArcGIS Enterprise 10.9. Syntax:
Example:
|
| Specifies whether the request will be processed asynchronously. If Values: This parameter was introduced at ArcGIS Enterprise 10.9.1. |
JSON Response syntax
JSON response (when async = false):
{
"moment" : <datetime>,
"success" : <true | false>,
"error" : { // only if success is false
"extendedCode" : <HRESULT>,
"message" : <error message>,
"details" : [ <detail> ]
}
}
JSON response (when async = true):
{
"statusUrl" : <url>
}
JSON response to the status URL (when pending or in progress):
{
"status" : "<Pending | InProgress>",
"submissionTime" : <datetime>,
"lastUpdatedTime" : <datetime>
}
Example usage
Use the post
operation to post edits from a named version to the default version.
Example 1
Use the post
operation to post all edits from a named version to the default version.
Request URL and parameters:
https
f=json
sessionId={3E11BA55-9A50-4EDD-A694-D5C4F21CD40D}
async=false
JSON response:
{
"moment": 1602605793507,
"success": true
}
Example 2
Use the post
operation to post a subset of edits from a named version to the default version using the rows
parameter.
The object
values provided must be edits in the current version, which can be obtained from the differences
operation. In the example, the object
values provided for the rows
parameter include a subset of edits with combinations of inserts, updates, and deletes. For layerId 0, objectIds 1207 and 1208 represent newly inserted features, and objectIds 12 and 14 are updated and deleted features. For layerId1, objectIds 809 represents an inserted feature.
Request URL and parameters:
https
f=json
sessionId={3E11BA55-9A50-4EDD-A694-D5C4F21CD40D}
rows=[
{
"layerId":0,
"objectIds":[1207,1208,12,14]
},
{
"layerId":1,
"objectIds":[809]
}
]
async=false
JSON response:
{
"moment": 1602605793507,
"success": true
}