- URL:https://<versionmanagementservice-url>/create(POST only)
- Version Introduced:10.6
Description
Create a named version off of DEFAULT. The version is associated with the specified feature service. During creation, the description and accessPermission (default is private) may be optionally set.
Request parameters
| Parameter | Details |
|---|---|
| f | Description: Optional parameter to specify the output format of the response. The default response format is html. Values: html | json |
| versionName | Description: The name of the new version. Syntax: versionName = <versionName> The version name cannot exceed 62 characters or include any of the following special characters:
|
| description | Description: Optional parameter to specify the description of the new version. Syntax: description = description for version |
| accessPermission | Description: Optional parameter to specify the access permissions of the new version. The default access permission is private. Values: private | public | protected | hidden Example: private |
JSON Response syntax
{
"versionInfo" : {
"versionName": <versionName>,
"versionGuid": <guid>,
"versionId": <long>,
"description": <description>,
"creationDate": <dateTime>,
"modifiedDate": <dateTime>,
"reconcileDate": <dateTime>,
"evaluationDate": <dateTime>,
"commonAncestorDate": <dateTime>,
"access" : "private" | "public" | "protected"
},
"success" : <true | false>,
"error" : { // only if success is false
"extendedCode" : <HRESULT>,
"message" : <error message>,
"details" : [ <detail> ]
}
}
Example usage
Create a named version using the create operation.
Request URL and parameters: https://myserver.esri.com/server/rest/services/LandUse/VersionManagementServer/create JSON response:f=json
versionName=carolina
description=Version for new subdivision edits
accessPermission=private{
"versionInfo": {
"versionName": "portaluser.carolina",
"versionGuid": "{30AD6543-16CD-4291-89CA-E734199EE231}",
"versionId": 2,
"description": "Version for new subdivision edits",
"creationDate": 1567540025752,
"modifiedDate": 1567540025752,
"reconcileDate": null,
"evaluationDate": null,
"previousAncestorDate": null,
"commonAncestorDate": 1567540025752,
"access": "private"
},
"success": true
}