Create

URL:
https://<root>/<serviceName>/VersionManagementServer/create
Methods:
POST
Required Capability:
ArcGIS Advanced Editing user type extension license
Version Introduced:
10.6

Description

Create a version off of DEFAULT. The version is associated with the specified feature service.

Request parameters

ParameterDetails

f

Specifies the output format of the response. The default response format is html.

Values: html | json | pjson

versionName (Required)

Specifies the name of the new version.

The version name cannot exceed 62 characters or include any of the following special characters:

  • Period (.)
  • Semicolon (;)
  • Single quotation mark (')
  • Double quotation mark (")

Syntax:

Use dark colors for code blocksCopy
1
versionName = <versionName>

description (Optional)

Specifies the description of the new version.

Ensure the description does not exceed 64 characters.

Syntax: description = description for version

accessPermission (Optional)

Specifies the access permissions of the new version. The default access permission is private.

Values: private | public | protected | hidden

Example: private

JSON Response syntax

Use dark colors for code blocksCopy
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
{
  "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

Use dark colors for code blocksCopy
1
2
3
4
f=json
versionName=carolina
description=Version for new subdivision edits
accessPermission=private

JSON response:

Use dark colors for code blocksCopy
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
{
 "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
}

Your browser is no longer supported. Please upgrade your browser for the best experience. See our browser deprecation post for more details.