Skip To Content

Create

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

ParameterDetails
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:

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

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

f=json
versionName=carolina
description=Version for new subdivision edits
accessPermission=private

JSON response:

{
 "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
}