Disable Topology

Description

Disables the network topology for a utility network. When the topology is disabled, feature and association edits do not generate dirty areas. Analytics and diagram generation can't be performed if the topology is not present.

When the topology is disabled, the following happens:

Disabling the topology is supported both synchronously and asynchronously. To perform certain network configuration tasks, the network topology must be disabled.

LicenseLicense:
The active portal account must be licensed with the ArcGIS Utility Network user type extension to use this operation.

Request parameters

Parameter

Details

f

Description: Optional parameter specifying the output format of the response. The default response format is html.

Values: html | json

gdbVersion

Description: Optional parameter specifying the name of the geodatabase version (default is DEFAULT).

Syntax: gdbVersion=<version>

Example: gdbVersion=sde.DEFAULT

sessionId

Description: Optional parameter specifying the token (guid) used to lock the version. If the calling client is editing a named version, the session ID must be provided; if the client is editing DEFAULT, the version may not be locked and the session ID should not be specified.

Syntax: sessionId=<guid>

Example: sessionId={29CC8FF6-D6C6-4157-A9A8-A9A9BCFE07D1}

async

Description: If true, the request is processed as an asynchronous job, and a URL is returned that a client can visit to check the status of the job. The default is false.

Values: true | false

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

JSON response to the status URL (when pending or in progress):

{
  "status" : "",
  "submissionTime" : ,
  "lastUpdatedTime" : 
 }

Example usage

Disable the network topology for a utility network using the disableTopology operation.

Request URL and parameters:

https://myserver.esri.com/server/rest/services/LandUse/UtilityNetworkServer/disableTopology

f=json
gdbVersion=SDE.DEFAULT
sessionID={29CC8FF6-D6C6-4157-A9A8-A9A9BCFE07D1}
async=false

JSON response:

{
 "moment": 1554393356246,
 "success": true
}